View a markdown version of this page

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

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

设置 Gremlin 控制台以连接到 Neptune 数据库实例

Gremlin 控制台允许你试验 TinkerPop REPL(读取评估-打印循环)环境中的图表和查询。

安装 Gremlin 控制台并以常规方式连接到控制台

您可以使用 Gremlin 控制台连接到远程图形数据库。以下部分将引导您安装和配置 Gremlin 控制台以远程连接到 Neptune 数据库实例。必须从与您的 Neptune 数据库实例位于同一虚拟私有云 (VPC) 中的 Amazon EC2 实例中按照这些说明操作。

如需帮助,请使用以下方式连接海王星 SSL/TLS (这是必填项),请参阅 SSL/TLS 配置。

注意

如果您在 Neptune 数据库集群上启用了 IAM 身份验证,请按照通过 Gremlin 控制台使用 IAM 身份验证连接到 Amazon Neptune 数据库中的说明安装 Gremlin 控制台,而不是按照此处的说明进行操作。

安装 Gremlin 控制台并连接到 Neptune
  1. Gremlin 控制台二进制文件适用于 TinkerPop 3.8.x 需要 Java 11 或更高版本。这些指令假定 Java 11。要在您的 EC2 实例上安装 Java 11,请执行以下操作:

    • 如果您使用的是 Amazon Linux 2 (AL2):

      sudo amazon-linux-extras install java-openjdk11
    • 如果您使用的是 Amazon Linux 2023 (AL2023):

      sudo yum install java-11-amazon-corretto-devel
    • 对于其它发行版,请使用以下适当的发行版:

      sudo yum install java-11-openjdk-devel

      或者:

      sudo apt-get install openjdk-11-jdk
  2. 输入以下命令以在 EC2 实例上将 Java 11 设置为默认运行时系统。

    sudo /usr/sbin/alternatives --config java

    在系统提示时,输入 Java 11 的版本号。

  3. 从 Apache 网站下载相应版本的 Gremlin 控制台。你可以检查 使用 Gremlin 访问 Neptune 图形 来确定你的 Neptune 版本支持哪个 Gremlin 版本。例如,如果你需要版本 3.8.0,你可以下载 Gremlin 控制台 来自 阿帕奇小叮当 像这样将网站放到你的 EC2 实例上:

    wget https://archive.apache.org/dist/tinkerpop/3.8.0/apache-tinkerpop-gremlin-console-3.8.0-bin.zip
  4. 解压缩 Gremlin 控制台 zip 文件。

    unzip apache-tinkerpop-gremlin-console-3.8.0-bin.zip
  5. 将目录更改为解压缩的目录。

    cd apache-tinkerpop-gremlin-console-3.8.0
  6. 在提取的目录的 conf 子目录中,创建名为 neptune-remote.yaml 的包含以下文本的文件。替换 your-neptune-endpoint 使用您的 Neptune 数据库实例的主机名或 IP 地址。方括号 ([ ]) 是必需的。

    注意

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

    hosts: [your-neptune-endpoint] port: 8182 connectionPool: { enableSsl: true } serializer: { className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1, config: { serializeResultToString: true }}
    注意

    在版本 3.7.0 中,序列化器已从 gremlin-driver 模块移至新的 gremlin-util 模块。软件包已从 org.apache.tinkerpop.gremlin.driver.ser 更改为 org.apache.tinkerpop.gremlin.util.ser。

  7. 在终端中,导航到 Gremlin 控制台目录 (apache-tinkerpop-gremlin-console-3.8.0),然后输入以下命令来运行 Gremlin 控制台。

    bin/gremlin.sh

    您应看到以下输出:

    \,,,/ (o o) -----oOOo-(3)-oOOo----- plugin activated: tinkerpop.server plugin activated: tinkerpop.utilities plugin activated: tinkerpop.tinkergraph gremlin>

    您现在位于 gremlin> 提示符处。将在此提示符处输入剩余步骤。

  8. 在 gremlin> 提示符处,输入以下命令以连接到 Neptune 数据库实例。

    :remote connect tinkerpop.server conf/neptune-remote.yaml
  9. 在 gremlin> 提示符处,输入以下命令以切换到远程模式。这会将所有 Gremlin 查询发送到远程连接。

    :remote console
  10. 输入以下命令以将查询发送到 Gremlin 图形。

    g.V().limit(1)
  11. 完成后,输入以下命令以退出 Gremlin 控制台。

    :exit
注意

使用分号 (;) 或换行符 (\n) 分隔每个语句。

在最后遍历之前的每个遍历必须以要执行的 next() 结尾。仅返回最后遍历中的数据。

有关 Gremlin 的 Neptune 实现的更多信息,请参阅Amazon Neptune 中的 Gremlin 标准合规性。

IAM 身份验证

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