Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation d'outils de ligne de commande pour accéder à Amazon Neptune

Vous pouvez utiliser les AWS CLI AWS kits SDK et les outils HTTP tels que curl et awscurl pour soumettre des requêtes à votre cluster de bases de données Neptune. Les sections suivantes montrent comment configurer chaque outil et exécuter des requêtes Gremlin et OpenCypher de base.

Utilisation de AWS CLI

Les aws neptunedata commandes vous permettent d'exécuter des requêtes Gremlin et OpenCypher, de vérifier l'état du moteur, de gérer des chargements groupés, etc. Pour la référence complète des commandes, voir neptunedata la référence des AWS CLI commandes.

Les exemples suivants montrent comment exécuter une requête de base :

Gremlin

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

Pour plus d'informations, consultez https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html execute-gremlin-query dans la référence des commandes. 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"

Pour plus d'informations, consultez https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html execute-open-cypher-query dans la référence des commandes. AWS CLI

Utilisation de AWS Kit SDK

Vous pouvez utiliser l'API Neptune Data via les AWS SDK pour exécuter des requêtes par programmation. Les exemples Python suivants montrent comment exécuter une requête de 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))

Pour des exemples de AWS SDK dans d'autres langues, consultezAWS 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))

Pour des exemples de AWS SDK dans d'autres langues, consultezAWS SDK.

Utilisation de curl et awscurl

L'outil de ligne de commande curl envoie des requêtes HTTP directement aux points de terminaison Neptune. Si l'authentification IAM est activée, utilisez awscurl ou curl 7.75.0+ avec la possibilité de signer les demandes. --aws-sigv4 Pour de plus amples informations, veuillez consulter Utilisation de awscurl avec des informations d'identification temporaires pour se connecter en toute sécurité à un cluster de bases de données avec l'authentification IAM activée.

Configuration de curl pour HTTPS

Pour se connecter via HTTPS (comme Neptune l'exige dans la plupart des régions), vous curl devez accéder aux certificats appropriés. Pour plus d'informations sur la façon d'obtenir des certificats et de les formater dans un magasin d'autorité de certification (CA), consultez la section Vérification des certificats SSL dans la curl documentation.

Vous pouvez spécifier l'emplacement de ce magasin de certificats CA à l'aide de la variable d'CURL_CA_BUNDLEenvironnement. Sous Windows, curl le recherche automatiquement dans un fichier nommé curl-ca-bundle.crt. Il examine d'abord dans le même répertoire que curl.exe, puis ailleurs sur le chemin. Pour plus d’informations, consultez SSL Certificate Verification (Vérification des certificats SSL).

Dans la mesure où curl peut localiser les certificats appropriés, il gère les connexions HTTPS comme des connexions HTTP, sans paramètres supplémentaires. Les exemples de cette documentation sont basés sur ce scénario.

Pour plus d'informations sur cet outil, consultez la page de manuel de curl et le livre Everything curl .

Exemples de requêtes

Les exemples suivants montrent comment exécuter une requête de base à l'aide de curl et 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

Note

Plain ne curl fonctionne que lorsque l'authentification IAM n'est pas activée sur votre 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

Note

Plain ne curl fonctionne que lorsque l'authentification IAM n'est pas activée sur votre cluster.

Pour d'autres exemples HTTP de Gremlin, consultezHTTPS REST. Pour d'autres exemples HTTP d'OpenCypher, consultez. Point de terminaison HTTPS