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 SDK et les outils HTTP tels que curl et awscurl pour envoyer des requêtes à votre cluster de base de données Neptune. Les sections suivantes montrent comment configurer chaque outil et exécuter des requêtes Gkremlin et OpenCypher de base.

Utilisation de AWS CLI

Les aws neptunedata commandes vous permettent d'exécuter des requêtes G705 et OpenCypher, de vérifier l'état du moteur, de gérer les chargements groupés, etc. Pour la référence complète des commandes, voir neptunedatala 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 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, voir 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, voirAWS 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, voirAWS 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 Utiliser awscurl avec des informations d'identification temporaires pour se connecter en toute sécurité à un cluster de base 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), il curl faut avoir accès 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 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 Gkremlin, voirHTTPS REST. Pour d'autres exemples HTTP d'OpenCypher, consultez. Point de terminaison HTTPS