安装
要开始创建 Neo4j Python 应用程序,您首先需要安装 Python 驱动程序并获取一个可连接的 Neo4j 数据库实例。
安装驱动程序
使用 pip
安装 Neo4j Python 驱动程序(需要 Python >= 3.7)
pip install neo4j
始终使用最新版本的驱动程序,因为它始终兼容之前的 Neo4j LTS 版本以及当前和未来的主要版本。最新的 5.x
驱动程序支持连接到任何 Neo4j 实例版本 4.4、5.x 和 2025.x。有关跨版本更改的详细列表,请参阅驱动程序的更新日志。
Python 驱动程序的 Rust 扩展是一个替代驱动程序包,与常规驱动程序相比可提供 3 到 10 倍的速度提升。您可以使用 pip install neo4j-rust-ext 安装它,可以与 neo4j 包一起安装,也可以作为其替代。在用法上,这两个驱动程序是相同的:本指南中的所有内容都适用于这两个包。 |
要在气隙(air-gapped)机器上获取驱动程序,请下载最新的驱动程序 tarball,并使用 pip install neo4j-<version>.tar.gz 进行安装。 |
获取 Neo4j 实例
您需要一个正在运行的 Neo4j 数据库才能使用驱动程序。启动本地实例最简单的方法是通过Docker 容器(需要 docker.io
)。以下命令在 Docker 中运行最新版本的 Neo4j,将管理员用户名设置为 neo4j
,密码设置为 secretgraph
docker run \
-p7474:7474 \ # forward port 7474 (HTTP)
-p7687:7687 \ # forward port 7687 (Bolt)
-d \ # run in background
-e NEO4J_AUTH=neo4j/secretgraph \ # set login credentials
neo4j:latest
或者,您可以通过 Aura 获取免费的云实例。
您也可以在您的系统上安装 Neo4j,或者使用Neo4j Desktop 来创建本地开发环境(不适用于生产环境)。
术语表
- LTS
-
长期支持版本是保证支持多年的版本。Neo4j 4.4 是 LTS 版本,Neo4j 5 也将有一个 LTS 版本。
- Aura
-
Aura 是 Neo4j 的全托管云服务。它提供免费和付费计划。
- Cypher
-
Cypher 是 Neo4j 的图查询语言,允许您从数据库中检索数据。它类似于 SQL,但专用于图。
- APOC
-
Cypher 上的出色过程 (APOC) 是一个函数库(包含许多函数),这些函数本身无法在 Cypher 中轻松表达。
- Bolt
-
Bolt 是 Neo4j 实例和驱动程序之间交互所使用的协议。它默认监听端口 7687。
- ACID
-
原子性、一致性、隔离性、持久性 (ACID) 是保证数据库事务可靠处理的属性。符合 ACID 的 DBMS 可确保数据库中的数据在发生故障时仍保持准确和一致。
- 最终一致性
-
如果数据库提供保证,即所有集群成员在某个时间点都将存储数据的最新版本,则该数据库是最终一致的。
- 因果一致性
-
如果集群的每个成员都以相同的顺序看到读写查询,则数据库是因果一致的。这比最终一致性更强。
- NULL
-
null 标记不是一种类型,而是表示值缺失的占位符。有关更多信息,请参阅Cypher → 使用
null
。 - 事务
-
事务是工作的一个单元,它要么整体提交,要么在失败时回滚。一个例子是银行转账:它涉及多个步骤,但这些步骤必须全部成功或被撤销,以避免资金从一个账户中扣除但未添加到另一个账户中。
- 反压
-
反压是阻碍数据流动的力。它确保客户端不会被超出其处理能力的数据淹没。
- 事务函数
-
事务函数是由
execute_read
或execute_write
调用执行的回调。在服务器故障时,驱动程序会自动重新执行该回调。 - 驱动程序
-
Driver
对象包含建立与 Neo4j 数据库连接所需的详细信息。