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

Conectar-se a um cluster do Amazon Neptune

Depois de criar um cluster Neptune, você deve configurar o acesso à rede para que seus aplicativos possam alcançar o endpoint do cluster. As seções a seguir descrevem as opções de conectividade de rede. Para obter mais informações sobre como consultar seus dados após a conexão, consulteAcessar dados de grafo.

Opções de conectividade de rede

Um cluster de banco de dados do Amazon Neptune só pode ser criado em uma Amazon Virtual Private Cloud (Amazon VPC). Seus endpoints são acessíveis somente dentro dessa VPC, a menos que você habilite e configure endpoints públicos do Neptune para o cluster de banco de dados.

Você pode configurar o acesso à rede ao seu cluster de banco de dados Neptune em sua VPC de várias maneiras:

Verifique sua conexão

Depois de configurar o acesso à rede, você pode verificar se sua conexão funciona chamando o endpoint de status da instância. Uma resposta bem-sucedida confirma que seu cliente pode acessar o cluster Neptune.

AWS CLI

Execute este comando: .

aws neptunedata get-engine-status \
  --endpoint-url https://your-neptune-endpoint:port \
  --region us-east-1

Para obter mais informações, consulte get-engine-status na Referência de comandos. AWS CLI

SDK

import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=10, retries={'total_max_attempts': 1})
)

response = client.get_engine_status()

print(response)

awscurl

awscurl https://your-neptune-endpoint:port/status \
  --region us-east-1 \
  --service neptune-db

nota

Este exemplo pressupõe que suas AWS credenciais estejam configuradas em seu ambiente. us-east-1Substitua pela região do seu cluster Neptune.

Para obter mais informações sobre como usar awscurl com a autenticação do IAM, consulteUsando awscurl com credenciais temporárias para se conectar com segurança a um cluster de banco de dados com a autenticação IAM ativada.

curl

Execute este comando: .

curl -G https://your-neptune-endpoint:port/status

nota

Esse comando funciona somente quando a autenticação do IAM não está habilitada no seu cluster. Se a autenticação do IAM estiver ativada, use awscurl ou AWS CLI em vez disso.

Um cluster íntegro retorna uma resposta JSON que inclui"status": "healthy". Por exemplo:

{
    "status": "healthy",
    "startTime": "Thu Aug 24 21:07:13 UTC 2023",
    "dbEngineVersion": "1.3.1.0.R1",
    "role": "writer",
    "dfeQueryEngine": "viaQueryHint",
    "gremlin": { "version": "tinkerpop-3.7.2" },
    "sparql": { "version": "sparql-1.1" },
    "opencypher": { "version": "Neptune-9.0.20190305-1.0" },
    "labMode": { ... },
    "features": { ... },
    "settings": { ... }
}

Se você não conseguir acessar o endpoint, verifique se sua configuração de rede permite tráfego na porta 8182 (ou na porta configurada) e se as regras do grupo de segurança permitem conexões de entrada do seu cliente. Para obter mais informações, consulte Proteger o acesso ao Neptune. Para obter ajuda na configuração do AWS CLI, SDKs oucurl, consulteUsando ferramentas de linha de comando.