連線到 Apache Iceberg

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

開始之前

確保您：

OCI GoldenGate 如何連線至您的來源和目標。
設定必要的原則以啟用安全保存庫和加密密碼存取，例如使用加密密碼、使用保存庫及讀取加密密碼組合。如需詳細資訊，請參閱最低建議原則。

建立連線

建立與 Apache Iceberg 的連線：

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

您也可以選取「開始使用」段落下的建立連線，然後跳至步驟 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. 從下拉式清單中選取一個儲存體類型，然後完成相關的儲存體欄位：
  - Oracle Object Storage (S3 API) :
    1. 輸入存取金鑰 ID
    2. 選取物件儲存體儲存體儲存體儲存設定 (Bucket) 。
    3. 建立或選取加密密碼存取金鑰加密密碼 ID 。
    4. 輸入端點。
  - Amazon S3：
    1. 選取配置類型。
    2. 輸入 S3 儲存桶所在的 Amazon 區域。
    3. 輸入 Iceberg 儲存中繼資料和資料檔案的 S3 儲存桶。
    4. 輸入存取金鑰 ID 以存取 S3 儲存桶。
  - Google 雲端儲存：
    1. 輸入 Iceberg 儲存中繼資料和資料檔案的 Google Cloud Storage 儲存桶 。
    2. 輸入儲存桶所在的專案 ID 。
    3. 若為端點，請輸入要連線至 Google Cloud Storage 的 URL。
  - Azure Data Lake Storage：
    1. 輸入 Azure 儲存帳戶名稱。
    2. 輸入 Iceberg 儲存其表格的 Azure blob 儲存容器。
  - 無 (僅限 REST 目錄類型)
8. 展開進階選項，您可以設定以下選項：
  - 安全
    - 取消選取此連線不使用密碼加密密碼的使用保存庫加密密碼。如果未選取：
      - 選取使用 Oracle 管理的加密金鑰，即可將所有加密金鑰管理保留給 Oracle。
      - 選取使用客戶管理的加密金鑰，即可選取儲存在 OCI 保存庫中的特定加密金鑰，以加密您的連線證明資料。
  - 網路連線
    - 共用端點：與指派的部署共用端點。您必須允許來自部署傳入 IP 的連線。
    - 專用端點：適用於透過您 VCN 中指定子網路之專用端點的網路流量。您必須允許來自此連線傳入 IP 的連線。
      注意：
      
      如果專用連線保留 7 天未指派，則服務會將它轉換成共用連線。
      
      深入瞭解 Oracle GoldenGate 連線。
  - 安全屬性：使用零信任封包路由 (ZPR) 新增安全屬性以控制對此連線的存取。
  - 標記：新增標記以組織您的資源。
選取建立。

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

後續步驟

已知問題

與 AI 資料目錄服務認證錯誤的 Apache Iceberg 連線

與 AI 資料目錄服務的 Apache Iceberg 連線因權杖到期所造成的認證錯誤而到期。如果發生此問題，請聯絡 Oracle Support。

Apache Iceberg NoSuchFileException 錯誤

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

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