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 instancia de EC2 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. Escriba lo siguiente para establecer Java 11 como tiempo de ejecución predeterminado en la instancia EC2.

   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 Gremlin desde el sitio web de Apache. Puedes comprobar Acceso al gráfico de Neptune con Gremlin qué versión de Gremlin es compatible con tu versión de Neptune. Por ejemplo, si necesita la versión 3.7.2, puede descargar la consola Gremlin del sitio web de Apache Tinkerpop a su instancia de EC2 de la siguiente manera:

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

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

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

5. Cambie al directorio del directorio descomprimido.

   cd apache-tinkerpop-gremlin-console-3.7.2

6. En el subdirectorio conf del directorio extraído, cree un archivo llamado neptune-remote.yaml con el texto siguiente. your-neptune-endpointSustitúyalo por el nombre de host o la dirección IP de la 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 trasladaron del módulo gremlin-driver al nuevo módulo gremlin-util de 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.7.2) 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