Endpoints de serviço globais e regionais

Esta página descreve os endpoints de serviço globais e regionais do Spanner e como usá-los.

Um endpoint de serviço é um URL de base que especifica o endereço de rede de um serviço de API. O Spanner tem endpoints globais e regionais. É possível usar um serviço global ou regional para fazer solicitações ao Spanner.

Use o endpoint global se você não tiver requisitos de restrição regionais estritas. Os dados ficam armazenados na região selecionada, eles podem ser processados fora da região. O endpoint global do Spanner é spanner.googleapis.com. O endpoint padrão da API acessa o endpoint global.

Um endpoint regional aplica restrições regionais. Os dados são armazenados e processados na mesma região. Endpoints regionais para o Spanner garantirá que os dados armazenados e processados sejam restritos ao Configuração da instância regional do Spanner onde o banco de dados reside. Use endpoints regionais se o local dos dados precisar ser restritas e controladas para cumprir requisitos regulatórios. Não é possível usar um endpoint regional para acessar recursos pertencentes a uma configuração de instância diferente. Primeiro, é necessário criar uma instância no servidor configuração da instância antes de usar o endpoint regional para essa configuração da instância.

Um endpoint regional do Spanner está disponível apenas na configuração de instância regional me-central2 de Dammam. As políticas de armazenamento subjacentes do Spanner não mudam, independentemente do endpoint usado.

Segurança e compliance para endpoints regionais

A vantagem de usar um endpoint regional do Spanner em vez de um endpoint global é que o endpoint regional oferece isolamento e proteção regionais para atender aos requisitos regulamentares, de segurança e de conformidade.

Só é possível usar endpoints regionais que pertençam a essa instância regional configuração do Terraform. Por exemplo, não é possível usar spanner.me-central2.rep.googleapis.com para exibir solicitações se a instância que você está acessando pertence à configuração de instância regional us-central1. A solicitação vai ser rejeitada com um erro InvalidRegionalRequest.

Limitações dos endpoints regionais

Não é possível acessar uma configuração de instância birregional ou multirregional com um em um endpoint regional. É necessário usar o endpoint global para acessar as configurações de instâncias de duas ou mais regiões. Por exemplo, se você tiver uma instância na configuração de instância multirregional nam7, não será possível usar o endpoint regional spanner.us-central1.rep.googleapis.com para enviar solicitações para a instância em nam7.

Se você tiver solicitações ativas que usam endpoints regionais em qualquer um os recursos da instância, movendo-a afeta todas as solicitações que usam o endpoint regional porque a aplicação regional bloqueia o acesso a instâncias entre regiões. As solicitações que usam um endpoint global sem ser afetada.

Convenção de nomenclatura de endpoint regional

Os nomes dos endpoints regionais do Spanner seguem a mesma convenção de nomenclatura que os nomes de configuração das instâncias regionais. O endpoint regional segue a no formato spanner.<REGION>.rep.googleapis.com. Por exemplo, o nome da configuração da instância regional e o nome do endpoint regional para Dammam são me-central2. Portanto, o endpoint regional é spanner.me-central2.rep.googleapis.com.

Somente me-central2 está disponível como um possível endpoint regional.

Especificar um endpoint regional

É possível especificar um endpoint regional do Spanner usando o Solicitações da Google Cloud CLI, REST ou API RPC.

gcloud

Para especificar um endpoint regional e substituir o endpoint global, execute o seguinte comando:

gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/

Forneça o seguinte valor:

REGION
A região em que um endpoint regional será definido. Por exemplo, me-central2.

Por exemplo, para configurar o endpoint regional como me-central2, execute o seguinte comando:

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/

Para reconfigurar um endpoint regional para o endpoint global, execute:

gcloud config unset api_endpoint_overrides/spanner

API REST

O endpoint padrão da API acessa o endpoint global. Para usar um endpoint regional, configure o endpoint para o endereço do endpoint regional usando o seguinte padrão:

https://spanner.REGION.rep.googleapis.com

Por exemplo, se você quiser aplicar garantias de dados na instância regional configuração Dammam (me-central2), use:

  https://spanner.me-central2.rep.googleapis.com

Consulte a API REST para mais informações.

API RPC

O endpoint padrão da API acessa o endpoint global. Para usar um endpoint regional, configure o endpoint para o endereço do endpoint regional usando o seguinte padrão:

spanner.REGION.rep.googleapis.com

Por exemplo, se você quiser aplicar garantias de dados na instância regional configuração Dammam (me-central2), use:

spanner.me-central2.rep.googleapis.com

Consulte a API RPC para mais informações.

A seguir