Datenstandort

Auf dieser Seite wird beschrieben, wie die Conversational Analytics API die Datenstandortverwaltung unterstützt. Der Datenstandort bezieht sich auf den physischen Speicherort Ihrer Daten und die Verpflichtungen, Ihre Daten innerhalb eines bestimmten geografischen Bereichs zu speichern und zu verarbeiten, um regulatorische oder Richtlinienanforderungen zu erfüllen. Wenn Sie den Speicherort Ihrer Daten kontrollieren möchten, geben Sie einen regionalen Dienstendpunkt für Ihre API-Anfragen an.

In diesem Dokument bezieht sich Datenstandort auf eine Google Cloud Region oder Multiregion, in der sich Daten befinden, und Ihre Daten hat dieselbe Bedeutung wie „Kundendaten“ im Abschnitt Datenstandort der dienstspezifischen Nutzungsbedingungen.

Die Zusicherungen zum Datenstandort für die Conversational Analytics API hängen davon ab, ob Ihr Agent eine Verbindung zu BigQuery oder Looker herstellt.

Umfang des Datenstandorts

Mit der Conversational Analytics API können Sie die Anforderungen an den Datenstandort erfüllen, da Sie den Speicherort von Kundendaten in verschiedenen Zuständen steuern können:

  • Daten sind ruhend, wenn sie in einem nichtflüchtigen Speicher gespeichert sind und nicht aktiv verarbeitet oder übertragen werden.
  • Daten sind in Verwendung, wenn sie sich im Arbeitsspeicher befinden, z. B. wenn Modelle für maschinelles Lernen (ML) Daten verarbeiten, um eine Antwort zu generieren, oder wenn der Dienst eine Abfrage ausführt. Bei der Conversational Analytics API gelten die Zusicherungen zum Datenstandort für aktive Daten nur für die ML-Verarbeitung in der jeweiligen Gerichtsbarkeit. Sie bieten keinen umfassenden Datenstandort für alle Zustände aktiver Daten.
  • Daten befinden sich bei der Übertragung, wenn sie in den Google-Netzwerkperimeter gelangen oder ihn verlassen.

Die Zusicherungen zum Datenstandort für die Conversational Analytics API gelten für DataAgent-Ressourcen (einschließlich Kundenkonfigurationen, Kontext, Systemanweisungen und Beispielabfragen) und Conversation-Ressourcen (einschließlich Nachrichteninhalten und Statusverlauf). Diese Zusicherungen gelten nicht für Dienstdaten wie Ressourcenkennungen und Labels oder für Daten bei der Übertragung.

Unterstützte Datenspeicherorte

Die Conversational Analytics API unterstützt globale, regionale und multiregionale Standorte. Wenn Sie einen regionalen oder multiregionalen Endpunkt verwenden, können Sie den Speicherort Ihrer ruhenden Daten steuern.

In den folgenden Tabellen bezieht sich die ML-Verarbeitung (Machine Learning) in der Gerichtsbarkeit (gekennzeichnet als In Verwendung (Gerichtsbarkeit)) auf die Verpflichtungen zur ML-Verarbeitung für Ihre Daten. Wie in den dienstspezifischen Nutzungsbedingungen definiert, führt Google die Verarbeitung Ihrer Daten durch maschinelles Lernen nur in der von Ihnen ausgewählten Region oder Multiregion durch.

In den folgenden Abschnitten finden Sie Details zur Unterstützung des Datenstandorts für Agenten und Unterhaltungen, die BigQuery- und Looker-Datenquellen verwenden.

BigQuery-Daten

Für Datenagenten, die eine Verbindung zu BigQuery herstellen, unterstützen regionale und multiregionale Endpunkte den Datenstandort für ruhende Daten und die ML-Verarbeitung für aktive Daten gemäß den rechtlichen Vorgaben. Unabhängig vom angegebenen Endpunktstandort kann der Agent eine Verbindung zu BigQuery-Datasets an jedem Standort oder jeder Kombination von Standorten herstellen:

Standort Standortbeschreibung Endpunkttyp Endpunkt-URL Dataset-Speicherort Unterstützung für den Datenstandort
global Global Global geminidataanalytics.googleapis.com Beliebige Region oder multiregional Nicht unterstützt
eu Europäische Union Multiregional geminidataanalytics.eu.rep.googleapis.com Beliebige Region oder multiregional Ruhend, Aktiv (rechtlich)
us USA Multiregional geminidataanalytics.us.rep.googleapis.com Beliebige Region oder multiregional Ruhend, Aktiv (rechtlich)
northamerica-northeast1 Montreal Regional geminidataanalytics-northamerica-northeast1.googleapis.com Beliebige Region oder multiregional Ruhend, Aktiv (rechtlich)
northamerica-northeast2 Toronto Regional geminidataanalytics-northamerica-northeast2.googleapis.com Beliebige Region oder multiregional Ruhend, aktiv (rechtlich)
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Beliebige Region oder multiregional Ruhend, Aktiv (rechtlich)

Looker-Daten

Bei KI-Datenagenten, die eine Verbindung zu Looker herstellen, unterstützen regionale und multiregionale Endpunkte den Datenstandort für ruhende Daten. Unabhängig vom angegebenen Endpunktstandort kann der Agent eine Verbindung zu Datenquellen an einem beliebigen Standort oder einer beliebigen Kombination von Standorten herstellen:

Standort Standortbeschreibung Endpunkttyp Endpunkt-URL Dataset-Speicherort Unterstützung für den Datenstandort
global Global Global geminidataanalytics.googleapis.com Beliebige Region oder multiregional Nicht unterstützt
eu Europäische Union Multiregional geminidataanalytics.eu.rep.googleapis.com Beliebige Region oder multiregional In Ruhe
us USA Multiregional geminidataanalytics.us.rep.googleapis.com Beliebige Region oder multiregional In Ruhe
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Beliebige Region oder multiregional In Ruhe

Eine vollständige Liste der verfügbaren regionalen und multiregionalen Endpunkte finden Sie unter Standorte der Conversational Analytics API.

Datenstandort mit regionalen Endpunkten erzwingen

Wenn Sie den Datenstandort für Ihre DataAgent- und Conversation-Ressourcen erzwingen möchten, verwenden Sie beim Erstellen und Zugreifen einen regionalen Endpunkt. Wenn Sie regionale Endpunkte aufrufen, muss der Standort im Anfragepfad oder im übergeordneten Element der Anfrage mit dem Standort des aufgerufenen Endpunkts übereinstimmen. Wenn Sie beispielsweise den Endpunkt geminidataanalytics.us.rep.googleapis.com aufrufen, müssen Sie us im Anfragepfad oder im übergeordneten Element der Anfrage angeben (z. B. /locations/us oder projects/PROJECT_ID/locations/us).

Die Dienstendpunkte für die Conversational Analytics API verwenden je nach Standorttyp die folgenden Formate:

  • Global: geminidataanalytics.googleapis.com
  • Multiregional: geminidataanalytics.LOCATION.rep.googleapis.com
  • Regional: geminidataanalytics-LOCATION.googleapis.com

Ersetzen Sie den Platzhalter LOCATION durch eine unterstützte Region oder Multiregion für Ihre Datenquelle. Weitere Informationen finden Sie unter Unterstützte Datenspeicherorte.

Die folgenden Beispiele zeigen, wie Sie einen regionalen Endpunkt für HTTP- und Python SDK-Anfragen konfigurieren:

HTTP

Wenn Sie einen regionalen Endpunkt mit HTTP verwenden möchten, erstellen Sie die Anfrage-URL mit der regionalen Basis-URL. Konfigurieren Sie zuerst den base_url so, dass der ausgewählte regionale Endpunkt verwendet wird, wie im folgenden Beispiel aus Anfangseinstellungen und Authentifizierung konfigurieren gezeigt:

project_id = "PROJECT_ID"
location = "LOCATION"

# Set the base URL based on location.
if not location or location == "global":
  base_url = "https://geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  base_url = f"https://geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  base_url = f"https://geminidataanalytics.{location}.rep.googleapis.com"

Verwenden Sie dann die Variable base_url, wenn Sie URLs für API-Anfragen erstellen, wie in diesem Beispiel aus Fragen mit zustandsorientiertem und zustandslosem Chat stellen:

# Example API request URL construction using base_url:
chat_url = f"{base_url}/v1beta/projects/{project_id}/locations/{location}:chat"

Python SDK

Wenn Sie einen regionalen Endpunkt mit dem Python SDK verwenden möchten, übergeben Sie client_options mit dem regionalen Parameter api_endpoint, wenn Sie API-Clients initialisieren, wie im folgenden Beispiel unter Einstellungen konfigurieren und Clients initialisieren gezeigt.

from google.cloud import geminidataanalytics
from google.api_core import client_options

project_id = "PROJECT_ID"
location = "LOCATION"

# Set client options based on location.
if not location or location == "global":
  endpoint = "geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  endpoint = f"geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  endpoint = f"geminidataanalytics.{location}.rep.googleapis.com"
opts = client_options.ClientOptions(api_endpoint=endpoint)

# Use client options when initializing API clients.
data_agent_client = geminidataanalytics.DataAgentServiceClient(client_options=opts)
data_chat_client = geminidataanalytics.DataChatServiceClient(client_options=opts)

# Use clients to make API requests. For example:
# response = data_chat_client.chat(request=request)

Ersetzen Sie die Beispielwerte so:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION: Die Region oder Multiregion, in der Sie Ihre Ressourcen erstellen möchten. Informationen zu den von den einzelnen Datenquellen unterstützten Datenstandorten finden Sie unter Unterstützte Datenstandorte.

Beschränkungen

Beachten Sie bei der Verwendung regionaler Endpunkte Folgendes:

Nächste Schritte