Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di strumenti da riga di comando per accedere ad Amazon Neptune
<a name="get-started-cli-tools"></a>

Puoi utilizzare gli AWS CLI AWS SDK e gli strumenti HTTP come `curl` e `awscurl` per inviare query al tuo cluster Neptune DB. Le sezioni seguenti mostrano come configurare ogni strumento ed eseguire query Gremlin e OpenCypher di base.

## Utilizzo di AWS CLI
<a name="get-started-cli-tools-cli"></a>

I `aws neptunedata` comandi consentono di eseguire query Gremlin e OpenCypher, controllare lo stato del motore, gestire carichi di massa e altro ancora. Per il riferimento completo ai comandi, consultate la sezione Command Reference. [https://docs.aws.amazon.com/cli/latest/reference/neptunedata/](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/) AWS CLI 

Gli esempi seguenti mostrano come eseguire una query di base:

------
#### [ Gremlin ]

```
aws neptunedata execute-gremlin-query \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --region {{us-east-1}} \
  --gremlin-query "g.V().limit(1)"
```

Per ulteriori informazioni, vedere [execute-gremlin-query nel Command Reference](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html). 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"
```

[Per ulteriori informazioni, vedere execute-open-cypher-query nel Command Reference.](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html) AWS CLI 

------

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

Puoi utilizzare l'API Neptune Data tramite gli SDK per eseguire query a AWS livello di codice. I seguenti esempi in Python mostrano come eseguire una query di base:

------
#### [ 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))
```

Per esempi AWS SDK in altre lingue, vedi. [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))
```

Per esempi di AWS SDK in altre lingue, consulta. [AWS SDK](access-graph-opencypher-sdk.md)

------

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

Lo strumento da riga di comando [curl](https://curl.haxx.se/) invia le richieste HTTP direttamente agli endpoint Neptune. Se l'autenticazione IAM è abilitata, usa [awscurl](https://github.com/okigan/awscurl) o 7.75.0\+ con l'opzione per firmare le richieste. `curl` `--aws-sigv4` Per ulteriori informazioni, consulta [Utilizzo di `awscurl` con credenziali temporanee per connettersi in modo sicuro a un cluster DB con autenticazione IAM abilitata](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).

### `Configurazione di curl per HTTPS`
<a name="get-started-cli-tools-curl-setup"></a>

Per connettersi tramite HTTPS (come richiesto da Neptune nella maggior parte delle regioni)`curl`, è necessario accedere ai certificati appropriati. Per informazioni su come ottenere i certificati e formattarli in un archivio di autorità di certificazione (CA), consulta la sezione [Verifica del certificato SSL nella documentazione](https://curl.haxx.se/docs/sslcerts.html). `curl`

È possibile specificare la posizione di questo archivio di certificati CA utilizzando la variabile di `CURL_CA_BUNDLE` ambiente. In Windows, `curl` cerca automaticamente un file denominato `curl-ca-bundle.crt`. Cerca prima nella stessa cartella di `curl.exe`, quindi in altri punti del percorso. Per ulteriori informazioni, consulta [Verifica certificati SSL](https://curl.haxx.se/docs/sslcerts.html).

Se `curl` è in grado di individuare i certificati adeguati, gestisce le connessioni HTTPS in modo analogo alle connessioni HTTP, senza parametri aggiuntivi. Gli esempi di questa documentazione si basano su questo scenario.

Per ulteriori informazioni sullo strumento, consultate la [pagina man di curl](https://curl.haxx.se/docs/manpage.html) e il libro *[Everything curl](https://ec.haxx.se/)*.

### Esempi di query
<a name="get-started-cli-tools-curl-examples"></a>

Gli esempi seguenti mostrano come eseguire una query di base utilizzando `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**  
Plain `curl` funziona solo quando l'autenticazione IAM non è abilitata sul 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**  
Plain `curl` funziona solo quando l'autenticazione IAM non è abilitata sul cluster.

------

Per altri esempi di Gremlin HTTP, vedi. [HTTPS REST](access-graph-gremlin-rest.md) Per altri esempi di OpenCypher HTTP, vedi. [Endpoint HTTPS](access-graph-opencypher-queries.md)