连接到 Apache Iceberg

了解如何在 OCI GoldenGate 中创建与 Apache Iceberg 的连接。

开始之前

确保您：

查看 OCI GoldenGate 如何连接到源和目标。
配置所需的策略以启用安全 Vault 和密钥访问，例如使用密钥、使用 Vault 和读取密钥包。有关详细信息，请参阅建议的最低策略。

创建连接

要创建与 Apache Iceberg 的连接：

从 OCI GoldenGate 概览页面中，选择连接。

您还可以在“入门”部分下选择创建连接，然后跳至步骤 3。
在“连接”页上，选择创建连接。
在“Create Connection（创建连接）”页面上，按如下方式填写字段：
1. 对于名称，为连接输入一个名称。
2. （可选）对于说明，输入有助于将此连接与其他连接区分开来的说明。
3. （仅限 GoldenGate on Multicloud ）选择您的订阅，然后填写以下字段。
  1. 从区间下拉列表中，选择资源锚点所在的区间。
  2. 选择多云合作伙伴区域。
  3. 选择您的合作伙伴可用性区域。可用选项根据所选的多云合作伙伴区域进行填充。
4. 对于区间，选择要在其中创建连接的区间。
5. 对于类型，在大数据下，选择 Apache Iceberg 。
6. 从下拉列表中选择目录类型，然后填写相关的目录字段：
  1. 对于 Glue ，输入 Glue ID 。
  2. 对于 Hadoop ，不需要其他信息。
  3. 对于 Nessie ，指定：
    - URI ：输入 Nessie 目录 URI。
    - 分支：输入 Nessie 从中读取和写入表元数据的活动 branch 名称。
  4. 对于 Polaris ，指定：
    - URI ：输入 Polaris 目录 URI。
    - 名称：输入 Polaris 注册 Iceberg 表的名称。
    - 客户端 ID ：输入要用于验证的 OAuth 客户端 ID。
    - 客户机密钥：选择客户机密钥，或选择创建客户机密钥以创建新密钥。如果选择创建新的客户机密钥，请提供以下信息：
      - 名称
      - （可选）说明
      - 选择属性密钥所在的区间。
      - 选择要存储属性密钥的 Vault 。
      - 选择要使用的 Encryption key 。
      - 输入用户密码，然后确认用户密码。
    - 主要角色：输入用于访问 Polaris 的 Snowflake 角色。
  5. 对于 Rest ，指定：
    - URI ：输入 REST 目录 API 的基本 URL。
    - 属性密钥：选择属性密钥，或选择创建属性密钥以创建新的属性密钥。如果选择创建新属性密钥，请提供以下信息：
      - 名称
      - （可选）说明
      - 选择属性密钥所在的区间。
      - 选择要存储属性密钥的 Vault 。
      - 选择要使用的 Encryption key 。
      - 上载属性密钥 ID 。
7. 从下拉列表中选择存储类型，然后填写相关的存储字段：
  - Oracle 对象存储 (S3 API)：
    1. 输入访问密钥 ID
    2. 选择 Object Storage bucket（对象存储存储存储）。
    3. 创建或选择 Secret access key secret ID（密钥密钥密钥 ID）。
    4. 输入端点。
  - Amazon S3：
    1. 选择方案类型。
    2. 输入 S3 存储桶所在的 Amazon 区域。
    3. 输入 S3 Bucket ，Iceberg 将在其中存储元数据和数据文件。
    4. 输入访问密钥 ID 以访问 S3 存储桶。
  - Google Cloud Storage（云存储）：
    1. 输入 Google Cloud Storage Bucket ，Iceberg 将在其中存储元数据和数据文件。
    2. 输入存储桶所在的项目编号。
    3. 对于 Endpoint（端点），输入 URL 以连接到 Google Cloud Storage。
  - Azure 数据湖存储：
    1. 输入 Azure 存储账户名称。
    2. 输入 Azure blob 存储容器，Iceberg 将在其中存储其表。
  - 无（仅限 REST 目录类型）
8. 展开“高级”选项。您可以配置以下选项：
  - 安全
    - 取消选择您不希望为此连接使用密码密钥的使用 Vault 密钥。如果未选择：
      - 选择使用 Oracle 管理的加密密钥可将所有加密密钥管理保留给 Oracle。
      - 选择使用客户管理的加密密钥以选择存储在 OCI Vault 中的特定加密密钥来加密连接身份证明。
  - 网络连接
    - 共享端点：与分配的部署共享端点。必须允许从部署的入站 IP 进行连接。
    - 专用端点：通过 VCN 中已分配子网中的专用端点传输的网络流量。您必须允许从此连接的入站 IP 进行连接。
      注:
      
      如果专用连接在七天内保持未分配状态，则服务会将其转换为共享连接。
      
      详细了解 Oracle GoldenGate 连接。
  - 安全属性：添加安全属性以使用 Zero Trust Packet Routing (ZPR) 控制对此连接的访问。
  - 标记：添加标记来组织资源。
选择创建。

创建连接后，它将显示在“连接”列表中。确保将连接分配给部署，以便在数据复制过程中使用该连接。

后续步骤

已知问题

Apache Iceberg 与 AI 数据目录服务验证错误的连接

与 AI 数据目录服务的 Apache Iceberg 连接因令牌到期导致的验证错误而过期。如果您遇到此问题，请与 Oracle 技术支持联系。

Apache Iceberg NoSuchFileException 错误

如果在使用 Apache Iceberg 连接时遇到以下错误，请打开支持请求单，共享详细信息和错误消息：

Caused by: java.nio.file.NoSuchFileException: /tmp/ogg/ocid1.goldengateconnection.oc1...../restCatalogProperties