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.
• Limitar o acesso de leitura a colunas ou linhas específicas: é possível expor apenas os dados que você quer permitir que os usuários leiam, sem conceder acesso à tabela inteira.

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
• Pode ser consultado usando qualquer uma das bibliotecas de cliente do Bigtable que oferecem suporte a SQL
• 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. Se você estiver usando um provedor de identidade externo (IdP), primeiro faça login na CLI gcloud com sua identidade federada.

3. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

Funções exigidas

Para trabalhar com visualizações lógicas, você precisa das seguintes permissões:

Para gerenciar visualizações lógicas:

• Para criar, atualizar ou excluir visualizações lógicas, você precisa do papel Administrador do Bigtable (roles/bigtable.admin) na instância.
• Como alternativa, peça ao administrador para conceder as seguintes permissões no nível da instância:
  • Criar: bigtable.logicalViews.create
  • Atualizar: bigtable.logicalViews.update
  • Excluir: bigtable.logicalViews.delete

Para ver e consultar visualizações lógicas:

• Para listar ou descrever visualizações lógicas, você precisa do papel de leitor do Bigtable (roles/bigtable.reader) na instância.

• Como alternativa, peça ao administrador para conceder as seguintes permissões no nível da instância:

  • Lista: bigtable.logicalViews.list
  • Descreva: bigtable.logicalViews.get

• Para consultar uma visualização lógica, você precisa da permissão bigtable.logicalViews.readRows nela.

Para criar uma visualização lógica:

• É preciso ter pelo menos a permissão bigtable.tables.readRows na tabela de origem.

Para conceder acesso de leitura a uma visualização específica:

É possível conceder a um usuário permissão para ler uma visualização lógica específica, mesmo que ele não tenha outras permissões do Bigtable. Para isso, use uma condição do IAM para conceder a permissão bigtable.logicalViews.readRows apenas nessa visualização:

1. Conceda ao usuário o papel bigtable.reader no projeto.

2. Crie uma condição do IAM que limite a permissão bigtable.logicalViews.readRows à visualização lógica específica. Exemplo:

   resource.name == projects/PROJECT_ID/instances/INSTANCE_ID/logicalViews/VIEW
   

   Substitua:

   • PROJECT_ID: o projeto Google Cloud em que a instância do Bigtable está.
   • VIEW: um ID de até 128 caracteres para a nova visão lógica. O ID precisa ser exclusivo entre os IDs de tabela e de visualização na instância.
   • INSTANCE_ID: o ID da instância em que a visualização lógica será criada.

   Para mais informações, consulte Gerenciar o acesso a recursos usando condições do IAM.

Para mais informações sobre 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

Consultar uma visualização lógica

Depois de criar uma visualização lógica, é possível consultá-la usando SQL, assim como uma tabela normal. É possível usar visualizações lógicas na cláusula FROM das instruções SELECT.

No editor de consultas, insira uma consulta do GoogleSQL que faça referência ao nome da visualização. Por exemplo, se a visualização se chamar MyLogicalView:

SELECT *
FROM MyLogicalView
LIMIT 100;

Para mais informações sobre como executar consultas SQL no Bigtable, consulte Consultar seus dados com SQL no editor de consultas.

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