Data Catalog 已淘汰。如果您要將程式輔助工作流程、指令碼、用戶端程式庫或 Terraform 設定從 Data Catalog 遷移至 Knowledge Catalog，請務必更新程式碼，改用 Dataplex API。
本文全面對應 Data Catalog 資源、功能和 API 方法，以及 Dataplex API 中的對應項目。
如需逐步遷移程序，請參閱「從 Data Catalog 轉移至 Knowledge Catalog」。如需 API 參考文件，請參閱 Dataplex API REST 說明文件和 Dataplex API RPC 說明文件。
資源對應
下表說明 Data Catalog 中的資源如何對應至 Knowledge Catalog 中的資源：
| Data Catalog 資源 | Knowledge Catalog 資源 | 說明 |
|---|---|---|
| 公開代碼範本 | 切面類型 (global) |
標記範本是 Data Catalog 中的區域資源，可用於各個區域。這些項目對應於 Knowledge Catalog 中的global切面類型。 |
| 公開標記 | 選用切面 | 公開標記對應至附加至 Knowledge Catalog 項目或資料欄的選用切面。 |
| 項目群組 | 項目群組 | 在兩項服務中，項目群組都可做為機構和安全容器。對於 Google Cloud 來源，系統會為每個專案自動建立系統輸入群組，例如 @bigquery。 |
| 自訂項目 | 自訂項目 (含必要切面) | 標準自訂項目屬性會以自訂項目 EntryType 定義的必要切面形式建模。 |
| 系統 (Google Cloud) 項目 | 系統項目 (含必要切面) | 描述內建實體 (例如 BigQuery 資料表的 Schema) 的中繼資料，會擷取至系統定義的必要層面類型層面。 |
| 組織詞彙 | 組織詞彙 | 業務用語分類，可讓企業的業務脈絡標準化。 |
功能比較
下表比較 Knowledge Catalog 和 Data Catalog 的中繼資料管理功能：
| 功能 | Knowledge Catalog | Data Catalog |
|---|---|---|
| 支援的 Google Cloud 來源 | 支援的 Google Cloud 來源中說明的所有來源。 | Data Catalog 說明文件中所述的所有來源。 |
| 擷取自訂來源 | 將資料匯入自訂項目，並以項目類型定義受控結構。 Data Catalog 自訂項目和項目群組會顯示在 Knowledge Catalog 的 |
擷取至一般自訂項目。 |
| 中繼資料充實 | 使用業務詞彙、切面和切面類型擷取。 系統支援進入連結。您可以直接將切面附加至項目連結。 |
使用業務詞彙表、標記和標記範本擷取。 不支援項目連結。 |
| 項目連結 | 支援。內建型別 (例如 synonym、definition、related 和 schema-join) 可讓您連結項目和資料欄。 |
不適用。 |
| 中繼資料變更動態饋給 | 近乎即時的元資料變更通知會串流至 Pub/Sub。 | 不適用。 |
| 搜尋 | 搜尋範圍涵蓋同一機構和 VPC Service Controls 範圍內的所有支援 Google Cloud 來源、自訂項目、層面和遷移的 Data Catalog 內容。 | 搜尋範圍涵蓋支援的來源、自訂項目，以及在 Data Catalog 建立的標記。 |
| 資料歷程 | 使用 Dataplex API 擷取資產節點的項目詳細資料。 在 Google Cloud 控制台中顯示附加的構面。 | 使用 Data Catalog API 擷取項目詳細資料。 |
| 組織詞彙 | 您可以建構業務字詞的分類，並將其與資料資產 (項目) 和資料欄建立關聯。 | 可將字詞與資料欄建立關聯。 |
將 Data Catalog API 方法對應至 Knowledge Catalog
下表提供 Data Catalog API (google.cloud.datacatalog.v1) 和 Dataplex API (google.cloud.dataplex.v1.CatalogService) 的方法對應。
項目群組
這兩項服務的項目群組概念一致：
| Data Catalog API 方法 | Dataplex API 方法 |
|---|---|
projects.locations.entryGroups.create (REST)CreateEntryGroup (RPC) |
projects.locations.entryGroups.create (REST)CreateEntryGroup (RPC) |
projects.locations.entryGroups.get (REST)GetEntryGroup (RPC) |
projects.locations.entryGroups.get (REST)GetEntryGroup (RPC) |
projects.locations.entryGroups.patch (REST)UpdateEntryGroup (RPC) |
projects.locations.entryGroups.patch (REST)UpdateEntryGroup (RPC) |
projects.locations.entryGroups.delete (REST)DeleteEntryGroup (RPC) |
projects.locations.entryGroups.delete (REST)DeleteEntryGroup (RPC) |
projects.locations.entryGroups.list (REST)ListEntryGroups (RPC) |
projects.locations.entryGroups.list (REST)ListEntryGroups (RPC) |
實體
這兩項服務的項目概念 (代表資料資產) 是一致的：
標記範本和切面類型
切面類型是 Data Catalog 標記範本的後繼產品：
| Data Catalog API 方法 | Dataplex API 方法 |
|---|---|
projects.locations.tagTemplates.create (REST)CreateTagTemplate (RPC) |
projects.locations.aspectTypes.create (REST)CreateAspectType (RPC) |
projects.locations.tagTemplates.get (REST)GetTagTemplate (RPC) |
projects.locations.aspectTypes.get (REST)GetAspectType (RPC) |
projects.locations.tagTemplates.patch (REST)UpdateTagTemplate (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.delete (REST)DeleteTagTemplate (RPC) |
projects.locations.aspectTypes.delete (REST)DeleteAspectType (RPC) |
catalog.search (REST) with type=tag_templateSearchCatalog (RPC) with type=tag_template |
projects.locations.aspectTypes.list (REST)ListAspectTypes (RPC) |
代碼範本欄位
代碼範本欄位會對應至切面類型中 metadata_template 欄位的內容。使用 UpdateAspectType 和修改後的 metadata_template 建立、更新、重新命名或刪除欄位：
| Data Catalog API 方法 | Dataplex API 方法 |
|---|---|
projects.locations.tagTemplates.fields.create (REST)CreateTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.patch (REST)UpdateTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.rename (REST)RenameTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.delete (REST)DeleteTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
代碼範本欄位列舉值
如要修改列舉值，請更新相應切面類型中的 metadata_template 欄位：
| Data Catalog API 方法 | Dataplex API 方法 |
|---|---|
projects.locations.tagTemplates.fields.enumValues.rename (REST)RenameTagTemplateFieldEnumValue (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
標記和切面
切面是 Data Catalog 標記的後繼功能。構面會直接封裝在父項項目或項目連結中，並使用 UpdateEntry 方法和 update_mask 進行管理：
| Data Catalog API 方法 | Dataplex API 方法 |
|---|---|
projects.locations.entryGroups.entries.tags.create (REST)CreateTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
projects.locations.entryGroups.entries.tags.list (REST)ListTags (RPC) |
projects.locations.entryGroups.entries.get (REST)GetEntry (RPC)
注意：如要篩選回應中的層面，請使用 |
projects.locations.entryGroups.entries.tags.patch (REST)UpdateTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
projects.locations.entryGroups.entries.tags.delete (REST)DeleteTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
政策標記和分類
政策標記和分類的 API 不會變更，也不需要遷移。這些廣告會繼續在 datacatalog.googleapis.com
端點 (政策代碼管理工具服務) 下放送。如果專案使用 BigQuery 資料欄層級存取控管或動態資料遮蓋功能，則必須保持啟用 Data Catalog API (datacatalog.googleapis.com)。
Knowledge Catalog 不支援的功能
Knowledge Catalog 不支援下列 Data Catalog 行為和功能，或這些行為和功能在 Knowledge Catalog 中的運作方式不同：
- 私人切面類型：Dataplex Catalog 沒有私人切面和私人切面類型 (對應至 Data Catalog 中的私人標記和私人標記範本) 的概念。所有自訂切面類型都受專案和項目群組的身分與存取權管理權限控管。
- 政策標記搜尋：目錄搜尋不支援使用
policytag或policytagid述詞搜尋政策標記。 - 權限轉移：將 Data Catalog 自訂項目群組、自訂項目、標記範本和標記匯入 Knowledge Catalog 時，系統不會轉移這些資源的原始權限。您必須為匯入的資源設定 IAM 權限。如要詳細比較舊版和替代權限，請參閱「對應 Data Catalog 和 Knowledge Catalog 之間的 IAM 權限」。
- Sensitive Data Protection 檢查結果：系統不支援將 Sensitive Data Protection 檢查結果直接傳送至 Knowledge Catalog。請改為將檢查結果傳送至 Data Catalog，然後將結果轉移至 Knowledge Catalog。
- 跨專案類型清單：不支援在單一 API 呼叫中列出跨專案的項目類型、項目連結類型和面向類型；要求必須限定於單一專案。
- 管理員搜尋：系統不支援管理員搜尋 (完整召回)。請改為匯出中繼資料至 Cloud Storage，然後使用 BigQuery 查詢。