Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Preferências
Entre em contato conosco
Feedback
AWS Documentation
Crie uma conta da AWS

Exemplos do Amazon RDS Data Service usando a AWS CLI

PDF
RSS
Modo de foco
Exemplos do Amazon RDS Data Service usando a AWS CLI - AWS Command Line Interface
Ações

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a 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 perfis 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, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

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

AWS CLI

Para executar uma instrução SQL em lote

O exemplo batch-execute-statement a seguir executa uma instrução SQL 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 Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

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

AWS CLI

Para executar uma instrução SQL em lote

O exemplo batch-execute-statement a seguir executa uma instrução SQL 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 Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

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

AWS CLI

Para iniciar uma transação SQL

O exemplo begin-transaction a seguir executa uma transação 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"

Saída:

{
    "transactionId": "ABC1234567890xyz"
}

Para obter mais informações, consulte Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para ver detalhes da API, consulte BeginTransaction na Referência de comandos da AWS CLI.

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

AWS CLI

Para iniciar uma transação SQL

O exemplo begin-transaction a seguir executa uma transação 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"

Saída:

{
    "transactionId": "ABC1234567890xyz"
}

Para obter mais informações, consulte Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para ver detalhes da API, consulte BeginTransaction na Referência de comandos da AWS CLI.

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

AWS CLI

Como confirmar uma transação SQL

O exemplo commit-transaction a seguir encerra a transação SQL 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 Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para ver detalhes da API, consulte CommitTransaction na Referência de comandos da AWS CLI.

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

AWS CLI

Como confirmar uma transação SQL

O exemplo commit-transaction a seguir encerra a transação SQL 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 Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para ver detalhes da API, consulte CommitTransaction na Referência de comandos da AWS CLI.

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

AWS CLI

Exemplo 1: como executar uma instrução SQL que faz parte de uma transação

O exemplo de execute-statement a seguir executa uma instrução SQL que é 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: como executar uma instrução SQL com parâmetros

O exemplo de execute-statement a seguir executa uma instrução SQL 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 Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para obter detalhes da API, consulte ExecuteStatement na Referência de comandos da AWS CLI.

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

AWS CLI

Exemplo 1: como executar uma instrução SQL que faz parte de uma transação

O exemplo de execute-statement a seguir executa uma instrução SQL que é 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: como executar uma instrução SQL com parâmetros

O exemplo de execute-statement a seguir executa uma instrução SQL 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 Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para obter detalhes da API, consulte ExecuteStatement na Referência de comandos da AWS CLI.

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

AWS CLI

Como reverter uma transação SQL

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

Saída:

{
    "transactionStatus": "Rollback Complete"
}

Para obter mais informações, consulte Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para ver detalhes da API, consulte RollbackTransaction na Referência de comandos da AWS CLI.

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

AWS CLI

Como reverter uma transação SQL

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

Saída:

{
    "transactionStatus": "Rollback Complete"
}

Para obter mais informações, consulte Using the Data API for Aurora Serverless no Guia do usuário do Amazon RDS.

  • Para ver detalhes da API, consulte RollbackTransaction na Referência de comandos da AWS CLI.

Nesta página

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.