데이터 상주

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

이 문서에서 위치는 데이터가 있는 Google Cloud 리전 또는 멀티 리전을 의미하며, 사용자 데이터는 서비스별 약관의 데이터 위치 섹션에 나오는 '고객 데이터'와 동일한 의미입니다.

대화형 분석 API의 데이터 레지던시 약정은 에이전트가 BigQuery에 연결되는지 아니면 Looker에 연결되는지에 따라 달라집니다.

데이터 레지던시 범위

Conversational Analytics API는 다양한 상태의 고객 데이터 위치를 제어할 수 있는 기능을 제공하여 데이터 레지던시 요구사항을 충족하도록 지원합니다.

  • 데이터가 적극적으로 처리되거나 전송되지 않고 영구 스토리지에 저장되어 있는 경우 저장 상태입니다.
  • 데이터가 메모리에 있는 경우(예: 머신러닝(ML) 모델이 데이터를 처리하여 대답을 생성하거나 서비스가 쿼리를 실행하는 경우) 데이터가 사용 중인 것입니다. 대화형 애널리틱스 API의 경우 사용 중 데이터의 데이터 레지던시 약정은 관할권 ML 처리에만 적용되며 사용 중 데이터의 모든 상태에 대한 포괄적인 레지던시를 제공하지 않습니다.
  • 데이터가 Google 네트워크 경계로 들어가거나 나갈 때 전송 중인 것으로 간주됩니다.

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

지원되는 데이터 위치

Conversational Analytics 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 모든 리전 또는 멀티 리전 안정 중

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

리전 엔드포인트로 데이터 레지던시 적용

DataAgent 및 Conversation 리소스에 데이터 레지던시를 적용하려면 리소스를 만들고 액세스할 때 리전 엔드포인트를 사용하세요. 리전 엔드포인트를 호출할 때는 요청 경로 또는 요청 상위 요소의 위치가 호출하는 엔드포인트의 위치와 일치해야 합니다. 예를 들어 geminidataanalytics.us.rep.googleapis.com 엔드포인트를 호출하는 경우 요청 경로 또는 요청 상위 요소 (예: /locations/us 또는 projects/PROJECT_ID/locations/us)에 us을 지정해야 합니다.

대화형 분석 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"

그런 다음 상태 저장 및 상태 비저장 채팅으로 질문하기의 예와 같이 API 요청의 URL을 구성할 때 base_url 변수를 사용합니다.

# 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: Google Cloud 프로젝트 ID입니다.
  • LOCATION: 리소스를 만들 리전 또는 멀티 리전입니다. 리전 엔드포인트 중 하나를 사용하려면 eu, us 또는 us-east4를 지정하세요.

제한사항

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

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

다음 단계