連線到 Apache Iceberg

瞭解如何在 OCI GoldenGate 中建立與 Apache Iceberg 的連線。

開始之前

建立連線之前，請確定您：

建立連線

建立與 Apache Iceberg 的連線：
  1. 從 OCI GoldenGate 總覽頁面中，按一下連線。
    您也可以按一下「開始使用」段落下的建立連線，然後跳至步驟 3。
  2. 在「連線」頁面上，按一下建立連線。
  3. 在「建立連線」頁面上，依下列方式完成欄位：
    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 從中讀取和寫入表格中繼資料的作用中分支名稱。
      4. 對於 Polaris ，請指定：
        • URI ：輸入 Polaris 目錄 URI。
        • 名稱：輸入 Polaris 註冊 Iceberg 表格的名稱。
        • 從屬端 ID ：輸入要用於認證的 OAuth 從屬端 ID。
        • 從屬端加密密碼：選取從屬端加密密碼，或按一下建立從屬端加密密碼以建立新的加密密碼。如果您選擇建立新的從屬端加密密碼，請提供以下資訊：
          • 名稱
          • (選用) 說明
          • 選取特性加密密碼所在的區間。
          • 選取要儲存特性加密密碼的保存庫。
          • 選取要使用的加密密鑰。
          • 輸入使用者密碼，然後確認使用者密碼。
        • 主要項目角色：輸入用來存取 Polaris 的 Snowflake 角色。
      5. 若為回復，請指定：
        • URI ：輸入 REST 目錄 API 的基礎 URL。
        • 特性加密密碼：選取特性加密密碼，或按一下建立特性加密密碼以建立新的加密密碼。如果您選擇建立新的特性加密密碼，請提供下列資訊：
          • 名稱
          • (選用) 說明
          • 選取特性加密密碼所在的區間。
          • 選取要儲存特性加密密碼的保存庫。
          • 選取要使用的加密密鑰。
          • 上傳特性加密密碼 ID 。
    7. 從下拉式清單中選取一個儲存體類型，然後完成相關的儲存體欄位：
  4. 展開顯示進階選項。您可以設定以下選項：
    • 安全
      • 如果您不想在此連線使用密碼加密密碼，請取消選取使用保存庫加密密碼。如果未選取：
        • 選取使用 Oracle 管理的加密金鑰，即可將所有加密金鑰管理保留給 Oracle。
        • 選取使用客戶管理的加密金鑰，即可選取儲存在 OCI 保存庫中的特定加密金鑰，以加密您的連線證明資料。
    • 網路連線
      • 共用端點：與指派的部署共用端點。您必須允許來自部署傳入 IP 的連線。
      • 專用端點，適用於透過您 VCN 中指定子網路之專用端點的網路流量。您必須允許來自此連線之傳入 IP 的連線。

        附註：

        • 如果專用連線保留 7 天未指派，則服務會將它轉換成共用連線。
        • 深入瞭解 Oracle GoldenGate 連線。
    • 安全屬性：使用零信任封包路由 (ZPR) 新增安全屬性以控制對此連線的存取。
    • 標記：新增標記以組織您的資源。
  5. 按一下建立。
建立連線之後，連線就會顯示在「連線」清單中。請確定已指派部署連線，以便在資料複製處理中使用該連線。

已知問題

OCI GoldenGate 中的 Apache Iceberg 連線發生問題

如果您在使用 Apache Iceberg 連線時遇到下列錯誤，請開啟支援回報項目，分享詳細資訊和錯誤訊息：

ERROR 2025-07-08 13:34:09.000481 [main] -  Parameter [awsSecretKey] is missing in the
      connection payload. Parameter [awsSecretKey] is missing in the connection payload.