리전 엔드포인트로 데이터 지역 구성

이 페이지에서는 리전 또는 멀티 리전 엔드포인트를 사용하도록 Cloud Firestore 클라이언트 라이브러리를 구성하는 방법을 설명합니다.

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

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

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

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

리전 또는 멀티 리전 엔드포인트 설정

리전 또는 멀티 리전 엔드포인트를 구성하는 방법은 동일합니다. 클라이언트 라이브러리를 초기화할 때 엔드포인트 문자열을 제공합니다. 다음 예에서는 리전 엔드포인트(firestore.us-central1.rep.googleapis.com)를 사용하여 엔드포인트 문자열을 설정하는 방법을 보여줍니다. 멀티 리전 엔드포인트를 사용하려면 데이터베이스 위치에 해당하는 멀티 리전 엔드포인트 문자열 (예: nam5의 경우 firestore.us.rep.googleapis.com)을 제공하세요.

Java


import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;
import com.google.cloud.firestore.FirestoreOptions;


/**
 * Demonstrate how to set a regional endpoint.
 */
public class RegionalEndpointSnippets {

  /**
   * Create a client with a regional endpoint.
   **/
  public Firestore regionalEndpoint(String projectId, String endpoint) throws Exception {
    FirestoreOptions firestoreOptions =
        FirestoreOptions.newBuilder()
            .setProjectId(projectId)
            .setCredentials(GoogleCredentials.getApplicationDefault())
            // set endpoint like firestore.us-central1.rep.googleapis.com:443
            .setHost(endpoint)
            .build();
    Firestore dbWithEndpoint = firestoreOptions.getService();

    return dbWithEndpoint;
  }

}
RegionalEndpointSnippets.java

Python

ENDPOINT = "firestore.africa-south1.rep.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
db = firestore.Client(client_options=client_options)

cities_query = db.collection("cities").limit(2).get()
for r in cities_query:
    print(r)
snippets.py

리전 및 멀티 리전 엔드포인트의 시맨틱스

리전 엔드포인트 (REP):

Cloud Firestore는 여기에 나열된 리전 위치의 리전 엔드포인트를 지원합니다(Cloud Firestore 위치).

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

자바

  firestore.REGION_NAME.rep.googleapis.com:443

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

Python

  firestore.REGION_NAME.rep.googleapis.com

Go

  firestore.REGION_NAME.rep.googleapis.com:443

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

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

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

  • firestore.us-central1.rep.googleapis.com
  • firestore.europe-west1.rep.googleapis.com

멀티 리전 엔드포인트 (MREP)

멀티 리전 엔드포인트의 경우 위치 nam5 및 nam7에는 us을 사용하고 위치 eur3에는 eu을 사용합니다 (멀티 리전 위치 참고).

Java

  firestore.us.rep.googleapis.com:443
  firestore.eu.rep.googleapis.com:443

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

Python

  firestore.us.rep.googleapis.com
  firestore.eu.rep.googleapis.com

Go

  firestore.us.rep.googleapis.com:443
  firestore.eu.rep.googleapis.com:443

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

제한사항

  • 리전 및 멀티 리전 엔드포인트는 실시간 리스너를 지원하지 않습니다.

위치 엔드포인트 (지원 중단됨)

이제 위치 엔드포인트가 지원 중단됩니다. 대신 리전 또는 멀티 리전 엔드포인트를 사용하세요.

이전에는 Cloud Firestore에서 다음과 같은 형식의 위치 엔드포인트를 지원했습니다.

Java

  REGION_NAME-firestore.googleapis.com:443

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

Python

  REGION_NAME-firestore.googleapis.com

Go

  REGION_NAME-firestore.googleapis.com:443

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

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

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

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

멀티 리전 및 리전 호스트 이름의 전체 목록은 Cloud Firestore 위치를 참고하세요.

전역 API 엔드포인트 사용 제한

리전 및 멀티 리전 엔드포인트 사용을 강제하려면 constraints/gcp.restrictEndpointUsage 조직 정책 제약 조건을 사용하여 전역 API 엔드포인트에 대한 요청을 차단하세요. 자세한 내용은 엔드포인트 사용 제한을 참고하세요.