# mulesoft Amazon Dynamodb Connector - Full Documentation # Amazon DynamoDB Connector Amazon DynamoDB Connector v1.4 Amazon DynamoDB 用 Anypoint Connector (Amazon DynamoDB Connector) を使用すると、Amazon DynamoDB API に接続できます。Amazon DynamoDB は完全に管理された NoSQL データベースサービスであり、シームレスな拡張性を備えた高速かつ予測可能なパフォーマンスを提供します。 互換性に関する情報と修正された問題については、​[「Amazon DynamoDB Connector リリースノート」](https://docs.mulesoft.com/jp/release-notes/connector/amazon-dynamodb-connector-release-notes-mule-4)​を参照してください ## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース Amazon DynamoDB Connector では、Amazon DynamoDB に接続してデータベーステーブルを作成し、次の操作を実行できます。 - 任意の量のデータを保存および取得する - あらゆるレベルの要求トラフィックに対応する - テーブルのデータとトラフィックを十分な数のサーバーに自動的に分散して、要求容量と保存されるデータ量を管理する。 Amazon Dynamo DB Connector は、一定の高速なパフォーマンスを維持しながらこれを行います。 ## [](#始める前に)始める前に この情報を使用するには、以下に精通している必要があります。 - Amazon DynamoDB API - Anypoint Connector - Mule Runtime Engine (Mule) - Mule フローの要素 - グローバル要素 - Anypoint Studio を使用した Mule アプリケーションの作成方法 アプリケーションを作成する前に、以下にアクセスできる必要があります。 - Amazon DynamoDB - AWS Identity and Access Management (IAM) ユーザーアカウントのログイン情報 - Anypoint Studio バージョン 7.0 以降 ## [](#対象者)対象者 - 初心者ユーザー Mule アプリケーションを作成するには、​[「Anypoint Studio を使用した Amazon DynamoDB Connector の設定」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-studio)​を参照してください。​[「例」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-examples)​トピックには、コネクタの 1 つ以上のユースケースがあります。 - パワーユーザー [「XML および Maven サポート」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-xml-maven)​トピックと​[「例」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-examples)​トピックを参照してください。 ## [](#認証種別)認証種別 Amazon DynamoDB Connector では、基本認証種別とロール認証種別がサポートされています。これらの認証種別の設定についての詳細は、​[「Anypoint Studio を使用した Amazon DynamoDB Connector の設定」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-studio)​を参照してください。 ## [](#次のステップ)次のステップ 前提条件を満たし、テンプレートおよびサンプルを試したら、Anypoint Studio を使用して新しいアプリケーションを作成できます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [Anypoint Studio を使用した Amazon DynamoDB Connector の設定](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-studio) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon DynamoDB Connector Amazon DynamoDB Connector v1.4 Amazon DynamoDB 用 Anypoint Connector (Amazon DynamoDB Connector) を使用すると、Amazon DynamoDB API に接続できます。Amazon DynamoDB は完全に管理された NoSQL データベースサービスであり、シームレスな拡張性を備えた高速かつ予測可能なパフォーマンスを提供します。 互換性に関する情報と修正された問題については、​[「Amazon DynamoDB Connector リリースノート」](https://docs.mulesoft.com/jp/release-notes/connector/amazon-dynamodb-connector-release-notes-mule-4)​を参照してください ## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース Amazon DynamoDB Connector では、Amazon DynamoDB に接続してデータベーステーブルを作成し、次の操作を実行できます。 - 任意の量のデータを保存および取得する - あらゆるレベルの要求トラフィックに対応する - テーブルのデータとトラフィックを十分な数のサーバーに自動的に分散して、要求容量と保存されるデータ量を管理する。 Amazon Dynamo DB Connector は、一定の高速なパフォーマンスを維持しながらこれを行います。 ## [](#始める前に)始める前に この情報を使用するには、以下に精通している必要があります。 - Amazon DynamoDB API - Anypoint Connector - Mule Runtime Engine (Mule) - Mule フローの要素 - グローバル要素 - Anypoint Studio を使用した Mule アプリケーションの作成方法 アプリケーションを作成する前に、以下にアクセスできる必要があります。 - Amazon DynamoDB - AWS Identity and Access Management (IAM) ユーザーアカウントのログイン情報 - Anypoint Studio バージョン 7.0 以降 ## [](#対象者)対象者 - 初心者ユーザー Mule アプリケーションを作成するには、​[「Anypoint Studio を使用した Amazon DynamoDB Connector の設定」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-studio)​を参照してください。​[「例」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-examples)​トピックには、コネクタの 1 つ以上のユースケースがあります。 - パワーユーザー [「XML および Maven サポート」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-xml-maven)​トピックと​[「例」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-examples)​トピックを参照してください。 ## [](#認証種別)認証種別 Amazon DynamoDB Connector では、基本認証種別とロール認証種別がサポートされています。これらの認証種別の設定についての詳細は、​[「Anypoint Studio を使用した Amazon DynamoDB Connector の設定」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-studio)​を参照してください。 ## [](#次のステップ)次のステップ 前提条件を満たし、テンプレートおよびサンプルを試したら、Anypoint Studio を使用して新しいアプリケーションを作成できます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Exchange を使用したコネクタ、テンプレート、およびサンプルの検出](https://docs.mulesoft.com/connectors/introduction/intro-use-exchange) - [Anypoint Studio を使用した Amazon DynamoDB Connector の設定](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-studio) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon DynamoDB Connector リファレンス Amazon DynamoDB Connector v1.4 リリースノート: [Amazon DynamoDB Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-dynamodb-connector-release-notes-mule-4) ## [](#設定)設定 * * * ### [](#config)デフォルト設定 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。

#### [](#接続種別)接続種別 ##### [](#config_basic)Basic (基本) ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

Amazon STS が提供するセッショントークン。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を true に設定します。​https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/credentials.html​ を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。

##### [](#config_role)ロール ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Role ARN (ロール ARN)

String (文字列)

ロール ARN は、クロスアカウントアクセスを取得することを前提とするロールを一意に特定します。

x

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を true に設定します。​https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/credentials.html​ を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。

### [](#streams-config)ストリーム設定 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。

#### [](#接続種別-2)接続種別 ##### [](#streams-config_streams)Streams (ストリーム) ###### [](#サポートされている操作)サポートされている操作 - [Describe Stream](#describeStream) - [Get Records](#getRecords) - [Get Shard Iterator](#getShardIterator) - [List Streams](#listStreams) ###### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

Amazon STS が提供するセッショントークン。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を true に設定します。​https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/credentials.html​ を参照してください。

false

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。

## [](#操作)操作 - [Batch Delete Item](#batchDeleteItem) - [Batch Get Item](#batchGetItem) - [Batch Put Item](#batchPutItem) - [Create Table](#createTable) - [Delete Item](#deleteItem) - [Delete Table](#deleteTable) - [Describe Table](#describeTable) - [Get Item](#getItem) - [List Tables](#listTables) - [Put Item](#putItem) - [Query](#query) - [Scan](#scan) - [Update Item](#updateItem) - [Update Table](#updateTable) ### [](#batchDeleteItem)Batch Delete Item `` Batch Delete Item 操作は、1 つ以上のテーブルの複数の項目を削除します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchWriteItem.html)​でこの操作を参照してください。 #### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Request Delete Items (削除要求項目)

Object (オブジェクト)

テーブルから削除する 1 つ以上の項目。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力)出力

型

Batch Write Item Result (項目のバッチ書き込み結果)

Attributes Type (属性型)

### [](#次の設定の場合)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#batchGetItem)Batch Get Item `` Batch Get Item 操作は、1 つ以上のテーブルから 1 つ以上の項目の属性を返します。要求された項目は主キーで識別します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchGetItem.html)​でこの操作を参照してください。 #### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Request Items (要求項目)

Object (オブジェクト)

1 つ以上のテーブル名のマップ、および各テーブルでそのテーブルから取得する 1 つ以上の項目を記述するマップ。

x

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベルを決定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-2)出力

型

Batch Get Item Result (項目のバッチ取得結果)

Attributes Type (属性型)

### [](#次の設定の場合-2)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-2)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#batchPutItem)Batch Put Item `` Batch Put Item 操作は、1 つ以上のテーブルに複数の項目を配置します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchWriteItem.html)​でこの操作を参照してください。 #### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Request Put Items (配置項目を要求)

Object (オブジェクト)

テーブルに挿入する 1 つ以上の項目。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-3)出力

型

Batch Write Item Result (項目のバッチ書き込み結果)

Attributes Type (属性型)

### [](#次の設定の場合-3)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-3)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#createTable)Create Table `` Create Table 操作は、アカウントに新規テーブルを追加します。AWS アカウントでは、テーブル名は各リージョン内で一意である必要があります。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html)​でこの操作を参照してください。 #### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

作成するテーブルの名前。

x

Attribute Definitions (属性定義)

テーブルとインデックスのキースキーマを記述する属性の配列。

x

Key Schemas (キースキーマ)

テーブルまたはインデックスの主キーを構成する属性を指定します。

x

Read Capacity Units (読み取り容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りの最大数。

x

Write Capacity Units (書き込み容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの書き込みの最大数。

x

Global Secondary Indexes (グローバルセカンダリインデックス)

テーブルに作成される 1 つ以上のグローバルセカンダリインデックス (最大 5 個)。

Local Secondary Indexes (ローカルセカンダリインデックス)

テーブルに作成される 1 つ以上のローカルセカンダリインデックス (最大 5 個)。

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

テーブル内の項目が変更されると、StreamViewType によってテーブルのストリームに書き込まれる情報が決まります。

Stream Enabled (ストリーム有効)

Boolean (ブール)

ストリームを有効 (true) にするか無効 (false) にするかを示します。

false

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-4)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-4)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-4)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#deleteItem)Delete Item `` この操作は、テーブルの 1 つの項目を主キーで削除します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)​でこの操作を参照してください。 #### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

テーブル名。

x

Primarykey

Object (オブジェクト)

主キー名と値のマップ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-5)出力

型

Delete Item Result (項目の削除結果)

Attributes Type (属性型)

### [](#次の設定の場合-5)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-5)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#deleteTable)Delete Table `` Delete Table 操作は、テーブルとそのすべての項目を削除します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html)​でこの操作を参照してください。 #### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

削除するテーブルの名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-6)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-6)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-6)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#describeTable)Describe Table `` この操作は、テーブルの現在の状況、作成日、主キースキーマ、テーブルのインデックスなど、テーブルに関する情報を返します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html)​でこの操作を参照してください。 #### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

記述するテーブルの名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-7)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-7)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-7)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#getItem)Get Item `` Get Item 操作は、指定された主キーを持つ項目の一連の属性を返します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_GetItem.html)​でこの操作を参照してください。 #### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

要求された項目を含むテーブルの名前。

x

Key (キー)

Object (オブジェクト)

取得する項目の主キーを表す、AttributeValue オブジェクトへの属性名のマップ。

#[payload]

Attributes To Gets (取得する属性)

Array of String (文字列の配列)

これはレガシーパラメーターです。代わりに ProjectionExpression を使用します。

Consistent Read (一貫性読み取り)

Boolean (ブール)

読み取り一貫性モデルを決定します。true に設定されている場合、この操作は厳密な一貫性読み取りを使用します。それ以外の場合、この操作は最終的な一貫性読み取りを使用します。

false

Expression Attribute Names (式の属性名)

Object (オブジェクト)

式の属性名に対する 1 つ以上の代用トークン。ExpressionAttributeNames のユースケースのいくつかを次に示します。

Projection Expression (射影式)

String (文字列)

テーブルから取得する 1 つ以上の属性を識別する文字列。

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベルを決定します。

None (なし)

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-8)出力

型

Get Item Result (項目の取得結果)

Attributes Type (属性型)

### [](#次の設定の場合-8)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-8)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#listTables)List Tables `` この操作は、現在のアカウントとエンドポイントに関連付けられたテーブル名の配列を返します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListTables.html)​でこの操作を参照してください。 #### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Exclusive Start Table Name (排他開始テーブル名)

String (文字列)

この操作が評価する最初のテーブル名。以前の操作で LastEvaluatedTableName に返された値を使用します。

Limit (制限)

Number (数値)

返すテーブル名の最大数。このパラメーターが指定されていない場合、制限は 100 です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-9)出力

型

List Tables Result (リストテーブル結果)

Attributes Type (属性型)

### [](#次の設定の場合-9)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-9)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#putItem)Put Item `` この操作は、新しい項目を作成するか、古い項目を新しい項目に置き換えます。指定されたテーブルに新しい項目と主キーが同じ項目がすでに存在する場合、新しい項目で既存の項目が置き換えられます。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)​でこの操作を参照してください。 #### [](#パラメーター-15)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

テーブル名。

x

Item (項目)

Object (オブジェクト)

挿入する項目。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-10)出力

型

Put Item Result (項目の配置結果)

Attributes Type (属性型)

### [](#次の設定の場合-10)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-10)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#query)Query `` Query 操作は、主キー値に基づいて項目を見つけます。複合主キー (パーティションキーと並び替えキー) を持つテーブルまたはセカンダリインデックスを照会できます。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html)​でこの操作を参照してください。 #### [](#パラメーター-16)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Key Condition Expression (キー条件式)

String (文字列)

Query アクションによって取得される項目のキー値を指定する条件。

Key Conditions (キー条件)

Object (オブジェクト)

これはレガシーパラメーターです。代わりに KeyConditionExpression を使用します。

Scan Index Forward (インデックス前方スキャン)

Boolean (ブール)

インデックス走査の順序を指定します。true (デフォルト) の場合、走査は昇順で実行されます。false の場合、操作は降順で実行されます。

false

Select

Enumeration (列挙)。次のいずれかになります。

  • ALL_ATTRIBUTES​

  • ALL_PROJECTED_ATTRIBUTES​

  • SPECIFIC_ATTRIBUTES​

  • COUNT

結果で返される属性。

Attribute Names (属性名)

Object (オブジェクト)

式の属性名に対する 1 つ以上の代用トークン。

Attribute Values (属性値)

Object (オブジェクト)

式で代入する 1 つ以上の値。

Table Name (テーブル名)

String (文字列)

要求された項目を含むテーブルの名前。

x

Attributes To Gets (取得する属性)

Array of String (文字列の配列)

これはレガシーパラメーターです。代わりに [Projection Expression (射影式)] 項目を使用します。

Conditional Operator (条件演算子)

Enumeration (列挙)。次のいずれかになります。

  • AND

  • または

条件に適用する論理演算子。

Consistent Read (一貫性読み取り)

Boolean (ブール)

読み取り一貫性モデルを決定します。true に設定されている場合、この操作は厳密な一貫性読み取りを使用します。それ以外の場合、この操作は最終的な一貫性読み取りを使用します。

false

Exclusive Start Key (排他開始キー)

Object (オブジェクト)

この操作で評価する最初の項目の主キー。

Filter Expression (検索条件式)

String (文字列)

操作後、データが返される前に DynamoDB で適用される条件を含む文字列。条件を満たさない項目は返されません。

Index Name (インデックス名)

String (文字列)

スキャンするセカンダリインデックスの名前。このインデックスは、任意のローカルセカンダリインデックスまたはグローバルセカンダリインデックスにすることができます。

Limit (制限)

Number (数値)

評価する項目の最大数 (一致する項目の数とは限りません)。

Projection Expression (射影式)

String (文字列)

テーブルから取得する 1 つ以上の属性を識別する文字列。

Condition Filter (条件)

Object (オブジェクト)

項目が読み取られた後にクエリ結果を評価し、目的の値のみを返す条件。

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベル。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-11)出力

型

Query Result (クエリ結果)

Attributes Type (属性型)

### [](#次の設定の場合-11)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-11)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#scan)Scan `` Scan 操作は、テーブルまたはセカンダリインデックスのすべての項目にアクセスすることで、1 つ以上の項目と項目属性を返します。DynamoDB から返される項目数を減らすには、Filter Expression 操作を指定します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Scan.html)​でこの操作を参照してください。 #### [](#パラメーター-17)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Segment (セグメント)

Number (数値)

並列スキャン要求の場合、セグメントを使用して、アプリケーションワーカーがスキャンする個々のセグメントを識別します。

Select

Enumeration (列挙)。次のいずれかになります。

  • ALL_ATTRIBUTES​

  • ALL_PROJECTED_ATTRIBUTES​

  • SPECIFIC_ATTRIBUTES​

  • COUNT

結果で返される属性。

Total Segments (セグメント総数)

Number (数値)

並列スキャン要求の場合、TotalSegments は Scan 操作によって分割されるセグメントの総数を表します。

Attribute Names (属性名)

Object (オブジェクト)

式の属性名に対する 1 つ以上の代用トークン。

Attribute Values (属性値)

Object (オブジェクト)

式で代入する 1 つ以上の値。

Table Name (テーブル名)

String (文字列)

要求された項目を含むテーブルの名前。

x

Attributes To Gets (取得する属性)

Array of String (文字列の配列)

これはレガシー項目です。代わりに [Projection Expression (射影式)] 項目を使用します。

Conditional Operator (条件演算子)

Enumeration (列挙)。次のいずれかになります。

  • AND

  • または

条件に適用する論理演算子。

Consistent Read (一貫性読み取り)

Boolean (ブール)

読み取り一貫性モデルを決定します。true に設定されている場合、この操作は厳密な一貫性読み取りを使用します。それ以外の場合、この操作は最終的な一貫性読み取りを使用します。

false

Exclusive Start Key (排他開始キー)

Object (オブジェクト)

この操作で評価する最初の項目の主キー。

Filter Expression (検索条件式)

String (文字列)

操作後、データが返される前に DynamoDB で適用される条件を含む文字列。条件を満たさない項目は返されません。

Index Name (インデックス名)

String (文字列)

スキャンするセカンダリインデックスの名前。このインデックスは、任意のローカルセカンダリインデックスまたはグローバルセカンダリインデックスにすることができます。

Limit (制限)

Number (数値)

評価する項目の最大数 (一致する項目の数とは限りません)。

Projection Expression (射影式)

String (文字列)

テーブルから取得する 1 つ以上の属性を識別する文字列。

Condition Filter (条件)

Object (オブジェクト)

項目が読み取られた後にクエリ結果を評価し、目的の値のみを返す条件。

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベル。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-12)出力

型

Scan Result (スキャン結果)

Attributes Type (属性型)

### [](#次の設定の場合-12)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-12)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#updateItem)Update Item `` この操作は、既存の項目の属性を編集するか、テーブルに新しい項目がまだない場合は追加します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)​でこの操作を参照してください。 #### [](#パラメーター-18)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

テーブル名。

x

Key (キー)

Object (オブジェクト)

主キー。

#[payload]

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベルを決定します。

Return Item Collection Metrics (項目コレクションメトリクスを返す)

Enumeration (列挙)。次のいずれかになります。

  • SIZE

  • None (なし)

項目コレクションメトリクスが返されるかどうかを決定します。

Return Values (戻り値)

Enumeration (列挙)。次のいずれかになります。

  • None (なし)

  • ALL_OLD​

  • UPDATED_OLD​

  • ALL_NEW​

  • UPDATED_NEW

項目属性が更新される前または後に表示される項目属性を取得する場合に使用します。

Update Expression (更新式)

String (文字列)

更新される 1 つ以上の属性、それらに対して実行されるアクション、それらの新しい値を定義する式。

Attribute Updates (属性の更新)

Object (オブジェクト)

これはレガシーパラメーターです。代わりに updateExpression を使用します。

Expected (想定)

Object (オブジェクト)

これはレガシーパラメーターです。代わりに conditionExpression を使用します。

Conditional Operator (条件演算子)

Enumeration (列挙)。次のいずれかになります。

  • AND

  • または

Condition Expression (条件式)

String (文字列)

Attribute Names (属性名)

Object (オブジェクト)

Attribute Values (属性値)

Object (オブジェクト)

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-13)出力

型

Update Item Result (項目の更新結果)

Attributes Type (属性型)

### [](#次の設定の場合-13)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-13)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#updateTable)Update Table `` この操作は、特定のテーブルのプロビジョニングされたスループット設定、グローバルセカンダリインデックス、または DynamoDB ストリーム設定を変更します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)​でこの操作を参照してください。 #### [](#パラメーター-19)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

更新するテーブルの名前。

x

Attribute Definitions (属性定義)

テーブルとインデックスのキースキーマを記述する属性の配列。テーブルに新しいグローバルセカンダリインデックスを追加する場合、AttributeDefinitions に新しいインデックスのキー要素を含める必要があります。

Read Capacity Units (読み取り容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りの最大数。

Write Capacity Units (書き込み容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの書き込みの最大数。

Global Secondary Index Updates (グローバルセカンダリインデックスの更新)

テーブルの 1 つ以上のグローバルセカンダリインデックスの配列。

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

テーブル内の項目が変更されると、StreamViewType によってこのテーブルのストリームに書き込まれる情報が決まります。

Stream Enabled (ストリーム有効)

Boolean (ブール)

DynamoDB ストリームが有効 (true) か無効 (false) かを示します。

false

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-14)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-14)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-14)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#describeStream)Describe Stream `` #### [](#パラメーター-20)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Stream ARN (ストリーム ARN)

String (文字列)

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-15)出力

型

Stream Description (ストリームの説明)

Attributes Type (属性型)

### [](#次の設定の場合-15)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-15)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#getRecords)Get Records `` #### [](#パラメーター-21)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Shard Iterator (シャードイテレーター)

String (文字列)

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-16)出力

型

Record (レコード)​ ペイロードおよび ​Request ID Attribute (要求 ID 属性)​ 属性のメッセージの配列

### [](#次の設定の場合-16)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-16)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#getShardIterator)Get Shard Iterator `` #### [](#パラメーター-22)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Shard Id (シャード ID)

String (文字列)

x

Shard Iterator Type (シャードイテレーター種別)

String (文字列)

x

Starting Sequence Number (開始連番)

String (文字列)

Stream ARN (ストリーム ARN)

String (文字列)

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-17)出力

型

String (文字列)

Attributes Type (属性型)

### [](#次の設定の場合-17)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-17)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#listStreams)List Streams `` #### [](#パラメーター-23)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-18)出力

型

[​Stream (ストリーム)​] ペイロードおよび​Request ID Attribute (要求 ID 属性)​属性のメッセージの配列

### [](#次の設定の場合-18)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-18)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ## [](#型)型 ### [](#Tls)TLS
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

Key Store (キーストア)

Revocation Check (取り消し確認)

### [](#TrustStore)トラストストア
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

使用するストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用するアルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。

### [](#KeyStore)Key Store (キーストア)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。

Type (型)

String (文字列)

使用するストアの型。

Alias (別名)

String (文字列)

キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、デフォルトでファイル内の最初の鍵が使用されます。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用するアルゴリズム。

### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーンの最後の要素のみを確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

最初に OCSP ではなく CRL を試みます。

No Fallback (代替なし)

Boolean (ブール)

第 2 の確認方法 (以前に選択されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。

### [](#custom-ocsp-responder)Custom OCSP Responder (カスタム OCSP レスポンダー)
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。

### [](#crl-file)CRL File (CRL ファイル)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

### [](#Reconnection)Reconnection (再接続)
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

### [](#reconnect)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位

### [](#BatchWriteItemResult)Batch Write Item Result (項目のバッチ書き込み結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

Object (オブジェクト)

Unprocessed Items (未処理項目)

Object (オブジェクト)

### [](#ConsumedCapacity)Consumed Capacity (コンシューム容量)
項目 型 説明 デフォルト値 必須

Capacity Units (容量単位)

Number (数値)

Global Secondary Indexes (グローバルセカンダリインデックス)

Object (オブジェクト)

Local Secondary Indexes (ローカルセカンダリインデックス)

Object (オブジェクト)

Table (テーブル)

Number (数値)

Table Name (テーブル名)

String (文字列)

### [](#RequestIDAttribute)Request ID Attribute (要求 ID 属性)
項目 型 説明 デフォルト値 必須

Request Id (要求 ID)

String (文字列)

### [](#BatchGetItemResult)Batch Get Item Result (項目のバッチ取得結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Responses (応答)

Object (オブジェクト)

Unprocessed Keys (未処理キー)

Object (オブジェクト)

### [](#TableDescription)Table Description (テーブルの説明)
項目 型 説明 デフォルト値 必須

Attribute Definitions (属性定義)

Creation Date Time (作成日時)

DateTime

Global Secondary Indexes (グローバルセカンダリインデックス)

Item Count (項目数)

Number (数値)

Key Schema (キースキーマ)

Latest Stream Arn (最新のストリーム ARN)

String (文字列)

Latest Stream Label (最新のストリーム表示ラベル)

String (文字列)

Local Secondary Indexes (ローカルセカンダリインデックス)

Provisioned Throughput (プロビジョニングされたスループット)

Stream Specification (ストリーム仕様)

Table Arn (テーブル ARN)

String (文字列)

Table Name (テーブル名)

String (文字列)

Table Size Bytes (テーブルサイズ (バイト))

Number (数値)

Table Status (テーブル状況)

String (文字列)

### [](#AttributeDefinition)Attribute Definitions (属性定義)
項目 型 説明 デフォルト値 必須

Attribute Name (属性名)

String (文字列)

Attribute Type (属性型)

Enumeration (列挙)。次のいずれかになります。

  • STRING

  • NUMBER

  • BINARY

### [](#GlobalSecondaryIndexDescription)Global Secondary Index Description (グローバルセカンダリインデックスの説明)
項目 型 説明 デフォルト値 必須

Backfilling (バックフィル)

Boolean (ブール)

Index Arn (インデックス ARN)

String (文字列)

Index Name (インデックス名)

String (文字列)

Index Size Bytes (インデックスサイズ (バイト))

Number (数値)

Index Status (インデックス状況)

Enumeration (列挙)。次のいずれかになります。

  • CREATING

  • UPDATING

  • DELETING

  • ACTIVE

Item Count (項目数)

Number (数値)

Key Schema (キースキーマ)

Projection (射影)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#KeySchemaElement)Key Schema Element (キースキーマ要素)
項目 型 説明 デフォルト値 必須

Attribute Name (属性名)

String (文字列)

Key Type (キー種別)

Enumeration (列挙)。次のいずれかになります。

  • HASH

  • RANGE

### [](#Projection)Projection (射影)
項目 型 説明 デフォルト値 必須

Non Key Attributes (非キー属性)

Array of String (文字列の配列)

Projection Type (射影種別)

Enumeration (列挙)。次のいずれかになります。

  • ALL (すべて)

  • KEYS_ONLY​

  • INCLUDE

### [](#ProvisionedThroughputDescription)Provisioned Throughput Description (プロビジョニングされたスループットの説明)
項目 型 説明 デフォルト値 必須

Last Decrease Date Time (最終減少日時)

DateTime

Last Increase Date Time (最終増加日時)

DateTime

Number Of Decreases Today (今日の減少数)

Number (数値)

Read Capacity Units (読み取り容量単位)

Number (数値)

Write Capacity Units (書き込み容量単位)

Number (数値)

### [](#LocalSecondaryIndexDescription)Local Secondary Index Description (ローカルセカンダリインデックスの説明)
項目 型 説明 デフォルト値 必須

Index Arn (インデックス ARN)

String (文字列)

Index Name (インデックス名)

String (文字列)

Index Size Bytes (インデックスサイズ (バイト))

Number (数値)

Item Count (項目数)

Number (数値)

Key Schema (キースキーマ)

Projection (射影)

### [](#StreamSpecification)Stream Specification (ストリーム仕様)
項目 型 説明 デフォルト値 必須

Stream Enabled (ストリーム有効)

Boolean (ブール)

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

### [](#GlobalSecondaryIndex)Global Secondary Index (グローバルセカンダリインデックス)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Key Schema (キースキーマ)

Projection (射影)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#ProvisionedThroughput)Provisioned Throughput (プロビジョニングされたスループット)
項目 型 説明 デフォルト値 必須

Read Capacity Units (読み取り容量単位)

Number (数値)

Write Capacity Units (書き込み容量単位)

Number (数値)

### [](#LocalSecondaryIndex)Local Secondary Index (ローカルセカンダリインデックス)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Key Schema (キースキーマ)

Projection (射影)

### [](#DeleteItemResult)Delete Item Result (項目の削除結果)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

### [](#ItemCollectionMetrics)Item Collection Metrics (項目コレクションメトリクス)
項目 型 説明 デフォルト値 必須

Item Collection Key (項目コレクションキー)

Object (オブジェクト)

Size Estimate Range GB (サイズ見積範囲 GB)

Array of Number (数値の配列)

### [](#GetItemResult)Get Item Result (項目の取得結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Item (項目)

Object (オブジェクト)

### [](#ListTablesResult)List Tables Result (リストテーブル結果)
項目 型 説明 デフォルト値 必須

Last Evaluated Table Name (最終評価テーブル名)

String (文字列)

Table Names (テーブル名)

Array of String (文字列の配列)

### [](#PutItemResult)Put Item Result (項目の配置結果)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

### [](#QueryResult)Query Result (クエリ結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Count (数)

Number (数値)

Items (項目)

Array of Object (オブジェクトの配列)

Last Evaluated Key (最終評価キー)

Object (オブジェクト)

Scanned Count (スキャン数)

Number (数値)

### [](#ScanResult)Scan Result (スキャン結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Count (数)

Number (数値)

Items (項目)

Array of Object (オブジェクトの配列)

Last Evaluated Key (最終評価キー)

Object (オブジェクト)

Scanned Count (スキャン数)

Number (数値)

### [](#UpdateItemResult)Update Item Result (項目の更新結果)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

### [](#GlobalSecondaryIndexUpdate)Global Secondary Index Update (グローバルセカンダリインデックスの更新)
項目 型 説明 デフォルト値 必須

Create (作成)

Delete (削除)

String (文字列)

Update (更新)

### [](#CreateGlobalSecondaryIndexAction)Create Global Secondary Index Action (グローバルセカンダリインデックスの作成アクション)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Key Schema (キースキーマ)

Projection (射影)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#UpdateGlobalSecondaryIndexAction)Update Global Secondary Index Action (グローバルセカンダリインデックスの更新アクション)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#StreamDescription)Stream Description (ストリームの説明)
項目 型 説明 デフォルト値 必須

Creation Request Date Time (作成要求日時)

DateTime

Key Schema (キースキーマ)

Last Evaluated Shard Id (最終評価シャード ID)

String (文字列)

Shards (シャード)

Shard (シャード)​ の配列

Stream Arn (ストリーム ARN)

String (文字列)

Stream Label (ストリーム表示ラベル)

String (文字列)

Stream Status (ストリーム状況)

Enumeration (列挙)。次のいずれかになります。

  • ENABLING

  • ENABLED

  • DISABLING

  • DISABLED

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

Table Name (テーブル名)

String (文字列)

### [](#Shard)Shard (シャード)
項目 型 説明 デフォルト値 必須

Parent Shard Id (親シャード ID)

String (文字列)

Sequence Number Range (連番範囲)

Shard Id (シャード ID)

String (文字列)

### [](#SequenceNumberRange)Sequence Number Range (連番範囲)
項目 型 説明 デフォルト値 必須

Ending Sequence Number (終了連番)

String (文字列)

Starting Sequence Number (開始連番)

String (文字列)

### [](#Record)Record (レコード)
項目 型 説明 デフォルト値 必須

Aws Region (AWS リージョン)

String (文字列)

Dynamodb

Event ID (イベント ID)

String (文字列)

Event Name (イベント名)

Enumeration (列挙)。次のいずれかになります。

  • INSERT

  • MODIFY

  • REMOVE

Event Source (イベント取得元)

String (文字列)

Event Version (イベントバージョン)

String (文字列)

User Identity (ユーザー ID)

### [](#StreamRecord)Stream Record (ストリームレコード)
項目 型 説明 デフォルト値 必須

Approximate Creation Date Time (おおよその作成日時)

DateTime

Keys (キー)

Object (オブジェクト)

New Image (新しい画像)

Object (オブジェクト)

Old Image (古い画像)

Object (オブジェクト)

Sequence Number (連番)

String (文字列)

Size Bytes (サイズ (バイト))

Number (数値)

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

### [](#Identity)Identity (ID)
項目 型 説明 デフォルト値 必須

Principal Id (プリンシパル ID)

String (文字列)

Type (型)

String (文字列)

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンスの量。ストリームのデータ量がこのバッファサイズを超える場合は、bufferSizeIncrement 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。デフォルト値は 100 インスタンスです。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

メモリ内に保持されるインスタンスの最大数。これ以上の量が必要な場合、コンテンツはディスク上にバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

maxInMemorySize で表される単位

### [](#Stream)Stream (ストリーム)
項目 型 説明 デフォルト値 必須

Stream Arn (ストリーム ARN)

String (文字列)

Stream Label (ストリーム表示ラベル)

String (文字列)

Table Name (テーブル名)

String (文字列)

## [](#関連情報)関連情報 [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon DynamoDB Connector リファレンス Amazon DynamoDB Connector v1.4 リリースノート: [Amazon DynamoDB Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/amazon-dynamodb-connector-release-notes-mule-4) ## [](#設定)設定 * * * ### [](#config)デフォルト設定 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。

#### [](#接続種別)接続種別 ##### [](#config_basic)Basic (基本) ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

Amazon STS が提供するセッショントークン。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Connection Timeout Unit (接続タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Connection Timeout (接続タイムアウト)]​ 項目の時間単位。

SECONDS

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Socket Timeout Unit (ソケットタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Socket Timeout (ソケットタイムアウト)]​ 項目の時間単位。

SECONDS

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を true に設定します。​https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/credentials.html​ を参照してください。

false

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。

##### [](#config_role)ロール ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Role ARN (ロール ARN)

String (文字列)

ロール ARN は、クロスアカウントアクセスを取得することを前提とするロールを一意に特定します。

x

Custom STS Endpoint (カスタム STS エンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Connection Timeout Unit (接続タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Connection Timeout (接続タイムアウト)]​ 項目の時間単位。

SECONDS

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Socket Timeout Unit (ソケットタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Socket Timeout (ソケットタイムアウト)]​ 項目の時間単位。

SECONDS

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を true に設定します。​https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/credentials.html​ を参照してください。

false

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。

### [](#streams-config)ストリーム設定 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。

#### [](#接続種別-2)接続種別 ##### [](#streams-config_streams)Streams (ストリーム) ###### [](#サポートされている操作)サポートされている操作 - [Describe Stream](#describeStream) - [Get Records](#getRecords) - [Get Shard Iterator](#getShardIterator) - [List Streams](#listStreams) ###### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Session Token (セッショントークン)

String (文字列)

Amazon STS が提供するセッショントークン。

Connection Timeout (接続タイムアウト)

Number (数値)

コネクタがギブアップまたはタイムアウトする前に、接続を最初に確立するのを待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Connection Timeout Unit (接続タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Connection Timeout (接続タイムアウト)]​ 項目の時間単位。

SECONDS

Max Connections (最大接続数)

Number (数値)

許可される開いた HTTP 接続の最大数を設定します。

Socket Timeout (ソケットタイムアウト)

Number (数値)

接続がタイムアウトする前に、確立または開いた接続でのデータの転送を待機する時間 (ミリ秒)。値 0 は無限を意味するため、お勧めできません。

50000

Socket Timeout Unit (ソケットタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Socket Timeout (ソケットタイムアウト)]​ 項目の時間単位。

SECONDS

Access Key (アクセスキー)

String (文字列)

Amazon が提供するアクセスキー。

x

Secret Key (シークレットキー)

String (文字列)

Amazon が提供するシークレットキー。

x

Try Default AWSCredentials Provider Chain (デフォルトの AWSCredentials プロバイダーチェーンを試す)

Boolean (ブール)

AWS 環境からログイン情報を取得するには、この項目を true に設定します。​https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/credentials.html​ を参照してください。

false

Custom Service Endpoint (カスタムサービスエンドポイント)

String (文字列)

カスタムサービスエンドポイントを設定します。VPC エンドポイントなど、非標準のサービスエンドポイントが必要な場合に役立ちます。ローカル接続の場合、この項目を ​http://localhost:8000/​ に設定します。

Region Endpoint (リージョンエンドポイント)

String (文字列)

トピックリージョンエンドポイントを設定します。

US_EAST_1

TLS Configuration (TLS 設定)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Host (ホスト)

String (文字列)

省略可能なプロキシホスト。

Port (ポート)

Number (数値)

省略可能なプロキシポート。

Username (ユーザー名)

String (文字列)

省略可能なプロキシユーザー名。

Password (パスワード)

String (文字列)

省略可能なプロキシパスワード。

Domain (ドメイン)

String (文字列)

省略可能なプロキシドメイン。

Workstation (ワークステーション)

String (文字列)

省略可能なプロキシワークステーション。

## [](#操作)操作 - [Batch Delete Item](#batchDeleteItem) - [Batch Get Item](#batchGetItem) - [Batch Put Item](#batchPutItem) - [Create Table](#createTable) - [Delete Item](#deleteItem) - [Delete Table](#deleteTable) - [Describe Table](#describeTable) - [Get Item](#getItem) - [List Tables](#listTables) - [Paginated Query](#paginatedQuery) - [Put Item](#putItem) - [Query](#query) - [Scan](#scan) - [Update Item](#updateItem) - [Update Table](#updateTable) ### [](#batchDeleteItem)Batch Delete Item `` Batch Delete Item 操作は、1 つ以上のテーブルの複数の項目を削除します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchWriteItem.html)​でこの操作を参照してください。 #### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Request Delete Items (削除要求項目)

Object (オブジェクト)

テーブルから削除する 1 つ以上の項目。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力)出力

型

Batch Write Item Result (項目のバッチ書き込み結果)

Attributes Type (属性型)

### [](#次の設定の場合)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#batchGetItem)Batch Get Item `` Batch Get Item 操作は、1 つ以上のテーブルから 1 つ以上の項目の属性を返します。要求された項目は主キーで識別します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchGetItem.html)​でこの操作を参照してください。 #### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Request Items (要求項目)

Object (オブジェクト)

1 つ以上のテーブル名のマップ、および各テーブルでそのテーブルから取得する 1 つ以上の項目を記述するマップ。

x

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベルを決定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-2)出力

型

Batch Get Item Result (項目のバッチ取得結果)

Attributes Type (属性型)

### [](#次の設定の場合-2)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-2)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#batchPutItem)Batch Put Item `` Batch Put Item 操作は、1 つ以上のテーブルに複数の項目を配置します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchWriteItem.html)​でこの操作を参照してください。 #### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Request Put Items (配置項目を要求)

Object (オブジェクト)

テーブルに挿入する 1 つ以上の項目。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-3)出力

型

Batch Write Item Result (項目のバッチ書き込み結果)

Attributes Type (属性型)

### [](#次の設定の場合-3)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-3)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#createTable)Create Table `` Create Table 操作は、アカウントに新規テーブルを追加します。AWS アカウントでは、テーブル名は各リージョン内で一意である必要があります。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html)​でこの操作を参照してください。 #### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

作成するテーブルの名前。

x

Attribute Definitions (属性定義)

テーブルとインデックスのキースキーマを記述する属性の配列。

x

Key Schemas (キースキーマ)

テーブルまたはインデックスの主キーを構成する属性を指定します。

x

Read Capacity Units (読み取り容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りの最大数。

x

Write Capacity Units (書き込み容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの書き込みの最大数。

x

Global Secondary Indexes (グローバルセカンダリインデックス)

テーブルに作成される 1 つ以上のグローバルセカンダリインデックス (最大 5 個)。

Local Secondary Indexes (ローカルセカンダリインデックス)

テーブルに作成される 1 つ以上のローカルセカンダリインデックス (最大 5 個)。

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

テーブル内の項目が変更されると、StreamViewType によってテーブルのストリームに書き込まれる情報が決まります。

Stream Enabled (ストリーム有効)

Boolean (ブール)

ストリームを有効 (true) にするか無効 (false) にするかを示します。

false

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-4)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-4)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-4)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#deleteItem)Delete Item `` この操作は、テーブルの 1 つの項目を主キーで削除します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)​でこの操作を参照してください。 #### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

テーブル名。

x

Primarykey

Object (オブジェクト)

主キー名と値のマップ。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-5)出力

型

Delete Item Result (項目の削除結果)

Attributes Type (属性型)

### [](#次の設定の場合-5)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-5)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#deleteTable)Delete Table `` Delete Table 操作は、テーブルとそのすべての項目を削除します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html)​でこの操作を参照してください。 #### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

削除するテーブルの名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-6)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-6)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-6)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#describeTable)Describe Table `` この操作は、テーブルの現在の状況、作成日、主キースキーマ、テーブルのインデックスなど、テーブルに関する情報を返します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html)​でこの操作を参照してください。 #### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

記述するテーブルの名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-7)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-7)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-7)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#getItem)Get Item `` Get Item 操作は、指定された主キーを持つ項目の一連の属性を返します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_GetItem.html)​でこの操作を参照してください。 #### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

要求された項目を含むテーブルの名前。

x

Key (キー)

Object (オブジェクト)

取得する項目の主キーを表す、AttributeValue オブジェクトへの属性名のマップ。

#[payload]

Attributes To Gets (取得する属性)

Array of String (文字列の配列)

これはレガシーパラメーターです。代わりに ProjectionExpression を使用します。

Consistent Read (一貫性読み取り)

Boolean (ブール)

読み取り一貫性モデルを決定します。true に設定されている場合、この操作は厳密な一貫性読み取りを使用します。それ以外の場合、この操作は最終的な一貫性読み取りを使用します。

false

Expression Attribute Names (式の属性名)

Object (オブジェクト)

式の属性名に対する 1 つ以上の代用トークン。ExpressionAttributeNames のユースケースのいくつかを次に示します。

Projection Expression (射影式)

String (文字列)

テーブルから取得する 1 つ以上の属性を識別する文字列。

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベルを決定します。

None (なし)

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-8)出力

型

Get Item Result (項目の取得結果)

Attributes Type (属性型)

### [](#次の設定の場合-8)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-8)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#listTables)List Tables `` この操作は、現在のアカウントとエンドポイントに関連付けられたテーブル名の配列を返します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListTables.html)​でこの操作を参照してください。 #### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Exclusive Start Table Name (排他開始テーブル名)

String (文字列)

この操作が評価する最初のテーブル名。以前の操作で LastEvaluatedTableName に返された値を使用します。

Limit (制限)

Number (数値)

返すテーブル名の最大数。このパラメーターが指定されていない場合、制限は 100 です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-9)出力

型

List Tables Result (リストテーブル結果)

Attributes Type (属性型)

### [](#次の設定の場合-9)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-9)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#paginatedQuery)Paginated Query `` **Paginated query**​ 操作は、主キー値に基づいて項目を見つけます。複合主キー (パーティションキーと並び替えキー) を持つテーブルまたはセカンダリインデックスを照会できます。この操作では、​**\[Limit (制限)\]**​ 項目で指定された制限または最大量の 1MB データがあるページが返されます。この動作は、クエリにはさらに一致する項目があることを示す、​**\[Last Evaluated Key (最終評価キー)\]**​ 項目の DynamoDB 値を無視して応答を切り捨てる既存の ​**Query**​ 操作とは異なります。 #### [](#パラメーター-15)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Key Condition Expression (キー条件式)

String (文字列)

Query​ 操作によって取得される項目のキー値を指定する条件。

Key Conditions (キー条件)

Object (オブジェクト)

これはレガシーパラメーターです。代わりに ​[Key Condition Expression (キー条件式)]​ を使用します。

Scan Index Forward (インデックス前方スキャン)

Boolean (ブール)

インデックス走査の順序を指定します。true (デフォルト) の場合、走査は昇順で実行されます。false の場合、操作は降順で実行されます。

false

Select

Enumeration (列挙)。次のいずれかになります。

  • ALL_ATTRIBUTES​

  • ALL_PROJECTED_ATTRIBUTES​

  • SPECIFIC_ATTRIBUTES​

  • COUNT

結果で返される属性。

Attribute Names (属性名)

Object (オブジェクト)

式の属性名に対する 1 つ以上の代用トークン。

Attribute Values (属性値)

Object (オブジェクト)

式で代入する 1 つ以上の値。

Table Name (テーブル名)

String (文字列)

要求された項目を含むテーブルの名前。

x

Attributes To Gets (取得する属性)

Array of String (文字列の配列)

これはレガシーパラメーターです。代わりに ​[Projection Expression (射影式)]​ 項目を使用します。

Conditional Operator (条件演算子)

Enumeration (列挙)。次のいずれかになります。

  • AND

  • または

条件に適用する論理演算子。

Consistent Read (一貫性読み取り)

Boolean (ブール)

読み取り一貫性モデルを決定します。true に設定されている場合、この操作は厳密な一貫性読み取りを使用します。それ以外の場合、この操作は最終的な一貫性読み取りを使用します。

false

Exclusive Start Key (排他開始キー)

Object (オブジェクト)

この操作で評価する最初の項目の主キー。

Filter Expression (検索条件式)

String (文字列)

操作後、データが返される前に DynamoDB で適用される条件を含む文字列。条件を満たさない項目は返されません。

Index Name (インデックス名)

String (文字列)

スキャンするセカンダリインデックスの名前。このインデックスは、任意のローカルセカンダリインデックスまたはグローバルセカンダリインデックスにすることができます。

Limit (制限)

Number (数値)

評価する項目の最大数 (一致する項目の数とは限りません)。

Projection Expression (射影式)

String (文字列)

テーブルから取得する 1 つ以上の属性を識別する文字列。

Condition Filter (条件)

Object (オブジェクト)

項目が読み取られた後にクエリ結果を評価し、目的の値のみを返す条件。

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベル。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-10)出力

​Type (型)​

Array of Object (オブジェクトの配列) ペイロードと ​Request ID Attribute (要求 ID 属性)​ 属性のメッセージの配列

### [](#次の設定の場合-10)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-10)スロー - DYNAMODB:THROTTLING\_EXCEPTION​ - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION​ - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION​ - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION​ - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION​ - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION​ - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION​ - DYNAMODB:UNKNOWN - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION​ - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION​ - DYNAMODB:VALIDATION\_EXCEPTION​ - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION​ - DYNAMODB:ACCESS\_DENIED\_EXCEPTION ### [](#putItem)Put Item `` この操作は、新しい項目を作成するか、古い項目を新しい項目に置き換えます。指定されたテーブルに新しい項目と主キーが同じ項目がすでに存在する場合、新しい項目で既存の項目が置き換えられます。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)​でこの操作を参照してください。 #### [](#パラメーター-16)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

テーブル名。

x

Item (項目)

Object (オブジェクト)

挿入する項目。

#[payload]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-11)出力

型

Put Item Result (項目の配置結果)

Attributes Type (属性型)

### [](#次の設定の場合-11)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-11)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#query)Query `` Query 操作は、主キー値に基づいて項目を見つけます。複合主キー (パーティションキーと並び替えキー) を持つテーブルまたはセカンダリインデックスを照会できます。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html)​でこの操作を参照してください。 #### [](#パラメーター-17)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Key Condition Expression (キー条件式)

String (文字列)

Query アクションによって取得される項目のキー値を指定する条件。

Key Conditions (キー条件)

Object (オブジェクト)

これはレガシーパラメーターです。代わりに KeyConditionExpression を使用します。

Scan Index Forward (インデックス前方スキャン)

Boolean (ブール)

インデックス走査の順序を指定します。true (デフォルト) の場合、走査は昇順で実行されます。false の場合、操作は降順で実行されます。

false

Select

Enumeration (列挙)。次のいずれかになります。

  • ALL_ATTRIBUTES​

  • ALL_PROJECTED_ATTRIBUTES​

  • SPECIFIC_ATTRIBUTES​

  • COUNT

結果で返される属性。

Attribute Names (属性名)

Object (オブジェクト)

式の属性名に対する 1 つ以上の代用トークン。

Attribute Values (属性値)

Object (オブジェクト)

式で代入する 1 つ以上の値。

Table Name (テーブル名)

String (文字列)

要求された項目を含むテーブルの名前。

x

Attributes To Gets (取得する属性)

Array of String (文字列の配列)

これはレガシーパラメーターです。代わりに [Projection Expression (射影式)] 項目を使用します。

Conditional Operator (条件演算子)

Enumeration (列挙)。次のいずれかになります。

  • AND

  • または

条件に適用する論理演算子。

Consistent Read (一貫性読み取り)

Boolean (ブール)

読み取り一貫性モデルを決定します。true に設定されている場合、この操作は厳密な一貫性読み取りを使用します。それ以外の場合、この操作は最終的な一貫性読み取りを使用します。

false

Exclusive Start Key (排他開始キー)

Object (オブジェクト)

この操作で評価する最初の項目の主キー。

Filter Expression (検索条件式)

String (文字列)

操作後、データが返される前に DynamoDB で適用される条件を含む文字列。条件を満たさない項目は返されません。

Index Name (インデックス名)

String (文字列)

スキャンするセカンダリインデックスの名前。このインデックスは、任意のローカルセカンダリインデックスまたはグローバルセカンダリインデックスにすることができます。

Limit (制限)

Number (数値)

評価する項目の最大数 (一致する項目の数とは限りません)。

Projection Expression (射影式)

String (文字列)

テーブルから取得する 1 つ以上の属性を識別する文字列。

Condition Filter (条件)

Object (オブジェクト)

項目が読み取られた後にクエリ結果を評価し、目的の値のみを返す条件。

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベル。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-12)出力

型

Query Result (クエリ結果)

Attributes Type (属性型)

### [](#次の設定の場合-12)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-12)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#scan)Scan `` Scan 操作は、テーブルまたはセカンダリインデックスのすべての項目にアクセスすることで、1 つ以上の項目と項目属性を返します。DynamoDB から返される項目数を減らすには、Filter Expression 操作を指定します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Scan.html)​でこの操作を参照してください。 #### [](#パラメーター-18)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Segment (セグメント)

Number (数値)

並列スキャン要求の場合、セグメントを使用して、アプリケーションワーカーがスキャンする個々のセグメントを識別します。

Select

Enumeration (列挙)。次のいずれかになります。

  • ALL_ATTRIBUTES​

  • ALL_PROJECTED_ATTRIBUTES​

  • SPECIFIC_ATTRIBUTES​

  • COUNT

結果で返される属性。

Total Segments (セグメント総数)

Number (数値)

並列スキャン要求の場合、TotalSegments は Scan 操作によって分割されるセグメントの総数を表します。

Attribute Names (属性名)

Object (オブジェクト)

式の属性名に対する 1 つ以上の代用トークン。

Attribute Values (属性値)

Object (オブジェクト)

式で代入する 1 つ以上の値。

Table Name (テーブル名)

String (文字列)

要求された項目を含むテーブルの名前。

x

Attributes To Gets (取得する属性)

Array of String (文字列の配列)

これはレガシー項目です。代わりに [Projection Expression (射影式)] 項目を使用します。

Conditional Operator (条件演算子)

Enumeration (列挙)。次のいずれかになります。

  • AND

  • または

条件に適用する論理演算子。

Consistent Read (一貫性読み取り)

Boolean (ブール)

読み取り一貫性モデルを決定します。true に設定されている場合、この操作は厳密な一貫性読み取りを使用します。それ以外の場合、この操作は最終的な一貫性読み取りを使用します。

false

Exclusive Start Key (排他開始キー)

Object (オブジェクト)

この操作で評価する最初の項目の主キー。

Filter Expression (検索条件式)

String (文字列)

操作後、データが返される前に DynamoDB で適用される条件を含む文字列。条件を満たさない項目は返されません。

Index Name (インデックス名)

String (文字列)

スキャンするセカンダリインデックスの名前。このインデックスは、任意のローカルセカンダリインデックスまたはグローバルセカンダリインデックスにすることができます。

Limit (制限)

Number (数値)

評価する項目の最大数 (一致する項目の数とは限りません)。

Projection Expression (射影式)

String (文字列)

テーブルから取得する 1 つ以上の属性を識別する文字列。

Condition Filter (条件)

Object (オブジェクト)

項目が読み取られた後にクエリ結果を評価し、目的の値のみを返す条件。

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベル。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-13)出力

型

Scan Result (スキャン結果)

Attributes Type (属性型)

### [](#次の設定の場合-13)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-13)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#updateItem)Update Item `` この操作は、既存の項目の属性を編集するか、テーブルに新しい項目がまだない場合は追加します。 詳細は、 [Amazon DynamoDB API リファレンス](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)​でこの操作を参照してください。 #### [](#パラメーター-19)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

テーブル名。

x

Key (キー)

Object (オブジェクト)

主キー。

#[payload]

Return Consumed Capacity (返されるコンシューム容量)

Enumeration (列挙)。次のいずれかになります。

  • INDEXES

  • TOTAL

  • None (なし)

応答で返されるプロビジョニングされたスループット消費の詳細レベルを決定します。

Return Item Collection Metrics (項目コレクションメトリクスを返す)

Enumeration (列挙)。次のいずれかになります。

  • SIZE

  • None (なし)

項目コレクションメトリクスが返されるかどうかを決定します。

Return Values (戻り値)

Enumeration (列挙)。次のいずれかになります。

  • None (なし)

  • ALL_OLD​

  • UPDATED_OLD​

  • ALL_NEW​

  • UPDATED_NEW

項目属性が更新される前または後に表示される項目属性を取得する場合に使用します。

Update Expression (更新式)

String (文字列)

更新される 1 つ以上の属性、それらに対して実行されるアクション、それらの新しい値を定義する式。

Attribute Updates (属性の更新)

Object (オブジェクト)

これはレガシーパラメーターです。代わりに updateExpression を使用します。

Expected (想定)

Object (オブジェクト)

これはレガシーパラメーターです。代わりに conditionExpression を使用します。

Conditional Operator (条件演算子)

Enumeration (列挙)。次のいずれかになります。

  • AND

  • または

Condition Expression (条件式)

String (文字列)

Attribute Names (属性名)

Object (オブジェクト)

Attribute Values (属性値)

Object (オブジェクト)

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-14)出力

型

Update Item Result (項目の更新結果)

Attributes Type (属性型)

### [](#次の設定の場合-14)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-14)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#updateTable)Update Table `` この操作は、特定のテーブルのプロビジョニングされたスループット設定、グローバルセカンダリインデックス、または DynamoDB ストリーム設定を変更します。 詳細は、 [Amazon DynamoDB API リファレンス](http://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)​でこの操作を参照してください。 #### [](#パラメーター-20)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

更新するテーブルの名前。

x

Attribute Definitions (属性定義)

テーブルとインデックスのキースキーマを記述する属性の配列。テーブルに新しいグローバルセカンダリインデックスを追加する場合、AttributeDefinitions に新しいインデックスのキー要素を含める必要があります。

Read Capacity Units (読み取り容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りの最大数。

Write Capacity Units (書き込み容量単位)

Number (数値)

DynamoDB が ThrottlingException を返す前にコンシュームされる 1 秒あたりの書き込みの最大数。

Global Secondary Index Updates (グローバルセカンダリインデックスの更新)

テーブルの 1 つ以上のグローバルセカンダリインデックスの配列。

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

テーブル内の項目が変更されると、StreamViewType によってこのテーブルのストリームに書き込まれる情報が決まります。

Stream Enabled (ストリーム有効)

Boolean (ブール)

DynamoDB ストリームが有効 (true) か無効 (false) かを示します。

false

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-15)出力

型

Table Description (テーブルの説明)

Attributes Type (属性型)

### [](#次の設定の場合-15)次の設定の場合 - [デフォルト設定](#config) #### [](#スロー-15)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#describeStream)Describe Stream `` #### [](#パラメーター-21)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Stream ARN (ストリーム ARN)

String (文字列)

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-16)出力

型

Stream Description (ストリームの説明)

Attributes Type (属性型)

### [](#次の設定の場合-16)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-16)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#getRecords)Get Records `` #### [](#パラメーター-22)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Shard Iterator (シャードイテレーター)

String (文字列)

x

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-17)出力

型

Record (レコード)​ ペイロードおよび ​Request ID Attribute (要求 ID 属性)​ 属性のメッセージの配列

### [](#次の設定の場合-17)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-17)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#getShardIterator)Get Shard Iterator `` #### [](#パラメーター-23)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Shard Id (シャード ID)

String (文字列)

x

Shard Iterator Type (シャードイテレーター種別)

String (文字列)

x

Starting Sequence Number (開始連番)

String (文字列)

Stream ARN (ストリーム ARN)

String (文字列)

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-18)出力

型

String (文字列)

Attributes Type (属性型)

### [](#次の設定の場合-18)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-18)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:CONNECTIVITY - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:RETRY\_EXHAUSTED - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ### [](#listStreams)List Streams `` #### [](#パラメーター-24)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Table Name (テーブル名)

String (文字列)

Streaming Strategy (ストリーミング戦略)

反復可能なストリームを使用するように設定します。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

#### [](#出力-19)出力

型

[​Stream (ストリーム)​] ペイロードおよび​Request ID Attribute (要求 ID 属性)​属性のメッセージの配列

### [](#次の設定の場合-19)次の設定の場合 - [ストリーム設定](#streams-config) #### [](#スロー-19)スロー - DYNAMODB:ACCESS\_DENIED\_EXCEPTION - DYNAMODB:CONDITIONAL\_CHECK\_FAILED\_EXCEPTION - DYNAMODB:INCOMPLETE\_SIGNATURE\_EXCEPTION - DYNAMODB:ITEM\_COLLECTION\_SIZE\_LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:LIMIT\_EXCEEDED\_EXCEPTION - DYNAMODB:MISSING\_AUTHENTICATION\_TOKEN\_EXCEPTION - DYNAMODB:PROVISIONED\_THROUGHPUT\_EXCEEDED\_EXCEPTION - DYNAMODB:RESOURCE\_IN\_USE\_EXCEPTION - DYNAMODB:RESOURCE\_NOT\_FOUND\_EXCEPTION - DYNAMODB:THROTTLING\_EXCEPTION - DYNAMODB:UNKNOWN - DYNAMODB:UNRECOGNIZED\_CLIENT\_EXCEPTION - DYNAMODB:VALIDATION\_EXCEPTION ## [](#型)型 ### [](#Tls)TLS
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

Key Store (キーストア)

Revocation Check (取り消し確認)

### [](#TrustStore)Trust Store (トラストストア)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

使用するストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用するアルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true の場合、証明書の検証が実行されず、攻撃に対して接続が脆弱になります。各自の責任で使用してください。

### [](#KeyStore)Key Store (キーストア)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアの場所 (可能な場合、現在のクラスパスとファイルシステムを基準として解決されます)。

Type (型)

String (文字列)

使用するストアの型。

Alias (別名)

String (文字列)

キーストアに多数の非公開キーがある場合、この属性は、使用する鍵の別名を示します。定義しない場合、デフォルトでファイル内の最初の鍵が使用されます。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用するアルゴリズム。

### [](#standard-revocation-check)Standard Revocation Check (標準の取り消し確認)
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーンの最後の要素のみを確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

最初に OCSP ではなく CRL を試みます。

No Fallback (代替なし)

Boolean (ブール)

第 2 の確認方法 (以前に選択されていない方法) を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合に検証エラーを回避します。

### [](#custom-ocsp-responder)Custom OCSP Responder (カスタム OCSP レスポンダー)
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

(トラストストアに含まれている) OCSP 応答の署名証明書の別名 (存在する場合)。

### [](#crl-file)CRL File (CRL ファイル)
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

### [](#Reconnection)Reconnection (再接続)
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

### [](#reconnect)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#reconnect-forever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー)
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

maxIdleTime 属性の時間単位

### [](#BatchWriteItemResult)Batch Write Item Result (項目のバッチ書き込み結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

Object (オブジェクト)

Unprocessed Items (未処理項目)

Object (オブジェクト)

### [](#ConsumedCapacity)Consumed Capacity (コンシューム容量)
項目 型 説明 デフォルト値 必須

Capacity Units (容量単位)

Number (数値)

Global Secondary Indexes (グローバルセカンダリインデックス)

Object (オブジェクト)

Local Secondary Indexes (ローカルセカンダリインデックス)

Object (オブジェクト)

Table (テーブル)

Number (数値)

Table Name (テーブル名)

String (文字列)

### [](#RequestIDAttribute)Request ID Attribute (要求 ID 属性)
項目 型 説明 デフォルト値 必須

Request Id (要求 ID)

String (文字列)

### [](#BatchGetItemResult)Batch Get Item Result (項目のバッチ取得結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Responses (応答)

Object (オブジェクト)

Unprocessed Keys (未処理キー)

Object (オブジェクト)

### [](#TableDescription)Table Description (テーブルの説明)
項目 型 説明 デフォルト値 必須

Attribute Definitions (属性定義)

Creation Date Time (作成日時)

DateTime

Global Secondary Indexes (グローバルセカンダリインデックス)

Item Count (項目数)

Number (数値)

Key Schema (キースキーマ)

Latest Stream Arn (最新のストリーム ARN)

String (文字列)

Latest Stream Label (最新のストリーム表示ラベル)

String (文字列)

Local Secondary Indexes (ローカルセカンダリインデックス)

Provisioned Throughput (プロビジョニングされたスループット)

Stream Specification (ストリーム仕様)

Table Arn (テーブル ARN)

String (文字列)

Table Name (テーブル名)

String (文字列)

Table Size Bytes (テーブルサイズ (バイト))

Number (数値)

Table Status (テーブル状況)

String (文字列)

### [](#AttributeDefinition)Attribute Definitions (属性定義)
項目 型 説明 デフォルト値 必須

Attribute Name (属性名)

String (文字列)

Attribute Type (属性型)

Enumeration (列挙)。次のいずれかになります。

  • STRING

  • NUMBER

  • BINARY

### [](#GlobalSecondaryIndexDescription)Global Secondary Index Description (グローバルセカンダリインデックスの説明)
項目 型 説明 デフォルト値 必須

Backfilling (バックフィル)

Boolean (ブール)

Index Arn (インデックス ARN)

String (文字列)

Index Name (インデックス名)

String (文字列)

Index Size Bytes (インデックスサイズ (バイト))

Number (数値)

Index Status (インデックス状況)

Enumeration (列挙)。次のいずれかになります。

  • CREATING

  • UPDATING

  • DELETING

  • ACTIVE

Item Count (項目数)

Number (数値)

Key Schema (キースキーマ)

Projection (射影)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#KeySchemaElement)Key Schema Element (キースキーマ要素)
項目 型 説明 デフォルト値 必須

Attribute Name (属性名)

String (文字列)

Key Type (キー種別)

Enumeration (列挙)。次のいずれかになります。

  • HASH

  • RANGE

### [](#Projection)Projection (射影)
項目 型 説明 デフォルト値 必須

Non Key Attributes (非キー属性)

Array of String (文字列の配列)

Projection Type (射影種別)

Enumeration (列挙)。次のいずれかになります。

  • ALL (すべて)

  • KEYS_ONLY​

  • INCLUDE

### [](#ProvisionedThroughputDescription)Provisioned Throughput Description (プロビジョニングされたスループットの説明)
項目 型 説明 デフォルト値 必須

Last Decrease Date Time (最終減少日時)

DateTime

Last Increase Date Time (最終増加日時)

DateTime

Number Of Decreases Today (今日の減少数)

Number (数値)

Read Capacity Units (読み取り容量単位)

Number (数値)

Write Capacity Units (書き込み容量単位)

Number (数値)

### [](#LocalSecondaryIndexDescription)Local Secondary Index Description (ローカルセカンダリインデックスの説明)
項目 型 説明 デフォルト値 必須

Index Arn (インデックス ARN)

String (文字列)

Index Name (インデックス名)

String (文字列)

Index Size Bytes (インデックスサイズ (バイト))

Number (数値)

Item Count (項目数)

Number (数値)

Key Schema (キースキーマ)

Projection (射影)

### [](#StreamSpecification)Stream Specification (ストリーム仕様)
項目 型 説明 デフォルト値 必須

Stream Enabled (ストリーム有効)

Boolean (ブール)

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

### [](#GlobalSecondaryIndex)Global Secondary Index (グローバルセカンダリインデックス)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Key Schema (キースキーマ)

Projection (射影)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#ProvisionedThroughput)Provisioned Throughput (プロビジョニングされたスループット)
項目 型 説明 デフォルト値 必須

Read Capacity Units (読み取り容量単位)

Number (数値)

Write Capacity Units (書き込み容量単位)

Number (数値)

### [](#LocalSecondaryIndex)Local Secondary Index (ローカルセカンダリインデックス)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Key Schema (キースキーマ)

Projection (射影)

### [](#DeleteItemResult)Delete Item Result (項目の削除結果)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

### [](#ItemCollectionMetrics)Item Collection Metrics (項目コレクションメトリクス)
項目 型 説明 デフォルト値 必須

Item Collection Key (項目コレクションキー)

Object (オブジェクト)

Size Estimate Range GB (サイズ見積範囲 GB)

Array of Number (数値の配列)

### [](#GetItemResult)Get Item Result (項目の取得結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Item (項目)

Object (オブジェクト)

### [](#ListTablesResult)List Tables Result (リストテーブル結果)
項目 型 説明 デフォルト値 必須

Last Evaluated Table Name (最終評価テーブル名)

String (文字列)

Table Names (テーブル名)

Array of String (文字列の配列)

### [](#PutItemResult)Put Item Result (項目の配置結果)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

### [](#QueryResult)Query Result (クエリ結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Count (数)

Number (数値)

Items (項目)

Array of Object (オブジェクトの配列)

Last Evaluated Key (最終評価キー)

Object (オブジェクト)

Scanned Count (スキャン数)

Number (数値)

### [](#ScanResult)Scan Result (スキャン結果)
項目 型 説明 デフォルト値 必須

Consumed Capacity (コンシューム容量)

Count (数)

Number (数値)

Items (項目)

Array of Object (オブジェクトの配列)

Last Evaluated Key (最終評価キー)

Object (オブジェクト)

Scanned Count (スキャン数)

Number (数値)

### [](#UpdateItemResult)Update Item Result (項目の更新結果)
項目 型 説明 デフォルト値 必須

Attributes (属性)

Object (オブジェクト)

Consumed Capacity (コンシューム容量)

Item Collection Metrics (項目コレクションメトリクス)

### [](#GlobalSecondaryIndexUpdate)Global Secondary Index Update (グローバルセカンダリインデックスの更新)
項目 型 説明 デフォルト値 必須

Create (作成)

Delete (削除)

String (文字列)

Update (更新)

### [](#CreateGlobalSecondaryIndexAction)Create Global Secondary Index Action (グローバルセカンダリインデックスの作成アクション)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Key Schema (キースキーマ)

Projection (射影)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#UpdateGlobalSecondaryIndexAction)Update Global Secondary Index Action (グローバルセカンダリインデックスの更新アクション)
項目 型 説明 デフォルト値 必須

Index Name (インデックス名)

String (文字列)

Provisioned Throughput (プロビジョニングされたスループット)

### [](#StreamDescription)Stream Description (ストリームの説明)
項目 型 説明 デフォルト値 必須

Creation Request Date Time (作成要求日時)

DateTime

Key Schema (キースキーマ)

Last Evaluated Shard Id (最終評価シャード ID)

String (文字列)

Shards (シャード)

Shard (シャード)​ の配列

Stream Arn (ストリーム ARN)

String (文字列)

Stream Label (ストリーム表示ラベル)

String (文字列)

Stream Status (ストリーム状況)

Enumeration (列挙)。次のいずれかになります。

  • ENABLING

  • ENABLED

  • DISABLING

  • DISABLED

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

Table Name (テーブル名)

String (文字列)

### [](#Shard)Shard (シャード)
項目 型 説明 デフォルト値 必須

Parent Shard Id (親シャード ID)

String (文字列)

Sequence Number Range (連番範囲)

Shard Id (シャード ID)

String (文字列)

### [](#SequenceNumberRange)Sequence Number Range (連番範囲)
項目 型 説明 デフォルト値 必須

Ending Sequence Number (終了連番)

String (文字列)

Starting Sequence Number (開始連番)

String (文字列)

### [](#Record)Record (レコード)
項目 型 説明 デフォルト値 必須

Aws Region (AWS リージョン)

String (文字列)

Dynamodb

Event ID (イベント ID)

String (文字列)

Event Name (イベント名)

Enumeration (列挙)。次のいずれかになります。

  • INSERT

  • MODIFY

  • REMOVE

Event Source (イベント取得元)

String (文字列)

Event Version (イベントバージョン)

String (文字列)

User Identity (ユーザー ID)

### [](#StreamRecord)Stream Record (ストリームレコード)
項目 型 説明 デフォルト値 必須

Approximate Creation Date Time (おおよその作成日時)

DateTime

Keys (キー)

Object (オブジェクト)

New Image (新しい画像)

Object (オブジェクト)

Old Image (古い画像)

Object (オブジェクト)

Sequence Number (連番)

String (文字列)

Size Bytes (サイズ (バイト))

Number (数値)

Stream View Type (ストリームビュー種別)

Enumeration (列挙)。次のいずれかになります。

  • NEW_IMAGE​

  • OLD_IMAGE​

  • NEW_AND_OLD_IMAGES​

  • KEYS_ONLY

### [](#Identity)Identity (ID)
項目 型 説明 デフォルト値 必須

Principal Id (プリンシパル ID)

String (文字列)

Type (型)

String (文字列)

### [](#repeatable-in-memory-iterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームし、ランダムアクセスを提供するために初期状態でメモリ内に保持が許容されるインスタンスの量。ストリームのデータ量がこのバッファサイズを超える場合は、bufferSizeIncrement 属性に従って、maxInMemorySize を上限としてバッファが拡張されます。デフォルト値は 100 インスタンスです。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。デフォルト値は 100 インスタンスです。

Max Buffer Size (最大バッファサイズ)

Number (数値)

使用するメモリの最大量。これを超えると、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。0 以下の値は無制限を意味します。

### [](#repeatable-file-store-iterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

メモリ内に保持されるインスタンスの最大数。これ以上の量が必要な場合、コンテンツはディスク上にバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

maxInMemorySize で表される単位

### [](#Stream)Stream (ストリーム)
項目 型 説明 デフォルト値 必須

Stream Arn (ストリーム ARN)

String (文字列)

Stream Label (ストリーム表示ラベル)

String (文字列)

Table Name (テーブル名)

String (文字列)

## [](#関連情報)関連情報 [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon DynamoDB の XML と Maven のサポート Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。 Studio を使用して、この手動プロセスを回避できます。コネクタを Studio にインストールすると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。 ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 次のコードを設定 XML のヘッダーの ​``​ タグ内に貼り付けます。 ```xml http://www.mulesoft.org/schema/mule/dynamodb http://www.mulesoft.org/schema/mule/dynamodb/current/mule-dynamodb.xsd ``` 次の例は、​``​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。 ```xml ``` ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Maven の ​`pom.xml`​ ファイルは Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします。 ```xml com.mulesoft.connectors mule-amazon-dynamodb-connector n.n.n mule-plugin ``` `n.n.n`​ を使用しているコネクタに対応するバージョンに置き換えます。 最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。 1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。 2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 3. Exchange で、「​`amazon dynamodb`​」を検索します。 4. コネクタを選択します。 5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。 ## [](#次のステップ)次のステップ 名前空間および ​`pom.xml`​ ファイルを作成したら、​[例](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon DynamoDB の XML と Maven のサポート Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。 Studio を使用して、この手動プロセスを回避できます。コネクタを Studio にインストールすると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。 ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 次のコードを設定 XML のヘッダーの ​``​ タグ内に貼り付けます。 ```xml http://www.mulesoft.org/schema/mule/dynamodb http://www.mulesoft.org/schema/mule/dynamodb/current/mule-dynamodb.xsd ``` 次の例は、​``​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。 ```xml ``` ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Maven の ​`pom.xml`​ ファイルは Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします。 ```xml com.mulesoft.connectors mule-amazon-dynamodb-connector n.n.n mule-plugin ``` `n.n.n`​ を使用しているコネクタに対応するバージョンに置き換えます。 最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。 1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。 2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 3. Exchange で、「​`amazon dynamodb`​」を検索します。 4. コネクタを選択します。 5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。 ## [](#次のステップ)次のステップ 名前空間および ​`pom.xml`​ ファイルを作成したら、​[例](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon DynamoDB の例 次に、Amazon DynamoDB Connector の一般的なユースケースを示します。 - Amazon DynamoDB テーブルの作成 - Amazon DynamoDB テーブルの削除 - Amazon DynamoDB テーブルスキャンの実行 ## [](#create-table)Amazon DynamoDB テーブルの作成 次の例は、Amazon DynamoDB Connector を使用して Amazon DynamoDB テーブルを作成する方法を示しています。 ### [](#amazon-dynamodb-テーブルの作成フロー)Amazon DynamoDB テーブルの作成フロー 次のスクリーンショットは、Amazon DynamoDB テーブルを作成するための Anypoint Studio フローを示しています。 ![Amazon DynamoDB テーブルを作成するための Studio フロー](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-create-table-flow.png) Figure 1. このサンプルフローを使用して、Amazon DynamoDB テーブルを作成します。 ### [](#preliminary-steps-create)事前手順 次の手順に従って、Amazon DynamoDB テーブルの作成を開始します。 1. Studio で新しい Mule プロジェクトを作成します。 2. 次のプロパティを ​`mule-artifact.properties`​ ファイルに追加して、Amazon DynamoDB ログイン情報を保存します。 ```text config.accesskey= config.secretkey= ``` 3. プロジェクトの ​`src/main/resources`​ ディレクトリに ​`mule-artifact.properties`​ ファイルを置きます。 ### [](#configure-http-listener)HTTP リスナーを設定する `/createtable`​ パスで HTTP 要求をリスンするように ​`HTTP Listener`​ を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`http`​」を検索し、​**\[Listener\]**​ 操作を選択します。 2. **\[Listener\]**​ 操作を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、​`HTTP Listener`​ のグローバル要素設定項目にアクセスします。 4. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択します。 ![HTTP リスナーのグローバル要素](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-http-global-element.png) Figure 2. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択して、ローカルコンピューターで HTTP 要求をリスンします。 5. **\[OK\]**​ をクリックします。 6. **\[Listener\]**​ タブの ​**\[Path (パス)\]**​ 項目で、「​`/createtable`​」と入力します。 ![HTTP リスナータブ](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-http-prop.png) Figure 3. **\[Path (パス)\]**​ 項目に「​`/createtable`​」と入力して、​`/createtable`​ パスで HTTP 要求をリスンします。 ### [](#create-table-操作を設定する)Create Table 操作を設定する `Issues`​ というテーブルを作成する ​`Create Table`​ 操作を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックして「​`amazon dynamodb`​」を検索します。 2. **\[Amazon DynamoDB Connector\]**​ を選択して ​**\[Add> (追加>)\]**​ をクリックし、​**\[Finish (完了)\]**​ をクリックします。 3. **\[Create Table\]**​ 操作を Studio キャンバスの ​**\[Listener\]**​ の右にドラッグします。 4. フローの下の ​**\[Global Elements (グローバル要素)\]**​ リンクをクリックします。 5. [「プロパティ値のプロパティプレースホルダーの使用」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview#property-placeholders)​の説明に従って、以前に作成したプロパティファイルを ​**\[Configuration properties (設定プロパティ)\]**​ 項目に追加します。 6. **\[Create (作成)\]**​ をクリックします。 7. **\[Connector Configuration (コネクタ設定)\]**​ を展開します。 8. **\[Amazon DynamoDB Configuration (Amazon DynamoDB 設定)\]**​ を選択し、​**\[OK\]**​ をクリックします。 9. 次の項目に入力します。
パラメーター 説明 値

Name (名前)

設定名

create-table-flow

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

${config.accesskey}

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

${config.secretkey}​

Region Endpoint (リージョンエンドポイント)

Amazon DynamoDB クライアントに設定するリージョン

us-east-1

次のスクリーンショットは、Amazon DynamoDB Connector のグローバル要素を設定する例を示しています。 ![Amazon DynamoDB グローバル要素](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-global-element.png) Figure 4. グローバル要素の ​**\[Connection (接続)\]**​ セクションで、Amazon DynamoDB にアクセスするために必要なログイン情報を設定します。 10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が Amazon DynamoDB インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 11. **\[OK\]**​ をクリックします。 12. **\[Create Table\]**​ タブで、次の項目を設定します。
項目 説明 ユーザーアクション

Table name (テーブル名)

テーブルの名前

「​Issues​」と入力します。

Attribute definitions (属性定義)

テーブルとそのインデックスのキースキーマを記述する属性の配列

Edit inline​ を選択して緑のプラス記号 (+) をクリックし、次の属性を追加します。

  • IssueId​ (​STRING​ 型)

  • Title​ (​STRING​ 型)

  • CreateDate​ (​STRING​ 型)

  • DueDate​ (​STRING​ 型)

Key schemas (キースキーマ)

テーブルまたはそのインデックスのいずれかの主キーを構成する属性

Edit inline​ を選択して緑のプラス記号 (+) をクリックし、次の属性を追加します。

  • IssueId​ (​HASH​ キー種別)

  • Title​ (​RANGE​ キー種別)

Read capacity units (読み取り容量単位)

Amazon DynamoDB が調整例外を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りの最大数

「​5​」と入力します。

Write capacity units (書き込み容量単位)

Amazon DynamoDB が調整例外を返す前にコンシュームされる 1 秒あたりの書き込みの最大数。

「​5​」と入力します。

Global secondary indexes (グローバルセカンダリインデックス)

テーブルの省略可能な追加キー構造

「Issues テーブルへのセカンダリインデックスの追加」​の説明に従って、「​#[vars.secondary]​」と入力してセカンダリインデックスの変数を作成し、XML コードにセカンダリインデックスを追加します。

次のスクリーンショットは、​`Create table`​ 操作の設定例を示しています。 ![Create table 操作の項目](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-create-table-props.png) Figure 5. `Create table`​ 操作の項目値を入力します。 このスクリーンショットについて説明します。 - 最初の項目では、フロー内の ​`Create table`​ 操作を表すコンポーネントの名前を指定します。 - 2 番目の項目では、作成するテーブルの名前を指定します。 - 3 番目の項目では、新しいテーブルの属性を定義します。 - 4 番目の項目では、新しいテーブルのキースキーマを定義します。 - 5 番目の項目では、Amazon DynamoDB が調整例外を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りと 1 秒あたりの厳密な一貫性書き込みの最大数を指定します。 - 6 番目の項目では、セカンダリインデックスの変数を指定します。 `HTTP Listener`​ および ​`Create table`​ 操作を設定したら、Create Table の例の XML フローは次のようになります。 ```xml ``` ### [](#secondary-index)Issues テーブルへのセカンダリインデックスの追加 グローバルセカンダリインデックスを ​`Issues`​ テーブルに追加するには、XML の ​``​ 要素の前に変数を追加します。 次の例では、3 つのセカンダリインデックスを ​`Issues`​ テーブルに追加します。 - `CreateDateIndex`​ (​`CreateDate`​ パーティションキーと ​`IssueId`​ 並び替えキーを使用) - `TitleIndex`​ (​`Title`​ パーティションキーと ​`IssueId`​ 並び替えキーを使用) - `DueDateIndex`​ (​`DueDate`​ パーティションキーを使用) XML に次の要素を含める必要があります。 - ``​: テーブルからインデックスにコピーする属性を指定します。 この例では、値 ​`ALL`​ はすべての属性がコピーされることを意味します。 ``​ 要素に設定した値に関係なく、主キー属性とインデックスキー属性は自動的にコピーされます。 - `ProvisionedThroughput`​: 読み取りおよび書き込みアクティビティのスループットをプロビジョニングします。 - `KeySchema`​: インデックスのキースキーマを指定します。 ```xml ``` ### [](#configure-logger-create)Logger コンポーネントを設定する `Create Table`​ 操作によって生成された応答を Mule コンソールに出力するように、​`Logger`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`logger`​」を検索します。 2. **\[Logger\]**​ コンポーネントを Studio キャンバスの ​**\[Create Table\]**​ の右にドラッグします。 3. **\[Logger\]**​ タブの ​**\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力します。 ![「Logger」 タブ](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-logger-props.png) Figure 6. **\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力し、Mule コンソールに操作の応答を出力します。 ### [](#完全な-create-table-の例の-xml)完全な Create Table の例の XML 完全な Create Table の例の XML は次のようになります。 ```xml ``` ### [](#プロジェクトを実行する)プロジェクトを実行する プロジェクトを保存し、Mule アプリケーションとして実行します。 1. **Package Explorer**​ で、プロジェクト名を右クリックし、​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 2. ブラウザーを開き、​`http://localhost:8081/createtable`​ URL を入力して応答を確認します。 Mule コンソールに ​`Create table`​ 操作から生成された応答が表示されます。 ## [](#delete-table)Amazon DynamoDB テーブルの削除 次の例は、Amazon DynamoDB Connector を使用して Amazon DynamoDB テーブルを削除する方法を示しています。 ### [](#dynamodb-テーブルの削除フロー)DynamoDB テーブルの削除フロー 次のスクリーンショットは、Amazon DynamoDB テーブルを削除するための Anypoint Studio フローを示しています。 ![Amazon DynamoDB テーブルを削除するための Studio フロー](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-delete-table-flow.png) Figure 7. このサンプルフローを使用して、Amazon DynamoDB テーブルを削除します。 ### [](#事前手順)事前手順 次の手順に従って、Amazon DynamoDB テーブルの削除を開始します。 1. Studio で新しい Mule プロジェクトを作成します。 2. 次のプロパティを ​`mule-artifact.properties`​ ファイルに追加して、Amazon DynamoDB ログイン情報を保持します。 ```text config.accesskey= config.secretkey= ``` 3. プロジェクトの ​`src/main/resources`​ ディレクトリに ​`mule-artifact.properties`​ ファイルを置きます。 ### [](#http-リスナーを設定する)HTTP リスナーを設定する `/deletetable`​ パスで HTTP 要求をリスンするように ​`HTTP Listener`​ を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`http`​」を検索し、​**\[Listener\]**​ 操作を選択します。 2. **\[Listener\]**​ 操作を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、​`HTTP Listener`​ のグローバル要素設定項目にアクセスします。 4. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択し、​**\[OK\]**​ をクリックします。 5. **\[Listener\]**​ タブの ​**\[Path (パス)\]**​ 項目で、「​`/deletetable`​」と入力します。 ### [](#delete-table-操作を設定する)Delete Table 操作を設定する `Issues`​ テーブルを削除する ​`Delete table`​ 操作を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックして「​`amazon dynamodb`​」を検索します。 2. **\[Amazon DynamoDB Connector\]**​ を選択して ​**\[Add> (追加>)\]**​ をクリックし、​**\[Finish (完了)\]**​ をクリックします。 3. **\[Delete Table\]**​ 操作を Studio キャンバスの ​**\[Listener\]**​ の右にドラッグします。 4. フローの下の ​**\[Global Elements (グローバル要素)\]**​ リンクをクリックします。 5. [「プロパティ値のプロパティプレースホルダーの使用」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview#property-placeholders)​の説明に従って、以前に作成したプロパティファイルを ​**\[Configuration properties (設定プロパティ)\]**​ 項目に追加します。 6. **\[Create (作成)\]**​ をクリックします。 7. **\[Connector Configuration (コネクタ設定)\]**​ を展開します。 8. **\[Amazon DynamoDB Configuration (Amazon DynamoDB 設定)\]**​ を選択し、​**\[OK\]**​ をクリックします。 9. 次の項目に入力します。
パラメーター 説明 値

Name (名前)

設定名

delete-table-flow

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

${config.accesskey}

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

${config.secretkey}

Region Endpoint (リージョンエンドポイント)

Amazon DynamoDB クライアントに設定するリージョン

us-east-1

対応する XML の設定は次のようになります。 ```xml ``` 10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が Amazon DynamoDB インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 11. **\[OK\]**​ をクリックします。 12. **\[Delete table\]**​ タブで、​`Table name`​ の値を ​`Issues`​ に設定します。 ### [](#configure-logger-delete)Logger コンポーネントを設定する `Delete table`​ 操作によって生成された応答を Mule コンソールに出力するように、​`Logger`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`logger`​」を検索します。 2. **\[Logger\]**​ コンポーネントを Studio キャンバスの ​**\[Delete Table\]**​ の右にドラッグします。 3. **\[Logger\]**​ タブで、​**\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力します。 ### [](#delete-table-の例の-xml)Delete Table の例の XML Delete Table の例の XML は次のようになります。 ```xml ``` ### [](#プロジェクトを実行する-2)プロジェクトを実行する プロジェクトを保存し、Mule アプリケーションとして実行します。 1. **Package Explorer**​ で、プロジェクト名を右クリックし、​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 2. ブラウザーを開き、​`http://localhost:8081/deletetable`​ URL を入力して応答を確認します。 Mule コンソールに ​`Delete table`​ 操作から生成された応答が表示されます。 ## [](#scan-operation)Amazon DynamoDB テーブルのスキャン 次の例は、Amazon DynamoDB Connector を使用して Amazon DynamoDB テーブルをスキャンする方法を示しています。 Amazon DynamoDB Connector を使用してスキャンを実行する場合、次の考慮事項が適用されます。 - DynamoDB AWS SDK は、結果を特定のページに分割します。 返される結果には 1 MB の制限が適用されます。この制限を超えた場合、残りのデータを受信するには、別のスキャンを実行する必要があります。 - 後続のスキャンを実行するには、JSON 応答の ​`LastEvaluatedKey`​ 項目の値を ​`Scan`​ 操作の Studio 設定内の ​`Exclusive start keys`​ 項目に適用します。 操作でデータのすべてのページが返された場合、JSON 応答の ​`LastEvaluatedKey`​ 値は null です。 ### [](#テーブルのスキャンフロー)テーブルのスキャンフロー 次のスクリーンショットは、Amazon DynamoDB テーブルをスキャンするための Anypoint Studio フローを示しています。 ![Amazon DynamoDB テーブルをスキャンするための Studio フロー](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.4/_images/amazon-dynamodb-scan-flow.png) Figure 8. このサンプルフローを使用して、Amazon DynamoDB テーブルをスキャンします。 ### [](#事前手順-2)事前手順 次の手順に従って、Amazon DynamoDB テーブルのスキャンを開始します。 1. Studio で新しい Mule プロジェクトを作成します。 2. 次のプロパティを ​`mule-artifact.properties`​ ファイルに追加して、Amazon DynamoDB ログイン情報を保持します。 ```text config.accesskey= config.secretkey= ``` 3. プロジェクトの ​`src/main/resources`​ ディレクトリに ​`mule-artifact.properties`​ ファイルを置きます。 ### [](#http-リスナーを設定する-2)HTTP リスナーを設定する `/scantable`​ パスで HTTP 要求をリスンするように ​`HTTP Listener`​ を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`http`​」を検索し、​**\[Listener\]**​ 操作を選択します。 2. **\[Listener\]**​ 操作を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、​`HTTP Listener`​ のグローバル要素設定項目にアクセスします。 4. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択し、​**\[OK\]**​ をクリックします。 5. **\[Listener\]**​ タブの ​**\[Path (パス)\]**​ 項目で、「​`/scantable`​」と入力します。 ### [](#scan-操作を設定する)Scan 操作を設定する 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックして「​`amazon dynamodb`​」を検索します。 2. **\[Amazon DynamoDB Connector\]**​ を選択して ​**\[Add> (追加>)\]**​ をクリックし、​**\[Finish (完了)\]**​ をクリックします。 3. **\[Scan\]**​ 操作を Studio キャンバスの ​**\[Listener\]**​ の右にドラッグします。 4. フローの下の ​**\[Global Elements (グローバル要素)\]**​ リンクをクリックします。 5. [「プロパティ値のプロパティプレースホルダーの使用」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview#property-placeholders)​の説明に従って、以前に作成したプロパティファイルを ​**\[Configuration properties (設定プロパティ)\]**​ 項目に追加します。 6. **\[Create (作成)\]**​ をクリックします。 7. **\[Connector Configuration (コネクタ設定)\]**​ を展開します。 8. **\[Amazon DynamoDB Configuration (Amazon DynamoDB 設定)\]**​ を選択し、​**\[OK\]**​ をクリックします。 9. 次の項目に入力します。
パラメーター 説明 値

Name (名前)

設定名

scan-table-flow

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

${config.accesskey}

Secret Key (シークレットキー)

パスワードの役割を果たすキー。

${config.secretkey}

Region Endpoint (リージョンエンドポイント)

Amazon DynamoDB クライアントに設定するリージョン

us-east-1

10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が Amazon DynamoDB インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 11. **\[OK\]**​ をクリックします。 12. **\[Scan\]**​ タブで、​`Table name`​ の値を ​`Issues`​ に設定します。 ### [](#transform-message-コンポーネントを設定する)Transform Message コンポーネントを設定する `Scan`​ 操作の出力を Java から JSON に変更する ​`Transform Message`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`transform`​」を検索します。 2. **\[Transform Message\]**​ コンポーネントを Studio キャンバスの ​**\[Scan\]**​ の右にドラッグします。 3. **\[Scan\]**​ 操作の ​**\[Output (出力)\]**​ セクションで、​`output/application/java`​ を ​`output/application/json`​ に変更します。 ### [](#configure-logger-scan)Logger コンポーネントを設定する `Scan`​ 操作によって生成された応答を Mule コンソールに出力するように、​`Logger`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`Logger`​」を検索します。 2. **\[Logger\]**​ コンポーネントを Studio キャンバスの ​**\[Transform\]**​ の右にドラッグします。 3. **\[Logger\]**​ タブの ​**\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力します。 ### [](#scan-table-の例の-xml)Scan Table の例の XML Scan Table の例の XML は次のようになります。 ```text ``` ### [](#scan-table-の例への応答)Scan Table の例への応答 `Scan`​ 操作への応答は、次のようになる可能性があります (簡潔にするため、応答の他のセクションは省略されています)。 ```xml { "scannedCount": 2, "lastEvaluatedKey": null, "count": 2, "consumedCapacity": null, "items": [ { "studentID": { "ss": null, "nullvalue": null, "b": null, "bool": null, "ns": null, "l": null, "m": null, "n": null, "bs": null, "s": "102" }, ... ] } ``` ### [](#プロジェクトを実行する-3)プロジェクトを実行する プロジェクトを保存し、Mule アプリケーションとして実行します。 1. **Package Explorer**​ で、プロジェクト名を右クリックし、​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 2. ブラウザーを開き、​`http://localhost:8081/scantable`​ URL を入力して応答を確認します。 Mule コンソールに ​`Scan`​ 操作から生成された応答が表示されます。 ## [](#関連情報)関連情報 - [Amazon API ドキュメント](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/Welcome.html) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Amazon DynamoDB の例 次に、Amazon DynamoDB Connector の一般的なユースケースを示します。 - Amazon DynamoDB テーブルの作成 - Amazon DynamoDB テーブルの削除 - Amazon DynamoDB テーブルスキャンの実行 ## [](#create-table)Amazon DynamoDB テーブルの作成 次の例は、Amazon DynamoDB Connector を使用して Amazon DynamoDB テーブルを作成する方法を示しています。 ### [](#amazon-dynamodb-テーブルの作成フロー)Amazon DynamoDB テーブルの作成フロー 次のスクリーンショットは、Amazon DynamoDB テーブルを作成するための Anypoint Studio フローを示しています。 ![Amazon DynamoDB テーブルを作成するための Studio フロー](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.5/_images/amazon-dynamodb-create-table-flow.png) Figure 1. このサンプルフローを使用して、Amazon DynamoDB テーブルを作成します。 ### [](#preliminary-steps-create)事前手順 次の手順に従って、Amazon DynamoDB テーブルの作成を開始します。 1. Studio で新しい Mule プロジェクトを作成します。 2. 次のプロパティを ​`mule-artifact.properties`​ ファイルに追加して、Amazon DynamoDB ログイン情報を保存します。 ```text config.accesskey= config.secretkey= ``` 3. プロジェクトの ​`src/main/resources`​ ディレクトリに ​`mule-artifact.properties`​ ファイルを置きます。 ### [](#configure-http-listener)HTTP リスナーを設定する `/createtable`​ パスで HTTP 要求をリスンするように ​`HTTP Listener`​ を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`http`​」を検索し、​**\[Listener\]**​ 操作を選択します。 2. **\[Listener\]**​ 操作を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、​`HTTP Listener`​ のグローバル要素設定項目にアクセスします。 4. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択します。 ![HTTP リスナーのグローバル要素](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.5/_images/amazon-dynamodb-http-global-element.png) Figure 2. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択して、ローカルコンピューターで HTTP 要求をリスンします。 5. **\[OK\]**​ をクリックします。 6. **\[Listener\]**​ タブの ​**\[Path (パス)\]**​ 項目で、「​`/createtable`​」と入力します。 ![HTTP リスナータブ](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.5/_images/amazon-dynamodb-http-prop.png) Figure 3. **\[Path (パス)\]**​ 項目に「​`/createtable`​」と入力して、​`/createtable`​ パスで HTTP 要求をリスンします。 ### [](#create-table-操作を設定する)Create Table 操作を設定する `Issues`​ というテーブルを作成する ​`Create Table`​ 操作を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックして「​`amazon dynamodb`​」を検索します。 2. **\[Amazon DynamoDB Connector\]**​ を選択して ​**\[Add> (追加>)\]**​ をクリックし、​**\[Finish (完了)\]**​ をクリックします。 3. **\[Create Table\]**​ 操作を Studio キャンバスの ​**\[Listener\]**​ の右にドラッグします。 4. フローの下の ​**\[Global Elements (グローバル要素)\]**​ リンクをクリックします。 5. [「プロパティ値のプロパティプレースホルダーの使用」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview#property-placeholders)​の説明に従って、以前に作成したプロパティファイルを ​**\[Configuration properties (設定プロパティ)\]**​ 項目に追加します。 6. **\[Create (作成)\]**​ をクリックします。 7. **\[Connector Configuration (コネクタ設定)\]**​ を展開します。 8. **\[Amazon DynamoDB Configuration (Amazon DynamoDB 設定)\]**​ を選択し、​**\[OK\]**​ をクリックします。 9. 次の項目に入力します。
パラメーター 説明 Value (値)

Name (名前)

設定名

create-table-flow

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

${config.accesskey}

Secret Key (シークレットキー)

パスワードの役割を果たすキー

${config.secretkey}​

Region Endpoint (リージョンエンドポイント)

Amazon DynamoDB クライアントに設定するリージョン

us-east-1

次のスクリーンショットは、Amazon DynamoDB Connector のグローバル要素を設定する例を示しています。 ![Amazon DynamoDB グローバル要素](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.5/_images/amazon-dynamodb-global-element.png) Figure 4. グローバル要素の ​**\[Connection (接続)\]**​ セクションで、Amazon DynamoDB にアクセスするために必要なログイン情報を設定します。 10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が Amazon DynamoDB インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 11. **\[OK\]**​ をクリックします。 12. **\[Create Table\]**​ タブで、次の項目を設定します。
項目 説明 ユーザーアクション

Table name (テーブル名)

テーブルの名前

「​Issues​」と入力します。

Attribute definitions (属性定義)

テーブルとそのインデックスのキースキーマを記述する属性の配列

Edit inline​ を選択して緑のプラス記号 (+) をクリックし、次の属性を追加します。

  • IssueId​ (​STRING​ 型)

  • Title​ (​STRING​ 型)

  • CreateDate​ (​STRING​ 型)

  • DueDate​ (​STRING​ 型)

Key schemas (キースキーマ)

テーブルまたはそのインデックスのいずれかの主キーを構成する属性

Edit inline​ を選択して緑のプラス記号 (+) をクリックし、次の属性を追加します。

  • IssueId​ (​HASH​ キー種別)

  • Title​ (​RANGE​ キー種別)

Read capacity units (読み取り容量単位)

Amazon DynamoDB が調整例外を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りの最大数

「​5​」と入力します。

Write capacity units (書き込み容量単位)

Amazon DynamoDB が調整例外を返す前にコンシュームされる 1 秒あたりの書き込みの最大数。

「​5​」と入力します。

Global secondary indexes (グローバルセカンダリインデックス)

テーブルの省略可能な追加キー構造

「Issues テーブルへのセカンダリインデックスの追加」​の説明に従って、「​#[vars.secondary]​」と入力してセカンダリインデックスの変数を作成し、XML コードにセカンダリインデックスを追加します。

次のスクリーンショットは、​`Create table`​ 操作の設定例を示しています。 ![Create table 操作の項目](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.5/_images/amazon-dynamodb-create-table-props.png) Figure 5. `Create table`​ 操作の項目値を入力します。 このスクリーンショットについて説明します。 - 最初の項目では、フロー内の ​`Create table`​ 操作を表すコンポーネントの名前を指定します。 - 2 番目の項目では、作成するテーブルの名前を指定します。 - 3 番目の項目では、新しいテーブルの属性を定義します。 - 4 番目の項目では、新しいテーブルのキースキーマを定義します。 - 5 番目の項目では、Amazon DynamoDB が調整例外を返す前にコンシュームされる 1 秒あたりの厳密な一貫性読み取りと 1 秒あたりの厳密な一貫性書き込みの最大数を指定します。 - 6 番目の項目では、セカンダリインデックスの変数を指定します。 `HTTP Listener`​ および ​`Create table`​ 操作を設定したら、Create Table の例の XML フローは次のようになります。 ```xml ``` ### [](#secondary-index)Issues テーブルへのセカンダリインデックスの追加 グローバルセカンダリインデックスを ​`Issues`​ テーブルに追加するには、XML の ​``​ 要素の前に変数を追加します。 次の例では、3 つのセカンダリインデックスを ​`Issues`​ テーブルに追加します。 - `CreateDateIndex`​ (​`CreateDate`​ パーティションキーと ​`IssueId`​ 並び替えキーを使用) - `TitleIndex`​ (​`Title`​ パーティションキーと ​`IssueId`​ 並び替えキーを使用) - `DueDateIndex`​ (​`DueDate`​ パーティションキーを使用) XML に次の要素を含める必要があります。 - ``​: テーブルからインデックスにコピーする属性を指定します。 この例では、値 ​`ALL`​ はすべての属性がコピーされることを意味します。 ``​ 要素に設定した値に関係なく、主キー属性とインデックスキー属性は自動的にコピーされます。 - `ProvisionedThroughput`​: 読み取りおよび書き込みアクティビティのスループットをプロビジョニングします。 - `KeySchema`​: インデックスのキースキーマを指定します。 ```xml ``` ### [](#configure-logger-create)Logger コンポーネントを設定する `Create Table`​ 操作によって生成された応答を Mule コンソールに出力するように、​`Logger`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`logger`​」を検索します。 2. **\[Logger\]**​ コンポーネントを Studio キャンバスの ​**\[Create Table\]**​ の右にドラッグします。 3. **\[Logger\]**​ タブの ​**\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力します。 ![\[Logger\] タブ](_images/amazon-dynamodb-logger-props.png) Figure 6. **\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力し、Mule コンソールに操作の応答を出力します。 ### [](#完全な-create-table-の例の-xml)完全な Create Table の例の XML 完全な Create Table の例の XML は次のようになります。 ```xml ``` ### [](#プロジェクトを実行する)プロジェクトを実行する プロジェクトを保存し、Mule アプリケーションとして実行します。 1. **Package Explorer**​ で、プロジェクト名を右クリックし、​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 2. ブラウザーを開き、​`http://localhost:8081/createtable`​ URL を入力して応答を確認します。 Mule コンソールに ​`Create table`​ 操作から生成された応答が表示されます。 ## [](#delete-table)Amazon DynamoDB テーブルの削除 次の例は、Amazon DynamoDB Connector を使用して Amazon DynamoDB テーブルを削除する方法を示しています。 ### [](#dynamodb-テーブルの削除フロー)DynamoDB テーブルの削除フロー 次のスクリーンショットは、Amazon DynamoDB テーブルを削除するための Anypoint Studio フローを示しています。 ![Amazon DynamoDB テーブルを削除するための Studio フロー](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.5/_images/amazon-dynamodb-delete-table-flow.png) Figure 7. このサンプルフローを使用して、Amazon DynamoDB テーブルを削除します。 ### [](#事前手順)事前手順 次の手順に従って、Amazon DynamoDB テーブルの削除を開始します。 1. Studio で新しい Mule プロジェクトを作成します。 2. 次のプロパティを ​`mule-artifact.properties`​ ファイルに追加して、Amazon DynamoDB ログイン情報を保持します。 ```text config.accesskey= config.secretkey= ``` 3. プロジェクトの ​`src/main/resources`​ ディレクトリに ​`mule-artifact.properties`​ ファイルを置きます。 ### [](#http-リスナーを設定する)HTTP リスナーを設定する `/deletetable`​ パスで HTTP 要求をリスンするように ​`HTTP Listener`​ を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`http`​」を検索し、​**\[Listener\]**​ 操作を選択します。 2. **\[Listener\]**​ 操作を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、​`HTTP Listener`​ のグローバル要素設定項目にアクセスします。 4. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択し、​**\[OK\]**​ をクリックします。 5. **\[Listener\]**​ タブの ​**\[Path (パス)\]**​ 項目で、「​`/deletetable`​」と入力します。 ### [](#delete-table-操作を設定する)Delete Table 操作を設定する `Issues`​ テーブルを削除する ​`Delete table`​ 操作を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックして「​`amazon dynamodb`​」を検索します。 2. **\[Amazon DynamoDB Connector\]**​ を選択して ​**\[Add> (追加>)\]**​ をクリックし、​**\[Finish (完了)\]**​ をクリックします。 3. **\[Delete Table\]**​ 操作を Studio キャンバスの ​**\[Listener\]**​ の右にドラッグします。 4. フローの下の ​**\[Global Elements (グローバル要素)\]**​ リンクをクリックします。 5. [「プロパティ値のプロパティプレースホルダーの使用」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview#property-placeholders)​の説明に従って、以前に作成したプロパティファイルを ​**\[Configuration properties (設定プロパティ)\]**​ 項目に追加します。 6. **\[Create (作成)\]**​ をクリックします。 7. **\[Connector Configuration (コネクタ設定)\]**​ を展開します。 8. **\[Amazon DynamoDB Configuration (Amazon DynamoDB 設定)\]**​ を選択し、​**\[OK\]**​ をクリックします。 9. 次の項目に入力します。
パラメーター 説明 Value (値)

Name (名前)

設定名

delete-table-flow

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

${config.accesskey}

Secret Key (シークレットキー)

パスワードの役割を果たすキー

${config.secretkey}

Region Endpoint (リージョンエンドポイント)

Amazon DynamoDB クライアントに設定するリージョン

us-east-1

対応する XML の設定は次のようになります。 ```xml ``` 10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が Amazon DynamoDB インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 11. **\[OK\]**​ をクリックします。 12. **\[Delete table\]**​ タブで、​`Table name`​ の値を ​`Issues`​ に設定します。 ### [](#configure-logger-delete)Logger コンポーネントを設定する `Delete table`​ 操作によって生成された応答を Mule コンソールに出力するように、​`Logger`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`logger`​」を検索します。 2. **\[Logger\]**​ コンポーネントを Studio キャンバスの ​**\[Delete Table\]**​ の右にドラッグします。 3. **\[Logger\]**​ タブで、​**\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力します。 ### [](#delete-table-の例の-xml)Delete Table の例の XML Delete Table の例の XML は次のようになります。 ```xml ``` ### [](#プロジェクトを実行する-2)プロジェクトを実行する プロジェクトを保存し、Mule アプリケーションとして実行します。 1. **Package Explorer**​ で、プロジェクト名を右クリックし、​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 2. ブラウザーを開き、​`http://localhost:8081/deletetable`​ URL を入力して応答を確認します。 Mule コンソールに ​`Delete table`​ 操作から生成された応答が表示されます。 ## [](#scan-operation)Amazon DynamoDB テーブルのスキャン 次の例は、Amazon DynamoDB Connector を使用して Amazon DynamoDB テーブルをスキャンする方法を示しています。 Amazon DynamoDB Connector を使用してスキャンを実行する場合、次の考慮事項が適用されます。 - DynamoDB AWS SDK は、結果を特定のページに分割します。 返される結果には 1 MB の制限が適用されます。この制限を超えた場合、残りのデータを受信するには、別のスキャンを実行する必要があります。 - 後続のスキャンを実行するには、JSON 応答の ​`LastEvaluatedKey`​ 項目の値を ​`Scan`​ 操作の Studio 設定内の ​`Exclusive start keys`​ 項目に適用します。 操作でデータのすべてのページが返された場合、JSON 応答の ​`LastEvaluatedKey`​ 値は null です。 ### [](#テーブルのスキャンフロー)テーブルのスキャンフロー 次のスクリーンショットは、Amazon DynamoDB テーブルをスキャンするための Anypoint Studio フローを示しています。 ![Amazon DynamoDB テーブルをスキャンするための Studio フロー](/mulesoft/current/ja-jp/amazon-dynamodb-connector/1.5/_images/amazon-dynamodb-scan-flow.png) Figure 8. このサンプルフローを使用して、Amazon DynamoDB テーブルをスキャンします。 ### [](#事前手順-2)事前手順 次の手順に従って、Amazon DynamoDB テーブルのスキャンを開始します。 1. Studio で新しい Mule プロジェクトを作成します。 2. 次のプロパティを ​`mule-artifact.properties`​ ファイルに追加して、Amazon DynamoDB ログイン情報を保持します。 ```text config.accesskey= config.secretkey= ``` 3. プロジェクトの ​`src/main/resources`​ ディレクトリに ​`mule-artifact.properties`​ ファイルを置きます。 ### [](#http-リスナーを設定する-2)HTTP リスナーを設定する `/scantable`​ パスで HTTP 要求をリスンするように ​`HTTP Listener`​ を設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで「​`http`​」を検索し、​**\[Listener\]**​ 操作を選択します。 2. **\[Listener\]**​ 操作を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、​`HTTP Listener`​ のグローバル要素設定項目にアクセスします。 4. **\[Host (ホスト)\]**​ 項目で ​`localhost`​ を選択し、​**\[OK\]**​ をクリックします。 5. **\[Listener\]**​ タブの ​**\[Path (パス)\]**​ 項目で、「​`/scantable`​」と入力します。 ### [](#scan-操作を設定する)Scan 操作を設定する 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックして「​`amazon dynamodb`​」を検索します。 2. **\[Amazon DynamoDB Connector\]**​ を選択して ​**\[Add> (追加>)\]**​ をクリックし、​**\[Finish (完了)\]**​ をクリックします。 3. **\[Scan\]**​ 操作を Studio キャンバスの ​**\[Listener\]**​ の右にドラッグします。 4. フローの下の ​**\[Global Elements (グローバル要素)\]**​ リンクをクリックします。 5. [「プロパティ値のプロパティプレースホルダーの使用」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview#property-placeholders)​の説明に従って、以前に作成したプロパティファイルを ​**\[Configuration properties (設定プロパティ)\]**​ 項目に追加します。 6. **\[Create (作成)\]**​ をクリックします。 7. **\[Connector Configuration (コネクタ設定)\]**​ を展開します。 8. **\[Amazon DynamoDB Configuration (Amazon DynamoDB 設定)\]**​ を選択し、​**\[OK\]**​ をクリックします。 9. 次の項目に入力します。
パラメーター 説明 Value (値)

Name (名前)

設定名

scan-table-flow

Access Key (アクセスキー)

アカウントを所有するユーザーを一意に識別する英数字のテキスト文字列

${config.accesskey}

Secret Key (シークレットキー)

パスワードの役割を果たすキー

${config.secretkey}

Region Endpoint (リージョンエンドポイント)

Amazon DynamoDB クライアントに設定するリージョン

us-east-1

10. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が Amazon DynamoDB インスタンスに接続できることを確認します。 - 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。 - 接続に失敗した場合は、誤ったパラメーターを確認して修正し、もう一度テストを実行してください。 11. **\[OK\]**​ をクリックします。 12. **\[Scan\]**​ タブで、​`Table name`​ の値を ​`Issues`​ に設定します。 ### [](#transform-message-コンポーネントを設定する)Transform Message コンポーネントを設定する `Scan`​ 操作の出力を Java から JSON に変更する ​`Transform Message`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`transform`​」を検索します。 2. **\[Transform Message\]**​ コンポーネントを Studio キャンバスの ​**\[Scan\]**​ の右にドラッグします。 3. **\[Scan\]**​ 操作の ​**\[Output (出力)\]**​ セクションで、​`output/application/java`​ を ​`output/application/json`​ に変更します。 ### [](#configure-logger-scan)Logger コンポーネントを設定する `Scan`​ 操作によって生成された応答を Mule コンソールに出力するように、​`Logger`​ コンポーネントを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、「​`Logger`​」を検索します。 2. **\[Logger\]**​ コンポーネントを Studio キャンバスの ​**\[Transform\]**​ の右にドラッグします。 3. **\[Logger\]**​ タブの ​**\[Message (メッセージ)\]**​ 項目に「​`#[payload]`​」と入力します。 ### [](#scan-table-の例の-xml)Scan Table の例の XML Scan Table の例の XML は次のようになります。 ```text ``` ### [](#scan-table-の例への応答)Scan Table の例への応答 `Scan`​ 操作への応答は、次のようになる可能性があります (簡潔にするため、応答の他のセクションは省略されています)。 ```xml { "scannedCount": 2, "lastEvaluatedKey": null, "count": 2, "consumedCapacity": null, "items": [ { "studentID": { "ss": null, "nullvalue": null, "b": null, "bool": null, "ns": null, "l": null, "m": null, "n": null, "bs": null, "s": "102" }, ... ] } ``` ### [](#プロジェクトを実行する-3)プロジェクトを実行する プロジェクトを保存し、Mule アプリケーションとして実行します。 1. **Package Explorer**​ で、プロジェクト名を右クリックし、​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。 2. ブラウザーを開き、​`http://localhost:8081/scantable`​ URL を入力して応答を確認します。 Mule コンソールに ​`Scan`​ 操作から生成された応答が表示されます。 ## [](#関連情報)関連情報 - [Amazon API ドキュメント](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/Welcome.html) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Anypoint Studio を使用した Amazon DynamoDB Connector の設定 Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。 Studio でコネクタを追加および設定する手順は、次のとおりです。 1. [Mule プロジェクトを作成します](#create-mule-project)​。 2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。 3. [コネクタのフローの入力元を設定します](#configure-input-source)​。 4. [フローにコネクタの操作を追加します](#add-connector-operation)​。 5. [コネクタのグローバル要素を設定します](#configure-global-element)​。 6. [その他のコネクタ項目を設定します](#configure-other-fields)​。 Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを読んだ後に、コネクタ項目に関する追加情報が必要な場合は、​[「Amazon DynamoDB Connector リファレンス」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-reference)​を参照してください。 ## [](#create-mule-project)Mule プロジェクトを作成する Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。 1. Anypoint Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。 2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。 ## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する Amazon DynamoDB Connector を Mule プロジェクトに追加すると、自動的に XML コードにコネクタの名前空間およびスキーマの場所が入力され、プロジェクトの ​`pom.xml`​ ファイルに必要な連動関係が追加されます。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。 2. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目に「​`amazon dynamodb`​」と入力します。 3. **\[Available modules (使用可能なモジュール)\]**​ で、​**\[Amazon DynamoDB\]**​ をクリックします。 4. **\[Add (追加)\]**​ をクリックします。 5. **\[Finish (完了)\]**​ をクリックします。 Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。 ## [](#configure-input-source)入力元の設定 入力元は、指定された条件が満たされたときにフローを開始します。次の入力元のいずれかを設定して、Amazon DynamoDB Connector で使用できます。 - `HTTP Listener`​: 設定されたホストとポートで要求を受信するたびにフローを開始 - `Scheduler`​: 時間ベースの条件が満たされたときにフローを開始 たとえば、​`HTTP リスナー`​を設定する手順は、次のとおりです。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[HTTP\]**​ > ​**\[Listener\]**​ を選択します。 2. **\[Listener\]**​ を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。 4. **\[Path (パス)\]**​ 項目の値を指定します。 5. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、アプリケーション内のすべての ​`HTTP Listener`​ インスタンスで使用できるグローバル要素を設定します。 6. **\[General (一般)\]**​ タブで、接続情報を指定します。 7. **\[TLS\]**​ タブで、必要に応じて TLS 情報を指定します。 8. **\[Advanced (詳細)\]**​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。 9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が特定のサーバーに接続できることを確認します。 10. **\[OK\]**​ をクリックします。 ## [](#add-connector-operation)フローにコネクタの操作を追加する フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。 Amazon DynamoDB Connector の操作を追加するには、次の手順に従います。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Amazon DynamoDB\]**​ を選択し、目的の操作を選択します。 2. その操作を Studio キャンバスの入力元の右にドラッグします。 ## [](#configure-global-element)コネクタのグローバル要素を設定する コネクタを設定する場合、最適なのはアプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することです。グローバル要素の設定では、コネクタが対象の Amazon DynamoDB システムにアクセスするために使用する認証ログイン情報を提供する必要があります。Amazon DynamoDB Connector では、基本認証とロール認証の両方がサポートされています。 Amazon DynamoDB Connector のグローバル要素を設定する手順は、次のとおりです。 1. Studio キャンバスでコネクタを選択します。 2. 操作の設定画面で、​`Connector configuration`​ 項目の横にあるプラス記号 (+) をクリックし、グローバル要素設定項目にアクセスします。 3. **\[General (一般)\]**​ タブで、​[「基本認証」](#basic-authentication)​および​[「ロール認証」](#role-authentication)​セクションの説明に従って基本認証またはロール認証を設定します。 ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。ANT スタイルのプロパティホルダーの使用についての詳細は、​[「Anypoint Connector 設定」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview)​を参照してください。 4. **\[Advanced (詳細)\]**​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。 5. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。 6. **\[OK\]**​ をクリックします。 ### [](#basic-authentication)基本認証 **\[Global Element Properties (グローバル要素のプロパティ)\]**​ 画面の ​**\[General (一般)\]**​ タブで次の情報を入力し、基本認証を設定します。
項目 ユーザーアクション

名前

設定名を入力します。

Connection (接続)

[Basic (基本)]​ を選択します。

Session Token (セッショントークン)

必要に応じて、Amazon Security Token Service (STS) が提供するセッショントークンを入力します。

Access Key (アクセスキー)

Amazon が提供するアクセスキーを入力します。

Secret Key (シークレットキー)

Amazon が提供するシークレットキーを入力します。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

AWS 環境からログイン情報を取得するには、​true​ に設定します。

Region Endpoint (リージョンエンドポイント)

サービスのリージョンエンドポイントを選択します。

次のスクリーンショットは、基本認証の設定例を示しています。 ![認証を設定するには、\*\[Connection (接続)\]\* 項目で \`\[Basic (基本)\]\` を選択し、\*\[General (一般)\]\* タブの項目に入力します。](_images/amazon-dynamodb-basic-authentication.png) Figure 1. 基本認証の項目 最初の項目は、コネクタが基本認証を使用することを指定する場所を示しています。2 番目の項目は、基本認証に関連する項目を含む ​**\[General (一般)\]**​ タブを示しています。 ### [](#role-authentication)ロール認証 グローバル要素設定画面の ​**\[General (一般)\]**​ タブで次の情報を入力し、ロール認証を設定します。
項目 ユーザーアクション

名前

設定名を入力します。

Connection (接続)

[Role (ロール)]​ を選択します。

Role ARN (ロール ARN)

クロスアカウントアクセスを取得することを前提とするロールを入力します。

Access Key (アクセスキー)

Amazon が提供するアクセスキーを入力します。

Secret Key (シークレットキー)

Amazon が提供するシークレットキーを入力します。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

AWS 環境からログイン情報を取得するには、​true​ に設定します。

Region Endpoint (リージョンエンドポイント)

サービスのリージョンエンドポイントを選択します。

次のスクリーンショットは、ロール認証の設定例を示しています。 ![ロール認証を設定するには、\*\[Connection (接続)\]\* 項目で \[Role (ロール)\] を選択し、\*\[General (一般)\]\* タブの項目に入力します。](_images/amazon-dynamodb-role-authentication.png) Figure 2. ロール認証の項目 最初の項目は、コネクタがロール認証を使用することを指定する場所を示しています。2 番目の項目は、ロール認証に関連する項目を含む ​**\[General (一般)\]**​ タブを示しています。 ## [](#configure-other-fields)その他のコネクタ項目の設定 Amazon DynamoDB Connector のグローバル要素を設定したら、コネクタの他の必須項目を設定します。
項目 説明

Table name (テーブル名)

作成するテーブルの名前。

Attribute definitions (属性定義)

テーブルとそのインデックスのキースキーマを記述する属性。

Key schemas (キースキーマ)

テーブルまたはインデックスの主キーを構成する属性。

## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [Amazon DynamoDB Connector リファレンス](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.4/amazon-dynamodb-connector-reference) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Anypoint Studio を使用した Amazon DynamoDB Connector の設定 Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。 Studio でコネクタを追加および設定する手順は、次のとおりです。 1. [Mule プロジェクトを作成します](#create-mule-project)​。 2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。 3. [コネクタのフローの入力元を設定します](#configure-input-source)​。 4. [フローにコネクタの操作を追加します](#add-connector-operation)​。 5. [コネクタのグローバル要素を設定します](#configure-global-element)​。 6. [その他のコネクタ項目を設定します](#configure-other-fields)​。 Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを読んだ後に、コネクタ項目に関する追加情報が必要な場合は、​[「Amazon DynamoDB Connector リファレンス」](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-reference)​を参照してください。 ## [](#create-mule-project)Mule プロジェクトを作成する Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。 1. Anypoint Studio で、​**\[File (ファイル)\] > \[New (新規)\] > \[Mule Project (Mule プロジェクト)\]**​ を選択します。 2. Mule プロジェクトの名前を入力して、​**\[Finish (完了)\]**​ をクリックします。 ## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する Amazon DynamoDB Connector を Mule プロジェクトに追加すると、自動的に XML コードにコネクタの名前空間およびスキーマの場所が入力され、プロジェクトの ​`pom.xml`​ ファイルに必要な連動関係が追加されます。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。 2. **\[Add Modules to Project (モジュールをプロジェクトに追加)\]**​ で、検索項目に「​`amazon dynamodb`​」と入力します。 3. **\[Available modules (使用可能なモジュール)\]**​ で、​**\[Amazon DynamoDB\]**​ をクリックします。 4. **\[Add (追加)\]**​ をクリックします。 5. **\[Finish (完了)\]**​ をクリックします。 Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。 ## [](#configure-input-source)入力元を設定する 入力元は、指定された条件が満たされたときにフローを開始します。次の入力元のいずれかを設定して、Amazon DynamoDB Connector で使用できます。 - `HTTP Listener`​: 設定されたホストとポートで要求を受信するたびにフローを開始 - `Scheduler`​: 時間ベースの条件が満たされたときにフローを開始 たとえば、​`HTTP リスナー`​を設定する手順は、次のとおりです。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[HTTP\]**​ > ​**\[Listener\]**​ を選択します。 2. **\[Listener\]**​ を Studio キャンバスにドラッグします。 3. **\[Listener\]**​ タブで、必要に応じて ​**\[Display Name (表示名)\]**​ 項目の値を変更します。 4. **\[Path (パス)\]**​ 項目の値を指定します。 5. **\[Connector configuration (コネクタ設定)\]**​ 項目の横にあるプラス記号 (+) をクリックして、アプリケーション内のすべての ​`HTTP Listener`​ インスタンスで使用できるグローバル要素を設定します。 6. **\[General (一般)\]**​ タブで、接続情報を指定します。 7. **\[TLS\]**​ タブで、必要に応じて TLS 情報を指定します。 8. **\[Advanced (詳細)\]**​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。 9. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が特定のサーバーに接続できることを確認します。 10. **\[OK\]**​ をクリックします。 ## [](#add-connector-operation)フローにコネクタの操作を追加する フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。 Amazon DynamoDB Connector の操作を追加するには、次の手順に従います。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Amazon DynamoDB\]**​ を選択し、目的の操作を選択します。 2. その操作を Studio キャンバスの入力元の右にドラッグします。 ## [](#configure-global-element)コネクタのグローバル要素を設定する コネクタを設定する場合、最適なのはアプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することです。グローバル要素の設定では、コネクタが対象の Amazon DynamoDB システムにアクセスするために使用する認証ログイン情報を提供する必要があります。Amazon DynamoDB Connector では、基本認証とロール認証の両方がサポートされています。 Amazon DynamoDB Connector のグローバル要素を設定する手順は、次のとおりです。 1. Studio キャンバスでコネクタを選択します。 2. 操作の設定画面で、​`Connector configuration`​ 項目の横にあるプラス記号 (+) をクリックし、グローバル要素設定項目にアクセスします。 3. **\[General (一般)\]**​ タブで、​[「基本認証」](#basic-authentication)​および​[「ロール認証」](#role-authentication)​セクションの説明に従って基本認証またはロール認証を設定します。 ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。ANT スタイルのプロパティホルダーの使用についての詳細は、​[「Anypoint Connector 設定」](https://docs.mulesoft.com/connectors/introduction/intro-connector-configuration-overview)​を参照してください。 4. **\[Advanced (詳細)\]**​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。 5. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。 6. **\[OK\]**​ をクリックします。 ### [](#basic-authentication)基本認証 **\[Global Element Properties (グローバル要素のプロパティ)\]**​ 画面の ​**\[General (一般)\]**​ タブで次の情報を入力し、基本認証を設定します。
項目 ユーザーアクション

Name (名前)

設定名を入力します。

Connection (接続)

[Basic (基本)]​ を選択します。

Session Token (セッショントークン)

必要に応じて、Amazon Security Token Service (STS) が提供するセッショントークンを入力します。

Access Key (アクセスキー)

Amazon が提供するアクセスキーを入力します。

Secret Key (シークレットキー)

Amazon が提供するシークレットキーを入力します。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

AWS 環境からログイン情報を取得するには、​true​ に設定します。

Region Endpoint (リージョンエンドポイント)

サービスのリージョンエンドポイントを選択します。

次のスクリーンショットは、基本認証の設定例を示しています。 ![\[Connection (接続)\] 項目で \[Basic (基本)\] オプションが選択されています](_images/amazon-dynamodb-basic-authentication.png) Figure 1. 基本認証の項目 最初の項目は、コネクタが基本認証を使用することを指定する場所を示しています。2 番目の項目は、基本認証に関連する項目を含む ​**\[General (一般)\]**​ タブを示しています。 ### [](#role-authentication)ロール認証 グローバル要素設定画面の ​**\[General (一般)\]**​ タブで次の情報を入力し、ロール認証を設定します。
項目 ユーザーアクション

Name (名前)

設定名を入力します。

Connection (接続)

[Role (ロール)]​ を選択します。

Role ARN (ロール ARN)

クロスアカウントアクセスを取得することを前提とするロールを入力します。

Access Key (アクセスキー)

Amazon が提供するアクセスキーを入力します。

Secret Key (シークレットキー)

Amazon が提供するシークレットキーを入力します。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

AWS 環境からログイン情報を取得するには、​true​ に設定します。

Region Endpoint (リージョンエンドポイント)

サービスのリージョンエンドポイントを選択します。

次のスクリーンショットは、ロール認証の設定例を示しています。 ![\[Connection (接続)\] 項目で \[Role (ロール)\] オプションが選択されています](_images/amazon-dynamodb-role-authentication.png) Figure 2. ロール認証の項目 最初の項目は、コネクタがロール認証を使用することを指定する場所を示しています。2 番目の項目は、ロール認証に関連する項目を含む ​**\[General (一般)\]**​ タブを示しています。 ## [](#configure-other-fields)その他のコネクタ項目の設定 Amazon DynamoDB Connector のグローバル要素を設定したら、コネクタの他の必須項目を設定します。
項目 説明

Table name (テーブル名)

作成するテーブルの名前。

Attribute definitions (属性定義)

テーブルとそのインデックスのキースキーマを記述する属性。

Key schemas (キースキーマ)

テーブルまたはインデックスの主キーを構成する属性。

## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Anypoint Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [Amazon DynamoDB Connector リファレンス](https://docs.mulesoft.com/jp/amazon-dynamodb-connector/1.5/amazon-dynamodb-connector-reference) - [MuleSoft ヘルプセンター](https://help.mulesoft.com)