使用 的 Amazon RDS Data Service 範例 AWS CLI - AWS SDK 程式碼範例
動作

文件 AWS SDK AWS 範例 SDK 儲存庫中有更多可用的 GitHub 範例。

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

使用 的 Amazon RDS Data Service 範例 AWS CLI

下列程式碼範例示範如何搭配 AWS Command Line Interface Amazon RDS Data Service 使用 來執行動作和實作常見案例。

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

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

主題

動作

下列程式碼範例示範如何使用 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 API 使用者指南中的使用 Data Word for Aurora Serverless。 RDS

下列程式碼範例示範如何使用 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 API 使用者指南中的使用 Data Word for Aurora Serverless。 RDS

  • 如需 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 API 使用者指南中的使用 Data Word for Aurora Serverless。 RDS

  • 如需 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 API 使用者指南中的使用 Data Word for Aurora Serverless。 RDS

  • 如需 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 API 使用者指南中的使用 Data Word for Aurora Serverless。 RDS