Utilizzo di Python per connettersi a un'istanza database Neptune

Se puoi, usa sempre l'ultima versione del client Apache TinkerPop Python Gremlin, gremlinpython, supportata dalla versione del tuo motore. Le nuove versioni contengono numerose correzioni di bug che migliorano la stabilità, le prestazioni e la fruibilità del client. La gremlinpython versione da utilizzare in genere si allinea alle TinkerPop versioni descritte nella tabella per il client Java Gremlin.

Nota

Le versioni gremlinpython 3.5.x sono compatibili con le versioni TinkerPop 3.4.x purché si utilizzino solo le funzionalità 3.4.x nelle query Gremlin che si scrivono.

La sezione seguente illustra come eseguire un esempio Python che si connette a un'istanza database Amazon Neptune ed esegue un attraversamento Gremlin.

È necessario seguire queste istruzioni da un'EC2istanza Amazon nello stesso cloud privato virtuale (VPC) dell'istanza DB Neptune.

Prima di iniziare, esegui queste attività:

• Scarica e installa Python 3.6 o versione successiva dal sito Web Python.org.

• Verificare di aver installato pip. Se non si dispone di pip o non si è sicuri, consultare Do I need to install pip? (Devo installare pip?) nella documentazione pip.

• Se l'installazione Python non lo comprende già, scaricare futures come segue: pip install futures

Per connettersi a Neptune tramite Python

1. Installare il pacchetto gremlinpython immettendo quanto segue:

   pip install --user gremlinpython

2. Creare un file denominato gremlinexample.py, quindi aprirlo in un editor di testo.

3. Copiare quanto segue nel file gremlinexample.py. Replace (Sostituisci) your-neptune-endpoint con l'indirizzo della tua istanza DB di Neptune.

   Per informazioni su come trovare l'indirizzo dell'istanza database Neptune, consulta la sezione Connessione agli endpoint Amazon 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. Immettere il comando seguente per eseguire l'esempio:

   python gremlinexample.py

   La query Gremlin alla fine di questo esempio restituisce i vertici (g.V().limit(2)) in un elenco. Questo elenco viene quindi stampato con la funzione Python standard print.

   Nota

   La parte finale della query Gremlin, toList() è obbligatoria per inviare l'attraversamento al server per la valutazione. Se non includi quel metodo o un altro metodo equivalente, la query non viene inviata all'istanza database Neptune.

   I metodi riportati sotto inviano la query all'istanza database Neptune:

   • toList()

   • toSet()

   • next()

   • nextTraverser()

   • iterate()

   L'esempio precedente restituisce i primi due vertici del grafo utilizzando l'attraversamento g.V().limit(2).toList(). Per eseguire query per qualcos'altro, sostituirla con un altro attraversamento Gremlin con uno dei metodi finali appropriati.