连接到 MongoDB

了解如何创建与 MongoDB 的连接以用作 OCI GoldenGate 的源或目标。

相关主题

开始之前

在创建连接之前，请确保：
  • 查看 OCI GoldenGate 如何连接到源和目标。
  • 配置所需的策略以启用安全 Vault 和密钥访问，例如使用密钥、使用 Vault 和读取密钥包。有关详细信息，请参阅建议的最低策略。
  • 配置 MongoDB 复制集：
    • OCI GoldenGate for Big Data 使用操作日志 (oplog) 读取更改数据捕获 (CDC) 记录。oplog 是 MongoDB 中的一个上限集合，用于维护修改数据库的所有操作的滚动记录。Oplog 文件是在 MongoDB 中启用副本集时创建的。
    • MongoDB Atlas 预先配置了复制集。对于内部部署 MongoDB 部署，必须手动配置和部署 Replicat 集以启用 oplog 和 CDC 功能。对于内部部署 MongoDB，您需要部署副本集。
  • 具有 MongoDB 版本 3.6 或更高版本。
  • 提供 OCI GoldenGate 支持来捕获以下操作：INSERT、UPDATE、DELETE。

创建连接

要创建 MongoDB 连接：
  1. 在 OCI GoldenGate “概览”页中，单击连接。
    您还可以单击“入门”部分下的创建连接，然后跳至步骤 3。
  2. 在“连接”页上，单击创建连接。
  3. 在“Create Connection（创建连接）”页面上，按以下方式填写字段：
    1. 对于名称，输入连接名称。
    2. （可选）对于说明，输入可帮助您将此连接与其他连接区分开的说明。
    3. 如果在 Oracle Database@Azure 上为 GoldenGate 创建此部署，请选择订阅。
      1. 从区间下拉列表中，选择资源锚点所在的区间。
      2. 选择多云合作伙伴区域。
      3. 选择您的合作伙伴可用性区域。可用选项根据所选的多云合作伙伴区域进行填充。
    4. 对于区间，选择要在其中创建连接的区间。
    5. 对于类型，选择 MongoDB 。
    6. 对于连接字符串，输入不带用户名和口令的有效 MongoDB 连接字符串 URI 。例如，mongodb://mongodb1.example.com:27017。
    7. 对于用户名，输入此数据库的用户名。
    8. 选择密码密钥。如果位于其他区间中，则使用下拉列表更改区间。

      注意：

      • 密钥是用于 OCI 服务的身份证明，例如密码、证书、SSH 密钥或验证令牌。要创建密钥，请参见 Creating a secret 。确保：
        • 选择手动生成密钥。
        • 将凭证粘贴到秘密内容中。
      • 如果您不希望使用密码密钥，请确保在此表单底部的高级选项下的“设置”选项卡中取消选择在 Vault 中使用密钥。
    9. 对于安全协议，选择安全协议：
      • 普通：用户名和口令验证。
      • TLS ：具有用户名和口令的 TLS。
      • MTLS ：具有用户名和口令的 MTLS。
    10. 扩展显示高级选项。您可以配置以下选项：
      • 安全
        • 取消选择您不希望为此连接使用密码密钥的使用 Vault 密钥。如果未选择：
          • 选择使用 Oracle 托管的加密密钥可将所有加密密钥管理留给 Oracle。
          • 选择使用客户管理的加密密钥以选择存储在 OCI Vault 中的特定加密密钥来加密连接身份证明。
      • 网络连接
        • 共享端点，用于与分配的部署共享端点。您必须允许来自部署的入站 IP 的连接。
        • 专用端点，用于通过 VCN 中已分配子网中的专用端点进行网络流量。您必须允许来自此连接的入站 IP 的连接。

          注意：

          • 如果专用连接保持未分配状态七天，则服务会将它转换为共享连接。
          • 详细了解 Oracle GoldenGate 连接。
      • 安全属性：添加安全属性以使用 Zero Trust Packet Routing (ZPR) 控制对此连接的访问。
      • 标记：添加标记来组织资源。
  4. 单击创建。
创建连接后，它将显示在“Connections（连接）”列表中。确保将连接分配给部署以将其用作复制中的源或目标。

已知问题

OCI GoldenGate MongoDB 连接不支持 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 测试连接出现问题

将 Test connection 与 MongoDB 连接一起使用时可能会遇到错误。您可以在 OCI GoldenGate 部署控制台中忽略此错误并测试 MongoDB 连接。在部署控制台中，打开 Administration Service 的导航菜单，单击配置。您的 MongoDB 连接应列为身份证明，您可以在其中单击连接到 <alias> 以测试连接。