Uso de Python para conectarse a una instancia de base de datos de Neptune - Amazon Neptune

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de Python para conectarse a una instancia de base de datos de Neptune

Si puede, utilice siempre la última versión del cliente Apache TinkerPop Python Gremlin, gremlinpython, compatible con la versión de su motor. Las versiones más recientes contienen numerosas correcciones de errores que mejoran la estabilidad, el rendimiento y la facilidad de uso del cliente. La gremlinpython versión que se utilizará normalmente se alineará con TinkerPop las versiones descritas en la tabla del cliente Java Gremlin.

nota

Las versiones gremlinpython 3.5.x son compatibles con las versiones TinkerPop 3.4.x siempre que solo utilices las funciones 3.4.x en las consultas de Gremlin que escribas.

En la siguiente sección se indica cómo ejecutar una muestra de Python que se conecta a una instancia de base de datos de Amazon Neptune y realiza un recorrido de Gremlin.

Debe seguir estas instrucciones desde una EC2 instancia de Amazon en la misma nube privada virtual (VPC) que su instancia de base de datos de Neptune.

Antes de comenzar, haga lo siguiente:

  • Descargue e instale Python 3.6 o una versión posterior desde el sitio web de Python.org.

  • Compruebe que tiene pip instalado. Si no tiene pip o no está seguro, consulte Do I need to install pip? en la documentación de pip.

  • Si su instalación de Python aún no lo tiene, descargue futures tal y como se indica a continuación: pip install futures

Para conectarse a Neptune mediante Python

  1. Escriba lo siguiente para instalar el paquete gremlinpython:

    pip install --user gremlinpython

  2. Cree un archivo con el nombre gremlinexample.py y, a continuación, ábralo en un editor de texto.

  3. Copie lo siguiente en el archivo gremlinexample.py. Reemplazar your-neptune-endpoint con la dirección de su instancia de base de datos Neptune.

    Para obtener información acerca de cómo encontrar la dirección de la instancia de base de datos de Neptune, consulte la sección Conexión a los puntos de conexión de 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. Escriba el comando siguiente para ejecutar el ejemplo:

    python gremlinexample.py

    La consulta de Gremlin al final de este ejemplo devuelve los vértices (g.V().limit(2)) en una lista. A continuación, la lista se imprime con la función print de Python estándar.

    nota

    La parte final de la consulta de Gremlin, toList(), es necesaria para enviar el recorrido al servidor para su evaluación. Si no incluye ese método u otro equivalente, la consulta no se envía a la instancia de base de datos de Neptune.

    Los siguientes métodos envían la consulta a la instancia de base de datos de Neptune:

    • toList()

    • toSet()

    • next()

    • nextTraverser()

    • iterate()

    El ejemplo anterior devuelve los dos primeros vértices del gráfico utilizando el recorrido g.V().limit(2).toList(). Para otras consultas, sustitúyalo por otro recorrido de Gremlin con uno de los métodos de finalización adecuados.