View a markdown version of this page

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

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

使用 Node.js 连接到 Neptune 数据库实例

重要

选择正确的 Apache TinkerPop Gremlin 驱动程序版本对于与海王星引擎版本的兼容性至关重要。使用不兼容的版本可能会导致连接失败或意外行为。有关版本兼容性的详细信息,请参见 使用 Gremlin 访问 Neptune 图形。

以下部分将引导您完成运行过程 Node.js 连接亚马逊海王星数据库实例并执行 Gremlin 遍历的示例。

必须从与您的 Neptune 数据库实例位于同一虚拟私有云 (VPC) 中的 Amazon EC2 实例中按照这些说明操作。

开始之前,请执行以下操作:

  • 验证一下 Node.js 已安装版本 8.11 或更高版本。如果不是,请下载并安装 Node.js 来自 Nodejs.org 网站。

使用以下方法连接海王星 Node.js
  1. 输入以下命令以安装 gremlin-javascript 程序包:

    npm install gremlin
  2. 创建名为 gremlinexample.js 的文件并在文本编辑器中打开它。

  3. 将以下内容复制到 gremlinexample.js 文件中。替换 your-neptune-endpoint 使用您的 Neptune 数据库实例的地址。

    有关查找 Neptune 数据库实例的地址的信息,请参阅连接到 Amazon Neptune 端点部分。

    const gremlin = require('gremlin'); const DriverRemoteConnection = gremlin.driver.DriverRemoteConnection; const Graph = gremlin.structure.Graph; dc = new DriverRemoteConnection('wss://your-neptune-endpoint:8182/gremlin',{}); const graph = new Graph(); const g = graph.traversal().withRemote(dc); g.V().limit(1).count().next(). then(data => { console.log(data); dc.close(); }).catch(error => { console.log('ERROR', error); dc.close(); });
  4. 输入以下命令以运行示例:

    node gremlinexample.js

上述示例通过使用 g.V().limit(1).count().next() 遍历返回图形中的单个顶点的计数。要查询其他内容,请将其替换为具有其中一种适当的结尾方法的其他 Gremlin 遍历。

注意

要将遍历提交到服务器进行评估,需要 Gremlin 查询的最后一部分 next()。如果您未包含该方法或其它等效方法,该查询将不会提交到 Neptune 数据库实例。

以下是向 Neptune 数据库实例提交查询的方法示例:

  • toList()

  • toSet()

  • next()

  • iterate()

这些终端步骤在脚本模式和字节码模式下的行为不同。有关终端步骤的规范清单以及它们如何影响交易的详细信息,请参阅 在要部署 Gremlin 代码的上下文中对其进行测试。

使用 iterate() 当你不需要查询结果(例如突变)时,因为它可以节省序列化成本。

重要

这是一款独立的 Node.js 示例。如果你打算在中运行这样的代码 Amazon Lambda 函数,参见 Lambda 函数示例 了解有关使用的详细信息 JavaScript 在 Neptune Lambda 函数中高效。

IAM 身份验证

海王星支持 IAM 身份验证 控制对数据库集群的访问权限。如果您启用了 IAM 身份验证,则需要使用签名版本 4 签名对您的请求进行身份验证。有关从 a 进行连接的详细说明和代码示例 JavaScript 客户,请参阅 使用 IAM 身份验证和 Gremlin 连接到 Amazon Neptune 数据库 JavaScript。