Usar o Python para conectar-se a uma instância de banco de dados do Neptune

Se você puder, sempre use a versão mais recente do cliente Apache TinkerPop Python Gremlin, gremlinpython, compatível com a versão do seu mecanismo. As versões mais recentes contêm várias correções de erros que melhoram a estabilidade, o desempenho e a usabilidade do cliente. A gremlinpython versão a ser usada normalmente se alinhará às TinkerPop versões descritas na tabela do cliente Java Gremlin.

nota

As versões gremlinpython 3.5.x são compatíveis com as versões TinkerPop 3.4.x, desde que você use apenas os recursos 3.4.x nas consultas do Gremlin que você escreve.

A seção a seguir descreve a execução de um exemplo do Python que se conecta a uma instância de banco de dados do Amazon Neptune e executa um percurso do Gremlin.

Você deve seguir estas instruções em uma instância do Amazon EC2 na mesma nuvem privada virtual (VPC) que a instância de banco de dados do Neptune.

Antes de começar, faça o seguinte:

• Baixe e instale o Python 3.6 ou posterior do site Python.org.

• Verifique se você tem o pip instalado. Se não tiver o pip ou não tiver certeza, consulte Do I need to install pip? (Preciso instalar pip?) na pip documentação.

• Se sua instalação do Python não o tiver, faça download de futures da seguinte forma: pip install futures

Como conectar-se ao Neptune usando o Python

1. Insira o seguinte para instalar o pacote gremlinpython:

   pip install --user gremlinpython

2. Crie um arquivo denominado gremlinexample.py e abra-o em um editor de texto.

3. Copie o seguinte no arquivo gremlinexample.py. Substitua your-neptune-endpoint pelo endereço da instância de banco de dados do Neptune.

   Para obter informações sobre como localizar o endereço da instância de banco de dados do Neptune, consulte a seção Conectar-se a endpoints do 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. Insira o seguinte comando para executar o exemplo:

   python gremlinexample.py

   A consulta do Gremlin no final deste exemplo retorna os vértices (g.V().limit(2)) em uma lista. Em seguida, essa lista é impressa com a função print padrão do Python.

   nota

   A parte final da consulta do Gremlin, toList(), é necessária para enviar a travessia ao servidor para avaliação. Se você não incluir esse método ou outro método equivalente, a consulta não será enviada à instância de banco de dados do Neptune.

   Os seguintes métodos enviam a consulta à instância de banco de dados do Neptune:

   • toList()

   • toSet()

   • next()

   • nextTraverser()

   • iterate()

   O exemplo anterior retorna os primeiros dois vértices do gráfico usando a travessia g.V().limit(2).toList(). Para consultar outro elemento, substitua-a por outra travessia do Gremlin com um dos métodos de término adequado.