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

安装 Gremlin 控制台并连接到 Neptune

1. Gremlin 控制台二进制文件需要 Java 8 或 Java 11。这些说明假设使用的是 Java 11。您可以在您的EC2实例上安装 Java 11，如下所示：

   • 如果你使用的是亚马逊 Linux 2 (AL2)：

     sudo amazon-linux-extras install java-openjdk11

   • 如果你使用的是亚马逊 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. 输入以下内容，将 Java 11 设置为EC2实例的默认运行时。

   sudo /usr/sbin/alternatives --config java

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

3. 从 Apache 网站下载相应版本的 Gremlin 控制台。你可以在 java gremlin 客户端页面上查看你当前正在运行的 Neptune 引擎版本，以确定它支持哪个 Gremlin 版本。例如，对于版本 3.7.2，你可以将 Gremlin 控制台从 Apache Tinkerpop3 网站下载到你的实例上，如下所示：EC2

   wget https://archive.apache.org/dist/tinkerpop/3.7.2/apache-tinkerpop-gremlin-console-3.7.2-bin.zip

4. 解压缩 Gremlin 控制台 zip 文件。

   unzip apache-tinkerpop-gremlin-console-3.7.2-bin.zip

5. 将目录更改为解压缩的目录。

   cd apache-tinkerpop-gremlin-console-3.7.2

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.7.2)，然后输入以下命令来运行 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