搜尋資源

在 BigQuery 中使用 Knowledge Catalog 搜尋功能,透過自然語言查詢尋找Google Cloud 資源,例如資料集和資料表。使用日常用語搜尋您建立的中繼資料,即可找到所需的資料資產,不必依賴完全相符的關鍵字比對。

如要進一步瞭解如何在 BigQuery 搜尋資料表資料,請參閱「BigQuery 搜尋功能簡介」。

申請使用預先發布版

如要申請預先發布版,Google 帳戶代表必須填寫申請表單提出要求。提交表單後,BigQuery 團隊會與您聯絡,說明後續步驟。

事前準備

在 BigQuery 中使用自然語言搜尋Google Cloud 資源之前,請先完成本節中的工作。

必要的角色

如要搜尋資源,您必須在用於搜尋的專案中,至少具備下列其中一個 Knowledge Catalog IAM 角色:Dataplex Catalog 管理員、Dataplex Catalog 編輯者或 Dataplex Catalog 檢視者。系統會獨立檢查搜尋結果的權限,不受所選專案影響。

BigQuery 的搜尋結果範圍取決於您對基礎資源的 IAM 權限。如要在 BigQuery 中搜尋資源,您必須具備相應資源的存取權限。詳情請參閱本文的「搜尋範圍」一節。

舉例來說,如要搜尋 BigQuery 資料集、資料表、檢視表和模型,您必須具備存取這些資源的權限。詳情請參閱「BigQuery 權限」。以下列出最低權限需求:

  • 如要搜尋資料表,您必須具備該資料表的 bigquery.tables.get 權限。
  • 如要搜尋資料集,您必須具備該資料集的 bigquery.datasets.get 權限。

BigQuery 中繼資料檢視者角色 (roles/bigquery.metadataViewer) 包含 bigquery.tables.get 和 bigquery.datasets.get 權限,可讓您搜尋任何 BigQuery 資源。

如要進一步瞭解如何授予角色,請參閱「管理存取權」。

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

啟用 API

如要使用搜尋功能,請務必啟用 Dataplex API。根據預設,所有採用 BigQuery 的新 Google Cloud 專案都會啟用 Dataplex API。如果專案未啟用 Dataplex API,請參閱「啟用 Knowledge Catalog」。

  1. 前往 Google Cloud 控制台的 BigQuery「Search」(搜尋) 頁面。

    前往「Search」(搜尋) 頁面

  2. 在搜尋欄位中,以自然語言輸入查詢,然後按下 Enter 鍵。以下是幾個查詢範例:

    • Show me the datasets that contain taxi information
    • Find data on vaccine distribution across different countries
    • Get tables with historical temperature data for major world cities
    • Search for hurricane tracking and storm activity datasets
    • Population data by country
  3. 如要篩選搜尋結果,請按一下「篩選器」。可用的篩選器如下:

    • 範圍:搜尋整個組織 (預設)、目前專案,或僅搜尋已加星號的資源。詳情請參閱本文的「搜尋範圍」一節。
    • 系統:資源所屬的 Google Cloud 服務,例如 BigQuery。Knowledge Catalog 系統包含項目群組。
    • 專案:要搜尋的專案。
    • 類型:資源類型,例如 BigQuery 連線、Cloud Storage bucket 或資料庫。視資源類型而定,您也可以依子類型篩選,例如連線類型或 SQL 方言。
    • 選取位置:要搜尋的位置。
    • 選取資料集:這會將搜尋結果限制為屬於所選 BigQuery 資料集的 BigQuery 資源。在「Type to filter」(輸入篩選條件) 欄位中,輸入資料集名稱。
    • 註解:與您搜尋的資源相關聯的 Knowledge Catalog 切面類型。如要依面向值篩選,請按一下「Filter on annotation values」(篩選註解值),然後選取所需的值。

    如要移除篩選器,請按一下要移除的特定篩選器旁邊的 「Clear」(清除)。如要移除所有篩選器,請按一下「Clear Filters」(清除篩選器)。

    如要進一步瞭解篩選器的評估方式,請參閱本文的「篩選器」一節。

  4. 選用:如要查看資源的詳細資訊,請在搜尋結果中按一下資源名稱。

    資源摘要會顯示在分割窗格中。執行下列任一操作:

    • 如要在資源所屬的服務中開啟資源,請按一下資源的「Open in PRODUCT_NAME」(在 PRODUCT_NAME 中開啟)。舉例來說,如要在 BigQuery Studio 中開啟 BigQuery 資料集,請按一下「Open in Studio」(在 Studio 中開啟)。可用選項取決於資源。
    • 如要查看與資源相關聯的 Knowledge Catalog 中繼資料,請按一下資源的「Open in Knowledge Catalog」(在 Knowledge Catalog 中開啟)。
    • 如果想將重要的搜尋結果加入書籤,可以加上星號。按一下資源的 「Star」(星號)。您可以在 BigQuery Studio 查看已加星號的資源。
    • 如要關閉分割窗格中的資源摘要,請按一下 「Close」(關閉)。

或者,您也可以使用 Gemini Cloud Assist 搜尋資源。

篩選器

篩選器可縮小搜尋結果範圍。

如果您在多個部分提供篩選器,系統會使用 AND 邏輯運算子評估篩選器。搜尋結果會包含符合每個所選區段中至少一個條件的資源。舉例來說,如果您選取 BigQuery 系統和 dataset 資源類型,搜尋結果會包含 BigQuery 資料集,但不包含 Gemini Enterprise Agent Platform 資料集。

如果您在單一區段中選取多個篩選器,系統會使用 OR 邏輯運算子評估篩選器。例如,如果您選取 dataset 資源類型和 table 資源類型,搜尋結果會同時包含資料集和資料表。

搜尋範圍

如果專案屬於 Google Cloud 組織,搜尋範圍會限定在該組織內。

搜尋結果會依據您對資源的權限顯示。舉例來說,如果您具備某項資源的 BigQuery 中繼資料讀取權限,該資源就會顯示在搜尋結果中。如果您有權存取 BigQuery 資料表,但無權存取包含該資料表的資料集,資料表仍會正常顯示在搜尋結果中。

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

後續步驟