本文档仅适用于 AWS CLI 版本 1。有关 AWS CLI 版本 2 的相关文档，请参阅版本 2 用户指南。
以下代码示例演示了如何通过将 AWS Command Line Interface与 Amazon RDS 数据服务结合使用来执行操作和实现常见场景。
操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
主题
操作
以下代码示例演示如何使用 batch-execute-statement。
- AWS CLI
-
执行批处理 SQL 语句
以下
batch-execute-statement实例使用参数集对数据数组运行批处理 SQL 语句。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\"}}]]"此命令不生成任何输出。
有关更多信息，请参阅《Amazon RDS 用户指南》中的使用 Aurora Serverless 数据 API。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 BatchExecuteStatement
。
-
以下代码示例演示如何使用 begin-transaction。
- AWS CLI
-
开始 SQL 事务
以下
begin-transaction示例运行 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"输出：
{ "transactionId": "ABC1234567890xyz" }有关更多信息，请参阅《Amazon RDS 用户指南》中的使用 Aurora Serverless 数据 API。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 BeginTransaction
。
-
以下代码示例演示如何使用 commit-transaction。
- AWS CLI
-
提交 SQL 事务
以下
commit-transaction示例结束指定的 SQL 事务并提交您在其中所做的更改。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"输出：
{ "transactionStatus": "Transaction Committed" }有关更多信息，请参阅《Amazon RDS 用户指南》中的使用 Aurora Serverless 数据 API。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 CommitTransaction
。
-
以下代码示例演示如何使用 execute-statement。
- 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。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 ExecuteStatement
。
-
以下代码示例演示如何使用 rollback-transaction。
- AWS CLI
-
回滚 SQL 事务
以下
rollback-transaction示例回滚指定的 SQL 事务。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"输出：
{ "transactionStatus": "Rollback Complete" }有关更多信息，请参阅《Amazon RDS 用户指南》中的使用 Aurora Serverless 数据 API。
-
有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 RollbackTransaction
。
-
