連線到 MongoDB

瞭解如何建立 MongoDB 連線，以作為 OCI GoldenGate 的來源或目標。

開始之前

確保您：

• OCI GoldenGate 如何連線至您的來源和目標。

• 設定必要的原則以啟用安全保存庫和加密密碼存取，例如使用加密密碼、使用保存庫及讀取加密密碼組合。如需詳細資訊，請參閱最低建議原則。

• 設定 MongoDB Replicat 集：

  • OCI GoldenGate for Big Data 使用作業日誌 (oplog) 讀取變更資料擷取 (CDC) 記錄。此 oplog 是 MongoDB 中上限的集合，可維護修改資料庫之所有作業的輪流記錄。在 MongoDB 中啟用複本集時，便會建立 Oplog 檔案。

  • MongoDB Atlas 已預先設定 Replicat 集。若為內部部署 MongoDB 部署，您必須手動設定並部署 Replicat 集，以啟用 Oplog 和 CDC 功能。對於內部部署 MongoDB，您必須部署複本集。

• MongoDB 版本 3.6 或更新版本。

• 支援 OCI GoldenGate 以擷取下列作業：INSERT、UPDATE、DELETE。

建立連線

建立 MongoDB 連線：

1. 從 OCI GoldenGate 總覽頁面中，選取連線。

   您也可以選取「開始使用」段落下的建立連線，然後跳至步驟 3。

2. 在「連線」頁面上，選取建立連線。

3. 在「建立連線」頁面上，依下列方式完成欄位：

   1. 若為名稱，請輸入連線的名稱。

   2. (選用) 在描述中，輸入可協助您區分此連線與其他連線的描述。

   3. (僅適用於 GoldenGate on Multicloud) 選取您的訂閱，然後填寫下列欄位。

      1. 從區間下拉式清單中，選取資源定錨點所在的區間。

      2. 選取多雲端合作夥伴區域。

      3. 選取您的合作夥伴可用性區域。可用的選項會根據選取的多雲端合作夥伴區域填入。

   4. 若為區間，請選取要在其中建立連線的區間。

   5. 對於類型，請選取 MongoDB 。

   6. 在連線字串中，輸入不含使用者名稱和密碼的有效 MongoDB 連線字串 URI 。例如，mongodb://mongodb1.example.com:27017。

   7. 在使用者名稱中，輸入此資料庫的使用者名稱

   8. 選取密碼加密密碼。如果位於其他區間中，請使用下拉式清單變更區間。

      注意：

      • 加密密碼是與 OCI 服務搭配使用的證明資料，例如密碼、憑證、SSH 金鑰或認證記號。若要建立加密密碼，請參閱建立加密密碼。請確定您：

        • 選取手動產生加密密碼。

        • 將證明資料貼到加密密碼內容中。

      • 如果您不想使用密碼加密密碼，請確定取消選取進階選項底下之「安全」段落中的在保存庫使用加密密碼。

      • 需要更新加密密碼內容時，請確定：

        • 使用純文字樣板建立新的加密密碼版本，並且提供更新的內容。如需詳細資訊，請參閱更新加密密碼的內容。

        • 重新整理連線以清除快取的加密密碼內容。

   9. 若為安全協定，請選取安全協定：

      • 純文字：使用者名稱和密碼認證。

      • TLS ：使用使用者名稱和密碼的 TLS。

      • MTLS ：使用使用者名稱和密碼的 MTLS。

   10. 展開顯示進階選項 您可以設定以下選項：

       • 安全

         • 取消選取此連線不使用密碼加密密碼的使用保存庫加密密碼。如果未選取：

           • 選取使用 Oracle 管理的加密金鑰，即可將所有加密金鑰管理保留給 Oracle。

           • 選取使用客戶管理的加密金鑰，即可選取儲存在 OCI 保存庫中的特定加密金鑰，以加密您的連線證明資料。

       • 網路連線

         • 共用端點：與指派的部署共用端點。您必須允許來自部署傳入 IP 的連線。

         • 專用端點：適用於透過您 VCN 中指定子網路之專用端點的網路流量。您必須允許來自此連線傳入 IP 的連線。

           注意：

           • 如果專用連線保留 7 天未指派，則服務會將它轉換成共用連線。
           • 深入瞭解 Oracle GoldenGate 連線。

       • 安全屬性：使用零信任封包路由 (ZPR) 新增安全屬性以控制對此連線的存取。

       • 標記：新增標記以組織您的資源。

4. 選取建立。

建立連線之後，連線就會顯示在「連線」清單中。請確定已將連線指派給部署，以將其作為複製中的來源或目標。

接下來的步驟

• 指定部署的連線
• 管理人脈

已知問題

MongoDB、DocumentDB 及 Oracle JSON 集合 TLS 安全協定

如果 MongoDB Replicat、DocumentDB Replicat 或 Oracle JSON 集合連線因報表檔案中的下列錯誤而失敗：

Error: Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

解決方法：將下列特性新增至您的「特性」檔案，使用您的連線 OCID 更新 <connection_ocid>，並保持原狀。

jvm.bootoptions=-Djavax.net.ssl.trustStore=/u02/connections/<connection_ocid>/truststore.pkcs12 -Djavax.net.ssl.trustStorePassword=Welcome123

OCI GoldenGateMongoDB 連線不支援 mongdb+srv 連線字串。

解決方法：使用 MongoDB 連線字串。

1. 在 MongoDB Atlas 中，選取連線。

2. 選取驅動程式。

3. 選取 Java 。

4. 若為「版本」，請選取 3.4 或更新版本。

5. 您可以使用提供的 mongodb 字串。舉例而言：

   mongodb://<user_name>:<db_password>@cluster0-shard-00-00.abc.mongodb.net:27017,cluster0-shard-00-01.abc.mongodb.net:27017,cluster0-shard-00-02.abc.mongodb.net:27017/?ssl=true&replicaSet=atlas-3grqh1-shard-0&authSource=admin&retryWrites=true&w=majority&appName=Cluster0

MongoDB 測試連線問題

使用與 MongoDB 連線的測試連線時發生錯誤。您可以忽略此錯誤，並在 OCI GoldenGate 部署主控台中測試 MongoDB 連線。在建置主控台中，開啟「管理服務」的導覽功能表，選取組態。您的 MongoDB 連線應列為證明資料，供您選取 ** 連線至 ** 以測試連線。