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

# Usando ferramentas de linha de comando para acessar o Amazon Neptune
<a name="get-started-cli-tools"></a>

Você pode usar as AWS CLI ferramentas de AWS SDKs e 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
<a name="get-started-cli-tools-cli"></a>

Os `aws neptunedata` comandos permitem executar consultas do Gremlin e do OpenCypher, verificar o status do mecanismo, gerenciar cargas em massa e muito mais. Para obter a referência completa do comando, consulte [https://docs.aws.amazon.com/cli/latest/reference/neptunedata/](https://docs.aws.amazon.com/cli/latest/reference/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 [execute-gremlin-query](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html) 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 [execute-open-cypher-query](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html) na Referência de Comandos. AWS CLI 

------

## Usar o AWS SDK
<a name="get-started-cli-tools-sdk"></a>

Você pode usar a API Neptune Data por meio AWS dos 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, 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 exemplos de AWS SDK em outras linguagens, consulte[AWS SDK](access-graph-opencypher-sdk.md).

------

## `Usando curl e awscurl`
<a name="get-started-cli-tools-curl"></a>

A ferramenta de linha de comando [curl](https://curl.haxx.se/) envia solicitações HTTP diretamente para os endpoints do Neptune. Se a autenticação do IAM estiver habilitada, use [awscurl](https://github.com/okigan/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](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).

### Configurando `curl` para HTTPS
<a name="get-started-cli-tools-curl-setup"></a>

Para se conectar usando HTTPS (como o Neptune exige na maioria das regiões)`curl`, é necessário 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 certificado SSL](https://curl.haxx.se/docs/sslcerts.html) na `curl` documentação.

Você pode especificar a localização desse armazenamento 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](https://curl.haxx.se/docs/sslcerts.html).

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 do manual curl](https://curl.haxx.se/docs/manpage.html) e o livro *[Everything curl](https://ec.haxx.se/)*.

### Exemplos de consulta
<a name="get-started-cli-tools-curl-examples"></a>

Os exemplos a seguir mostram como executar uma consulta básica usando `curl` e`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**  
O Plain `curl` funciona somente quando a autenticação do IAM não está habilitada no 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 no seu cluster.

------

Para obter mais exemplos de HTTP do Gremlin, consulte. [REST HTTPS](access-graph-gremlin-rest.md) Para obter mais exemplos de OpenCypher HTTP, consulte. [Endpoint de HTTP](access-graph-opencypher-queries.md)