Exemplos do Amazon RDS Data Service usando AWS CLI - AWS Command Line Interface
Ações

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos do Amazon RDS Data Service usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Amazon RDS Data Service.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar batch-execute-statement.

AWS CLI

Para executar uma SQL instrução em lote

O batch-execute-statement exemplo a seguir executa uma SQL instrução em lote em uma matriz de dados com um 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 não produz saída.

Para obter mais informações, consulte Usando os dados API do Aurora Serverless no Guia do usuário da Amazon. RDS

O código de exemplo a seguir mostra como usar begin-transaction.

AWS CLI

Para iniciar uma SQL transação

O begin-transaction exemplo a seguir inicia uma SQL transação.

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"

Saída:

{
    "transactionId": "ABC1234567890xyz"
}

Para obter mais informações, consulte Usando os dados API do Aurora Serverless no Guia do usuário da Amazon. RDS

  • Para API obter detalhes, consulte BeginTransactionna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar commit-transaction.

AWS CLI

Para confirmar uma SQL transação

O commit-transaction exemplo a seguir encerra a SQL transação especificada e confirma as alterações feitas como parte dela.

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"

Saída:

{
    "transactionStatus": "Transaction Committed"
}

Para obter mais informações, consulte Usando os dados API do Aurora Serverless no Guia do usuário da Amazon. RDS

  • Para API obter detalhes, consulte CommitTransactionna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar execute-statement.

AWS CLI

Exemplo 1: Para executar uma SQL declaração que faz parte de uma transação

O execute-statement exemplo a seguir executa uma SQL declaração que faz parte de uma transação.

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"

Saída:

{
    "numberOfRecordsUpdated": 1
}

Exemplo 2: Para executar uma SQL instrução com parâmetros

O execute-statement exemplo a seguir executa uma SQL instrução com 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\"}}]"

Saída:

{
    "numberOfRecordsUpdated": 1
}

Para obter mais informações, consulte Usando os dados API do Aurora Serverless no Guia do usuário da Amazon. RDS

  • Para API obter detalhes, consulte ExecuteStatementna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar rollback-transaction.

AWS CLI

Para reverter uma SQL transação

O rollback-transaction exemplo a seguir reverte a SQL transação 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"

Saída:

{
    "transactionStatus": "Rollback Complete"
}

Para obter mais informações, consulte Usando os dados API do Aurora Serverless no Guia do usuário da Amazon. RDS