데이터 상주

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

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

대화형 애널리틱스 API의 데이터 레지던시 약정은 에이전트가 BigQuery에 연결되는지 아니면 Looker에 연결되는지에 따라 다릅니다.

데이터 레지던시 범위

Conversational Analytics API는 다양한 상태의 고객 데이터 위치를 제어하여 데이터 레지던시 요구사항을 충족하도록 도와줍니다.

  • 데이터가 활발하게 처리되거나 전송되지 않고 영구 스토리지에 저장되어 있는 경우 저장됩니다.
  • 데이터는 메모리에 있을 때 사용 중입니다. 예를 들어 머신러닝 (ML) 모델이 데이터를 처리하여 응답을 생성하거나 서비스가 쿼리를 실행할 때입니다. Conversational Analytics 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 모든 리전 또는 멀티 리전 저장, 사용 중 (관할권)
northamerica-northeast1 몬트리올 리전 geminidataanalytics-northamerica-northeast1.googleapis.com 모든 리전 또는 멀티 리전 저장, 사용 중 (관할권)
northamerica-northeast2 토론토 리전 geminidataanalytics-northamerica-northeast2.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를 지정해야 합니다.

Conversational Analytics API의 서비스 엔드포인트는 위치 유형에 따라 다음 형식을 사용합니다.

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

LOCATION 자리표시자를 데이터 소스에 지원되는 리전 또는 멀티 리전으로 바꿉니다. 자세한 내용은 지원되는 데이터 위치를 참고하세요.

다음 예시에서는 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"

그런 다음 스테이트풀(Stateful) 및 스테이트리스(Stateless) 채팅으로 질문하기의 이 예시와 같이 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: 리소스를 만들려는 리전 또는 멀티 리전입니다. 각 데이터 소스에서 지원하는 위치는 지원되는 데이터 위치를 참조하세요.

제한사항

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

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

다음 단계