搜尋資源

使用 Dataplex Universal Catalog 搜尋功能,在 BigQuery 中尋找資源,例如 BigQuery 資料集和資料表。 Google Cloud

Dataplex Universal Catalog 搜尋功能支援自然語言搜尋查詢 (也稱為語意搜尋查詢),可讓您使用日常用語搜尋資源。

與關鍵字搜尋類似,自然語言搜尋會分析與貴機構資源相關聯的中繼資料,著重於探索資源。搜尋功能會考量各種描述資源的中繼資料,包括您建立的中繼資料。

自然語言搜尋的重點在於提高喚回度,而非精確度。

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

申請使用預先發布版

如要申請加入搶先體驗計畫,請由 Google 帳戶代表填寫申請表單。提交表單後,BigQuery 團隊會與您聯絡,說明後續步驟。

事前準備

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

必要的角色

如要在專案搜尋資源,至少須具備該專案的其中一個 Dataplex Universal 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.getbigquery.datasets.get 權限,可讓您搜尋任何 BigQuery 資源。

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

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

啟用 API

如要使用搜尋功能,請務必啟用 Dataplex API。 對於所有使用 BigQuery 的新 Google Cloud 專案,Dataplex API 預設為啟用。如果專案尚未啟用 Dataplex API,請參閱「啟用 Dataplex Universal Catalog」。

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

    前往「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。Dataplex Universal Catalog 系統包含項目群組
    • 專案:要搜尋的專案。
    • 類型:資源類型,例如 BigQuery 連線、Cloud Storage 值區或資料庫。視資源類型而定,您也可以依子類型篩選,例如連線類型或 SQL 方言。
    • 選取地點:要搜尋的地點。
    • 選取資料集:將搜尋結果限制為屬於所選 BigQuery 資料集的 BigQuery 資源。在「Type to filter」(輸入以篩選) 欄位中,輸入資料集的名稱。
    • 註解:與您搜尋的資源相關聯的 Dataplex Universal Catalog切面類型。如要依層面值篩選,請按一下「篩選註解值」,然後選取值。

    如要移除篩選器,請找到要移除的篩選器,然後按一下旁邊的「清除」。如要移除所有篩選器,請按一下「清除篩選器」

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

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

    系統會在分割窗格中開啟資源摘要。請採行下列任一動作:

    • 如要在資源所屬的服務中開啟資源,請按一下資源的「在 PRODUCT_NAME 中開啟」。 舉例來說,如要在 BigQuery Studio 中開啟 BigQuery 資料集,請按一下「在 Studio 中開啟」。可用的選項會因資源而異。
    • 如要查看與資源相關聯的 Dataplex Universal Catalog 中繼資料,請點選資源的「在 Dataplex Catalog 中開啟」
    • 如要將重要搜尋結果標記為書籤,可以加上星號。按一下資源的「加上星號」。您可以在 BigQuery Studio 中查看已加星號的資源。
    • 如要關閉分割窗格中的資源摘要,請按一下「關閉」

篩選器

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

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

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

搜尋範圍

如果是屬於 Google Cloud 機構的專案,搜尋作業會在該機構的範圍內進行。

搜尋結果會遵守您對資源擁有的權限。舉例來說,如果您有資源的 BigQuery 中繼資料讀取權,該資源就會顯示在搜尋結果中。如果您有權存取 BigQuery 資料表,但無權存取包含該資料表的資料集,搜尋結果仍會如預期顯示該資料表。

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

後續步驟