關於 Knowledge Catalog 的搜尋功能

使用 Knowledge Catalog (舊稱 Dataplex Universal Catalog) 搜尋功能，透過語意比對、關鍵字和結構化述詞，以自然語言查詢探索貴機構的資源。

用途

以下列出常見的搜尋用途，並提供說明和查詢範例：

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

    查詢範例

    • 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 中維護的資料資產建立所有內容的索引。包含下列項目：

  • 從 BigQuery 和 Cloud SQL 等 Google Cloud 資料來源自動擷取的中繼資料
  • 透過連接器和整合功能擷取資源的背景資訊
  • 您為資源建立的其他內容，例如代表業務情境或說明資料語意。脈絡也可能以層面或連結的業務字詞形式擷取。

處理查詢時，搜尋會同時套用語意和關鍵字比對。下表說明可搭配 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 範圍以外的資源，請使用 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。從特定範圍內的專案執行搜尋時，只會傳回位於該範圍內的資產結果。

搜尋中的回憶集錦限制

Knowledge Catalog 搜尋查詢無法保證完整召回，也就是說，搜尋結果可能不會與查詢相符。此外，如果您重複搜尋查詢，傳回 (和未傳回) 的結果可能會有所不同。

如要查詢所有 Knowledge Catalog 中繼資料，您可以將中繼資料匯出至 Cloud Storage，然後從 BigQuery 查詢。詳情請參閱「匯出中繼資料」。

後續步驟