Amazon RDS 數據服務示例使用 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Amazon RDS 數據服務示例使用 AWS CLI

下列程式碼範例說明如何透過使用 Amazon RDS 資料服務來執行動作和實作常見案例。 AWS Command Line Interface

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境和跨服務範例中查看內容中的動作。

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

每個範例都包含一個連結 GitHub,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例會示範如何使用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 無伺服器使用資料 API

下列程式碼範例會示範如何使用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 無伺服器使用資料 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 無伺服器使用資料 API

下列程式碼範例會示範如何使用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 無伺服器使用資料 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 無伺服器使用資料 API