Ejemplos de Amazon RDS Data Service que utilizan AWS CLI - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de ejemplos de AWS Doc SDK.

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

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.

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-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 en la Guía del usuario de Amazon RDS.

  • Para obtener más información sobre la API, consulte BatchExecuteStatementla Referencia de AWS CLI comandos.

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 en la Guía del usuario de Amazon RDS.

  • Para obtener más información sobre la API, consulte BeginTransactionla Referencia de AWS CLI comandos.

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 en la Guía del usuario de Amazon RDS.

  • Para obtener más información sobre la API, consulte CommitTransactionla Referencia de AWS CLI comandos.

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 en la Guía del usuario de Amazon RDS.

  • Para obtener más información sobre la API, consulte ExecuteStatementla Referencia de AWS CLI comandos.

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 en la Guía del usuario de Amazon RDS.

  • Para obtener más información sobre la API, consulte RollbackTransactionla Referencia de AWS CLI comandos.