本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 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
-
输入以下命令以安装
gremlin-javascript程序包:npm install gremlin -
创建名为
gremlinexample.js的文件并在文本编辑器中打开它。 -
将以下内容复制到
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(); }); -
输入以下命令以运行示例:
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。