安装

要开始创建 Neo4j Python 应用程序,首先需要安装 Python 驱动程序并获取要连接到的 Neo4j 数据库实例。

安装驱动程序

使用 pip 安装 Neo4j Python 驱动程序(需要 Python >= 3.7)

pip install neo4j

始终使用最新版本的驱动程序,因为它始终与之前的 Neo4j LTS 版本以及当前和下一个主要版本兼容。最新的 5.x 驱动程序支持连接到任何 Neo4j 5 和 4.4 实例,并且也与 Neo4j 6 兼容。有关跨版本的详细更改列表,请参阅 驱动程序的更改日志

Python 驱动程序的 Rust 扩展 是一种替代驱动程序包,与常规驱动程序相比,它可以提高 3 倍到 10 倍的速度。您可以使用 pip install neo4j-rust-ext 安装它,无论是在 neo4j 包旁边还是作为它的替换。在使用方面,这些驱动程序是相同的:本指南中的所有内容都适用于这两个包。
要在隔离的机器上获取驱动程序,请 下载最新的驱动程序 压缩包并使用 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 桌面 创建本地开发环境(不适用于生产环境)。

词汇表

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

空标记不是类型,而是值缺失的占位符。有关更多信息,请参阅 Cypher → 使用 null

事务

事务是工作单元,要么完全提交,要么在失败时回滚。例如银行转账:它涉及多个步骤,但这些步骤必须全部成功或被还原,以避免从一个帐户中扣除资金而没有添加到另一个帐户中。

背压

背压是反对数据流动的力量。它确保客户端不会被它无法处理的数据所淹没。

事务函数

事务函数是在 execute_readexecute_write 调用时执行的回调函数。驱动程序会在服务器发生故障时自动重新执行回调函数。

驱动程序

Driver 对象包含建立与 Neo4j 数据库连接所需的详细信息。