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 une instance EC2 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 la commande suivante pour définir Java 8 en tant qu'environnement d'exécution par défaut sur votre instance EC2.

   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 depuis le site Web d'Apache. Vous pouvez vérifier si votre version de Accès au graphe Neptune avec Gremlin Neptune est prise en charge par votre version de G705. Par exemple, si vous avez besoin de la version 3.7.2, vous pouvez télécharger la console Gremlin depuis le site Web Apache Tinkerpop sur votre instance EC2 comme suit :

   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. your-neptune-endpointRemplacez-le par 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