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 Neptune. En las siguientes secciones se muestra cómo configurar cada herramienta y 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 neptunedata la 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 https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html 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, consulta 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, consulte. AWS 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, utilice https://github.com/okigan/awscurl 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 exige Neptune en la mayoría de las regiones), es curl necesario tener acceso a los certificados correspondientes. Para obtener información sobre cómo obtener certificados y formatearlos para convertirlos en un almacén de una autoridad de certificación (CA), consulte la verificación del certificado 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 del manual 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

En pocas curl palabras, solo 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

La autenticación simple solo curl funciona cuando la autenticación de IAM no está habilitada en su clúster.

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