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.

# Exemples d'Amazon RDS Data Service utilisant AWS CLI
<a name="cli_rds-data_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'Amazon RDS Data Service.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `batch-execute-statement`
<a name="rds-data_BatchExecuteStatement_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`batch-execute-statement`.

**AWS CLI**  
**Pour exécuter une instruction SQL par lots**  
L’exemple `batch-execute-statement` suivant exécute une instruction SQL par lots sur un tableau de données avec un jeu de paramètres.  

```
aws rds-data batch-execute-statement \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --sql "insert into mytable values (:id, :val)" \
    --parameter-sets "[[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueOne\"}}],
        [{\"name\": \"id\", \"value\": {\"longValue\": 2}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueTwo\"}}],
        [{\"name\": \"id\", \"value\": {\"longValue\": 3}},{\"name\": \"val\", \"value\": {\"stringValue\": \"ValueThree\"}}]]"
```
Cette commande ne produit aucune sortie.  
Pour plus d’informations, consultez [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) dans le *Guide de l’utilisateur Amazon RDS*.  
+  Pour plus de détails sur l'API, reportez-vous [BatchExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/batch-execute-statement.html)à la section *Référence des AWS CLI commandes*. 

### `begin-transaction`
<a name="rds-data_BeginTransaction_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`begin-transaction`.

**AWS CLI**  
**Pour démarrer une transaction SQL**  
L’exemple `begin-transaction` suivant démarre une transaction SQL.  

```
aws rds-data begin-transaction \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret"
```
Sortie :  

```
{
    "transactionId": "ABC1234567890xyz"
}
```
Pour plus d’informations, consultez [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) dans le *Guide de l’utilisateur Amazon RDS*.  
+  Pour plus de détails sur l'API, reportez-vous [BeginTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/begin-transaction.html)à la section *Référence des AWS CLI commandes*. 

### `commit-transaction`
<a name="rds-data_CommitTransaction_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`commit-transaction`.

**AWS CLI**  
**Pour valider une transaction SQL**  
L’exemple `commit-transaction` suivant met fin à la transaction SQL spécifiée et valide les modifications que vous avez apportées dans le cadre de celle-ci.  

```
aws rds-data commit-transaction \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --transaction-id "ABC1234567890xyz"
```
Sortie :  

```
{
    "transactionStatus": "Transaction Committed"
}
```
Pour plus d’informations, consultez [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) dans le *Guide de l’utilisateur Amazon RDS*.  
+  Pour plus de détails sur l'API, reportez-vous [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/commit-transaction.html)à la section *Référence des AWS CLI commandes*. 

### `execute-statement`
<a name="rds-data_ExecuteStatement_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`execute-statement`.

**AWS CLI**  
**Exemple 1 : pour exécuter une instruction SQL faisant partie d’une transaction**  
L’exemple `execute-statement` suivant exécute une instruction SQL faisant partie d’une transaction.  

```
aws rds-data execute-statement \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --sql "update mytable set quantity=5 where id=201" \
    --transaction-id "ABC1234567890xyz"
```
Sortie :  

```
{
    "numberOfRecordsUpdated": 1
}
```
**Exemple 2 : pour exécuter une instruction SQL avec des paramètres**  
L’exemple `execute-statement` suivant exécute une instruction SQL avec des paramètres.  

```
aws rds-data execute-statement \
    --resource-arn "arn:aws:rds:us-east-1:123456789012:cluster:mydbcluster" \
    --database "mydb" \
    --secret-arn "arn:aws:secretsmanager:us-east-1:123456789012:secret:mysecret" \
    --sql "insert into mytable values (:id, :val)" \
    --parameters "[{\"name\": \"id\", \"value\": {\"longValue\": 1}},{\"name\": \"val\", \"value\": {\"stringValue\": \"value1\"}}]"
```
Sortie :  

```
{
    "numberOfRecordsUpdated": 1
}
```
Pour plus d’informations, consultez [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) dans le *Guide de l’utilisateur Amazon RDS*.  
+  Pour plus de détails sur l'API, reportez-vous [ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)à la section *Référence des AWS CLI commandes*. 

### `rollback-transaction`
<a name="rds-data_RollbackTransaction_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`rollback-transaction`.

**AWS CLI**  
**Pour restaurer une transaction SQL**  
L’exemple `rollback-transaction` suivant restaure la transaction SQL spécifiée.  

```
aws rds-data rollback-transaction \
    --resource-arn "arn:aws:rds:us-west-2:123456789012:cluster:mydbcluster" \
    --secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:mysecret" \
    --transaction-id "ABC1234567890xyz"
```
Sortie :  

```
{
    "transactionStatus": "Rollback Complete"
}
```
Pour plus d’informations, consultez [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) dans le *Guide de l’utilisateur Amazon RDS*.  
+  Pour plus de détails sur l'API, reportez-vous [RollbackTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/rollback-transaction.html)à la section *Référence des AWS CLI commandes*.