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à.

# Esempi di Amazon RDS Data Service utilizzando AWS CLI
<a name="cli_rds-data_code_examples"></a>

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con Amazon RDS Data Service.

Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

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

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

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

Il seguente esempio di codice mostra come usare`batch-execute-statement`.

**AWS CLI**  
**Come eseguire un’istruzione SQL in batch**  
L’esempio `batch-execute-statement` seguente esegue un’istruzione SQL batch su un array di dati con un set di parametri.  

```
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\"}}]]"
```
Questo comando non produce alcun output.  
Per ulteriori informazioni, consulta [Utilizzo dell’API dati per Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) nella *Guida per l’utente di Amazon RDS*.  
+  Per i dettagli sull'API, consulta [BatchExecuteStatement AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/batch-execute-statement.html)*Command Reference*. 

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

Il seguente esempio di codice mostra come utilizzare`begin-transaction`.

**AWS CLI**  
**Come avviare una transazione SQL**  
L’esempio `begin-transaction` seguente esegue una transazione 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"
```
Output:  

```
{
    "transactionId": "ABC1234567890xyz"
}
```
Per ulteriori informazioni, consulta [Utilizzo dell’API dati per Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) nella *Guida per l’utente di Amazon RDS*.  
+  Per i dettagli sull'API, consulta [BeginTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/begin-transaction.html)*Command Reference*. 

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

Il seguente esempio di codice mostra come utilizzare`commit-transaction`.

**AWS CLI**  
**Come eseguire il commit di una transazione SQL**  
L’esempio `commit-transaction` seguente termina la transazione SQL specificata e conferma le modifiche apportate come parte di essa.  

```
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"
```
Output:  

```
{
    "transactionStatus": "Transaction Committed"
}
```
Per ulteriori informazioni, consulta [Utilizzo dell’API dati per Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) nella *Guida per l’utente di Amazon RDS*.  
+  Per i dettagli sull'API, consulta [CommitTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/commit-transaction.html)*Command Reference*. 

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

Il seguente esempio di codice mostra come utilizzare`execute-statement`.

**AWS CLI**  
**Esempio 1: come eseguire un’istruzione SQL inclusa in una transazione**  
L’esempio `execute-statement` seguente esegue un’istruzione SQL che fa parte di una transazione.  

```
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"
```
Output:  

```
{
    "numberOfRecordsUpdated": 1
}
```
**Esempio 2: come eseguire un’istruzione SQL con parametri**  
L’esempio `execute-statement` seguente esegue un’istruzione SQL con parametri.  

```
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\"}}]"
```
Output:  

```
{
    "numberOfRecordsUpdated": 1
}
```
Per ulteriori informazioni, consulta [Utilizzo dell’API dati per Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) nella *Guida per l’utente di Amazon RDS*.  
+  Per i dettagli sull'API, consulta [ExecuteStatement AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)*Command Reference*. 

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

Il seguente esempio di codice mostra come utilizzare`rollback-transaction`.

**AWS CLI**  
**Come eseguire il rollback di una transazione SQL**  
L’esempio `rollback-transaction` seguente ripristina la transazione SQL specificata.  

```
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"
```
Output:  

```
{
    "transactionStatus": "Rollback Complete"
}
```
Per ulteriori informazioni, consulta [Utilizzo dell’API dati per Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) nella *Guida per l’utente di Amazon RDS*.  
+  Per i dettagli sull'API, consulta [RollbackTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/rollback-transaction.html)*Command Reference*.