使用 HTTPS REST 端点连接到 Neptune 数据库实例 - Amazon Neptune
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用 HTTPS REST 端点连接到 Neptune 数据库实例

Amazon Neptune 为 Gremlin 查询提供 HTTPS 端点。REST 接口与您的数据库集群使用的任何 Gremlin 版本兼容(请参阅您正在运行的 Neptune 引擎版本的引擎版本页面,以确定它支持哪个 Gremlin 版本)。

注意

传输中加密:使用 SSL/HTTPS 连接到 Neptune中所述,Neptune 现在要求您使用 HTTPS 而不是 HTTP 进行连接。

以下说明将带您演练使用 curl 命令和 HTTPS 连接到 Gremlin 终端节点。必须从与您的 Neptune 数据库实例位于同一虚拟私有云 (VPC) 中的 Amazon EC2 实例中按照这些说明操作。

针对 Neptune 数据库实例的 Gremlin 查询的 HTTPS 端点为 https://your-neptune-endpoint:port/gremlin

注意

有关查找 Neptune 数据库实例的主机名的信息,请参阅连接到 Amazon Neptune 端点

使用 HTTP REST 端点连接到 Neptune

以下示例使用 curl 来通过 HTTP POST 提交 Gremlin 查询。该查询采用 JSON 格式在 POST 请求正文中提交为 gremlin 属性。

curl -X POST -d '{"gremlin":"g.V().limit(1)"}' https://your-neptune-endpoint:port/gremlin

此示例通过使用 g.V().limit(1) 遍历返回图形中的第一个顶点。您可以通过将它替换为另一个 Gremlin 遍历来查询其它内容。

重要

默认情况下,REST 端点在单个 JSON 结果集中返回所有结果。如果此结果集太大,Neptune 数据库实例可能会出现 OutOfMemoryError 异常。

您可以通过启用分块响应(在一系列单独的响应中返回的结果)来避免这种情况。请参阅 使用可选的 HTTP 尾随标头启用由多部分组成的 Gremlin 响应

尽管建议在发送 Gremlin 查询时使用 HTTP POST 请求,但也可以使用 HTTP GET 请求:

curl -G "https://your-neptune-endpoint:port?gremlin=g.V().count()"
注意

Neptune 不支持 bindings 属性。