위치 엔드포인트로 데이터 지역 구성

이 페이지에서는 위치 엔드포인트를 사용하도록 Datastore 모드의 Firestore 클라이언트 라이브러리를 구성하는 방법을 설명합니다.

Firestore in Datastore 모드 클라이언트 라이브러리를 사용하는 경우 다음 엔드포인트 중 하나를 사용할 수 있습니다.

  • 전역 엔드포인트: 기본적으로 Firestore in Datastore 모드 클라이언트 라이브러리는 datastore.googleapis.com이라는 전역 서비스 엔드포인트에 API 요청을 전송합니다. 전역 서비스 엔드포인트는 요청을 데이터베이스로 라우팅합니다. 라우팅 중에는 요청이 데이터베이스 위치와 다른 위치의 위치별 서비스 엔드포인트를 통과할 수 있습니다.

  • 위치 엔드포인트: 위치 엔드포인트는 데이터가 특정 리전에 저장 및 처리되도록 리전 제한을 적용합니다. 서비스 엔드포인트가 데이터베이스와 동일한 리전에서 앱의 Firestore in Datastore 모드 요청을 처리하도록 보장하려면 클라이언트 라이브러리에서 위치 엔드포인트를 지정합니다.

위치 엔드포인트 설정

다음 예시에서는 Firestore in Datastore 모드 클라이언트를 초기화할 때 위치 엔드포인트를 설정하는 방법을 보여줍니다.

Java

Datastore 모드용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Datastore 모드 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Datastore 모드 Java API 참고 문서를 확인하세요.

Datastore 모드에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요. 


import com.google.cloud.datastore.Datastore;
import com.google.cloud.datastore.DatastoreOptions;

public class RegionalEndpoint {

  public Datastore createClient() throws Exception {
    // Instantiates a client
    DatastoreOptions options =
        DatastoreOptions.newBuilder().setHost("https://nam5-datastore.googleapis.com").build();
    Datastore datastore = options.getService();
    return datastore;
  }
}

Python

Datastore 모드용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Datastore 모드 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Datastore 모드 Python API 참고 문서를 확인하세요.

Datastore 모드에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요. 

ENDPOINT = "https://eur3-datastore.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
client = datastore.Client(client_options=client_options)

query = client.query(kind="Task")
results = list(query.fetch())
for r in results:
    print(r)

위치 엔드포인트의 시맨틱스

Datastore 모드의 Firestore는 리전 및 멀티 리전 위치 모두에 대해 위치 엔드포인트를 지원합니다.

위치 엔드포인트를 정의하려면 다음 형식을 사용합니다.

자바

  https://REGION_NAME-firestore.googleapis.com:443

전체 https URL이 사용되고 포트 번호가 엔드포인트와 함께 정의되었는지 확인합니다.

Python

  https://REGION_NAME-firestore.googleapis.com

전체 https URL이 위치 엔드포인트로 설정되었는지 확인합니다.

Go

  REGION_NAME-firestore.googleapis.com:443

포트 번호가 엔드포인트와 함께 정의되었는지 확인합니다.

REGION_NAME을 리전 이름 또는 멀티 리전 호스트 이름으로 바꿉니다.

일부 호스트 이름 예시는 다음과 같습니다.

  • eur3-datastore.googleapis.com
  • nam5-datastore.googleapis.com
  • europe-west6-datastore.googleapis.com
  • asia-northeast2-datastore.googleapis.com

멀티 리전 및 리전 호스트 이름의 전체 목록은 Firestore in Datastore 모드 위치를 참조하세요.

다음 단계