이 페이지에서는 Spanner 전역 및 리전 서비스 엔드포인트와 이를 사용하는 방법을 설명합니다.
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. Spanner에서는 전역 및 리전 엔드포인트 모두가 사용됩니다. 전역 또는 리전 서비스 엔드포인트를 사용하여 Spanner에 요청을 보낼 수 있습니다.
엄격한 리전 제한 요구사항이 없는 경우 전역 엔드포인트를 사용합니다. 데이터가 선택한 리전 내에 저장되지만 리전 외부에서 데이터가 처리될 수 있습니다. Spanner의 전역 엔드포인트는 spanner.googleapis.com
입니다. 기본 API 엔드포인트가 전역 엔드포인트에 액세스합니다.
리전 엔드포인트는 리전 제한을 적용합니다. 데이터는 동일한 리전 내에서 저장되고 처리됩니다. Spanner의 리전 엔드포인트는 저장 및 처리된 데이터가 데이터베이스가 있는 Spanner 리전 인스턴스 구성으로 제한되도록 보장합니다. 규제 요건을 준수하기 위해 데이터 위치를 제한하고 제어해야 하는 경우에는 리전 엔드포인트를 사용합니다. 리전 엔드포인트를 사용하여 다른 인스턴스 구성에 속하는 리소스에 액세스할 수 없습니다. 인스턴스 구성에 리전 엔드포인트를 사용하려면 먼저 리전 인스턴스 구성에서 인스턴스를 만들어야 합니다.
Spanner 리전 엔드포인트는 담맘 me-central2
리전 인스턴스 구성에서만 사용할 수 있습니다. 기본 Spanner 스토리지 정책은 사용되는 엔드포인트에 관계없이 변경되지 않습니다.
리전 엔드포인트의 보안 및 규정 준수
전역 엔드포인트 대신 Spanner 리전 엔드포인트를 사용할 경우 얻을 수 있는 이점은 리전 격리 및 보호 기능을 제공하여 리전 엔드포인트가 보안, 규정 준수, 규제 요건을 충족시킬 수 있다는 것입니다.
해당 리전 인스턴스 구성에 속하는 리전 엔드포인트만 사용할 수 있습니다. 예를 들어 액세스하려는 인스턴스가 us-central1
리전 인스턴스 구성에 속하는 경우 spanner.me-central2.rep.googleapis.com
을 사용하여 요청을 처리할 수 없습니다.
InvalidRegionalRequest
오류와 함께 요청이 거부됩니다.
리전 엔드포인트 제한사항
리전 엔드포인트가 있는 멀티 리전 인스턴스 구성에 액세스할 수 없습니다.
멀티 리전 인스턴스 구성에 액세스하려면 전역 엔드포인트를 사용해야 합니다. 예를 들어 멀티 리전 인스턴스 구성 nam7
에 인스턴스가 있으면 리전 엔드포인트 spanner.us-central1.rep.googleapis.com
을 사용하여 nam7
의 인스턴스에 요청을 전송할 수 없습니다.
인스턴스 리소스에 리전 엔드포인트를 사용하는 활성 요청이 있는 경우 리전 시행에서 리전 간 인스턴스 액세스를 차단하므로 인스턴스를 이동하면 리전 엔드포인트를 사용하는 모든 요청에 영향을 미칩니다. 전역 엔드포인트를 사용하는 요청은 영향을 받지 않습니다.
리전 엔드포인트 이름 지정 규칙
Spanner 리전 엔드포인트 이름은 리전 인스턴스 구성 이름과 동일한 이름 지정 규칙을 따릅니다. 리전 엔드포인트는 spanner.<REGION>.rep.googleapis.com
형식을 따릅니다. 예를 들어 담맘의 리전 인스턴스 구성 이름과 리전 엔드포인트 이름이 모두 me-central2
인 경우 리전 엔드포인트는 spanner.me-central2.rep.googleapis.com
입니다.
me-central2
만 가능한 리전 엔드포인트로 사용할 수 있습니다.
리전 엔드포인트 지정
Google Cloud CLI, REST 또는 RPC API 요청을 사용하여 Spanner 리전 엔드포인트를 지정할 수 있습니다.
gcloud
리전 엔드포인트를 지정하고 전역 엔드포인트를 재정의하려면 다음 명령어를 실행합니다.
gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/
다음 값을 제공합니다.
REGION
- 리전 엔드포인트를 설정할 리전입니다. 예를 들면
me-central2
입니다.
예를 들어 리전 엔드포인트를 me-central2
로 구성하려면 다음 명령어를 실행합니다.
gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/
리전 엔드포인트를 전역 엔드포인트로 다시 구성하려면 다음을 실행합니다.
gcloud config unset api_endpoint_overrides/spanner
REST API
기본 API 엔드포인트가 전역 엔드포인트에 액세스합니다. 리전 엔드포인트를 사용하려면 다음 패턴을 사용하여 엔드포인트를 리전 엔드포인트 주소로 구성합니다.
https://spanner.REGION.rep.googleapis.com
예를 들어 리전 인스턴스 구성 담맘(me-central2
)에서 데이터 보장을 적용하려면 다음을 사용합니다.
https://spanner.me-central2.rep.googleapis.com
자세한 내용은 REST API를 참조하세요.
RPC API
기본 API 엔드포인트가 전역 엔드포인트에 액세스합니다. 리전 엔드포인트를 사용하려면 다음 패턴을 사용하여 엔드포인트를 리전 엔드포인트 주소로 구성합니다.
spanner.REGION.rep.googleapis.com
예를 들어 리전 인스턴스 구성 담맘(me-central2
)에서 데이터 보장을 적용하려면 다음을 사용합니다.
spanner.me-central2.rep.googleapis.com
자세한 내용은 RPC API를 참조하세요.
다음 단계
Spanner 인스턴스 구성 자세히 알아보기
Spanner REST API와 전역 및 리전 엔드포인트 자세히 알아보기
Spanner RPC API와 전역 및 리전 엔드포인트 자세히 알아보기