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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 essas instruções de uma EC2 instância da Amazon na mesma nuvem privada virtual (VPC) da sua instância de banco de dados 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. Substituir your-neptune-endpoint com o endereço da sua instância de banco de dados 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.