Pontos finais regionais e globais

Esta página descreve os pontos finais do Bigtable, explica o que deve considerar antes de os usar e mostra como definir um ponto final através da CLI cbt.

Para enviar pedidos para o Bigtable, pode usar um ponto final de serviço global ou regional. Os pontos finais regionais do Bigtable garantem que os dados de uma instância são armazenados e tratados na região do Bigtable onde os dados residem. Pode ter de usar endpoints regionais para o Bigtable numa região geográfica específica para satisfazer as necessidades de segurança e conformidade do seu projeto.

Antes de ler este documento, familiarize-se com as instâncias, os clusters e os nós e os perfis de apps.

Os conceitos-chave incluem o seguinte:

  • Ponto final do serviço: um URL base que especifica o endereço de rede de um serviço de API. O Bigtable tem pontos finais globais e regionais.

  • Ponto final global: permite que o Bigtable armazene e encaminhe os dados numa instância do Bigtable para qualquer região que contenha um dos clusters da instância. O ponto final global da Cloud Bigtable API (API de dados) é bigtable.googleapis.com. O ponto final da API Data predefinido acede ao ponto final global.

  • Ponto final regional: aplica restrições regionais, garantindo que o Bigtable armazena e processa dados numa região especificada. Só pode usar os endpoints regionais com a Cloud Bigtable API (API Google Data). O Bigtable não suporta pontos finais regionais para a Cloud Bigtable Admin API.

Quando usar pontos finais regionais

A vantagem de usar um ponto final regional do Bigtable em vez de um ponto final global é que o ponto final regional oferece isolamento e proteção regionais para cumprir os requisitos de segurança, conformidade e regulamentares.

No entanto, os pontos finais regionais não suportam o Data Boost nem a Cloud Bigtable Admin API. Além disso, não pode configurar o Bigtable para alcançar uma percentagem de tempo de atividade mensal de >=99,999% quando usa pontos finais regionais. Para mais informações, consulte a secção Considerações para usar um ponto final regional deste documento.

Quando usar pontos finais globais

Use um ponto final global nos seguintes casos:

  • Não tem requisitos de restrição regional que exijam a utilização de um ponto final regional.
  • Tem de usar o aumento de dados.
  • Tem de usar a Cloud Bigtable Admin API.
  • Precisa de uma percentagem de tempo de atividade mensal de, pelo menos, 99,999%.

Considerações para usar um ponto final regional

Se usar um ponto final regional, tenha em atenção os seguintes fatores:

Agrupe localizações

Antes de poder usar um ponto final regional, tem de criar uma instância com, pelo menos, um cluster na região onde quer isolar os seus dados. Os pontos finais regionais do Bigtable estão disponíveis em regiões do Bigtable selecionadas. Para ver uma lista das regiões disponíveis, consulte o artigo Pontos finais de serviço regionais.

Só pode usar um ponto final regional pertencente à região onde quer isolar os seus dados. Por exemplo, se um cluster estiver na região us-central1, não pode usar bigtable.us-west1.rep.googleapis.com para publicar pedidos.

Se tentar usar um ponto final regional para aceder a um cluster que se encontra numa região diferente, o Bigtable rejeita o pedido com uma mensagem de erro FAILED_PRECONDITION a indicar que não é possível aceder a nenhum cluster através do cluster e do ponto final especificados. Para mais informações sobre esta mensagem de erro, consulte o artigo Códigos de estado do Bigtable.

Perfis de apps

Depois de definir um ponto final regional, tem de usar um perfil de app configurado para encaminhar pedidos para um cluster na região do ponto final.

Se tentar usar um perfil de app configurado para enviar gravações apenas para um cluster (usando o encaminhamento de cluster único) ou clusters numa região diferente do ponto final (usando o encaminhamento de vários clusters), recebe a mensagem de erro FAILED_PRECONDITION. Para mais informações sobre o encaminhamento de clusters, consulte a Política de encaminhamento.

Se usar um perfil de app configurado para encaminhar para qualquer cluster numa instância para alta disponibilidade (HA) e também usar um ponto final regional, o ponto final regional garante que todos os pedidos são encaminhados apenas para clusters na respetiva região, mesmo que a instância tenha clusters noutras regiões. A comutação por falha automática está restrita, pelo que os pedidos só são publicados a partir de clusters na região do ponto final.

Considere um exemplo em que está a enviar pedidos através de um perfil de app configurado para encaminhamento de vários clusters para uma instância que tem clusters em us-west1-a (Oregão), us-west1-b (Oregão) e us-central1-a (Iowa). Se enviar estes pedidos para o ponto final bigtable.us-central1.rep.googleapis.com regional, todos os pedidos são publicados pela us-central1-a, mesmo que não reconfigure o perfil da app. As solicitações que não podem ser processadas por us-central1-a falham.

Replicação

Os pontos finais regionais não afetam nem impedem a replicação. Se configurar um ponto final regional na região A e, em seguida, adicionar um cluster à sua instância na região B, os seus dados são replicados para a região B tal como se tivesse usado o ponto final global.

Para evitar a replicação de dados para outra região, crie clusters apenas na região pretendida.

Para impedir que os utilizadores na sua organização adicionem clusters fora da região do ponto final, pode definir uma política da organização que use restrições de localização.

Disponibilidade

Quando usa pontos finais regionais, não pode configurar o Bigtable para alcançar uma percentagem de tempo de atividade mensal de >=99,999%. Um tempo de atividade mensal de >=99,999% requer ativação pós-falha automática de pedidos em limites regionais. Um ponto final regional impede a comutação por falha automática porque limita todos os pedidos a uma única região. Para mais informações sobre as percentagens de tempo de atividade mensais, consulte o contrato de nível de serviço (SLA) do Bigtable.

Semântica do ponto final regional

Um ponto final regional segue o formato bigtable.REGION.rep.googleapis.com, onde REGION é um Google Cloud nome da região, como northamerica-northeast2.

Por exemplo, se quiser isolar os seus dados na região de Iowa, uma vez que o nome da região de Iowa é us-central1, o URL do ponto final regional para a região de Iowa é bigtable.us-central1.rep.googleapis.com.

Especifique um ponto final regional

Pode especificar um ponto final regional do Bigtable através da CLI cbt ou das bibliotecas de cliente do Cloud Bigtable.

cbt

Para especificar um ponto final regional e substituir o ponto final global através da CLI cbt, pode usar a opção --data-endpoint no seu pedido ou adicionar o seguinte ao ficheiro ~/.cbtrc. Para mais informações sobre como criar um ficheiro ~/.cbtrc, consulte a referência da CLI cbt.

data-endpoint = https://bigtable.REGION.rep.googleapis.com/

Substitua REGION pela região onde quer definir um ponto final regional, como us-central1 ou europe-west1.

Por exemplo, para configurar o ponto final regional como us-central1, adicione o seguinte ao ficheiro ~/.cbtrc:

data-endpoint = https://bigtable.us-central1.rep.googleapis.com/

Especifique o ponto final global

cbt

Para especificar o ponto de envio global, envie o seu pedido sem usar a opção --data-endpoint. Se adicionou anteriormente uma linha data-endpoint ao ficheiro ~/.cbtrc, elimine-a.

Restrinja a utilização do ponto final da API global

Para ajudar a aplicar a utilização de pontos finais regionais, use a restrição da política da organização constraints/gcp.restrictEndpointUsage para bloquear pedidos ao ponto final da API global. Para mais informações, consulte o artigo Restringir a utilização de pontos finais.

O que se segue?