

Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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 de código para o Amazon RDS Data Service usando AWS SDKs
<a name="rds-data_code_examples"></a>

Os exemplos de código a seguir mostram como usar o Amazon Relational Database Service (Amazon Relational Database Service) com AWS um kit de desenvolvimento de software (SDK).

*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.

*Cenários* são exemplos de código que mostram como realizar tarefas específicas chamando várias funções dentro de um serviço ou combinadas com outros Serviços da AWS.

**Mais atributos**
+  **[ Guia do usuário do Amazon RDS Data Service](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html)**: mais informações sobre o Amazon RDS Data Service.
+ **[Referência da API Amazon RDS Data Service](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/Welcome.html)**: detalhes sobre todas as ações disponíveis do Amazon RDS Data Service.
+ **[AWS Centro do desenvolvedor](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23rds)** — exemplos de código que você pode filtrar por categoria ou pesquisa de texto completo.
+ **[AWS Exemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub repositório com código completo nos idiomas preferidos. Inclui instruções para configurar e executar o código.

**Contents**
+ [Conceitos básicos](rds-data_code_examples_basics.md)
  + [Ações](rds-data_code_examples_actions.md)
    + [`ExecuteStatement`](rds-data_example_rds-data_ExecuteStatement_section.md)
+ [Cenários](rds-data_code_examples_scenarios.md)
  + [Crie um rastreador de itens de trabalho do Aurora Sem Servidor](rds-data_example_cross_RDSDataTracker_section.md)

# Exemplos básicos para o Amazon RDS Data Service usando AWS SDKs
<a name="rds-data_code_examples_basics"></a>

Os exemplos de código a seguir mostram como usar as noções básicas do Amazon Relational Database Service Data Service com. AWS SDKs 

**Contents**
+ [Ações](rds-data_code_examples_actions.md)
  + [`ExecuteStatement`](rds-data_example_rds-data_ExecuteStatement_section.md)

# Ações para o Amazon RDS Data Service usando AWS SDKs
<a name="rds-data_code_examples_actions"></a>

Os exemplos de código a seguir demonstram como realizar ações individuais do Amazon RDS Data Service com AWS SDKs. Cada exemplo inclui um link para GitHub, onde você pode encontrar instruções para configurar e executar o código. 

Esses trechos chamam a API do Amazon RDS Data Service e são trechos de código de programas maiores que devem ser executados no contexto. É possível ver as ações em contexto em [Cenários para o Amazon RDS Data Service usando AWS SDKs](rds-data_code_examples_scenarios.md). 

 Os exemplos a seguir incluem apenas as ações mais utilizadas. Consulte uma lista completa na [Referência de API do Amazon Relational Database Service Data Service](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/Welcome.html). 

**Topics**
+ [`ExecuteStatement`](rds-data_example_rds-data_ExecuteStatement_section.md)

# Use `ExecuteStatement` com um AWS SDK ou CLI
<a name="rds-data_example_rds-data_ExecuteStatement_section"></a>

Os exemplos de código a seguir mostram como usar o `ExecuteStatement`.

------
#### [ CLI ]

**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](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) no *Guia do usuário do Amazon RDS*.  
+  Para obter detalhes da API, consulte [ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)em *Referência de AWS CLI Comandos*. 

------
#### [ Rust ]

**SDK para Rust**  
 Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/rdsdata#code-examples). 

```
async fn query_cluster(
    client: &Client,
    cluster_arn: &str,
    query: &str,
    secret_arn: &str,
) -> Result<(), Error> {
    let st = client
        .execute_statement()
        .resource_arn(cluster_arn)
        .database("postgres") // Do not confuse this with db instance name
        .sql(query)
        .secret_arn(secret_arn);

    let result = st.send().await?;

    println!("{:?}", result);
    println!();

    Ok(())
}
```
+  Para obter detalhes da API, consulte a [ExecuteStatement](https://docs.rs/aws-sdk-rdsdata/latest/aws_sdk_rdsdata/client/struct.Client.html#method.execute_statement)referência da *API AWS SDK for Rust*. 

------

# Cenários para o Amazon RDS Data Service usando AWS SDKs
<a name="rds-data_code_examples_scenarios"></a>

Os exemplos de código a seguir mostram como implementar cenários comuns no Amazon RDS Data Service com AWS SDKs. Esses casos mostram como realizar tarefas específicas chamando várias funções dentro do Amazon RDS Data Service ou combinadas com outros Serviços da AWS. Cada cenário inclui um link para o código-fonte completo, onde podem ser encontradas instruções sobre como configurar e executar o código. 

Os cenários têm como alvo um nível intermediário de experiência para ajudar você a compreender ações de serviço em contexto.

**Topics**
+ [Crie um rastreador de itens de trabalho do Aurora Sem Servidor](rds-data_example_cross_RDSDataTracker_section.md)

# Crie um rastreador de itens de trabalho do Aurora Sem Servidor
<a name="rds-data_example_cross_RDSDataTracker_section"></a>

Os exemplos de código a seguir mostram como criar uma aplicação Web que rastreia os itens de trabalho em um banco de dados do Amazon Aurora Sem Servidor e usa o Amazon Simple Email Service (Amazon SES) para enviar relatórios.

------
#### [ .NET ]

**SDK para .NET**  
 Mostra como usar o AWS SDK para .NET para criar um aplicativo web que rastreia itens de trabalho em um banco de dados Amazon Aurora e envia relatórios por e-mail usando o Amazon Simple Email Service (Amazon SES). Este exemplo usa um front-end criado com o React.js para interagir com um back-end RESTful do.NET.   
+ Integre um aplicativo web React com AWS serviços.
+ Liste, adicione, atualize e exclua itens em uma tabela do Aurora.
+ Envie um relatório por e-mail dos itens de trabalho filtrados usando o Amazon SES.
+ Implante e gerencie recursos de exemplo com o AWS CloudFormation script incluído.
 Para obter o código-fonte completo e instruções sobre como configurar e executar, veja o exemplo completo em [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/cross-service/AuroraItemTracker).   

**Serviços usados neste exemplo**
+ Aurora
+ Amazon RDS
+ Serviços de dados do Amazon RDS
+ Amazon SES

------
#### [ C\$1\$1 ]

**SDK para C\$1\$1**  
 Mostra como criar uma aplicação Web que rastreia e gera relatórios sobre itens de trabalho armazenados em um banco de dados do Amazon Aurora Sem Servidor.   
 Para obter o código-fonte completo e instruções sobre como configurar uma API REST C\$1\$1 que consulta dados do Amazon Aurora Serverless e para uso por um aplicativo React, veja o exemplo completo em. [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/cross-service/serverless-aurora)   

**Serviços usados neste exemplo**
+ Aurora
+ Amazon RDS
+ Serviços de dados do Amazon RDS
+ Amazon SES

------
#### [ Java ]

**SDK para Java 2.x**  
 Mostra como construir uma aplicação Web que monitora e gera relatórios sobre itens de trabalho armazenados em um banco de dados do Amazon RDS.   
 Para obter o código-fonte completo e instruções sobre como configurar uma API Spring REST que consulta dados do Amazon Aurora Serverless e para uso por um aplicativo React, veja o exemplo completo em. [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/usecases/Creating_Spring_RDS_Rest)   
 Para obter o código-fonte completo e instruções sobre como configurar e executar um exemplo que usa a API JDBC, consulte o exemplo completo em. [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/usecases/Creating_rds_item_tracker)   

**Serviços usados neste exemplo**
+ Aurora
+ Amazon RDS
+ Serviços de dados do Amazon RDS
+ Amazon SES

------
#### [ JavaScript ]

**SDK para JavaScript (v3)**  
 Mostra como usar o AWS SDK para JavaScript (v3) para criar um aplicativo web que rastreia itens de trabalho em um banco de dados Amazon Aurora e envia relatórios por e-mail usando o Amazon Simple Email Service (Amazon SES). Este exemplo usa um front-end criado com React.js para interagir com um back-end Node.js Express.   
+ Integre um aplicativo web React.js com Serviços da AWS o.
+ Liste, adicione e atualize itens em uma tabela do Aurora.
+ Use o Amazon SES para enviar um relatório por e-mail dos itens de trabalho filtrados.
+ Implante e gerencie recursos de exemplo com o AWS CloudFormation script incluído.
 Para obter o código-fonte completo e instruções sobre como configurar e executar, veja o exemplo completo em [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cross-services/aurora-serverless-app).   

**Serviços usados neste exemplo**
+ Aurora
+ Amazon RDS
+ Serviços de dados do Amazon RDS
+ Amazon SES

------
#### [ Kotlin ]

**SDK para Kotlin**  
 Mostra como construir uma aplicação Web que monitora e gera relatórios sobre itens de trabalho armazenados em um banco de dados do Amazon RDS.   
 Para obter o código-fonte completo e instruções sobre como configurar uma API Spring REST que consulta dados do Amazon Aurora Serverless e para uso por um aplicativo React, veja o exemplo completo em. [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/usecases/serverless_rds)   

**Serviços usados neste exemplo**
+ Aurora
+ Amazon RDS
+ Serviços de dados do Amazon RDS
+ Amazon SES

------
#### [ PHP ]

**SDK para PHP**  
 Mostra como usar o AWS SDK para PHP para criar uma aplicação web que rastreia itens de trabalho em um banco de dados do Amazon RDS e envia relatórios por e-mail usando o Amazon Simple Email Service (Amazon SES). Este exemplo usa um front-end criado com o React.js para interagir com um back-end RESTful PHP.   
+ Integre um aplicativo web React.js com AWS serviços.
+ Liste, adicione, atualize e exclua itens em uma tabela do Amazon RDS.
+ Envie um relatório por e-mail dos itens de trabalho filtrados usando o Amazon SES.
+ Implante e gerencie recursos de exemplo com o AWS CloudFormation script incluído.
 Para obter o código-fonte completo e instruções sobre como configurar e executar, veja o exemplo completo em [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/cross_service/aurora_item_tracker).   

**Serviços usados neste exemplo**
+ Aurora
+ Amazon RDS
+ Serviços de dados do Amazon RDS
+ Amazon SES

------
#### [ Python ]

**SDK para Python (Boto3)**  
 Mostra como usar o AWS SDK para Python (Boto3) para criar um serviço REST que rastreia itens de trabalho em um banco de dados Amazon Aurora Serverless e envia relatórios por e-mail usando o Amazon Simple Email Service (Amazon SES). Este exemplo usa a estrutura web Flask para lidar com o roteamento HTTP e se integra a uma página da Web do React para apresentar uma aplicação Web totalmente funcional.   
+ Crie um serviço Flask REST que se integre com o. Serviços da AWS
+ Leia, grave e atualize itens de trabalho armazenados em um banco de dados do Aurora Sem Servidor.
+ Crie um AWS Secrets Manager segredo que contenha as credenciais do banco de dados e use-o para autenticar chamadas para o banco de dados.
+ Use o Amazon SES para enviar relatórios por e-mail de itens de trabalho.
 Para obter o código-fonte completo e instruções sobre como configurar e executar, veja o exemplo completo em [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/cross_service/aurora_item_tracker).   

**Serviços usados neste exemplo**
+ Aurora
+ Amazon RDS
+ Serviços de dados do Amazon RDS
+ Amazon SES

------