# Ejemplos de servicio de datos de Amazon RDS que utilizan la AWS CLI
<a name="cli_rds-data_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes utilizando el AWS Command Line Interface con Amazon RDS Data Service.

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_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 información sobre la API, consulte [BatchExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/batch-execute-statement.html) en la *Referencia de la API de AWS CLI*. 

### `begin-transaction`
<a name="rds-data_BeginTransaction_cli_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 información sobre la API, consulte [BeginTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/begin-transaction.html) en la *Referencia de comandos de la AWS CLI*. 

### `commit-transaction`
<a name="rds-data_CommitTransaction_cli_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 información sobre la API, consulte [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/commit-transaction.html) en la *Referencia de comandos de la AWS CLI*. 

### `execute-statement`
<a name="rds-data_ExecuteStatement_cli_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 para Aurora Serverless](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) en la *Guía del usuario de Amazon RDS*.  
+  Para obtener información sobre la API, consulte [ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html) en la *Referencia de comandos de la AWS CLI*. 

### `rollback-transaction`
<a name="rds-data_RollbackTransaction_cli_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 información sobre la API, consulte [RollbackTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/rollback-transaction.html) en la *Referencia de comandos de la AWS CLI*.