Utilisation de Python pour se connecter à une instance de base de données Neptune

Si possible, utilisez toujours la dernière version du client Apache TinkerPop Python Gkremlin, gremlinpython, prise en charge par la version de votre moteur. Les versions plus récentes contiennent de nombreux correctifs de bogues qui améliorent la stabilité, les performances et l'ergonomie du client. La gremlinpython version à utiliser s'aligne généralement sur les TinkerPop versions décrites dans le tableau du client Java Gkremlin.

Note

Les versions gremlinpython 3.5.x sont compatibles avec les versions TinkerPop 3.4.x tant que vous n'utilisez que les fonctionnalités 3.4.x dans les requêtes Gkremlin que vous écrivez.

La section suivante vous accompagne dans l'exécution d'un exemple Python qui se connecte à une instance de base de données Amazon Neptune et effectue une traversée Gremlin.

Vous devez suivre ces instructions à partir d'une instance Amazon EC2 dans le même cloud privé virtuel (VPC) (VPC) que l'instance de base de données Neptune.

Avant de commencer, vous devez exécuter les actions suivantes :

• Téléchargez et installez Python 3.6 ou version ultérieure depuis le site web Python.org.

• Vérifiez que vous avez installé pip. Si vous n'avez pas pip ou que vous n'en êtes pas certain, voir Do I need to install pip? (Dois-je installer pip? dans la documentation pip.

• Si votre installation Python n'est pas déjà définie, téléchargez futures comme suit : pip install futures

Pour se connecter à Neptune à l'aide de Python

1. Entrez ce qui suit pour installer le package gremlinpython :

   pip install --user gremlinpython

2. Créez un fichier nommé gremlinexample.py et ouvrez-le dans un éditeur de texte.

3. Copiez ce qui suit dans le fichier gremlinexample.py. Remplacez your-neptune-endpointpar l'adresse de votre instance de base de données Neptune.

   Consultez la section Connexion aux points de terminaison Amazon Neptune pour découvrir comment trouver l'adresse de votre instance de base de données Neptune.

   from __future__  import print_function  # Python 2/3 compatibility
   
   from gremlin_python import statics
   from gremlin_python.structure.graph import Graph
   from gremlin_python.process.graph_traversal import __
   from gremlin_python.process.strategies import *
   from gremlin_python.driver.driver_remote_connection import DriverRemoteConnection
   
   graph = Graph()
   
   remoteConn = DriverRemoteConnection('wss://your-neptune-endpoint:8182/gremlin','g')
   g = graph.traversal().withRemote(remoteConn)
   
   print(g.V().limit(2).toList())
   remoteConn.close()

4. Pour exécuter l'exemple, entrez la commande suivante :

   python gremlinexample.py

   La requête Gremlin à la fin de cet exemple renvoie les vertex (g.V().limit(2)) dans une liste. Cette liste est ensuite imprimée avec la fonction standard Python print.

   Note

   La partie finale de la requête Gremlin, toList(), est obligatoire pour soumettre la traversée au serveur à des fins d'évaluation. Si vous n'incluez pas cette méthode ou une autre méthode équivalente, la requête ne sera pas soumise à l'instance de base de données Neptune.

   Les méthodes suivantes soumettent la requête à l'instance de base de données Neptune :

   • toList()

   • toSet()

   • next()

   • nextTraverser()

   • iterate()

   L'exemple précédent renvoie les deux premier vertex du graphe en utilisant la traversée g.V().limit(2).toList(). Pour interroger quelque chose d'autre, remplacez la traversée par une autre traversée Gremlin avec l'une des méthodes de fin appropriées.