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 [https://docs.aws.amazon.com/cli/latest/reference/neptunedata/](https://docs.aws.amazon.com/cli/latest/reference/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 [execute-gremlin-query](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html) 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.](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html) 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, consulte[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ 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](access-graph-opencypher-sdk.md).
------
## `Uso de curl y awscurl`
La herramienta de línea de comandos [curl](https://curl.haxx.se/) envía las solicitudes HTTP directamente a los puntos finales de Neptune. Si la autenticación de IAM está habilitada, usa [awscurl](https://github.com/okigan/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](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).
### `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](https://curl.haxx.se/docs/sslcerts.html) 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](https://curl.haxx.se/docs/sslcerts.html).
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](https://curl.haxx.se/docs/manpage.html) y el libro *[Everything curl](https://ec.haxx.se/)*.
### 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](access-graph-gremlin-rest.md) Para ver más ejemplos de HTTP de OpenCypher, consulte. [Punto de conexión HTTP](access-graph-opencypher-queries.md)