Configuration de la console Gremlin pour se connecter à une instance de base de données Neptune

Pour installer la console Gremlin et vous connecter à Neptune

1. Les fichiers binaires de la console Gremlin nécessitent Java 8 ou Java 11. Ces instructions supposent l'utilisation de Java 11. Vous pouvez installer Java 11 sur votre EC2 instance comme suit :

   • Si vous utilisez Amazon Linux 2 (AL2) :

     sudo amazon-linux-extras install java-openjdk11

   • Si vous utilisez Amazon Linux 2023 (AL2023) :

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

   • Pour les autres distributions, utilisez l'instruction qui convient le mieux parmi les suivantes :

     sudo yum install java-11-openjdk-devel

     ou :

     sudo apt-get install openjdk-11-jdk

2. Entrez ce qui suit pour définir Java 11 comme environnement d'exécution par défaut sur votre EC2 instance.

   sudo /usr/sbin/alternatives --config java

   Lorsque vous y êtes invité, saisissez le nombre correspondant à Java 11.

3. Téléchargez la version appropriée de la console Gremlin à partir du site web Apache. Vous pouvez consulter la page du client Java G705 correspondant à la version du moteur Neptune que vous utilisez actuellement afin de déterminer quelle version de G705 est prise en charge. Par exemple, pour la version 3.7.2, vous pouvez télécharger la console Gremlin depuis le site Web Apache Tinkerpop3 sur votre instance comme suit : EC2

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

4. Décompressez le fichier zip Gremlin Console.

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

5. Modifiez les répertoires du répertoire décompressé.

   cd apache-tinkerpop-gremlin-console-3.7.2

6. Dans le sous-répertoire conf du répertoire extrait, créez un fichier nommé neptune-remote.yaml avec le texte suivant. Remplacez your-neptune-endpoint avec le nom d'hôte ou l'adresse IP de votre instance de base de données Neptune. Les crochets ([ ]) sont obligatoires.

   Note

   Consultez la section Connexion aux points de terminaison Amazon Neptune pour découvrir comment trouver le nom d'hôte de votre instance de base de données Neptune.

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

   Note

   Les sérialiseurs ont été déplacés du gremlin-driver module vers le nouveau gremlin-util module dans la version 3.7.0. Le package est passé de org.apache.tinkerpop.gremlin.driver.ser à org.apache.tinkerpop.gremlin.util.ser.

7. Dans un terminal, accédez au répertoire Gremlin Console (apache-tinkerpop-gremlin-console-3.7.2), puis entrez la commande suivante pour exécuter la console Gremlin.

   bin/gremlin.sh

   Vous devriez voir la sortie suivante :

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

   Vous êtes maintenant à l'invite gremlin>. Vous entrez les étapes restantes à cette invite.

8. À l'invite de commande gremlin>, saisissez le texte suivant pour vous connecter à l'instance de base de données Neptune.

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

9. À l'invite gremlin>, entrez ce qui suit pour passer en mode distant. Toutes les requêtes Gremlin sont alors envoyées à la connexion distante.

   :remote console

10. Saisissez la commande suivante pour envoyer une requête au graphe Gremlin.

    g.V().limit(1)

11. Lorsque vous avez terminé, saisissez la commande suivante pour quitter la console Gremlin.

    :exit