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 應用程式時，成為寶貴的資源。

先決條件

開始之前，請確定您有下列項目：

本指南的資料模型

本指南中的所有範例程式碼都假設連線到具有「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 版進行測試。