連線到 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. 從下拉式清單中選取一個儲存體類型,然後完成相關的儲存體欄位:

    8. 展開顯示進階選項 您可以設定以下選項:

      • 安全

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

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

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

      • 網路連線

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

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

          注意:

          • 如果專用連線保留 7 天未指派,則服務會將它轉換成共用連線。
          • 深入瞭解 Oracle GoldenGate 連線
      • 安全屬性:使用零信任封包路由 (ZPR) 新增安全屬性以控制對此連線的存取。

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

  4. 選取建立

建立連線之後,連線就會顯示在「連線」清單中。請確定已指派部署連線,以在資料複製處理中使用該連線。

接下來的步驟

已知問題

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.