を使用した Amazon RDS Data Service の例 AWS CLI - AWS Command Line Interface
アクション

このドキュメントは、 のバージョン 1 AWS CLI 専用です。のバージョン 2 に関連するドキュメントについては AWS CLI、バージョン 2 ユーザーガイド を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した Amazon RDS Data Service の例 AWS CLI

次のコード例は、Amazon RDS Data Service AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次のコード例は、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」の「」を参照してください。