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 menentukan 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 di berbagai status:

  • Data berada dalam penyimpanan saat disimpan di penyimpanan persisten, bukan saat 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 sedang digunakan bersifat spesifik untuk pemrosesan ML sesuai wilayah hukum dan tidak memberikan residensi yang komprehensif untuk semua status data yang sedang digunakan.
  • Data berada dalam pengiriman saat memasuki 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) berdasarkan wilayah hukum (diidentifikasi sebagai Sedang digunakan (berdasarkan wilayah hukum)) mengacu pada komitmen pemrosesan ML untuk data Anda. Seperti yang didefinisikan 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 dalam penyimpanan dan pemrosesan ML sesuai wilayah hukum untuk data yang sedang 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 Dalam penyimpanan, Sedang digunakan (wilayah hukum)
us Amerika Serikat Multi-regional geminidataanalytics.us.rep.googleapis.com Region atau multi-region mana pun Dalam penyimpanan, Sedang digunakan (wilayah hukum)
northamerica-northeast1 Montréal Regional geminidataanalytics-northamerica-northeast1.googleapis.com Region atau multi-region mana pun Dalam penyimpanan, Sedang digunakan (wilayah hukum)
northamerica-northeast2 Toronto Regional geminidataanalytics-northamerica-northeast2.googleapis.com Region atau multi-region mana pun Dalam penyimpanan, Sedang digunakan (wilayah hukum)
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Region atau multi-region mana pun Dalam penyimpanan, Sedang digunakan (wilayah hukum)

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 Dalam penyimpanan
us Amerika Serikat Multi-regional geminidataanalytics.us.rep.googleapis.com Region atau multi-region mana pun Dalam penyimpanan
us-east4 Northern Virginia Regional geminidataanalytics-us-east4.googleapis.com Region atau multi-region mana pun Dalam penyimpanan

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 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 Anda 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
  • Multi-regional: geminidataanalytics.LOCATION.rep.googleapis.com
  • Regional: geminidataanalytics-LOCATION.googleapis.com

Ganti placeholder LOCATION dengan wilayah yang didukung atau multi-region untuk sumber data Anda. Untuk mengetahui detailnya, lihat Lokasi data yang didukung.

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, konfigurasikan 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 melakukan inisialisasi klien API, seperti yang ditunjukkan dalam contoh berikut dari Mengonfigurasi setelan dan melakukan inisialisasi 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 Google Cloud Anda.
  • LOCATION: Region atau multi-region tempat Anda ingin membuat resource. Untuk lokasi yang didukung oleh setiap sumber data, lihat Lokasi data yang didukung.

Batasan

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

Langkah berikutnya