連結至 BigQuery

本文說明如何建立連結至 BigQuery 資料的資料儲存庫。您可以將這個資料儲存庫連結至 Gemini Enterprise 應用程式，讓代理程式分析您的資料。

如要使用 Gemini Enterprise 資料儲存庫連結 BigQuery 資料，可以採用下列任一模式：

  • 聯合查詢 (建議) [預先發布版]： 直接連線至 BigQuery 資料，不必支付複製及移動資料的輸出費用。聯合查詢會直接將查詢傳送至 BigQuery，並存取您身分具備 Identity and Access Management (IAM) 存取權的所有資料集和資料表，因此更適合用於分析查詢。由於查詢是使用您的憑證執行，因此 BigQuery IAM 權限 (包括資料列層級安全防護機制) 會維持不變。使用聯合查詢模式時，系統會自動在 Gemini Enterprise 應用程式的「助理」分頁中啟用 Knowledge Catalog，讓代理程式工具搜尋使用者有權存取的資料，並查詢相關背景資訊。
  • 資料擷取：將特定 BigQuery 資料表中的資料複製到 Gemini Enterprise 資料儲存庫。您必須重新整理資料，才能反映 BigQuery 資料表的變更。這個模式會產生將資料移至新位置的輸出費用，且現有的 IAM 權限不會複製到資料儲存庫。

事前準備

如要在 Gemini Enterprise 建立 BigQuery 資料儲存庫，您必須具備 Gemini Enterprise 管理員 (roles/discoveryengine.agentspaceAdmin) 或 Discovery Engine 管理員 (roles/discoveryengine.admin) 角色。詳情請參閱「將權限授予管理員」。

如果專案受到 VPC Service Controls perimeter 保護，或已啟用組織政策強制執行功能，請確保組織政策允許連接器：

此外，請為您打算使用的連接器模式設定必要的 BigQuery IAM 權限：

聯合查詢

聯合查詢模式會使用 BigQuery MCP 伺服器。由於不同 MCP 工具 (動作) 需要不同權限，因此所需的 IAM 權限取決於您使用的工具。詳情請參閱 BigQuery MCP 說明文件中的「必要的角色」。

以下是使用者透過連接器查詢或執行動作時，最常套用的 IAM 角色：

資料擷取

如要從來源 Google Cloud 專案擷取資料，而該專案與包含您要建立的 Gemini Enterprise 資料儲存庫的 Google Cloud 專案不同，請將來源 BigQuery 專案的下列 IAM 角色授予service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com服務帳戶 (其中 PROJECT_NUMBER 是包含 Gemini Enterprise 資料儲存庫的Google Cloud 專案編號)：

建立 BigQuery 資料儲存庫

如要建立資料儲存庫，將 BigQuery 的資料連結至 Gemini Enterprise，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    Gemini Enterprise

  2. 前往「Data Stores」(資料儲存庫) 頁面。

  3. 按一下「Create data store」(建立資料儲存庫)。

  4. 在「Source」(來源) 頁面，選擇資料儲存庫的資料來源。在「選取資料來源」搜尋欄位中搜尋「BigQuery」，或在「第一方資料來源」清單中尋找 BigQuery。選取「新增資料來源」。

  5. 在「Data」(資料) 頁面，選取連接器模式，指定資料連結方式。根據您選擇的模式，選取下列分頁標籤，查看進一步的操作說明。

    聯合查詢

    1. 選取「聯合查詢 (建議)」。
    2. (選用) 在「進階選項」下方，於「報帳專案 ID」欄位中輸入專案 ID，指定資料存放區查詢執行的 Google Cloud 報帳專案。如果將這個欄位留空，查詢會提示使用者提供計費專案，或依據自訂指示執行。
    3. 按一下「繼續」。
    4. 在「Actions」(動作) 頁面，選取要為資料儲存庫啟用的 BigQuery 動作。你之後可以編輯這些設定。然後點按「繼續」。

    資料擷取

    1. 選取「Data ingestion」(資料擷取)。
    2. 判斷要匯入的資料類型。匯入資料前，請參閱「為資料進行擷取的準備作業」。
      • 如要匯入結構化資料，請選取「BigQuery 資料表 (使用您自己的結構定義)」或「BigQuery 資料表 (使用中繼資料)」。如果使用自己的結構定義，系統會在匯入期間自動偵測結構定義。如果使用中繼資料，則必須在匯入時定義 Google 指定的結構定義。
      • 如果要匯入的資料需要特殊處理，請選取「資料匯入」下方的選項。

    3. 在「同步頻率」下方，選取從 BigQuery 資料表匯入資料的頻率。資料儲存庫建立後，即無法變更這個選項。

      • 如要匯入一次，請選取「單次」。
      • 選取「週期性」，設定週期性匯入時間表。

    4. 選取要匯入的資料表。在「BigQuery 路徑」欄位中，按一下「瀏覽」，選取準備擷取的資料表，然後點選「選取」。或者，您也可以直接在「BigQuery path」(BigQuery 路徑) 欄位中輸入資料表位置。

    5. 按一下「繼續」。

    建立資料儲存庫後，請前往「Data stores」(資料儲存庫) 頁面，點選資料儲存庫名稱，即可在相應的「Data」(資料) 頁面查看該儲存庫的詳細資料，並檢查擷取狀態。「Activity」(活動) 分頁的狀態欄從「In progress」(進行中) 變為「Import completed」(匯入完成) 時，表示擷取作業已完成。

    視資料大小而定，可能需要數分鐘至數小時才能擷取完畢。

  6. 在「Configuration」(設定) 頁面，調整資料儲存庫設定。

    • 資料連接器的位置：選擇資料儲存庫中繼資料的儲存區域。資料儲存庫建立後，即無法變更位置。如要查看多區域的重要資訊，請參閱「Gemini Enterprise 位置」一文。
    • 資料連接器名稱：在「資料連接器名稱」欄位中，輸入資料連接器的名稱。資料連接器建立後，名稱即無法變更。輸入名稱後，系統會為資料連接器產生專屬 ID。選用步驟：在「Tag (optional)」(標記 (選用)) 欄位中，輸入資料連接器的標記，做為所有版本連接器的固定 ID。
    • Sensitive Data Protection 政策：選取資料儲存庫的 Sensitive Data Protection 政策。格式應為：projects/{project}/locations/{location}/contentPolicies/{policy}。您之後可以編輯這項設定。

  7. 點選「建立」。

現在可以將資料儲存庫附加至 Gemini Enterprise 應用程式。在聯合查詢模式下，使用者透過附加的應用程式執行查詢時，會產生 BigQuery 運算費用；在資料擷取模式下，即使資料儲存庫尚未附加至應用程式，匯入資料也會產生 BigQuery 和 Gemini Enterprise 索引費用。如要進一步瞭解這些費用，請參閱 Gemini Enterprise 定價。

後續步驟