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 herramientas de línea de comandos para acceder a Amazon Neptune

Puede usar los AWS SDK y las AWS CLI herramientas HTTP, como curl y awscurl para enviar consultas a su clúster de base de datos de Neptune. En las siguientes secciones se muestra cómo configurar cada herramienta y cómo ejecutar consultas básicas de Gremlin y OpenCypher.

Uso de AWS CLI

Los aws neptunedata comandos permiten ejecutar consultas de Gremlin y OpenCypher, comprobar el estado del motor, gestionar cargas masivas y mucho más. Para ver la referencia completa de los comandos, consulte neptunedatala Referencia de comandos. AWS CLI

Los siguientes ejemplos muestran cómo ejecutar una 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 obtener más información, consulte execute-gremlin-query en la Referencia 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 obtener más información, consulte execute-open-cypher-query en la Referencia de comandos. AWS CLI

Uso de AWS SDK

Puede usar la API de datos de Neptune a través de los AWS SDK para ejecutar consultas mediante programación. Los siguientes ejemplos de Python muestran cómo ejecutar una 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 ver ejemplos de AWS SDK en otros lenguajes, 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 ver ejemplos de AWS SDK en otros idiomas, consulteAWS SDK.

Uso de curl y awscurl

La herramienta de línea de comandos curl envía las solicitudes HTTP directamente a los puntos finales de Neptune. Si la autenticación de IAM está habilitada, usa awscurl o 7.75.0+ con la opción de firmar las solicitudes. curl --aws-sigv4 Para obtener más información, consulte Uso de awscurl con credenciales temporales para conectarse de forma segura a un clúster de base de datos con la autenticación de IAM habilitada.

Configurar curl para HTTPS

Para conectarse mediante HTTPS (como lo requiere Neptune en la mayoría de las regiones), curl necesita acceder a los certificados correspondientes. Para obtener información sobre cómo obtener certificados y darles formato en un almacén de entidades de certificación (CA), consulte la sección Verificación de certificados SSL en la curl documentación.

Puede especificar la ubicación de este almacén de certificados de CA mediante la variable de CURL_CA_BUNDLE entorno. En Windows, curl lo busca de forma automática en un archivo llamado curl-ca-bundle.crt. Primero busca en el mismo directorio que curl.exe y después en el resto de sitios de la ruta. Para obtener más información, consulte Certificados SSL.

Siempre que curl pueda localizar los certificados adecuados, gestionará las conexiones HTTPS de la misma forma que las conexiones HTTP, sin parámetros adicionales. Los ejemplos de esta documentación se basan en ese escenario.

Para obtener más información sobre la herramienta, consulte la página de manual de curl y el libro Everything curl.

Consultas de ejemplo

Los siguientes ejemplos muestran cómo ejecutar una consulta básica con curl y: awscurl

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

Plain solo curl funciona cuando la autenticación de IAM no está habilitada en el clúster.

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

Plain solo curl funciona cuando la autenticación de IAM no está habilitada en el clúster.

Para ver más ejemplos de HTTP de Gremlin, consulte. HTTPS REST Para ver más ejemplos de HTTP de OpenCypher, consulte. Punto de conexión HTTP