文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Amazon RDS 数据服务的代码示例 AWS SDKs
以下代码示例向您展示了如何使用带有 AWS 软件开发套件 (SDK) 的 Amazon Relational Database Service 数据服务。
*操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
*场景*是向您展示如何通过在一个服务中调用多个函数或与其他 AWS 服务服务结合来完成特定任务的代码示例。
**更多资源**
+ **[Amazon RDS 数据服务用户指南](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html)**——有关 Amazon RDS 数据服务的更多信息。
+ **[Amazon RDS 数据服务 API 参考](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/Welcome.html)**——有关所有可用的 Amazon RDS 数据服务操作的详细信息。
+ **[AWS 开发者中心](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23rds)** — 您可以按类别或全文搜索筛选的代码示例。
+ **[AWS SDK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)** — 包含首选语言完整代码的 GitHub 存储库。包括有关设置和运行代码的说明。
**Contents**
+ [基本功能](rds-data_code_examples_basics.md)
+ [操作](rds-data_code_examples_actions.md)
+ [`ExecuteStatement`](rds-data_example_rds-data_ExecuteStatement_section.md)
+ [场景](rds-data_code_examples_scenarios.md)
+ [创建 Aurora Serverless 工作项跟踪器](rds-data_example_cross_RDSDataTracker_section.md)
# 使用 Amazon RDS 数据服务的基本示例 AWS SDKs
以下代码示例展示了如何使用 Amazon Relational Database Service 数据服务的基础知识 AWS SDKs。
**Contents**
+ [操作](rds-data_code_examples_actions.md)
+ [`ExecuteStatement`](rds-data_example_rds-data_ExecuteStatement_section.md)
# 使用 Amazon RDS 数据服务执行的操作 AWS SDKs
以下代码示例演示了如何使用执行单个 Amazon RDS 数据服务操作 AWS SDKs。每个示例都包含一个指向的链接 GitHub，您可以在其中找到有关设置和运行代码的说明。
这些代码节选调用了 Amazon RDS Data Service API，是必须在上下文中运行的较大型程序的代码节选。您可以在[使用 Amazon RDS 数据服务的场景 AWS SDKs](rds-data_code_examples_scenarios.md)中结合上下文查看操作。
以下示例仅包括最常用的操作。有关完整列表，请参阅 [Amazon Relational Database Service Data Service API 参考](https://docs.aws.amazon.com/rdsdataservice/latest/APIReference/Welcome.html)。
**Topics**
+ [`ExecuteStatement`](rds-data_example_rds-data_ExecuteStatement_section.md)
# `ExecuteStatement`与 AWS SDK 或 CLI 配合使用
以下代码示例演示如何使用 `ExecuteStatement`。
------
#### [ CLI ]
**AWS CLI**
**示例 1：执行属于事务的 SQL 语句**
以下 `execute-statement` 示例运行属于事务的 SQL 语句。
```
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"
```
输出：
```
{
"numberOfRecordsUpdated": 1
}
```
**示例 2：执行带有参数的 SQL 语句**
以下 `execute-statement` 示例运行带有参数的 SQL 语句。
```
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\"}}]"
```
输出：
```
{
"numberOfRecordsUpdated": 1
}
```
有关更多信息，请参阅《Amazon RDS 用户指南》**中的[使用 Aurora Serverless 数据 API](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[ExecuteStatement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds-data/execute-statement.html)*中的。
------
#### [ Rust ]
**适用于 Rust 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](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(())
}
```
+ 有关 API 的详细信息，请参阅适用[ExecuteStatement](https://docs.rs/aws-sdk-rdsdata/latest/aws_sdk_rdsdata/client/struct.Client.html#method.execute_statement)于 *Rust 的AWS SDK API 参考*。
------
# 使用 Amazon RDS 数据服务的场景 AWS SDKs
以下代码示例向您展示了如何使用在 Amazon RDS 数据服务中实现常见场景 AWS SDKs。这些场景向您展示了如何通过调用 Amazon RDS 数据服务中的多个函数或与其他 AWS 服务结合来完成特定任务。每个场景都包含完整源代码的链接，您可以在其中找到有关如何设置和运行代码的说明。
场景以中等水平的经验为目标，可帮助您结合具体环境了解服务操作。
**Topics**
+ [创建 Aurora Serverless 工作项跟踪器](rds-data_example_cross_RDSDataTracker_section.md)
# 创建 Aurora Serverless 工作项跟踪器
以下代码示例演示了如何创建用于跟踪 Amazon Aurora Serverless 数据库中的工作项，以及使用 Amazon Simple Email Service（Amazon SES）发送报告的 Web 应用程序。
------
#### [ .NET ]
**适用于 .NET 的 SDK**
演示如何使用创建一个 Web 应用程序，该 适用于 .NET 的 AWS SDK 应用程序可跟踪 Amazon Aurora 数据库中的工作项目，并使用亚马逊简单电子邮件服务 (Amazon SES) 通过电子邮件发送报告。此示例使用使用 React.js 构建的前端与 RESTful .NET 后端进行交互。
+ 将 React Web 应用程序与 AWS 服务集成。
+ 列出、添加、更新和删除 Aurora 表中的项目。
+ 使用 Amazon SES 以电子邮件形式发送已筛选工作项的报告。
+ 使用随附的 AWS CloudFormation 脚本部署和管理示例资源。
有关如何设置和运行的完整源代码和说明，请参阅上的完整示例[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/cross-service/AuroraItemTracker)。
**本示例中使用的服务**
+ Aurora
+ Amazon RDS
+ Amazon RDS 数据服务
+ Amazon SES
------
#### [ C\$1\$1 ]
**SDK for C\$1\$1**
演示了如何创建用于跟踪和报告存储在 Amazon Aurora Serverless 数据库中的工作项的 Web 应用程序。
有关如何设置查询 Amazon Aurora Serverless 数据的 C\$1\$1 REST API 以及如何由 React 应用程序使用的完整源代码和说明，请参阅上的[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/cross-service/serverless-aurora)完整示例。
**本示例中使用的服务**
+ Aurora
+ Amazon RDS
+ Amazon RDS 数据服务
+ Amazon SES
------
#### [ Java ]
**适用于 Java 的 SDK 2.x**
展示如何创建 Web 应用程序来跟踪与报告存储与 Amazon RDS 数据库的工作项。
有关如何设置查询 Amazon Aurora Serverless 数据的 Spring REST API 以及如何让 React 应用程序使用的完整源代码和说明，请参阅上的[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/usecases/Creating_Spring_RDS_Rest)完整示例。
有关如何设置和运行使用 JDBC API 的示例的完整源代码和说明，请参阅上的完整示例。[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/usecases/Creating_rds_item_tracker)
**本示例中使用的服务**
+ Aurora
+ Amazon RDS
+ Amazon RDS 数据服务
+ Amazon SES
------
#### [ JavaScript ]
**适用于 JavaScript (v3) 的软件开发工具包**
演示如何使用 适用于 JavaScript 的 AWS SDK (v3) 创建一个 Web 应用程序，该应用程序使用亚马逊简单电子邮件服务 (Amazon SES) Service 跟踪亚马逊 Aurora 数据库中的工作项目并通过电子邮件发送报告。此示例使用由 React.js 构建的前端与 Express Node.js 后端进行交互。
+ 将 React.js 网络应用程序与集成 AWS 服务。
+ 列出、添加以及更新 Aurora 表中的项目。
+ 使用 Amazon SES 以电子邮件形式发送已筛选工作项的报告。
+ 使用随附的 AWS CloudFormation 脚本部署和管理示例资源。
有关如何设置和运行的完整源代码和说明，请参阅上的完整示例[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cross-services/aurora-serverless-app)。
**本示例中使用的服务**
+ Aurora
+ Amazon RDS
+ Amazon RDS 数据服务
+ Amazon SES
------
#### [ Kotlin ]
**适用于 Kotlin 的 SDK**
展示如何创建 Web 应用程序来跟踪与报告存储与 Amazon RDS 数据库的工作项。
有关如何设置查询 Amazon Aurora Serverless 数据的 Spring REST API 以及如何让 React 应用程序使用的完整源代码和说明，请参阅上的[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/usecases/serverless_rds)完整示例。
**本示例中使用的服务**
+ Aurora
+ Amazon RDS
+ Amazon RDS 数据服务
+ Amazon SES
------
#### [ PHP ]
**适用于 PHP 的 SDK**
演示如何使用创建一个 Web 应用程序，该 适用于 PHP 的 AWS SDK 应用程序通过亚马逊简单电子邮件服务 (Amazon SES) Semple Service 跟踪亚马逊 RDS 数据库中的工作项目并通过电子邮件发送报告。此示例使用使用 React.js 构建的前端与 RESTful PHP 后端进行交互。
+ 将 React.js 网络应用程序与 AWS 服务集成。
+ 列出、添加、更新和删除 Amazon RDS 表中的项目。
+ 使用 Amazon SES 以电子邮件发送已筛选工作项的报告。
+ 使用随附的 AWS CloudFormation 脚本部署和管理示例资源。
有关如何设置和运行的完整源代码和说明，请参阅上的完整示例[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/cross_service/aurora_item_tracker)。
**本示例中使用的服务**
+ Aurora
+ Amazon RDS
+ Amazon RDS 数据服务
+ Amazon SES
------
#### [ Python ]
**适用于 Python 的 SDK（Boto3）**
演示如何使用创建 REST 服务，该 适用于 Python (Boto3) 的 AWS SDK 服务可跟踪亚马逊 Aurora 无服务器数据库中的工作项目，并使用亚马逊简单电子邮件服务 (Amazon SES) 通过电子邮件发送报告。此示例使用 Flask Web 框架处理 HTTP 路由，并且与 React 网页集成来呈现完整功能的 Web 应用程序。
+ 构建与 AWS 服务集成的 Flask REST 服务。
+ 读取、写入和更新存储在 Aurora Serverless 数据库中的工作项。
+ 创建包含数据库凭据的 AWS Secrets Manager 密钥，并使用它来验证对数据库的调用。
+ 使用 Amazon SES 发送工作项的电子邮件报告。
有关如何设置和运行的完整源代码和说明，请参阅上的完整示例[GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/cross_service/aurora_item_tracker)。
**本示例中使用的服务**
+ Aurora
+ Amazon RDS
+ Amazon RDS 数据服务
+ Amazon SES
------