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

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

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. 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. 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. AWS CLI

Utilizzo di AWS SDK

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

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

Usare curl e awscurl

Lo strumento da riga di comando curl invia le richieste HTTP direttamente agli endpoint Neptune. Se l'autenticazione IAM è abilitata, usa 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.

Configurazione di curl per HTTPS

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

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 e il libro Everything curl.

Esempi di query

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 Per altri esempi di OpenCypher HTTP, vedi. Endpoint HTTPS