Residência dos dados

Esta página explica como a API Conversational Analytics oferece suporte à residência de dados. Residência de dados se refere ao local físico dos dados e aos compromissos de armazenar e processar os dados em uma área geográfica específica para atender aos requisitos regulamentares ou de políticas. Para controlar o local dos dados, especifique um endpoint de serviço regional para as solicitações de API.

Neste documento, local se refere a uma Google Cloud região ou multirregião em que os dados residem, e seus dados têm o mesmo significado de "Dados do cliente" na seção Localização de dados dos Termos do serviço específico.

Os compromissos de residência de dados para a API Conversational Analytics variam de acordo com a conexão do agente ao BigQuery ou ao Looker.

Escopo da residência de dados

A API Conversational Analytics ajuda você a atender aos requisitos de residência de dados, fornecendo controles sobre o local dos dados do cliente em diferentes estados:

  • Os dados estão em repouso quando são armazenados em um armazenamento persistente, em vez de serem processados ou transmitidos ativamente.
  • Os dados estão em uso quando estão na memória, como quando modelos de machine learning (ML) processam dados para gerar uma resposta ou quando o serviço executa uma consulta. Para a API Conversational Analytics, os compromissos de residência de dados em uso são específicos para o processamento de ML jurisdicional e não oferecem residência abrangente para todos os estados de dados em uso.
  • Os dados estão em trânsito quando entram ou saem do perímetro da rede do Google.

Os compromissos de residência de dados para a API Conversational Analytics se aplicam a recursos DataAgent (incluindo configurações do cliente, contexto, instruções do sistema e consultas de exemplo) e recursos Conversation (incluindo conteúdo de mensagens e histórico de estados). Esses compromissos não se aplicam a dados de serviço, como identificadores e rótulos de recursos, ou a dados em trânsito.

Locais de dados com suporte

A API Conversational Analytics oferece suporte a locais globais, regionais e multirregionais. Ao usar um endpoint regional ou multirregional, você controla o local em que os dados são armazenados em repouso.

Nas tabelas a seguir, o processamento de machine learning (ML) jurisdicional (identificado como Em uso (jurisdicional)) se refere aos compromissos de processamento de ML para seus dados. Conforme definido nos Termos do serviço específico, o Google realiza o processamento de machine learning dos seus dados apenas na região ou multirregião selecionada.

As seções a seguir fornecem detalhes sobre o suporte à residência de dados para agentes e conversas que usam BigQuery e Looker fontes de dados.

Dados do BigQuery

Para agentes de dados que se conectam ao BigQuery, os endpoints regionais e multirregionais oferecem suporte à residência de dados em repouso e ao processamento de ML jurisdicional para dados em uso. Independente do local do endpoint especificado, o agente pode se conectar a conjuntos de dados do BigQuery em qualquer local ou combinação de locais:

Local Descrição do local Tipo de endpoint URL do endpoint Local do conjunto de dados Suporte à residência de dados
global Global Global geminidataanalytics.googleapis.com Qualquer região ou multirregião Sem suporte
eu União Europeia Multirregional geminidataanalytics.eu.rep.googleapis.com Qualquer região ou multirregião Em repouso, Em uso (jurisdicional)
us Estados Unidos Multirregional geminidataanalytics.us.rep.googleapis.com Qualquer região ou multirregião Em repouso, Em uso (jurisdicional)
us-east4 Norte da Virgínia Regional geminidataanalytics-us-east4.googleapis.com Qualquer região ou multirregião Em repouso, Em uso (jurisdicional)

Dados do Looker

Para agentes de dados que se conectam ao Looker, os endpoints regionais e multirregionais oferecem suporte à residência de dados em repouso. Independente do local do endpoint especificado, o agente pode se conectar a fontes de dados em qualquer local ou combinação de locais:

Local Descrição do local Tipo de endpoint URL do endpoint Local do conjunto de dados Suporte à residência de dados
global Global Global geminidataanalytics.googleapis.com Qualquer região ou multirregião Sem suporte
eu União Europeia Multirregional geminidataanalytics.eu.rep.googleapis.com Qualquer região ou multirregião Em repouso
us Estados Unidos Multirregional geminidataanalytics.us.rep.googleapis.com Qualquer região ou multirregião Em repouso
us-east4 Norte da Virgínia Regional geminidataanalytics-us-east4.googleapis.com Qualquer região ou multirregião Em repouso

Para conferir a lista completa de endpoints regionais e multirregionais disponíveis, consulte Locais da API Conversational Analytics.

Aplicar a residência de dados com endpoints regionais

Para aplicar a residência de dados aos recursos DataAgent e Conversation, use um endpoint regional ao criá-los e acessá-los. Os endpoints de serviço da API Conversational Analytics usam os seguintes formatos, dependendo do tipo de local:

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

Substitua o marcador de posição LOCATION por uma região única ou multirregião com suporte, como eu, us ou us-east4.

Os exemplos a seguir mostram como configurar um endpoint regional para solicitações de HTTP e SDK do Python:

HTTP

Para usar um endpoint regional com HTTP, crie o URL da solicitação com o URL base regional. Primeiro, configure o base_url para usar o endpoint regional escolhido, conforme mostrado no exemplo a seguir em Configurar as configurações iniciais e a autenticação:

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"

Em seguida, use a variável base_url ao criar URLs para solicitações de API, como neste exemplo de Fazer perguntas com chat com estado e sem estado:

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

SDK do Python

Para usar um endpoint regional com o SDK do Python, transmita client_options com o parâmetro api_endpoint regional ao inicializar clientes de API, conforme mostrado no exemplo a seguir em Configurar as configurações e inicializar clientes.

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)

Substitua os valores de exemplo da seguinte forma:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: a região ou multirregião em que você quer criar seus recursos. Para usar um dos endpoints regionais, especifique eu, us ou us-east4.

Limitações

Ao usar endpoints regionais, considere os seguintes pontos:

A seguir