Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplos de Amazon RDS Data Service que utilizan AWS CLI
<a name="cli_2_rds-data_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar situaciones comunes mediante Amazon RDS Data Service. AWS Command Line Interface 

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

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

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

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

En el siguiente ejemplo de código, se muestra cómo utilizar `batch-execute-statement`.

**AWS CLI**  
**Para ejecutar una instrucción SQL por lotes**  
El siguiente ejemplo de `batch-execute-statement` ejecuta una instrucción SQL por lotes en una matriz de datos con un 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 no genera ninguna salida.  
Para obtener más información, consulte la sección de [Uso de la API de datos de RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) en la *Guía del usuario de Amazon RDS*.  
+  Para obtener más información sobre la API, consulte [BatchExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/batch-execute-statement.html)la *Referencia de AWS CLI comandos*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `begin-transaction`.

**AWS CLI**  
**Para iniciar una transacción SQL**  
En el ejemplo siguiente de `begin-transaction` se inicia una transacción 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"
```
Salida:  

```
{
    "transactionId": "ABC1234567890xyz"
}
```
Para obtener más información, consulte la sección de [Uso de la API de datos de RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) en la *Guía del usuario de Amazon RDS*.  
+  Para obtener más información sobre la API, consulte [BeginTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/begin-transaction.html)la *Referencia de AWS CLI comandos*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `commit-transaction`.

**AWS CLI**  
**Para confirmar una transacción SQL**  
El siguiente ejemplo de `commit-transaction` finaliza la transacción de SQL especificada y confirma los cambios que haya realizado como parte de ella.  

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

```
{
    "transactionStatus": "Transaction Committed"
}
```
Para obtener más información, consulte la sección de [Uso de la API de datos de RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) en la *Guía del usuario de Amazon RDS*.  
+  Para obtener más información sobre la API, consulte [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/commit-transaction.html)la *Referencia de AWS CLI comandos*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `execute-statement`.

**AWS CLI**  
**Ejemplo 1: Ejecución de una instrucción SQL que forma parte de una transacción**  
En el siguiente ejemplo de `execute-statement` se ejecuta una instrucción SQL que forma parte de una transacción.  

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

```
{
    "numberOfRecordsUpdated": 1
}
```
**Ejemplo 2: Ejecución de una instrucción SQL con parámetros**  
En el siguiente ejemplo de `execute-statement` se ejecuta una instrucción SQL con 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\"}}]"
```
Salida:  

```
{
    "numberOfRecordsUpdated": 1
}
```
Para obtener más información, consulte la sección de [Uso de la API de datos de RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) en la *Guía del usuario de Amazon RDS*.  
+  Para obtener más información sobre la API, consulte [ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)la *Referencia de AWS CLI comandos*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `rollback-transaction`.

**AWS CLI**  
**Restauración de una transacción SQL**  
El siguiente ejemplo de `rollback-transaction` revierte la transacción 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"
```
Salida:  

```
{
    "transactionStatus": "Rollback Complete"
}
```
Para obtener más información, consulte la sección de [Uso de la API de datos de RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) en la *Guía del usuario de Amazon RDS*.  
+  Para obtener más información sobre la API, consulte [RollbackTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/rollback-transaction.html)la *Referencia de AWS CLI comandos*.