10.3. AWS-DDB


DDB コンポーネント

Camel 2.10 以降で利用可能
DynamoDB コンポーネントは、Amazon の DynamoDB サービスからデータの保存および取得をサポートします。
前提条件
有効な Amazon Web Services 開発者アカウントを持っていて、Amazon DynamoDB を使用するためにサインアップしている必要がある。詳細は、Amazon DynamoDB を参照してください。

URI 形式

aws-ddb://domainName[?options]
Copy to Clipboard Toggle word wrap
URI にクエリーオプションは ?options=value&option2=value&.. の形式で追加できます。

URI オプション

Expand
名前 デフォルト値 コンテキスト 説明
amazonDDBClient null プロデューサー レジストリーの com.amazonaws.services.dynamodb.AmazonDynamoDB への参照。
accessKey null プロデューサー Amazon AWS Access Key
secretKey null プロデューサー Amazon AWS Secret Key
amazonDdbEndpoint null プロデューサー AWS-DDB クライアントが動作するリージョン。
tableName null プロデューサー 現在操作しているテーブルの名前。
readCapacity 0 プロデューサー テーブルからリソースを読み取るために予約するプロビジョニングされたスループット
writeCapacity 0 プロデューサー テーブルにリソースを書き込むために予約するプロビジョニングされたスループット。
consistentRead false プロデューサー データの読み取り時に強力な整合性を適用するべきかどうかを決定します。
operation PutAttributes プロデューサー 有効な値は BatchGetItems、DeleteItem、DeleteTable、DescribeTable、GetItem、PutItem、Query、Scan Scan、UpdateItem、UpdateTable です。
proxyHost null プロデューサー クライアント定義内で使用されるプロキシーホストを指定します。
proxyPort null プロデューサー クライアント定義内で使用されるプロキシーポートを指定します。
必要な DDB コンポーネントオプション

使用方法

DDB プロデューサーによって評価されるメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbBatchItems Map<String, KeysAndAttributes> プライマリーキーによって取得するテーブル名と対応する項目のマップ。
CamelAwsDdbTableName 文字列 この操作のテーブル名。
CamelAwsDdbKey Map<String, AttributeValue> テーブル内の各項目を一意に識別するプライマリーキー。
CamelAwsDdbReturnValues 文字列 変更前または変更後の属性の名前および値のペアを取得する場合は、このパラメーターを使用します (NONE、ALL_OLD、UPDATED_OLD、ALL_NEW、UPDATED_NEW)。
CamelAwsDdbUpdateCondition Map<String, ExpectedAttributeValue> 条件変更の属性を指定します。
CamelAwsDdbAttributeNames Collection<String> 属性名が指定されていない場合、すべての属性が返されます。
CamelAwsDdbConsistentRead ブール値 true に設定すると、一貫性のある読み取りが発行されます。それ以外の場合は、最終的に一貫性が使用されます。
CamelAwsDdbItem Map<String, AttributeValue> アイテムの属性のマップ。アイテムを定義するプライマリーキー値を含める必要があります。
CamelAwsDdbKeyConditions Map<String, Condition> このヘッダーはクエリーの選択基準を指定し、CamelAwsDdbHashKeyValueCamelAwsDdbScanRangeKeyConditionの 2 つの古いヘッダーをマージします。
CamelAwsDdbStartKey キー 以前のクエリーを続行するアイテムのプライマリーキー。
CamelAwsDdbLimit 整数 返すアイテムの最大数。
CamelAwsDdbScanIndexForward ブール値 インデックスの順方向または逆方向のトラバーサルを指定します。
CamelAwsDdbScanFilter Map<String, Condition> スキャン結果を評価し、目的の値のみを返します。
CamelAwsDdbUpdateValues Map<String, AttributeValueUpdate> 更新の新しい値とアクションへの属性名のマップ。

BatchGetItems 操作中に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbBatchResponse Map<String,BatchResponse> テーブル名およびテーブルの各項目属性。
CamelAwsDdbUnprocessedKeys Map<String,KeysAndAttributes> テーブルのマップと、現在の応答で処理されなかった対応するキーが含まれます。

DeleteItem 操作時に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbAttributes Map<String, AttributeValue> 操作によって返される属性の一覧。

DeleteTable 操作時に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbProvisionedThroughput ProvisionedThroughputDescription このテーブルの ProvisionedThroughput プロパティーの値
CamelAwsDdbCreationDate 日付 このテーブルの DateTime の作成。
CamelAwsDdbTableItemCount Long このテーブルのアイテム数。
CamelAwsDdbKeySchema List<KeySchemaElement> このテーブルのプライマリーキーを識別する KeySchema。
CamelAwsDdbTableName 文字列 テーブル名。
CamelAwsDdbTableSize Long テーブルサイズ(バイト単位)。
CamelAwsDdbTableStatus 文字列 テーブルのステータス: CREATING、UPDATING、DELETING、ACTIVE

DescribeTable 操作中に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbProvisionedThroughput ProvisionedThroughputDescription このテーブルの ProvisionedThroughput プロパティーの値
CamelAwsDdbCreationDate 日付 このテーブルの DateTime の作成。
CamelAwsDdbTableItemCount Long このテーブルのアイテム数。
CamelAwsDdbKeySchema
List<KeySchemaElement>
このテーブルのプライマリーキーを識別する KeySchema。
CamelAwsDdbTableName 文字列 テーブル名。
CamelAwsDdbTableSize Long テーブルサイズ(バイト単位)。
CamelAwsDdbTableStatus 文字列 テーブルのステータス: CREATING、UPDATING、DELETING、ACTIVE
CamelAwsDdbReadCapacity Long このテーブルの ReadCapacityUnits プロパティー。
CamelAwsDdbWriteCapacity Long このテーブルの WriteCapacityUnits プロパティー。

GetItem 操作時に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbAttributes Map<String, AttributeValue> 操作によって返される属性の一覧。

PutItem 操作中に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbAttributes Map<String, AttributeValue> 操作によって返される属性の一覧。

Query 操作時に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbItems List<java.util.Map<String,AttributeValue>> 操作によって返される属性の一覧。
CamelAwsDdbLastEvaluatedKey キー 前の結果セットを含む、クエリー操作が停止した項目のプライマリーキー。
CamelAwsDdbConsumedCapacity double 操作中に消費された、テーブルのプロビジョニングされたスループットのキャパシティーユニットの数。
CamelAwsDdbCount 整数 応答のアイテム数。

Scan 操作時に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbItems List<java.util.Map<String,AttributeValue>> 操作によって返される属性の一覧。
CamelAwsDdbLastEvaluatedKey キー 前の結果セットを含む、クエリー操作が停止した項目のプライマリーキー。
CamelAwsDdbConsumedCapacity double 操作中に消費された、テーブルのプロビジョニングされたスループットのキャパシティーユニットの数。
CamelAwsDdbCount 整数 応答のアイテム数。
CamelAwsDdbScannedCount 整数 フィルターが適用される前の完全なスキャン内のアイテムの数。

UpdateItem 操作時に設定されたメッセージヘッダー

Expand
ヘッダー タイプ 説明
CamelAwsDdbAttributes Map<String, AttributeValue> 操作によって返される属性の一覧。

高度な AmazonDynamoDB 設定

AmazonDynamoDB インスタンス設定をさらに制御する必要がある場合は、独自のインスタンスを作成し、URI から参照できます。
from("direct:start")
.to("aws-ddb://domainName?amazonDDBClient=#client");
Copy to Clipboard Toggle word wrap
#client は、レジストリー内の AmazonDynamoDB を参照します。
たとえば、Camel アプリケーションがファイアウォールの背後で実行されている場合は、以下のようになります。
AWSCredentials awsCredentials = new BasicAWSCredentials("myAccessKey", "mySecretKey");
ClientConfiguration clientConfiguration = new ClientConfiguration();
clientConfiguration.setProxyHost("http://myProxyHost");
clientConfiguration.setProxyPort(8080);

AmazonDynamoDB client = new AmazonDynamoDBClient(awsCredentials, clientConfiguration);

registry.bind("client", client);
Copy to Clipboard Toggle word wrap

Dependencies

Maven ユーザーは、以下の依存関係を pom.xml に追加する必要があります。
pom.xml
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-aws</artifactId>
    <version>${camel-version}</version>
</dependency>
Copy to Clipboard Toggle word wrap
${camel-version} は、実際のバージョンの Camel (2.10 以降)に置き換える必要があります。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat