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 a 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 di base su Gremlin e OpenCypher.

Utilizzo di AWS CLI

I aws neptunedata comandi consentono di eseguire query su Gremlin e OpenCypher, controllare lo stato del motore, gestire carichi di massa e altro ancora. Per il riferimento completo ai comandi, consulta 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 AWS SDK per eseguire query a 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 di 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 l'autenticazione IAM abilitata.

Configurare 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 dell'autorità di certificazione (CA), consulta la verifica dei certificati SSL nella documentazione. curl

È possibile specificare la posizione di questo archivio 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 usando curl and: 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, consulta. HTTPS REST Per altri esempi HTTP di OpenCypher, consulta. Endpoint HTTPS