使用 的 Amazon RDS Data Service 範例 AWS CLI - AWS Command Line Interface
動作

本文件 AWS CLI 僅適用於 的第 1 版。如需與 第 2 版相關的文件 AWS CLI，請參閱 第 2 版使用者指南 。

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

使用 的 Amazon RDS Data Service 範例 AWS CLI

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

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

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

  • 如需API詳細資訊，請參閱 命令參考 BeginTransaction中的 。 AWS CLI

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

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

  • 如需API詳細資訊，請參閱 命令參考 ExecuteStatement中的 。 AWS CLI

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