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 untuk 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 menyediakan kontrol atas lokasi data pelanggan dalam berbagai status:

  • Data dalam penyimpanan saat disimpan dalam penyimpanan persisten, bukan saat sedang diproses atau dikirim 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 yang komprehensif untuk semua status data yang digunakan.
  • Data dalam pengiriman saat data 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 transit.

Lokasi data yang didukung

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

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

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

Data BigQuery

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

Lokasi Deskripsi lokasi Jenis endpoint URL Endpoint Lokasi set data Dukungan residensi data
global Global Global geminidataanalytics.googleapis.com Region tunggal atau multi-region Tidak didukung
eu Uni Eropa Multi-regional geminidataanalytics.eu.rep.googleapis.com Region tunggal atau multi-region Dalam penyimpanan, Sedang digunakan (yurisdiksi)
us Amerika Serikat Multi-regional geminidataanalytics.us.rep.googleapis.com Region tunggal atau multi-region Dalam penyimpanan, Sedang digunakan (yurisdiksi)
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Region tunggal atau multi-region Dalam penyimpanan, 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 mana pun atau kombinasi lokasi:

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

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

Menerapkan residensi data dengan endpoint regional

Untuk menerapkan residensi data bagi resource DataAgent dan Conversation, gunakan endpoint regional saat Anda membuat dan mengaksesnya. Saat Anda memanggil endpoint regional, lokasi di jalur permintaan atau induk permintaan harus cocok dengan lokasi endpoint yang Anda panggil. Misalnya, jika Anda memanggil endpoint geminidataanalytics.us.rep.googleapis.com, Anda harus menentukan us di jalur permintaan atau induk permintaan (seperti /locations/us atau projects/PROJECT_ID/locations/us).

Endpoint layanan untuk Conversational Analytics API menggunakan format berikut, bergantung pada jenis lokasi:

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

Ganti placeholder LOCATION dengan single 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 dari Mengajukan pertanyaan dengan chat stateful dan stateless ini:

# 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 sampel sebagai berikut:

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

Batasan

Saat Anda menggunakan endpoint regional, pertimbangkan hal-hal berikut:

Langkah berikutnya