简介

事务性 HTTP API 已被弃用,已由 Query API 取代。有关更多信息,请参阅 Neo4j Query API 文档。

Neo4j HTTP API 允许通过 HTTP 请求在 Neo4j 服务器上执行一系列 Cypher 语句。

HTTP API 的主要用例是为那些没有受支持库的语言开发客户端应用程序。如果您使用的语言已有官方库(驱动),请考虑使用该库——参见 创建应用程序

默认情况下,API 使用端口 7474 进行 HTTP,端口 7473 进行 HTTPS。

本指南假设您已拥有

要通过 HTTP API 执行查询,您可以使用以下任一种方式

  • 隐式事务 — 您只需提交查询,API 会为您处理事务。

  • 显式事务 — 您可以控制事务的生命周期(打开、提交、回滚),并在其中执行查询。

自 Neo4j 5.17 起,HTTP API 支持 HTTP/2 与 HTTP/1.1,除非在服务器配置 server.http_enabled_transports 中显式禁用其中之一。由客户端决定使用首选协议发起连接。

术语表

Aura

Aura 是 Neo4j 的全托管云服务。它提供免费和付费计划。

Cypher

Cypher 是 Neo4j 的图查询语言,允许您从数据库中检索数据。它类似于 SQL,但专门用于图数据。

ACID

原子性 (Atomicity)、一致性 (Consistency)、隔离性 (Isolation)、持久性 (Durability) (ACID) 是保证数据库事务可靠处理的属性。符合 ACID 的 DBMS 确保即使发生故障,数据库中的数据也能保持准确和一致。

因果一致性

如果集群的每个成员都以相同的顺序看到读写查询,则该数据库具有因果一致性。这比最终一致性更强。

事务

事务是一个工作单元,要么被提交,要么在失败时被回滚。例如银行转账:它涉及多个步骤,但它们必须全部成功或全部撤销,以避免钱从一个账户扣除却未存入另一个账户的情况。