简介在 5.19 中引入
查询 API 默认启用。然而,在自托管实例版本 < 5.25 中默认是禁用的。要在这些部署上启用它,请将 QUERY_API_ENDPOINTS 添加到配置设置 server.http_enabled_modules 中。 |
查询 API 允许通过 HTTP 请求对 Neo4j 服务器执行 Cypher 语句。该 API 取代了已废弃的 HTTP API。
该 API 的主要用例是为没有受支持库的语言开发客户端应用程序。如果您使用的语言已有官方库(驱动),请考虑改用它——参见 创建应用程序。
在自托管实例上,该 API 默认使用端口 7474 进行 HTTP,端口 7473 进行 HTTPS。可以通过配置设置 server.http.listen_address 和 server.https.listen_address 来更改端口。
Aura 实例仅通过端口 443 支持 HTTPS。
本指南假设您已拥有
-
一个正在运行的 Neo4j 实例 — 如果您没有,请 在本地安装 Neo4j或注册一个 Aura 云实例。
-
对 Cypher 有一定了解 — 如果您是新手,请查看 入门 → Cypher。
查询 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 确保即使发生故障,数据库中的数据也能保持准确和一致。
- 因果一致性
-
如果集群的每个成员都以相同的顺序看到读写查询,则该数据库具有因果一致性。这比最终一致性更强。
- 事务
-
事务是一个工作单元,要么被提交,要么在失败时被回滚。例如银行转账:它涉及多个步骤,但它们必须全部成功或全部撤销,以避免钱从一个账户扣除却未存入另一个账户的情况。