翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Step Functions を使用して DynamoDB CRUD オペレーションを実行する
Step Functions を DynamoDB と統合すると、DynamoDB テーブルで CRUD オペレーションを実行できます。このページでは、サポートされている DynamoDB API を一覧表示し、DynamoDB から項目を取得するための Task 状態の例を示します。
Step Functions での AWSサービスとの統合については、 サービスとの統合「」および「」を参照してくださいStep Functions でサービス API にパラメータを渡す。
最適化された DynamoDB 統合の主な機能
-
レスポンスのリクエスト 統合パターンに固有の最適化はありません。
-
タスクトークンのコールバックまで待機する 統合パターンはサポートされていません。
-
最適化された統合では、
GetItem、PutItem、UpdateItem、およびDeleteItemAPI アクションのみを使用できます。などの他の API アクションCreateTableは、DynamoDBAWS SDK 統合を使用して使用できます。
次に示しているのは、DynamoDB からメッセージを取得する Task ステートの例です。
"Read next Message from DynamoDB": {
"Type": "Task",
"Resource": "arn:aws:states:::dynamodb:getItem",
"Arguments": {
"TableName": "DYNAMO_DB_TABLE_NAME",
"Key": {
"MessageId": {"S": "{% $List[0] %}"}
}
}実際の例でこのステートを確認するには、Lambda、DynamoDB、および Amazon SQS を使用してデータレコードを転送する スターターテンプレートを参照してください。
例外プレフィックスの違い
標準の DynamoDB 接続でエラーが発生した場合、例外プレフィックスは DynamoDb (大文字と小文字の混在) になります。
最適化統合の場合、例外プレフィックスは DynamoDB (すべて大文字の DB) になります。
入力または結果データのクォータ
サービス間でデータを送受信する際、タスクの入力または結果の最大サイズは、UTF-8 でエンコードされた文字列で 256 KiB です。「ステートマシンの実行に関連するクォータ」を参照してください。
最適化された DynamoDB API
Step Functions のパラメータは PascalCase で表されます。
ネイティブサービス API が、API アクション startSyncExecution などの camelCase である場合でも、StateMachineArn などの PascalCase でパラメータを指定します。
DynamoDB を呼び出すための IAM ポリシー
次のサンプルテンプレートは、 がステートマシン定義のリソースに基づいて IAM ポリシーAWS Step Functionsを生成する方法を示しています。詳細については、「Step Functions が統合サービスの IAM ポリシーを生成する方法」および「Step Functions でサービス統合パターンを検出する」を参照してください。
静的リソース
-
{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dynamodb:GetItem", "dynamodb:PutItem", "dynamodb:UpdateItem", "dynamodb:DeleteItem" ], "Resource": [ "arn:aws:dynamodb:us-east-1:123456789012:table/myTableName" ] } ] }
動的リソース
-
{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dynamodb:GetItem", "dynamodb:PutItem", "dynamodb:UpdateItem", "dynamodb:DeleteItem" ], "Resource": "*" } ] }
すべての DynamoDB API アクションの IAM ポリシーの詳細については、「Amazon DynamoDB デベロッパーガイド」の「DynamoDB での IAM ポリシー」を参照してください。さらに、DynamoDB 用 PartiQL の IAM ポリシーについては、「Amazon DynamoDB DynamoDB デベロッパーガイド」の「DynamoDB 用 PartiQL の IAM ポリシー」を参照してください。