Datenstandort

Auf dieser Seite wird erläutert, wie die Conversational Analytics API den Datenstandort unterstützt. Der Datenstandort bezieht sich auf den physischen Standort Ihrer Daten und die Zusicherungen, Ihre Daten in einem bestimmten geografischen Gebiet zu speichern und zu verarbeiten, um gesetzliche oder Richtlinienanforderungen zu erfüllen. Wenn Sie den Standort Ihrer Daten steuern möchten, geben Sie einen regionalen Dienstendpunkt für Ihre API-Anfragen an.

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

Die Zusicherungen zum Datenstandort für die Conversational Analytics API variieren je nachdem, ob Ihr Agent eine Verbindung zu BigQuery oder zu Looker herstellt.

Umfang des Datenstandorts

Die Conversational Analytics API unterstützt Sie bei der Einhaltung der Anforderungen an den Datenstandort, indem sie Ihnen die Möglichkeit gibt, den Standort von Kundendaten in verschiedenen Zuständen zu steuern:

  • Daten sind im Ruhezustand, 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 ML-Modelle (Machine Learning) Daten verarbeiten, um eine Antwort zu generieren, oder wenn der Dienst eine Abfrage ausführt. Für die Conversational Analytics API gelten die Zusicherungen zum Datenstandort für Daten in Verwendung nur für die ML-Verarbeitung in der Gerichtsbarkeit und bieten keinen umfassenden Datenstandort für alle Zustände von Daten in Verwendung.
  • Daten sind bei der Übertragung , wenn sie in den oder aus dem Google-Netzwerkperimeter gelangen.

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 Nachrichteninhalte und Statusverlauf). Diese Zusicherungen gelten nicht für Dienstdaten wie Ressourcen-IDs und Labels oder für Daten bei der Übertragung.

Unterstützte Datenstandorte

Die Conversational Analytics API unterstützt globale, regionale und multiregionale Standorte. Wenn Sie einen regionalen oder multiregionalen Endpunkt verwenden, steuern Sie den Standort, an dem Ihre Daten im Ruhezustand gespeichert werden.

In den folgenden Tabellen bezieht sich die ML-Verarbeitung in der Gerichtsbarkeit (als In Verwendung (Gerichtsbarkeit) gekennzeichnet) auf die Zusicherungen zur ML-Verarbeitung für Ihre Daten. Gemäß den dienstspezifischen Nutzungsbedingungen führt Google die ML-Verarbeitung Ihrer Daten 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 Agents und Unterhaltungen, die BigQuery und Looker Datenquellen verwenden.

BigQuery-Daten

Für Daten-Agents, die eine Verbindung zu BigQuery herstellen, unterstützen regionale und multiregionale Endpunkte den Datenstandort für Daten im Ruhezustand und die ML-Verarbeitung in der Gerichtsbarkeit für Daten in Verwendung. 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 Multiregion Nicht unterstützt
eu Europäische Union Multiregional geminidataanalytics.eu.rep.googleapis.com Beliebige Region oder Multiregion Im Ruhezustand, In Verwendung (Gerichtsbarkeit)
us USA Multiregional geminidataanalytics.us.rep.googleapis.com Beliebige Region oder Multiregion Im Ruhezustand, In Verwendung (Gerichtsbarkeit)
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Beliebige Region oder Multiregion Im Ruhezustand, In Verwendung (Gerichtsbarkeit)

Looker-Daten

Für Daten-Agents, die eine Verbindung zu Looker herstellen, unterstützen regionale und multiregionale Endpunkte den Datenstandort für Daten im Ruhezustand. Unabhängig vom angegebenen Endpunktstandort kann der Agent eine Verbindung zu Datenquellen 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 Multiregion Nicht unterstützt
eu Europäische Union Multiregional geminidataanalytics.eu.rep.googleapis.com Beliebige Region oder Multiregion Im Ruhezustand, In Verwendung (Gerichtsbarkeit)
us USA Multiregional geminidataanalytics.us.rep.googleapis.com Beliebige Region oder Multiregion Im Ruhezustand
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Beliebige Region oder Multiregion Im Ruhezustand

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

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 auf diese Ressourcen einen regionalen Endpunkt. 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 einzelne Region oder Multiregion wie eu, us oder us-east4.

In den folgenden Beispielen wird gezeigt, 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 base_url so, dass der von Ihnen ausgewählte regionale Endpunkt verwendet wird, wie im folgenden Beispiel unter Erste Einstellungen 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 unter Fragen mit zustandsbehaftetem 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. Wenn Sie einen der regionalen Endpunkte verwenden möchten, geben Sie eu, us oder us-east4 an.

Beschränkungen

Beachten Sie bei der Verwendung regionaler Endpunkte Folgendes:

Nächste Schritte