Criar e gerenciar visualizações lógicas

No Bigtable, uma visualização lógica é o resultado de uma consulta SQL que funciona como uma tabela virtual que pode ser consultada por outras consultas SQL. Os dados permanecem na tabela de origem.

Este documento descreve as visualizações lógicas e como criar e realizar operações nelas. Para uma comparação com visualizações materializadas contínuas e autorizadas, consulte Tabelas e visualizações.

Com as visualizações lógicas, é possível fazer o seguinte com seus dados do Bigtable:

• Evite a repetição de consultas: é possível armazenar e desenvolver o mapeamento de colunas e a lógica de conversão em uma visualização lógica, que outras visualizações lógicas podem usar em vez de copiar e colar essa lógica ou precisar entendê-la.
• Integração com sistemas projetados para ler de bancos de dados relacionais: as visualizações lógicas permitem que os dados do Bigtable sejam lidos como uma tabela de banco de dados relacional ou do Cassandra.
• Executar a mesma visualização lógica em várias tabelas: ao modificar a cláusula FROM, é possível usar a mesma visualização para consultar qualquer tabela na sua instância do Bigtable.
• Forneça uma interface consistente: seu aplicativo pode usar uma visualização lógica mesmo que a tabela de origem mude.

Uma visualização lógica é um recurso no nível da instância. É possível criar uma visualização lógica usando a Google Cloud CLI ou o editor de consultas do Bigtable Studio no console Google Cloud . Para consultar uma visualização lógica, use o editor de consultas do Bigtable Studio ou qualquer uma das bibliotecas de cliente do Bigtable que oferecem suporte a SQL.

Uma visualização lógica tem as seguintes características:

• É necessário usar recursos do SQL compatíveis com o GoogleSQL para Bigtable.
• Somente leitura
• Precisa ser lido com SQL em vez de uma chamada para ReadRows
• Usa direitos de definidor. É possível consultar uma visualização lógica se você tiver permissões para ler dela, mesmo que não tenha permissão para ler da tabela de origem.

A chave de linha, o qualificador de coluna e os valores de coluna usados para definir uma visualização lógica são tratados como dados de serviço. Por isso, não crie uma visualização lógica usando chave de linha, qualificador de coluna ou valores de coluna que contenham informações sensíveis. Para informações sobre como os dados de serviço são tratados, consulte o Aviso de privacidade doGoogle Cloud .

Antes de começar

Siga estas etapas se você planeja usar a CLI gcloud:

1. Install the Google Cloud CLI.

2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

Funções exigidas

Para receber as permissões necessárias para criar e gerenciar visualizações lógicas, peça ao administrador para conceder a você o papel de Administrador do Bigtable (roles/bigtable.admin) na instância. Caso contrário, peça as seguintes permissões no nível da instância, dependendo da operação que você quer realizar:

• Criar: bigtable.logicalViews.create
• Atualizar: bigtable.logicalViews.update
• Excluir: bigtable.logicalViews.delete
• Lista: bigtable.logicalViews.list
• Descreva: bigtable.logicalViews.get

Para criar uma visualização lógica, você também precisa ter pelo menos a permissão bigtable.table.readRows na tabela de origem.

Para conferir todos os papéis e permissões disponíveis, consulte Controle de acesso do Bigtable com o IAM.

Criar uma visualização lógica

gcloud bigtable logical-views create VIEW \
  --instance=INSTANCE --query=QUERY

Atualizar uma visualização lógica

gcloud bigtable logical-views update VIEW  \
    --instance=INSTANCE --query=QUERY

Excluir uma visualização lógica

Essa ação é permanente.

Não é possível excluir uma visualização lógica com a proteção contra exclusão ativada. Para excluir uma visualização lógica com a proteção contra exclusão ativada, atualize a visualização lógica para desativar a proteção contra exclusão. Para mais informações, consulte a seção Modificar a proteção contra exclusão deste documento.

  gcloud bigtable logical-views delete VIEW \
    --instance=INSTANCE

Receber uma lista de visualizações lógicas para uma instância

É possível conferir uma lista de visualizações lógicas de uma instância.

gcloud bigtable logical-views list --instance=INSTANCE

Descrever uma visualização lógica

Para conferir detalhes sobre uma visualização lógica, use o comando gcloud bigtable logical-views describe.

  gcloud bigtable logical-views describe VIEW \
      --instance=INSTANCE

O terminal mostra detalhes semelhantes a estes:

  createTime: '2025-03-07T19:49:56.316578Z'
  etag: W/"/v1/17919275593532352351"
  name: projects/my-project/instances/my-instance/logicalViews/my-view
  query: SELECT street FROM addresses
  updateTime: '2025-03-07T19:49:56.316578Z'
  deletion_protection: true

Mudar proteção contra exclusão

A proteção contra exclusão impede a exclusão da visualização lógica. Para ativar ou desativar a proteção contra exclusão de uma visualização lógica, você precisa das permissões necessárias. Para mais informações, consulte a seção Papéis necessários deste documento.

gcloud bigtable logical-views update VIEW \
    --instance=INSTANCE \
    --deletion-protection

gcloud bigtable logical-views update VIEW \
    --instance=INSTANCE \
    --no-deletion-protection

A seguir

• Visão geral do GoogleSQL para Bigtable
• Visualizações materializadas contínuas
• Visão geral das visualizações autorizadas