Configure la consola de Gremlin para conectarse a una instancia de base de datos de Neptune

Para instalar la consola de Gremlin y conectarse a Neptune

1. Los archivos binarios de la consola de Gremlin requieren Java 8 o Java 11. En estas instrucciones se presupone el uso de Java 11. Puede instalar Java 11 en su EC2 instancia de la siguiente manera:

   • Si utilizas Amazon Linux 2 (AL2):

     sudo amazon-linux-extras install java-openjdk11

   • Si utilizas Amazon Linux 2023 (AL2023):

     sudo yum install java-11-amazon-corretto-devel

   • Para otras distribuciones, utilice la que sea adecuada de las siguientes opciones:

     sudo yum install java-11-openjdk-devel

     o bien:

     sudo apt-get install openjdk-11-jdk

2. Introduce lo siguiente para configurar Java 11 como el tiempo de ejecución predeterminado de tu EC2 instancia.

   sudo /usr/sbin/alternatives --config java

   Cuando se le solicite, escriba el número para Java 11.

3. Descargue la versión adecuada de la consola de Gremlin del sitio web de Apache. Consulte la página de versiones del motor de la versión del motor de Neptune que está utilizando para determinar qué versión de Gremlin es compatible. Por ejemplo, para la versión 3.6.5, puedes descargar la consola Gremlin del sitio web Apache Tinkerpop3 a tu instancia de la siguiente manera: EC2

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

4. Descomprima el archivo .zip de la consola de Gremlin.

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

5. Cambie al directorio del directorio descomprimido.

   cd apache-tinkerpop-gremlin-console-3.6.5

6. En el subdirectorio conf del directorio extraído, cree un archivo llamado neptune-remote.yaml con el texto siguiente. Reemplazar your-neptune-endpoint con el nombre de host o la dirección IP de su instancia de base de datos de Neptune. Los corchetes ([ ]) son obligatorios.

   nota

   Para obtener información acerca de cómo encontrar el nombre de host de la instancia de base de datos de Neptune, consulte la sección Conexión a los puntos de conexión de Amazon Neptune.

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

   nota

   Los serializadores se movieron del gremlin-driver módulo al nuevo gremlin-util módulo en la versión 3.7.0. El paquete cambió de org.apache.tinkerpop.gremlin.driver.ser a org.apache.tinkerpop.gremlin.util.ser.

7. En un terminal, vaya al directorio de la consola de Gremlin (apache-tinkerpop-gremlin-console-3.6.5) y, a continuación, escriba el siguiente comando para ejecutarla.

   bin/gremlin.sh

   Debería ver los siguientes datos de salida:

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

   Ahora se encuentra en gremlin>. Escriba los pasos restantes en este punto.

8. En el símbolo del sistema gremlin>, escriba lo siguiente para conectarse a la instancia de base de datos de Neptune.

   :remote connect tinkerpop.server conf/neptune-remote.yaml

9. En la entrada gremlin>, escriba lo siguiente para cambiar al modo remoto. Esto envía todas las consultas de Gremlin a la conexión remota.

   :remote console

10. Escriba lo siguiente para enviar una consulta al gráfico de Gremlin.

    g.V().limit(1)

11. Cuando haya terminado, escriba lo siguiente para salir de la consola de Gremlin.

    :exit