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
<a name="get-started-cli-tools"></a>

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
<a name="get-started-cli-tools-cli"></a>

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 [https://docs.aws.amazon.com/cli/latest/reference/neptunedata/](https://docs.aws.amazon.com/cli/latest/reference/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 [execute-gremlin-query](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html) 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](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html) dans la référence des commandes. AWS CLI 

------

## Utilisation de AWS Kit SDK
<a name="get-started-cli-tools-sdk"></a>

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, voir[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))
```

Pour des exemples de AWS SDK dans d'autres langues, voir[AWS SDK](access-graph-opencypher-sdk.md).

------

## `Utilisation de curl et awscurl`
<a name="get-started-cli-tools-curl"></a>

L'outil de ligne de commande [curl](https://curl.haxx.se/) envoie des requêtes HTTP directement aux points de terminaison Neptune. Si l'authentification IAM est activée, utilisez [awscurl](https://github.com/okigan/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](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).

### Configuration de `curl` pour HTTPS
<a name="get-started-cli-tools-curl-setup"></a>

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](https://curl.haxx.se/docs/sslcerts.html) dans la `curl` documentation.

Vous pouvez spécifier l'emplacement de ce magasin de certificats CA à l'aide de la variable d'`CURL_CA_BUNDLE`environnement. 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)](https://curl.haxx.se/docs/sslcerts.html).

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](https://curl.haxx.se/docs/manpage.html) et le livre *[Everything curl](https://ec.haxx.se/)*.

### Exemples de requêtes
<a name="get-started-cli-tools-curl-examples"></a>

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, voir[HTTPS REST](access-graph-gremlin-rest.md). Pour d'autres exemples HTTP d'OpenCypher, consultez. [Point de terminaison HTTPS](access-graph-opencypher-queries.md)