Nesta página, descrevemos os endpoints de serviço globais e regionais do Spanner e como usá-los.
Um endpoint de serviço é um URL base que especifica o endereço de rede de um serviço de API. O Spanner tem endpoints globais e regionais. Use um endpoint de serviço global ou regional para fazer solicitações ao Spanner.
Use o endpoint global se você não tiver requisitos
de restrição regional rígidos. Os dados são armazenados na região selecionada, mas
podem ser processados fora dela. O endpoint global do Spanner é spanner.googleapis.com
. O endpoint de API padrão
acessa o endpoint global.
Um endpoint regional aplica restrições regionais. Os dados são armazenados e processados dentro da mesma região. Os endpoints regionais do Spanner garantem e garantem que os dados armazenados e processados estejam restritos à configuração de instância regional do Spanner em que o banco de dados reside. Use endpoints regionais se o local dos dados precisar ser restrito e controlado para atender aos requisitos regulamentares. Não é possível usar um endpoint regional para acessar recursos pertencentes a uma configuração de instância diferente. Primeiro, é preciso criar uma instância na configuração regional antes de usar o endpoint regional nessa configuração.
Um endpoint regional do Spanner está disponível apenas na configuração da instância regional me-central2
de Dammam. As políticas de armazenamento do Spanner não são alteradas, independentemente do endpoint usado.
Segurança e conformidade para endpoints regionais
A vantagem de usar um endpoint regional do Spanner em vez de um endpoint global é que o endpoint regional fornece isolamento e proteção regionais para atender aos requisitos de segurança, conformidade e regulamentação.
Só é possível usar endpoints regionais que pertençam à configuração dessa instância. 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 pertencer à configuração de instância regional us-central1
.
A solicitação será rejeitada com um erro InvalidRegionalRequest
.
Limitações dos endpoints regionais
Não é possível acessar uma configuração de instância multirregional com um endpoint regional.
Use o endpoint global para acessar as configurações da instância
multirregional. 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 à sua instância
em nam7
.
Se você tiver solicitações ativas que usam endpoints regionais em qualquer um dos recursos da instância, mover a instância 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 não são afetadas.
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 o
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
.
Apenas me-central2
está disponível como um possível endpoint regional.
Especificar um endpoint regional
É possível especificar um endpoint regional do Spanner usando as 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 no endpoint global, execute:
gcloud config unset api_endpoint_overrides/spanner
API REST
O endpoint de API padrão acessa o endpoint global. Para usar um endpoint regional, configure o endpoint como 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 configuração da instância regional Dammam (me-central2
), use:
https://spanner.me-central2.rep.googleapis.com
Consulte a API REST para mais informações.
API RPC
O endpoint de API padrão acessa o endpoint global. Para usar um endpoint regional, configure o endpoint como 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 configuração da instância regional Dammam (me-central2
), use:
spanner.me-central2.rep.googleapis.com
Consulte a API RPC para mais informações.
A seguir
Saiba mais sobre as configurações de instância do Spanner.
Saiba mais sobre a API REST do Spanner e os endpoints globais e regionais.
Saiba mais sobre a API RPC do Spanner e os endpoints globais e regionais.