Ejemplos RDS de Amazon Data Service que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

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 RDS de Amazon Data Service que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar situaciones comunes AWS Command Line Interface mediante 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usarlobatch-execute-statement.

AWS CLI

Para ejecutar una SQL sentencia por lotes

El siguiente batch-execute-statement ejemplo ejecuta una SQL sentencia por lotes sobre 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 Uso de los datos API para Aurora Serverless en la Guía del RDS usuario de Amazon.

El siguiente ejemplo de código muestra cómo usarlobegin-transaction.

AWS CLI

Para iniciar una SQL transacción

En el siguiente begin-transaction ejemplo, se inicia una SQL transacción.

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 Uso de los datos API para Aurora Serverless en la Guía del RDS usuario de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlocommit-transaction.

AWS CLI

Para confirmar una SQL transacción

El siguiente commit-transaction ejemplo finaliza la SQL transacción especificada y confirma los cambios que realizó 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 Uso de los datos API para Aurora Serverless en la Guía del RDS usuario de Amazon.

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

El siguiente ejemplo de código muestra cómo usarloexecute-statement.

AWS CLI

Ejemplo 1: Para ejecutar una SQL sentencia que forma parte de una transacción

El siguiente execute-statement ejemplo ejecuta una SQL sentencia 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: Para ejecutar una SQL sentencia con parámetros

En el siguiente execute-statement ejemplo, se ejecuta una SQL sentencia 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 Uso de los datos API para Aurora Serverless en la Guía del RDS usuario de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlorollback-transaction.

AWS CLI

Para anular una SQL transacción

El siguiente rollback-transaction ejemplo anula la SQL transacción 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 Uso de los datos API para Aurora Serverless en la Guía del RDS usuario de Amazon.

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