데이터 상주

이 페이지에서는 대화형 분석 API가 데이터 상주를 지원하는 방법을 설명합니다. 데이터 상주 는 데이터의 물리적 위치와 규제 또는 정책 요구사항을 충족하기 위해 특정 지리적 영역 내에 데이터를 저장하고 처리하는 약정을 의미합니다. 데이터의 위치를 제어하려면 API 요청에 리전 서비스 엔드포인트를 지정합니다.

이 문서에서 위치는 데이터가 상주하는 Google Cloud 리전 또는 멀티 리전을 의미하며 사용자 데이터는 서비스별 약관의 데이터 위치 섹션에 있는 "고객 데이터"와 동일한 의미를 갖습니다.

대화형 분석 API의 데이터 상주 약정은 에이전트가 BigQuery에 연결하는지 아니면 Looker에 연결하는지에 따라 다릅니다.

데이터 상주 범위

대화형 분석 API는 다양한 상태의 고객 데이터 위치를 제어하여 데이터 상주 요구사항을 충족하도록 지원합니다.

  • 데이터는 활발하게 처리되거나 전송되지 않고 영구 스토리지에 저장될 때 안정 중 입니다.
  • 데이터는 머신러닝 (ML) 모델이 데이터를 처리하여 응답을 생성하거나 서비스가 쿼리를 실행하는 경우와 같이 메모리에 있을 때 사용 중 입니다. 대화형 분석 API의 경우 사용 중인 데이터의 데이터 상주 약정은 관할권 ML 처리에만 적용되며 사용 중인 데이터의 모든 상태에 대한 포괄적인 상주를 제공하지 않습니다.
  • 데이터는 Google 네트워크 경계에 들어가거나 나갈 때 전송 중 입니다.

대화형 분석 API의 데이터 상주 약정은 DataAgent 리소스 (고객 구성, 컨텍스트, 시스템 안내, 예시 쿼리 포함) 및 Conversation 리소스 (메시지 콘텐츠 및 상태 기록 포함)에 적용됩니다. 이러한 약정은 리소스 식별자 및 라벨과 같은 서비스 데이터 또는 전송 중인 데이터에는 적용되지 않습니다.

지원되는 데이터 위치

대화형 분석 API는 전역, 리전, 멀티 리전 위치를 지원합니다. 리전 또는 멀티 리전 엔드포인트를 사용하면 안정 중인 데이터가 저장되는 위치를 제어할 수 있습니다.

다음 표에서 관할권 머신러닝 (ML) 처리 (사용 중 (관할권) 으로 식별됨)는 데이터에 대한 ML 처리 약정을 나타냅니다. 서비스별 약관에 정의된 대로 Google은 선택한 리전 또는 멀티 리전에서만 데이터의 머신러닝 처리를 실행합니다.

다음 섹션에서는 BigQuery 및 Looker 데이터 소스를 사용하는 에이전트 및 대화의 데이터 상주 지원에 관한 세부정보를 제공합니다.

BigQuery 데이터

BigQuery에 연결하는 데이터 에이전트의 경우 리전 및 멀티 리전 엔드포인트는 안정 중인 데이터의 데이터 상주와 사용 중인 데이터의 관할권 ML 처리를 지원합니다. 지정한 엔드포인트 위치와 관계없이 에이전트는 모든 위치 또는 위치 조합의 BigQuery 데이터 세트에 연결할 수 있습니다.

위치 위치 설명 엔드포인트 유형 엔드포인트 URL 데이터 세트 위치 데이터 상주 지원
global 전역 전역 geminidataanalytics.googleapis.com 모든 리전 또는 멀티 리전 지원되지 않음
eu 유럽 연합 멀티 리전 geminidataanalytics.eu.rep.googleapis.com 모든 리전 또는 멀티 리전 안정 중, 사용 중 (관할권)
us 미국 멀티 리전 geminidataanalytics.us.rep.googleapis.com 모든 리전 또는 멀티 리전 안정 중, 사용 중 (관할권)
us-east4 북버지니아 리전 geminidataanalytics-us-east4.googleapis.com 모든 리전 또는 멀티 리전 안정 중, 사용 중 (관할권)

Looker 데이터

Looker에 연결하는 데이터 에이전트의 경우 리전 및 멀티 리전 엔드포인트는 안정 중인 데이터의 데이터 상주를 지원합니다. 지정한 엔드포인트 위치와 관계없이 에이전트는 모든 위치 또는 위치 조합의 데이터 소스에 연결할 수 있습니다.

위치 위치 설명 엔드포인트 유형 엔드포인트 URL 데이터 세트 위치 데이터 상주 지원
global 전역 전역 geminidataanalytics.googleapis.com 모든 리전 또는 멀티 리전 지원되지 않음
eu 유럽 연합 멀티 리전 geminidataanalytics.eu.rep.googleapis.com 모든 리전 또는 멀티 리전 안정 중, 사용 중 (관할권)
us 미국 멀티 리전 geminidataanalytics.us.rep.googleapis.com 모든 리전 또는 멀티 리전 안정 중
us-east4 북버지니아 리전 geminidataanalytics-us-east4.googleapis.com 모든 리전 또는 멀티 리전 안정 중

사용 가능한 리전 및 멀티 리전 엔드포인트의 전체 목록은 대화형 분석 API 위치를 참고하세요.

리전 엔드포인트로 데이터 상주 적용

DataAgent 및 Conversation 리소스의 데이터 상주를 적용하려면 리소스를 만들고 액세스할 때 리전 엔드포인트를 사용하세요. 대화형 분석 API의 서비스 엔드포인트는 위치 유형에 따라 다음 형식을 사용합니다.

  • 전역: geminidataanalytics.googleapis.com
  • 멀티 리전: geminidataanalytics.LOCATION.rep.googleapis.com
  • 리전: geminidataanalytics-LOCATION.googleapis.com

LOCATION 자리표시자를 지원되는 단일 리전 또는 멀티 리전(예: eu, us, us-east4)으로 바꿉니다.

다음 예에서는 HTTP 및 Python SDK 요청의 리전 엔드포인트를 구성하는 방법을 보여줍니다.

HTTP

HTTP에서 리전 엔드포인트를 사용하려면 리전 기본 URL로 요청 URL을 구성합니다. 먼저 초기 설정 및 인증 구성 구성의 다음 예와 같이 선택한 리전 엔드포인트를 사용하도록 base_url을 구성합니다.

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"

그런 다음 base_url 변수를 사용하여 API 요청의 URL을 구성합니다. 예를 들어 스테이트풀(Stateful) 및 스테이트리스(Stateless) 채팅으로 질문하기의 예가 있습니다.

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

Python SDK

Python SDK에서 리전 엔드포인트를 사용하려면 API 클라이언트를 초기화할 때 리전 api_endpoint 매개변수와 함께 client_options를 전달합니다. 자세한 내용은 설정 구성 및 클라이언트 초기화의 다음 예시를 참고하세요.

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)

샘플 값을 다음과 같이 바꿉니다.

  • PROJECT_ID: 프로젝트 ID입니다. Google Cloud
  • LOCATION: 리소스를 만들려는 리전 또는 멀티 리전입니다. 리전 엔드포인트 중 하나를 사용하려면 eu, us, us-east4를 지정합니다.

제한사항

리전 엔드포인트를 사용할 때는 다음 사항을 고려하세요.

  • 대화형 분석 API와 함께 고객 관리 암호화 키 (CMEK)를 사용하는 경우 Cloud KMS 키는 리전 엔드포인트와 동일한 위치에 있어야 합니다.

다음 단계