Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
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.
Temas
Acciones
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-statementejecuta 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 en la Guía del usuario de Amazon RDS.
-
Para obtener información sobre la API, consulte BatchExecuteStatement
en la Referencia de la API de AWS CLI.
-
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-transactionse 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 en la Guía del usuario de Amazon RDS.
-
Para obtener información sobre la API, consulte BeginTransaction
en la Referencia de comandos de la AWS CLI.
-
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-transactionfinaliza 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 en la Guía del usuario de Amazon RDS.
-
Para obtener información sobre la API, consulte CommitTransaction
en la Referencia de comandos de la AWS CLI.
-
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-statementse 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-statementse 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 en la Guía del usuario de Amazon RDS.
-
Para obtener información sobre la API, consulte ExecuteStatement
en la Referencia de comandos de la AWS CLI.
-
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-transactionrevierte 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 en la Guía del usuario de Amazon RDS.
-
Para obtener información sobre la API, consulte RollbackTransaction
en la Referencia de comandos de la AWS CLI.
-
