Amazon DocumentDB Java プログラミングガイド - Amazon DocumentDB
序章前提条件データモデル

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

Amazon DocumentDB Java プログラミングガイド

この包括的なガイドでは、MongoDB の Java ドライバーを使用して Amazon DocumentDB を操作するための詳細なウォークスルーを提供し、データベースの運用と管理の重要な側面について説明します。

トピック

序章

このガイドでは、MongoDB Java ドライバーを使用して DocumentDB クラスターへの安全な接続を確立する方法について説明します。接続文字列コンポーネント、SSL/TLS 実装、IAM 認証や接続プーリングなどのさまざまな接続オプション、堅牢なエラー処理戦略について詳しく説明します。

CRUD (作成、読み取り、更新、削除) オペレーションセクションで、このガイドではドキュメントの操作について詳しく説明し、単一オペレーションと一括オペレーションの両方を使用してドキュメントを作成、読み取り、更新、削除する方法を示します。ここでは、フィルター、クエリ、およびさまざまなオペレーションオプションの使用方法について説明しながら、エラー処理のベストプラクティスと信頼性を向上させるための再試行ロジックの実装に重点を置いています。このガイドでは、単一フィールド、複合インデックス、スパースインデックス、テキストインデックスなど、さまざまなインデックスタイプの作成とメンテナンスについて詳しく説明しています。explain() 関数の適切なインデックス選択と使用を通じてクエリパフォーマンスを最適化し、クエリ実行プランを分析する方法について説明します。

最後のセクションでは、Amazon DocumentDB の変更ストリームを使用したイベント駆動型プログラミングに焦点を当て、Java アプリケーションでリアルタイムのデータ変更モニタリングを実装する方法を示します。変更ストリームカーソルの実装、継続的オペレーションの再開トークンの処理、履歴データ処理の時間ベースのオペレーションについて説明します。このガイドでは、実用的なコード例とベストプラクティスが提供されるため、Amazon DocumentDB で堅牢な Java アプリケーションを構築する際に貴重なリソースとなります。

前提条件

開始する前に、以下があることを確認してください。

  • DocumentDB クラスターが設定された AWS アカウント。DocumentDB クラスターのセットアップについては、この入門ブログ記事を参照してください。

  • Java Development Kit (JDK) がインストールされました (このガイドでは Amazon Corretto 21 を使用します）。

  • 依存関係管理のための Maven。

このガイドのデータモデル

このガイドのすべてのサンプルコードは、「Restaurants」コレクションを持つ「ProgGuideData」テストデータベースへの接続を前提としています。このガイドのすべてのサンプルコードは、レストラン出品システムで動作します。以下は、このシステムのドキュメントの例です。

{
    "_id": "ab6ad8f119b5bca3efa2c7ae",
    "restaurantId": "REST-CRT9BL",
    "name": "Thai Curry Palace",
    "description": "Amazing Restaurant, must visit",
    "cuisine": "Thai",
    "address": {
        "street": "914 Park Street",
        "city": "Bryan",
        "state": "AL",
        "zipCode": "96865",
        "location": {
            "type": "Point",
            "coordinates": [-25.4619, 8.389]
        }
    },
    "contact": {
        "phone": "(669) 915-9056 x6657"
    },
    "rating": {
        "average": 3.4,
        "totalReviews": 275
    },
    "priceRange": "$",
    "menu": [{
        "category": "Appetizers",
        "items": [{
            "name": "Buffalo Chicken Wings",
            "price": 13.42
        }]
    }],
    "features": [
        "Private Dining"
    ],
    "isActive": false“ michelin”: {“
        star”: 3,
        “ranking_years”: 4
    }
}

CRUD、インデックス管理、イベント駆動型プログラミングを示すすべてのコードサンプルは、MongoClientオブジェクト dbClient、MongoDatabaseオブジェクト connectionDB、MongoCollectionおよびオブジェクト があることを前提としていますcollection。

注記

このガイドのすべてのコード例は、MongoDB Java ドライバーバージョン 5.3.0 でテストされています。