Neo4j 图数据库入门与 Python 集成实战

增删改查实战

1. 创建节点与关系

创建单个带属性的节点很简单：

# 创建单个节点（带标签和属性）
CREATE (u:User {id: 1, name: "张三", age: 25, city: "北京"})
RETURN u;

如果要批量插入，可以一次写多条：

# 创建多个节点
CREATE (p1:Product {id: 101, name: "手机", price: 3999}), 
       (p2:Product {id: 102, name: "耳机", price: 299})
RETURN p1, p2;

解释一下： u:User 里的 u 是别名，User 是标签，相当于关系型数据库里的表名。

建立关系时，推荐先匹配节点再创建，避免重复：

# 先匹配节点，再创建关系
MATCH (u:User {id:1}), (p:Product {id:101})
CREATE (u)-[r:BUY {order_time: "2025-01-01", amount: 1, total: 3999}]->(p)
RETURN u, r, p;

或者一次性完成节点创建和关系建立：

# 一次性创建节点 + 关系
CREATE (u:User {id:2, name:"李四"})-[r:VIEW {time:"2025-01-02"}]->(p:Product {id:102})
RETURN u, r, p;

2. 查询数据

这是最核心的部分，Cypher 的查询能力很强。

基础查询：

# 查询所有 User 节点
MATCH (u:User) RETURN u.name, u.age;

# 查询带条件的节点
MATCH (u:User {age:25}) RETURN u;

# 查询关系（张三购买的商品）
MATCH (u:User {name:"张三"})-[r:BUY]->(p:Product) 
RETURN u.name, r.order_time, p.name;

# 查询路径
MATCH path = (u:User)-[:BUY]->(p:Product) 
RETURN path;

进阶一点，加上过滤、排序和统计：

# 过滤：价格>1000 的商品
MATCH (p:Product) WHERE p.price > 1000 RETURN p.name, p.price;

# 排序 + 分页：按价格降序，取前 1 条
MATCH (p:Product) RETURN p.name, p.price ORDER BY p.price DESC LIMIT 1;

# 统计：用户购买商品的数量
MATCH (u:User)-[:BUY]->(p:Product) 
RETURN u.name, COUNT(p) AS buy_count;

# 多关系查询（用户既购买又浏览的商品）
MATCH (u:User)-[:BUY]->(p:Product), (u)-[:VIEW]->(p) 
RETURN u.name, p.name;

3. 更新与删除

更新属性直接用 SET：

# 更新节点属性（修改张三的年龄）
MATCH (u:User {name:"张三"}) SET u.age = 26, u.city = "上海"
RETURN u;

# 更新关系属性（修改订单金额）
MATCH (u:User {id:1})-[r:BUY]->(p:Product {id:101}) 
SET r.total = 3899
RETURN r;

删除要格外小心！ 删除节点前必须先删掉关联的关系，否则会报错。

# 删除单个关系
MATCH (u:User {id:1})-[r:BUY]->(p:Product {id:101}) DELETE r;

# 删除节点（先删关系再删节点）
MATCH (u:User {id:2})-[r]->(p:Product) 
DELETE r, u, p;

# 同时删除关系和节点
# 清空数据库（谨慎使用！）
MATCH (n) DETACH DELETE n;

进阶用法

1. 索引与约束

为了性能，记得给常用查询字段建索引：

# 为 User 的 id 创建索引
CREATE INDEX idx_user_id FOR (u:User) ON (u.id);

# 为 Product 的 name 创建全文索引
CREATE FULLTEXT INDEX idx_product_name FOR (p:Product) ON EACH [p.name];

约束能保证数据唯一性：

# 保证 User 的 id 唯一
CREATE CONSTRAINT constraint_user_id UNIQUE FOR (u:User) REQUIRE u.id IS UNIQUE;

# 非空约束（Neo4j 4.0+）
CREATE CONSTRAINT constraint_product_price FOR (p:Product) REQUIRE p.price IS NOT NULL;

2. 批量导入

大量数据建议用 CSV 导入。把文件放进 import 目录（桌面版可在「Database → Open Folder → Import」找到），然后执行命令。如果格式复杂，可以用 APOC 插件，支持 JSON/Excel 导入。

3. Python 连接

官方驱动叫 neo4j，安装 pip install neo4j 即可。

from neo4j import GraphDatabase

# 连接数据库
driver = GraphDatabase.driver(
    "bolt://localhost:7687", 
    auth=("neo4j", "你的密码")
)

# 执行查询
def get_user_buy_products(user_name):
    with driver.session() as session:
        result = session.run(
            """
            MATCH (u:User {name:$name})-[r:BUY]->(p:Product) 
            RETURN u.name, r.order_time, p.name
            """, 
            name=user_name
        )
        # 处理结果
        for record in result:
            print(f"用户 {record['u.name']} 在 {record['r.order_time']} 购买了 {record['p.name']}")

get_user_buy_products("张三")
driver.close()

常用技巧与常见问题

Browser 快捷键：

• :help：查看帮助
• :schema：查看索引、约束、标签
• :clear：清空界面

性能优化：

• 查询字段务必建索引
• 避免 MATCH (n) 全图扫描
• 复杂查询用 PROFILE 分析执行计划

常见问题：

1. 忘记密码：桌面版在「Database → Manage → Change Password」修改；Docker 需进容器重置。
2. 端口占用：修改 neo4j.conf 中的 dbms.connector.bolt.port 和 dbms.connector.http.port。
3. 备份恢复：使用 neo4j-admin dump/load 或桌面版功能。

最后，官方文档是最权威的参考，遇到高级特性（如图算法、集群）建议查阅 docs。