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á.

Uso de ferramentas de linha de comando para acessar o Amazon Neptune

Você pode usar os AWS CLI AWS SDKs e as ferramentas HTTP, como curl e awscurl para enviar consultas ao seu cluster de banco de dados Neptune. As seções a seguir mostram como configurar cada ferramenta e executar consultas básicas do Gremlin e do OpenCypher.

Usar o AWS CLI

Os aws neptunedata comandos permitem executar consultas Gremlin e OpenCypher, verificar o status do mecanismo, gerenciar cargas em massa e muito mais. Para obter a referência completa do comando, consulte neptunedata na Referência de AWS CLI comandos.

Os exemplos a seguir mostram como executar uma consulta básica:

Gremlin

aws neptunedata execute-gremlin-query \
  --endpoint-url https://your-neptune-endpoint:port \
  --region us-east-1 \
  --gremlin-query "g.V().limit(1)"

Para obter mais informações, consulte https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html execute-gremlin-query na Referência de comandos. AWS CLI

openCypher

aws neptunedata execute-open-cypher-query \
  --endpoint-url https://your-neptune-endpoint:port \
  --region us-east-1 \
  --open-cypher-query "MATCH (n) RETURN n LIMIT 1"

Para obter mais informações, consulte https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html execute-open-cypher-query na Referência de comandos. AWS CLI

Usar o AWS SDK

Você pode usar a API Neptune Data por meio dos AWS SDKs para executar consultas de forma programática. Os exemplos de Python a seguir mostram como executar uma consulta básica:

Gremlin

import boto3
import json
from botocore.config import Config

# Disable the client-side read timeout and retries so that
# Neptune's server-side neptune_query_timeout controls query duration.
client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.execute_gremlin_query(
    gremlinQuery='g.V().limit(1)',
    serializer='application/vnd.gremlin-v3.0+json;types=false'
)

print(json.dumps(response['result'], indent=2))

Para exemplos de AWS SDK em outras linguagens, consulteAWS SDK.

openCypher

import boto3
import json
from botocore.config import Config

# Disable the client-side read timeout and retries so that
# Neptune's server-side neptune_query_timeout controls query duration.
client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.execute_open_cypher_query(
    openCypherQuery='MATCH (n) RETURN n LIMIT 1'
)

print(json.dumps(response['results'], indent=2))

Para exemplos de AWS SDK em outras linguagens, consulteAWS SDK.

Usando curl e awscurl

A ferramenta de linha de comando curl envia solicitações HTTP diretamente para os endpoints do Neptune. Se a autenticação do IAM estiver ativada, use awscurl ou curl 7.75.0+ com a opção de assinar solicitações. --aws-sigv4 Para obter mais informações, consulte Usando awscurl com credenciais temporárias para se conectar com segurança a um cluster de banco de dados com a autenticação IAM ativada.

Configurando curl para HTTPS

Para se conectar usando HTTPS (como o Neptune exige na maioria das regiões), curl precisa acessar os certificados apropriados. Para obter informações sobre como obter certificados e formatá-los em um repositório de autoridade de certificação (CA), consulte Verificação de certificados SSL na curl documentação.

Você pode especificar a localização desse repositório de certificados CA usando a variável de CURL_CA_BUNDLE ambiente. No Windows, o curl os procura automaticamente em um arquivo chamado curl-ca-bundle.crt. Ele procura primeiro no mesmo diretório curl.exe e, em seguida, em outros lugares no caminho. Para obter mais informações, consulte SSL Certificate Verification.

Desde que o curl possa localizar os certificados adequados, ele trata as conexões HTTPS da mesma forma como as conexões HTTP, sem parâmetros extras. Os exemplos desta documentação se baseiam nesse cenário.

Para obter mais informações sobre a ferramenta, consulte a página de manual do curl e o livro Everything curl.

Exemplos de consulta

Os exemplos a seguir mostram como executar uma consulta básica usando curl eawscurl:

Gremlin (awscurl)

awscurl https://your-neptune-endpoint:port/gremlin \
  --region us-east-1 \
  --service neptune-db \
  -X POST \
  -d '{"gremlin":"g.V().limit(1)"}'

Gremlin (curl)

curl -X POST \
  -d '{"gremlin":"g.V().limit(1)"}' \
  https://your-neptune-endpoint:port/gremlin

nota

O Plain curl funciona somente quando a autenticação do IAM não está habilitada em seu cluster.

openCypher (awscurl)

awscurl https://your-neptune-endpoint:port/openCypher \
  --region us-east-1 \
  --service neptune-db \
  -X POST \
  -d "query=MATCH (n) RETURN n LIMIT 1"

openCypher (curl)

curl -X POST \
  -d "query=MATCH (n) RETURN n LIMIT 1" \
  https://your-neptune-endpoint:port/openCypher

nota

O Plain curl funciona somente quando a autenticação do IAM não está habilitada em seu cluster.

Para obter mais exemplos de Gremlin HTTP, consulte. REST HTTPS Para obter mais exemplos de OpenCypher HTTP, consulte. Endpoint de HTTP