使用自訂管道匯入中繼資料

本文說明如何使用中繼資料匯入 API 方法和您自己的管道，將中繼資料從第三方系統匯入 Knowledge Catalog (舊稱 Dataplex Universal Catalog)。Knowledge Catalog 中繼資料包含項目及其切面。

如要改用 Google Cloud管理的調度管道來擷取及匯入中繼資料，建議使用受管理連線管道。使用受管理連線管道時，您可自備連接器，擷取中繼資料並以可做為中繼資料匯入 API 方法輸入內容的格式 (中繼資料匯入檔案) 產生輸出內容。接著，您可以使用 Workflows 調度管道工作。

您可以執行下列類型的中繼資料匯入作業：

• 完整同步處理項目，並累加匯入項目各方面資料。支援自訂項目。
• 僅限遞增匯入屬性。支援屬於自訂項目和系統項目的屬性。如果是自訂項目，您可以修改選填和必填屬性。如果是系統項目，您可以修改選填屬性。

大致步驟

如要使用中繼資料匯入 API 匯入中繼資料，請按照下列高階步驟操作：

1. 決定工作範圍。

   此外，也請瞭解 Knowledge Catalog 如何套用比較邏輯，以及項目和切面的同步模式。

2. 建立一或多個中繼資料匯入檔案，定義要匯入的資料。

3. 將中繼資料匯入檔案儲存在 Cloud Storage 值區中。

4. 執行中繼資料匯入工作。

本頁的步驟假設您已熟悉 Knowledge Catalog 中繼資料概念，包括項目群組、項目類型和切面類型。詳情請參閱「關於 Knowledge Catalog 中的中繼資料管理」。

事前準備

匯入中繼資料前，請先完成本節中的工作。

必要的角色

為確保 Knowledge Catalog 服務帳戶具備存取 Cloud Storage bucket 的必要權限，請管理員將 bucket 的 Storage 物件檢視者 (roles/storage.objectViewer) IAM 角色和 storage.buckets.get 權限授予 Knowledge Catalog 服務帳戶。

如要取得管理中繼資料匯入作業所需的權限，請要求管理員授予您下列 IAM 角色：

• 在完整項目同步中繼資料工作中，修改項目及其各方面：
  • Dataplex 項目類型使用者 (roles/dataplex.entryTypeUser) 在項目類型或定義項目類型的專案中
  • Dataplex 切面類型使用者 (roles/dataplex.aspectTypeUser) 在切面類型或定義切面類型的專案中
• 在僅限切面的中繼資料作業中修改必要切面：
  • Dataplex 項目類型使用者 (roles/dataplex.entryTypeUser) 在項目類型或定義項目類型的專案中
  • Dataplex 切面類型使用者 (roles/dataplex.aspectTypeUser) 在切面類型或定義切面類型的專案中
• 在僅限切面的中繼資料工作中修改選用切面： Dataplex 切面類型使用者 (roles/dataplex.aspectTypeUser) 在定義切面類型的切面類型或專案中。請注意，在僅限切面的中繼資料工作中修改選用切面時，您不需要相關聯項目類型的權限。
• 建立中繼資料匯入工作：
  • 專案或資源的 Dataplex 項目群組匯入者 (roles/dataplex.entryGroupImporter)
  • 專案或資源的 Dataplex 項目和 EntryLink 擁有者 (roles/dataplex.entryOwner)
• 查看中繼資料工作： 專案的 Dataplex 中繼資料工作檢視者 (roles/dataplex.metadataJobViewer)
• 建立、查看及取消中繼資料工作： 專案的 Dataplex 中繼資料工作擁有者 (roles/dataplex.metadataJobOwner)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

建立 Google Cloud 資源

準備下列 Google Cloud 資源：

1. 為要匯入的項目建立項目群組。
2. 建立切面類型，以匯入所需切面。