Datenstandort

Auf dieser Seite wird erläutert, wie die Conversational Analytics API den Datenstandort unterstützt. Datenstandort bezieht sich auf den physischen Speicherort Ihrer Daten und die Verpflichtungen, Ihre Daten in einem bestimmten geografischen Gebiet zu speichern und zu verarbeiten, um behördliche oder Richtlinienanforderungen zu erfüllen. Um den Speicherort Ihrer Daten zu steuern, 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, und Ihre Daten hat dieselbe Bedeutung wie „Kundendaten“ im Abschnitt Datenspeicherort 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

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 befinden sich im Ruhezustand, wenn sie in einem permanenten 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 Anfrage ausführt. Für die Conversational Analytics API gelten die Zusagen zum Datenstandort für verwendete Daten nur für die ML-Verarbeitung in Gerichtsbarkeiten und bieten keinen umfassenden Standort für alle Zustände der verwendeten Daten.
  • Daten werden übertragen, wenn sie in das Google-Netzwerk eintreten oder es 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, bestimmen Sie den Speicherort Ihrer Daten im Ruhezustand.

In den folgenden Tabellen bezieht sich die Verarbeitung von maschinellem Lernen (ML) in Gerichtsbarkeiten (als Wird verwendet (Gerichtsbarkeit) gekennzeichnet) auf die Verpflichtungen zur Verarbeitung von ML 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 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 die Datenresidenz für ruhende Daten und die Gerichtsbarkeits-ML-Verarbeitung für Daten in Verwendung. Unabhängig vom angegebenen Endpunktspeicherort kann der Agent eine Verbindung zu BigQuery-Datasets an einem beliebigen Speicherort oder einer beliebigen Kombination von Speicherorten herstellen:

Standort Standortbeschreibung Endpunkttyp Endpunkt-URL Dataset-Speicherort Unterstützung für den Datenstandort
global Global Global geminidataanalytics.googleapis.com Beliebige Region oder mehrere Regionen Nicht unterstützt
eu Europäische Union Multiregional geminidataanalytics.eu.rep.googleapis.com Beliebige Region oder mehrere Regionen Im Ruhezustand, In Verwendung (Gerichtsbarkeit)
us USA Multiregional geminidataanalytics.us.rep.googleapis.com Beliebige Region oder mehrere Regionen Im Ruhezustand, In Verwendung (Gerichtsbarkeit)
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Beliebige Region oder mehrere Regionen Im Ruhezustand, In Verwendung (Gerichtsbarkeit)

Looker-Daten

Bei Datenagenten, die eine Verbindung zu Looker herstellen, unterstützen regionale und multiregionale Endpunkte den Datenstandort für Daten im Ruhezustand. Unabhängig vom angegebenen Endpunkt kann der Agent eine Verbindung zu Datenquellen an einem beliebigen Ort oder einer beliebigen Kombination von Orten herstellen:

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

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 auf diese Ressourcen einen regionalen Endpunkt. Wenn Sie regionale Endpunkte aufrufen, muss der Standort in Ihrem Anfragepfad oder der übergeordneten Anfrage mit dem Standort des Endpunkts übereinstimmen, den Sie aufrufen. Wenn Sie beispielsweise den Endpunkt geminidataanalytics.us.rep.googleapis.com aufrufen, müssen Sie us in Ihrem Anfragepfad oder in der übergeordneten Anfrage (z. B. /locations/us oder projects/PROJECT_ID/locations/us) angeben.

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

  • Global: geminidataanalytics.googleapis.com
  • Multi-regional: geminidataanalytics.LOCATION.rep.googleapis.com
  • Regional: geminidataanalytics-LOCATION.googleapis.com

Ersetzen Sie den Platzhalter LOCATION durch eine unterstützte einzelne Region oder Multi-Region, z. B. eu, us oder us-east4.

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 die base_url so, dass der von Ihnen ausgewählte regionale Endpunkt verwendet wird. Das folgende Beispiel stammt aus Erste Einstellungen und Authentifizierung konfigurieren:

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 zustandsbehaftetem und zustandslosen 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 beim Initialisieren von API-Clients, 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 multiregionale Umgebung, 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