Mit BigQuery verbinden

In diesem Dokument wird beschrieben, wie Sie einen Datenspeicher erstellen, der mit BigQuery-Daten verbunden ist. Sie können diesen Datenspeicher mit einer Gemini Enterprise App verknüpfen, damit die Agenten Ihre Daten analysieren können.

Wenn Sie mit einem Gemini Enterprise-Datenspeicher eine Verbindung zu BigQuery-Daten herstellen möchten, können Sie einen der folgenden Modi verwenden:

  • Föderierte Abfrage (empfohlen) [Vorabversion]: Stellen Sie eine Verbindung zu BigQuery-Daten her, ohne dass Kosten für das Kopieren und Verschieben der Daten anfallen. Bei einer föderierten Abfrage wird Ihre Abfrage direkt an BigQuery gesendet und zwar für alle Datasets und Tabellen, auf die Ihre Identität Zugriffsberechtigungen (Identity and Access Management, IAM) hat. Das ist effizienter für Analyseabfragen. Da Abfragen mit Ihren Anmeldedaten ausgeführt werden, bleiben BigQuery-IAM-Berechtigungen, einschließlich Sicherheit auf Zeilenebene, erhalten. Wenn Sie den föderierten Abfragemodus verwenden, wird Knowledge Catalog automatisch auf dem Tab Assistant Ihrer Gemini Enterprise-App aktiviert. So erhält der Agent Tools, mit denen er nach Daten suchen kann, auf die der Nutzer Zugriff hat, und Kontextinformationen abrufen kann.
  • Datenaufnahme: Daten aus einer bestimmten BigQuery-Tabelle in den Gemini Enterprise-Datenspeicher kopieren. Die Daten müssen aktualisiert werden, damit Änderungen in der BigQuery-Tabelle berücksichtigt werden. In diesem Modus fallen Egress-Kosten für das Verschieben von Daten an einen neuen Speicherort an und vorhandene IAM-Berechtigungen werden nicht in den Datenspeicher repliziert.

Hinweis

Wenn Sie einen BigQuery-Datenspeicher in Gemini Enterprise erstellen möchten, benötigen Sie die Rolle Gemini Enterprise-Administrator (roles/discoveryengine.agentspaceAdmin) oder Discovery Engine-Administrator (roles/discoveryengine.admin). Weitere Informationen finden Sie unter Administratoren Berechtigungen erteilen.

Wenn Ihr Projekt durch einen VPC Service Controls-Perimeter geschützt ist oder die Erzwingung von Organisationsrichtlinien aktiviert ist, muss die Organisationsrichtlinie den Connector zulassen:

Konfigurieren Sie außerdem die erforderlichen BigQuery-IAM-Berechtigungen für den Connectormodus, den Sie verwenden möchten:

Föderierte Abfrage

Im Modus Föderierte Abfrage wird der BigQuery-MCP-Server verwendet. Da für verschiedene MCP-Tools (Aktionen) unterschiedliche Berechtigungen erforderlich sind, hängen die erforderlichen IAM-Berechtigungen davon ab, welche Tools Sie verwenden. Weitere Informationen finden Sie in der BigQuery MCP-Dokumentation unter Erforderliche Rollen.

Die folgenden IAM-Rollen werden am häufigsten für Nutzer angewendet, die über den Connector Abfragen ausführen oder Aktionen vornehmen:

Datenaufnahme

Wenn Sie Daten aus einem Google Cloud Quellprojekt aufnehmen möchten, das sich von dem Google Cloud Projekt unterscheidet, das den Gemini Enterprise-Datenspeicher enthält, den Sie erstellen, weisen Sie demservice-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.comDienstkonto (wobei PROJECT_NUMBER die Projektnummer desGoogle Cloud Projekts ist, das den Gemini Enterprise-Datenspeicher enthält) die folgenden IAM-Rollen für das BigQuery-Quellprojekt zu:

BigQuery-Datenspeicher erstellen

So erstellen Sie einen Datenspeicher, der Daten aus BigQuery mit Gemini Enterprise verbindet:

  1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

    Gemini Enterprise

  2. Rufen Sie die Seite Datenspeicher auf.

  3. Klicken Sie auf Datenspeicher erstellen.

  4. Wählen Sie auf der Seite Quelle eine Datenquelle für Ihren Datenspeicher aus. Suchen Sie im Suchfeld Datenquelle auswählen nach „BigQuery“ oder suchen Sie in der Liste der Erstanbieter-Datenquellen nach BigQuery. Wählen Sie Datenquelle hinzufügen aus.

  5. Wählen Sie auf der Seite Daten den Connector-Modus aus, um eine Verbindung zu Ihren Daten herzustellen. Wählen Sie einen der folgenden Tabs aus, um weitere Anleitungen für den von Ihnen ausgewählten Modus zu erhalten.

    Föderierte Abfrage

    1. Wählen Sie Föderierte Abfrage (empfohlen) aus.
    2. Optional können Sie unter Erweiterte Optionen das Google Cloud Abrechnungsprojekt für die Ausführung von Abfragen für Ihren Datenspeicher angeben, indem Sie die Projekt-ID in das Feld ID des Abrechnungsprojekts eingeben. Wenn Sie dieses Feld leer lassen, werden Nutzer bei Abfragen nach einem Abrechnungsprojekt gefragt oder es wird auf benutzerdefinierte Anweisungen zurückgegriffen.
    3. Klicken Sie auf Weiter.
    4. Wählen Sie auf der Seite Aktionen die BigQuery-Aktionen aus, die Sie für Ihren Datenspeicher aktivieren möchten. Sie können diese Einstellungen später bearbeiten. Klicken Sie auf Weiter.

    Datenaufnahme

    1. Wählen Sie Datenaufnahme aus.
    2. Legen Sie fest, welche Art von Daten Sie importieren möchten. Lesen Sie vor dem Importieren der Daten, wie Sie Daten für die Aufnahme vorbereiten.
      • Wenn Sie strukturierte Daten importieren, wählen Sie BigQuery-Tabelle mit eigenem Schema oder BigQuery-Tabelle mit Metadaten aus. Wenn Sie Ihr eigenes Schema verwenden, wird es beim Import automatisch erkannt. Wenn Sie Metadaten verwenden, müssen Sie beim Import ein von Google angegebenes Schema definieren.
      • Wenn Sie Daten importieren, die eine spezielle Verarbeitung erfordern, wählen Sie eine der Optionen unter Spezialisierter Datenimport aus.

    3. Wählen Sie unter Synchronisierungshäufigkeit aus, wie oft Sie Daten aus Ihrer BigQuery-Tabelle importieren möchten. Diese Option kann nach dem Erstellen des Datenspeichers nicht mehr geändert werden.

      • Wählen Sie Einmal für einen einzelnen Import aus.
      • Wählen Sie Regelmäßig aus, um einen wiederkehrenden Importzeitplan festzulegen.

    4. Wählen Sie die Datentabelle aus, die Sie importieren möchten. Klicken Sie im Feld BigQuery-Pfad auf Durchsuchen, wählen Sie eine Tabelle aus, die Sie für die Aufnahme vorbereitet haben, und klicken Sie dann auf Auswählen. Alternativ können Sie den Tabellenspeicherort direkt in das Feld BigQuery-Pfad eingeben.

    5. Klicken Sie auf Weiter.

    Nachdem Sie Ihren Datenspeicher erstellt haben, können Sie den Status der Aufnahme prüfen, indem Sie die Seite Datenspeicher aufrufen und auf den Namen des Datenspeichers klicken, um Details dazu auf der Seite Daten anzeigen zu lassen. Wenn sich die Statusspalte auf dem Tab Aktivität von In Bearbeitung zu Import abgeschlossen ändert, ist die Aufnahme abgeschlossen.

    Abhängig von der Größe der Daten kann die Datenaufnahme einige Minuten bis mehrere Stunden dauern.

  6. Konfigurieren Sie auf der Seite Konfiguration die Einstellungen für den Datenspeicher.

    • Standort des Daten-Connectors: Wählen Sie eine Region für den Speicherort der Metadaten Ihres Datenspeichers aus. Sie können den Standort nicht mehr ändern, nachdem der Datenspeicher erstellt wurde. Wichtige Informationen zu multiregionalen Standorten finden Sie unter Gemini Enterprise-Standorte.
    • Name des Daten-Connectors: Geben Sie im Feld Name des Daten-Connectors einen Namen für den Daten-Connector ein. Sie können den Namen nach dem Erstellen des Datenconnectors nicht mehr ändern. Wenn Sie einen Namen eingeben, wird eine eindeutige ID für den Daten-Connector generiert. Geben Sie optional im Feld Tag (optional) ein Tag für den Daten-Connector ein. Dieses dient als versionsübergreifend stabile Kennung für den Connector.
    • Sensitive Data Protection-Richtlinie: Wählen Sie eine Sensitive Data Protection-Richtlinie für Ihren Datenspeicher aus. Das Format sollte so aussehen: projects/{project}/locations/{location}/contentPolicies/{policy}. Sie können diese Einstellung später ändern.

  7. Klicken Sie auf Erstellen.

Jetzt können Sie den Datenspeicher an eine Gemini Enterprise-App anhängen. Im Modus für föderierte Abfragen fallen BigQuery-Rechenkosten an, wenn Nutzer Abfragen über die angehängte App ausführen. Im Modus für die Datenaufnahme fallen BigQuery- und Gemini Enterprise-Indexierungskosten für den Import von Daten an, noch bevor der Datenspeicher an eine App angehängt wird. Weitere Informationen zu diesen Gebühren finden Sie unter Gemini Enterprise-Preise.

Nächste Schritte