Nesta página, descrevemos os endpoints de serviço regionais e globais do Spanner e como usá-los.
Um endpoint de serviço é uma base URL que especifica o endereço de rede de um serviço de API. 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 políticas regionais restritas
requisitos de restrição. Os dados ficam armazenados na região selecionada,
eles podem ser processados fora da região. O endpoint global do
O 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 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 instância diferente configuração do Terraform. Primeiro, é preciso 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 no Dammam
me-central2
configuração da instância regional. A infraestrutura
As políticas de armazenamento do Spanner não mudam, independentemente de qual
endpoint que você usa.
Segurança e compliance para endpoints regionais
O benefício de usar um endpoint regional do Spanner em vez de um endpoint global é que o endpoint regional fornece isolamento regional e para atender aos requisitos regulatórios, 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 atender às solicitações se a instância que
está acessando pertence à configuração da 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 os locais birregionais
ou configurações de instâncias multirregionais. Por exemplo, se você tiver uma instância
a configuração da instância multirregional nam7
, não será possível usar o
endpoint spanner.us-central1.rep.googleapis.com
para enviar solicitações ao
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 endpoints regionais
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
formato spanner.<REGION>.rep.googleapis.com
. Por exemplo, os clusters regionais
o nome da configuração da instância e o nome do endpoint regional de Dammam
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 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 uma coluna endpoint, configure-o 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 API REST para mais informações.
API RPC
O endpoint padrão da API acessa o endpoint global. Para usar uma coluna endpoint, configure-o 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
Saiba mais sobre as configurações de instância do Spanner.
Saiba mais sobre a API REST do Spanner e Endpoints globais e regionais.
Saiba mais sobre a API Spanner RPC e Endpoints globais e regionais.