の操作 DynamoDB - AWS SDK for Java 2.x
DynamoDB クライアントを選択するDynamoDB クライアントを設定するこのトピックで説明する内容

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

の操作 DynamoDB

DynamoDB は、高速で予測可能なパフォーマンスとシームレスなスケーラビリティを提供するフルマネージド NoSQL データベースサービスです。このセクションでは、 AWS SDK for Java 2.x を使用して DynamoDB を操作する方法について説明します。

DynamoDB クライアントを選択する

SDK には、DynamoDB を操作するための 2 つの主要なアプローチがあります。

低レベルクライアント (DynamoDbClient)

DynamoDB オペレーションへの直接アクセスを提供し、リクエストとレスポンスを完全に制御します。きめ細かな制御が必要な場合や動的スキーマを使用する場合は、このクライアントを使用します。

拡張クライアント (DynamoDbEnhancedClient）

Java オブジェクトと DynamoDB 項目間の自動マッピングによるオブジェクト指向プログラミングを提供します。また、固定スキーマに従わない JSON のようなデータを操作するためのドキュメント指向の機能も提供します。明確に定義されたデータモデルまたはドキュメントタイプのデータを使用する場合は、このクライアントを使用します。

DynamoDB クライアントを設定する

DynamoDB を使用する前に、最適なパフォーマンスと信頼性を実現するようにクライアントを設定します。

DynamoDB の再試行動作を理解する

DynamoDB クライアントは、デフォルトの最大再試行回数 8 を使用します。これは他の AWS のサービス クライアントよりも高くなります。この再試行回数の増加は、DynamoDB の分散性および一時的な容量制限の処理に役立ちます。再試行戦略の詳細については、「」を参照してくださいで再試行動作を設定する AWS SDK for Java 2.x。

アカウントベースのエンドポイントでパフォーマンスを最適化する

DynamoDB はAWS 、アカウント ID を使用してリクエストのルーティングを合理化することで、パフォーマンスを向上させるアカウントベースのエンドポイントを提供します。 AWS

この機能を使用するには、 のバージョン 2.28.4 以降が必要です AWS SDK for Java 2.x。最新バージョンは Maven 中央リポジトリにあります。サポートされている SDK バージョンでは、新しいエンドポイントが自動的に使用されます。

アカウントベースのルーティングをオプトアウトするには、次のいずれかのオプションを選択します。

  • を AccountIdEndpointModeに設定して DynamoDB サービスクライアントを設定しますDISABLED。

  • 環境変数を設定します。

  • JVM システムプロパティを設定します。

  • 共有 AWS 設定ファイル設定を更新します。

次の例は、DynamoDB サービスクライアントを設定してアカウントベースのルーティングを無効にする方法を示しています。

DynamoDbClient.builder()
                 .accountIdEndpointMode(AccountIdEndpointMode.DISABLED)
                 .build();

その他の設定オプションの詳細については、「SDK およびツールリファレンスガイド」の「アカウントベースのエンドポイント」を参照してください。 AWS SDKs

このトピックで説明する内容

以下のセクションでは、DynamoDB を使用する方法を示します。

その他の DynamoDB コード例については、「 コード例ライブラリ」のDynamoDB AWS コード例」を参照してください。