命名 Knowledge Catalog 資源的指南

Google Cloud 資源是指您在Google Cloud中建立或使用的任何元件。這些資源是您在平台上執行的應用程式和系統的建構模塊。

如要進一步瞭解一般 Google Cloud 資源命名，請參閱「資源名稱」。

資源命名格式

下表列出 Knowledge Catalog 資源的完整資源名稱格式：

資源 完整資源名稱格式
項目群組 projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}
Entry projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entries/{ENTRY_ID}
項目類型 projects/{PROJECT_ID}/locations/{LOCATION}/entryTypes/{ENTRY_TYPE_ID}
切面類型 projects/{PROJECT_ID}/locations/{LOCATION}/aspectTypes/{ASPECT_TYPE_ID}
Entry link projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}
中繼資料工作 projects/{PROJECT_ID}/locations/{LOCATION}/metadataJobs/{METADATA_JOB_ID}
中繼資料動態饋給 projects/{PROJECT_ID}/locations/{LOCATION}/metadataFeeds/{METADATA_FEED_ID}
詞彙 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}
詞彙表類別 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}
詞彙表字詞 projects/{PROJECT_ID}/locations/{LOCATION}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}
資料產品 projects/{PROJECT_ID}/locations/{LOCATION}/dataProducts/{DATA_PRODUCT_ID}
資料網域 projects/{PROJECT_ID}/locations/{LOCATION}/dataDomains/{DATA_DOMAIN_ID}
歷程程序 projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}
歷程執行作業 projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}
歷程事件 projects/{PROJECT_ID}/locations/{LOCATION}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

資源名稱元件

以下各節將詳細說明各個元件。

專案 ID

這個值必須是專案 ID 或專案編號，可從 Google Cloud 控制台取得。例如，my-cool-project 是專案 ID，123456789123 則是專案編號。

位置

值必須是支援的 Knowledge Catalog 位置。如需可用位置清單，請參閱「Knowledge Catalog 位置」。

資源 ID

資源路徑包含階層中各項資源及其父項資源的專屬 ID (ID) 區段。以下各節說明每種資源 ID 的命名規範和格式規定。

標準資源 ID

除了項目 ID 和資料歷程資源 ID 之外，所有資源 ID 變數 (例如 {ENTRY_GROUP_ID} 和 {GLOSSARY_ID}) 都必須符合下列規範：

  • 開頭是小寫字母。
  • 長度介於 1 至 63 個字元之間。
  • 只能使用小寫英文字母、數字、連字號和底線。
  • 結尾須為數字或小寫英文字母。

系統項目群組

項目 ID

{ENTRY_ID} 的命名規範有所不同：

  • 最多可包含 4000 個半形字元。

  • 請根據 Google Cloud 完整資源名稱，使用項目 ID 格式。格式為資源的完整資源名稱，不含 API 服務名稱部分的前置雙斜線。這樣一來，您就能使用相關聯的資源名稱擷取項目。

    例如：

    • 如果 Looker 執行個體的完整資源名稱為 //looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance，則建議的 {ENTRY_ID} 為 looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance。

資料歷程資源 ID

資料歷程資源代表資料轉換作業的階層：

  • 程序 ID ({PROCESS_ID})：識別資料轉換的定義 (例如特定 SQL 查詢或 ETL 管道)。
  • 執行 ID ({RUN_ID})：用於識別父項程序的單一執行個體。
  • 歷程事件 ID ({LINEAGE_EVENT_ID})：識別執行期間來源和目標之間發生的離散資料移動事件。

透過 API 建立自訂歷程資源時，變數 {PROCESS_ID}、{RUN_ID} 和 {LINEAGE_EVENT_ID} 必須符合下列規範：

  • 最多可包含 200 個半形字元。
  • 只能使用英文字母 (區分大小寫)、數字、連字號、底線、冒號和句點。

如果是自動歷程 (例如 BigQuery 查詢、Managed Service for Apache Spark 或 OpenLineage 擷取)，Knowledge Catalog 會自動產生這些 ID。

BigQuery 項目名稱

透過 Dataplex API 與 BigQuery 資源互動時，必須使用特定格式的項目群組 ID 和項目 ID。

  • 項目群組 ID：@bigquery
  • 項目 ID：bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}

範例

如果 BigQuery 資料表為 projects/test-project/datasets/test_dataset/tables/test_table，則完整的 Knowledge Catalog 項目名稱如下：

projects/{PROJECT_ID}/locations/{LOCATION}/entryGroups/@bigquery/entries/bigquery.googleapis.com/projects/test-project/datasets/test_dataset/tables/test_table