Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Exemplos de serviços de dados do Amazon RDS usando AWS CLI
<a name="cli_2_rds-data_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface Amazon RDS Data Service.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

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

O código de exemplo a seguir mostra como usar `batch-execute-statement`.

**AWS CLI**  
**Para executar uma instrução SQL em lote**  
O exemplo `batch-execute-statement` a seguir executa uma instrução SQL em lote em uma matriz de dados com um conjunto de parâmetros.  

```
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\"}}]]"
```
Este comando não produz saída.  
Para obter mais informações, consulte [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) no *Guia do usuário do Amazon RDS*.  
+  Para obter detalhes da API, consulte [BatchExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/batch-execute-statement.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `begin-transaction`.

**AWS CLI**  
**Para iniciar uma transação SQL**  
O exemplo `begin-transaction` a seguir executa uma transação 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"
```
Saída:  

```
{
    "transactionId": "ABC1234567890xyz"
}
```
Para obter mais informações, consulte [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) no *Guia do usuário do Amazon RDS*.  
+  Para obter detalhes da API, consulte [BeginTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/begin-transaction.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `commit-transaction`.

**AWS CLI**  
**Como confirmar uma transação SQL**  
O exemplo `commit-transaction` a seguir encerra a transação SQL especificada e confirma as alterações feitas como parte dela.  

```
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"
```
Saída:  

```
{
    "transactionStatus": "Transaction Committed"
}
```
Para obter mais informações, consulte [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) no *Guia do usuário do Amazon RDS*.  
+  Para obter detalhes da API, consulte [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/commit-transaction.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `execute-statement`.

**AWS CLI**  
**Exemplo 1: como executar uma instrução SQL que faz parte de uma transação**  
O exemplo de `execute-statement` a seguir executa uma instrução SQL que é parte de uma transação.  

```
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"
```
Saída:  

```
{
    "numberOfRecordsUpdated": 1
}
```
**Exemplo 2: como executar uma instrução SQL com parâmetros**  
O exemplo de `execute-statement` a seguir executa uma instrução SQL com parâmetros.  

```
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\"}}]"
```
Saída:  

```
{
    "numberOfRecordsUpdated": 1
}
```
Para obter mais informações, consulte [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) no *Guia do usuário do Amazon RDS*.  
+  Para obter detalhes da API, consulte [ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `rollback-transaction`.

**AWS CLI**  
**Como reverter uma transação SQL**  
O exemplo `rollback-transaction` a seguir reverte a transação SQL especificada.  

```
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"
```
Saída:  

```
{
    "transactionStatus": "Rollback Complete"
}
```
Para obter mais informações, consulte [Using the Data API for Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) no *Guia do usuário do Amazon RDS*.  
+  Para obter detalhes da API, consulte [RollbackTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/rollback-transaction.html)em *Referência de AWS CLI Comandos*.