關於 Knowledge Catalog 的搜尋功能

您可以使用 Knowledge Catalog (舊稱 Dataplex Universal Catalog) 的搜尋功能，透過自然語言查詢、語意比對、關鍵字和結構化述詞，探索組織中的資源。您可以查詢特定資料資產、探索各系統的相關中繼資料，或擷取程式輔助和 Agentic Workflows 的範圍結果。

用途

下列清單說明常見的搜尋用途，以及說明和查詢範例：

  • 指定資產查詢：搜尋與資產名稱、資料欄或說明相關的關鍵字，找出特定資產。

    查詢範例

    • retail_transactions_2026
    • customer_id
    • column:customer_id

  • 廣泛資料探索：使用開放式自然語言或關鍵字查詢，找出組織中的相關資產。

    查詢範例

    • quarterly financial reports
    • ad campaign click through rates tables
    • server health metrics
    • audit logs system=bigquery

  • 工作流程的範圍資產擷取：列舉特定容器 (例如專案) 內或具有特定屬性 (例如類型或系統) 的資產。這種方法常用於程式輔助和代理工作流程。

    查詢範例

    • type=table projectid:banking-prod aspect:classification.tier=PII
    • system=spanner projectid:inventory-service (parent=marketing_analytics OR parent=finance_analytics)

運作方式

搜尋功能會自動為 Knowledge Catalog 中維護的資料資產建立所有背景資訊的索引。包含下列項目：

  • 自動從 Google Cloud 資料來源 (例如 BigQuery 和 Cloud SQL) 擷取中繼資料
  • 透過連接器和整合功能擷取的資源背景資訊
  • 您為資源建立的其他背景資訊，例如代表業務背景資訊或描述資料語意。背景資訊也可能以切面或連結的業務術語形式擷取。

處理查詢時，搜尋功能會結合語意和關鍵字比對。下表列出可與 Knowledge Catalog 搜尋搭配使用的查詢類型，並提供說明和查詢範例：

查詢類型 用量 範例
單一關鍵字 用於比對中繼資料元素 (例如資產名稱、說明和結構定義) 的精確和子字串。 prd_fin_invoices_fct_v02
部分關鍵字和權杖化片段 比對中繼資料內容中的子字串，即使資源名稱使用縮寫、分隔字詞或變化版本，也能找到。 fin transactions 2026 (與 prd_fin_transactions_fy2026_raw 相符)
自然語言查詢 使用語意比對，不需完全符合名稱或資料欄。 customer churn prediction features
結構化述詞 結合任意文字查詢和明確的述詞篩選器，縮小搜尋結果範圍。 audit logs system=bigquery
擴充語法 如要精準搜尋，請縮小至特定範圍。擴充語法最常用於代理和程式輔助用途。詳情請參閱「搜尋語法」。 (system:bigquery OR system:spanner) AND column:credit_card_number aspect:classification.tier=PII -projectid:sandbox-project

您可以透過下列選項，在 Knowledge Catalog 中使用搜尋功能：

搜尋範圍

Knowledge Catalog 的搜尋結果會遵循您在來源系統中對應資源的權限。

舉例來說，如果您具備某個物件的 BigQuery 中繼資料讀取權限，該物件就會顯示在 Knowledge Catalog 搜尋結果中。如果您有權存取 BigQuery 資料表，但無權存取包含該資料表的資料集，該資料表仍會正常顯示在 Knowledge Catalog 搜尋結果中。

根據預設，搜尋範圍為貴組織。結果只會包含與您搜尋的專案屬於同一組織的資源。

搜尋結果只會列出與執行搜尋的專案屬於相同 VPC Service Controls 範圍的資源。使用Google Cloud 控制台時，這是控制台中選取的專案。

如要擴大搜尋結果範圍，納入專案 VPC Service Controls perimeter 以外的資源，請使用 VPC Service Controls 輸入和輸出規則。這些規則可讓您在組織內私下有效率地交換資料。您可以使用Google Cloud 控制台，或透過 JSON 或 YAML 檔案設定輸入和輸出規則。請參考下列 YAML 範例，並參閱 VPC Service Controls 說明文件，根據您的特定需求調整規則。

egressPolicies:
  - egressFrom:
      identityType: ANY_USER_ACCOUNT
    egressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids under which the search is performed.
      resources:
      - projects/SEARCH_PROJECT_ID
ingressPolicies:
  - ingressFrom:
      identityType: ANY_USER_ACCOUNT
      sources:
      - accessLevel: '*'
    ingressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids to expose in search results.
      resources:
      - projects/INGRESS_PROJECT_ID

如要進一步瞭解使用 Knowledge Catalog 搜尋功能所需的 Identity and Access Management 角色，請參閱「Knowledge Catalog IAM 角色」。

使用 VPC Service Controls 依環境區隔搜尋結果

如要區隔開發、測試和正式環境等不同環境的 Knowledge Catalog 搜尋結果，請為各環境設定獨立的 VPC Service Controls perimeter。將包含資料資產的專案和用於執行搜尋的專案，指派給對應環境的 perimeter。從特定範圍內的專案執行搜尋時，只會傳回位於該範圍內的資產結果。

搜尋功能的回憶限制

Knowledge Catalog 搜尋功能會優先探索資料，而非擷取完整目錄，因此搜尋查詢不保證能擷取所有結果。查詢可能會省略相符的結果，且重複查詢時傳回的結果可能不同。

召回率損失的原因

搜尋時，Knowledge Catalog 會動態檢查您的權限，確認是否符合存取控管限制 (最多 600 項限制，即權限評估規則)。如果存取權檢查超過這項限制，系統會提早停止檢查，以維持搜尋速度。這時搜尋功能可能會遺漏相符的素材資源。

如果符合下列任一情況，就可能達到這項上限：

  • 直接指派給數百項個別資源的 IAM 角色。
  • 多個 Google 群組的成員資格，每個群組都授予個別資源的存取權。
  • Google 群組成員資格，可直接存取數百項個別資源。

解決檢索限制和結果遺漏問題

如要解決檢索問題或擷取完整中繼資料，請根據目標選擇合適的方法：

  • 如何修正搜尋結果不一致或缺少的問題：減少存取權檢查總數，確保不超過 600 次的限制。只授予所需資源的存取權，並移除不需要權限的資源或 Google 群組存取權。您也可以在專案或資料夾層級授予角色，而非個別資源。
  • 如要擷取完整、保證的中繼資料目錄：請勿使用搜尋功能。請改為將中繼資料匯出至 Cloud Storage，並使用 BigQuery 查詢完整資料集。

後續步驟