Residensi data

Halaman ini menjelaskan cara Conversational Analytics API mendukung residensi data. Residensi data mengacu pada lokasi fisik data Anda dan komitmen untuk menyimpan dan memproses data Anda dalam area geografis tertentu guna memenuhi persyaratan peraturan atau kebijakan. Untuk mengontrol lokasi data Anda, tentukan endpoint layanan regional untuk permintaan API Anda.

Dalam dokumen ini, lokasi mengacu pada Google Cloud region atau multi-region tempat data berada, dan data Anda memiliki arti yang sama dengan "Data Pelanggan" di bagian Lokasi Data dalam Persyaratan Khusus Layanan.

Komitmen residensi data untuk Conversational Analytics API bervariasi berdasarkan apakah agen Anda terhubung ke BigQuery atau ke Looker.

Cakupan residensi data

Conversational Analytics API membantu Anda memenuhi persyaratan residensi data dengan memberikan kontrol atas lokasi data pelanggan dalam berbagai status:

  • Data saat istirahat saat disimpan dalam penyimpanan persisten, bukan saat diproses atau ditransmisikan secara aktif.
  • Data sedang digunakan saat berada dalam memori, seperti saat model machine learning (ML) memproses data untuk menghasilkan respons atau saat layanan menjalankan kueri. Untuk Conversational Analytics API, komitmen residensi data untuk data yang digunakan khusus untuk pemrosesan ML yurisdiksi dan tidak memberikan residensi komprehensif untuk semua status data yang digunakan.
  • Data dalam pengiriman saat masuk atau keluar dari perimeter jaringan Google.

Komitmen residensi data untuk Conversational Analytics API berlaku untuk resource DataAgent (termasuk konfigurasi pelanggan, konteks, petunjuk sistem, dan contoh kueri) dan resource Conversation (termasuk konten pesan dan histori status). Komitmen ini tidak berlaku untuk data layanan, seperti ID dan label resource, atau untuk data dalam pengiriman.

Lokasi data yang didukung

Conversational Analytics API mendukung lokasi global, regional, dan multi-regional. Saat menggunakan endpoint regional atau multi-regional, Anda mengontrol lokasi tempat data Anda disimpan dalam penyimpanan.

Dalam tabel berikut, pemrosesan machine learning (ML) yurisdiksi (diidentifikasi sebagai Sedang digunakan (yurisdiksi)) mengacu pada komitmen pemrosesan ML untuk data Anda. Sebagaimana ditentukan dalam Persyaratan Khusus Layanan, Google hanya melakukan pemrosesan machine learning atas data Anda di region atau multi-region yang Anda pilih.

Bagian berikut memberikan detail tentang dukungan residensi data untuk agen dan percakapan yang menggunakan BigQuery dan Looker sumber data.

Data BigQuery

Untuk agen data yang terhubung ke BigQuery, endpoint regional dan multi-regional mendukung residensi data untuk data dalam penyimpanan dan pemrosesan ML yurisdiksi untuk data yang digunakan. Terlepas dari lokasi endpoint yang Anda tentukan, agen dapat terhubung ke set data BigQuery di lokasi atau kombinasi lokasi mana pun:

Lokasi Deskripsi lokasi Jenis endpoint URL Endpoint Lokasi set data Dukungan residensi data
global Global Global geminidataanalytics.googleapis.com Region atau multi-region mana pun Tidak didukung
eu Uni Eropa Multi-regional geminidataanalytics.eu.rep.googleapis.com Region atau multi-region mana pun Saat istirahat, Sedang digunakan (yurisdiksi)
us Amerika Serikat Multi-regional geminidataanalytics.us.rep.googleapis.com Region atau multi-region mana pun Saat istirahat, Sedang digunakan (yurisdiksi)
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Region atau multi-region mana pun Saat istirahat, Sedang digunakan (yurisdiksi)

Data Looker

Untuk agen data yang terhubung ke Looker, endpoint regional dan multi-regional mendukung residensi data untuk data dalam penyimpanan. Terlepas dari lokasi endpoint yang Anda tentukan, agen dapat terhubung ke sumber data di lokasi atau kombinasi lokasi mana pun:

Lokasi Deskripsi lokasi Jenis endpoint URL Endpoint Lokasi set data Dukungan residensi data
global Global Global geminidataanalytics.googleapis.com Region atau multi-region mana pun Tidak didukung
eu Uni Eropa Multi-regional geminidataanalytics.eu.rep.googleapis.com Region atau multi-region mana pun Saat istirahat, Sedang digunakan (yurisdiksi)
us Amerika Serikat Multi-regional geminidataanalytics.us.rep.googleapis.com Region atau multi-region mana pun Saat istirahat
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Region atau multi-region mana pun Saat istirahat

Untuk mengetahui daftar lengkap endpoint regional dan multi-regional yang tersedia, lihat Lokasi Conversational Analytics API.

Menerapkan residensi data dengan endpoint regional

Untuk menerapkan residensi data untuk resource DataAgent dan Conversation, gunakan endpoint regional saat Anda membuat dan mengaksesnya. Endpoint layanan untuk Conversational Analytics API menggunakan format berikut, bergantung pada jenis lokasi:

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

Ganti placeholder LOCATION dengan satu region atau multi-region yang didukung, seperti eu, us, atau us-east4.

Contoh berikut menunjukkan cara mengonfigurasi endpoint regional untuk permintaan HTTP dan Python SDK:

HTTP

Untuk menggunakan endpoint regional dengan HTTP, buat URL permintaan dengan URL dasar regional. Pertama, konfigurasi base_url untuk menggunakan endpoint regional yang Anda pilih, seperti yang ditunjukkan dalam contoh berikut dari Mengonfigurasi setelan awal dan autentikasi:

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"

Kemudian, gunakan variabel base_url saat membuat URL untuk permintaan API, seperti dalam contoh ini dari Mengajukan pertanyaan dengan chat stateful dan stateless:

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

Python SDK

Untuk menggunakan endpoint regional dengan Python SDK, teruskan client_options dengan parameter api_endpoint regional saat menginisialisasi klien API, seperti yang ditunjukkan dalam contoh berikut dari Mengonfigurasi setelan dan menginisialisasi klien.

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)

Ganti nilai contoh sebagai berikut:

  • PROJECT_ID: Project ID Anda Google Cloud .
  • LOCATION: Region atau multi-region tempat Anda ingin membuat resource. Untuk menggunakan salah satu endpoint regional, tentukan eu, us, atau us-east4.

Batasan

Saat menggunakan endpoint regional, pertimbangkan hal-hal berikut:

Langkah berikutnya