Criar consultas no console

É possível consultar e visualizar os dados do Bigtable usando o Criador de consultas do Bigtable Studio. O Criador de consultas é um formulário interativo no console do Google Cloud que permite criar uma consulta, executá-la em uma tabela e conferir os resultados no console.

O Criador de consultas do Bigtable Studio permite usar os seletores suspensos para especificar uma combinação de cláusulas de consulta sem precisar escrever um aplicativo ou usar uma CLI. Quando você executa a consulta, o console faz uma chamada para a API Bigtable Data, que retorna dados correspondentes à consulta.

Este documento descreve como usar o criador de consultas e oferece dicas sobre como otimizar suas consultas. Antes de ler esta página, familiarize-se com a visão geral do Bigtable.

As consultas executadas no Criador de consultas estão sujeitas aos mesmos preços e cotas que qualquer outra consulta enviada a uma tabela.

Quando usar o Criador de consultas

A capacidade de consultar seus dados do Bigtable no console do Google Cloud é útil quando você precisa fazer o seguinte:

  • Receba uma representação visual do esquema da tabela.
  • Verifique se determinados dados foram gravados.
  • Valide a integridade dos dados durante uma migração.
  • Depurar possíveis problemas de dados.
  • Visualize os resultados que uma combinação específica de cláusulas retorna antes de usá-las no código. Isso pode ser útil principalmente para novos usuários do Bigtable e para usuários experientes que não querem usar a CLI cbt.

Antes de começar

Para receber as permissões necessárias para usar o criador de consultas, peça ao administrador para conceder a você o papel do IAM Leitor do Bigtable (roles/bigtable.reader) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para usar o criador de consultas. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para usar o criador de consultas:

  • bigtable.tables.get
  • bigtable.instances.get
  • bigtable.appProfiles.list
  • bigtable.tables.list
  • bigtable.tables.readRows

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Se você não tiver uma tabela para consultar, crie uma pequena tabela de teste e execute as consultas nela.

Abrir o criador de consultas

Quando você abre o Criador de consultas, uma consulta padrão é executada e exibida para a primeira tabela em ordem alfabética na instância. A consulta padrão é executada usando o perfil de app padrão, e até 100 linhas são retornadas.

  1. Abra a lista de instâncias do Bigtable no Console do Google Cloud.

    Abrir a lista de instâncias

  2. Clique no nome da instância que contém a tabela que você quer consultar.

  3. No painel de navegação, clique em Bigtable Studio. A página Bigtable Studio é aberta no modo de criação de consultas. O painel Explorer fornece uma lista de tabelas na instância, e o painel Resultados da consulta mostra os resultados da consulta padrão.

  4. Opcional: encolha o painel Explorer para aumentar o painel do criador de consultas.

Formato de exibição de dados

Os resultados do criador de consultas são mostrados em uma tabela. O primeiro título e a primeira coluna são Chave de linha. Os cabeçalhos restantes representam uma coluna na tabela do Bigtable, expressa como o grupo de colunas e o qualificador de coluna separados por dois-pontos. Por exemplo, o cabeçalho cell_plan: data_plan_01gb indica que os valores nessa coluna são da coluna data_plan_01gb no grupo de colunas cell_plan.

menu suspenso

Somente o valor mais recente de uma coluna é retornado. As marcas de tempo ficam ocultas por padrão, mas você pode clicar no botão para exibi-las.

Selecione uma tabela

Use o menu suspenso Tabela para selecionar o ID da tabela que você quer consultar.

Opcional: especificar um perfil de app

É possível usar um perfil de app criado especificamente para uso com o criador de consultas. Isso pode ser útil, por exemplo, quando você quer isolar o tráfego de consulta usando um cluster diferente do usado pelo aplicativo principal.

Para usar um perfil de app diferente para executar a próxima consulta, siga estas etapas.

  1. Clique em Adicionar à consulta.
  2. Clique em Mudar o perfil do app (padrão). Um novo menu suspenso é exibido.
  3. Use o menu suspenso Perfil de app e escolha na lista de perfis de app da instância.

Para saber mais sobre as vantagens de usar perfis de app diferentes para cargas de trabalho diferentes, consulte Sobre os perfis de app. Para saber como criar um perfil de app, consulte Criar e configurar perfis de app.

Se a tabela estiver em uma instância que usa a replicação, configure o perfil do app para ler do cluster geograficamente mais próximo de você.

Adicionar cláusulas à consulta e executá-la

  1. Depois de selecionar a tabela e o perfil do app, adicione cláusulas à consulta. Consulte a próxima seção para saber mais sobre as cláusulas disponíveis.
  2. Depois de adicionar todas as cláusulas, clique em Executar.
  3. Veja os resultados.

Cláusulas de consulta

Use o criador de consultas para adicionar cláusulas à consulta. Quando você executa a consulta, o editor de consulta cria e envia uma solicitação de leitura para a tabela. Para saber mais sobre solicitações de leitura, consulte Leituras.

As cláusulas de chave de linha, intervalo de chave de linha e prefixo de chave de linha determinam as linhas que são extraídas do armazenamento. As cláusulas de regex da chave de linha, colunas e período adicionam um filtro à solicitação de leitura gerada. Os filtros usados no criador de consultas funcionam da mesma forma que nas bibliotecas de cliente. Para saber mais sobre os filtros do Bigtable e como eles afetam a performance, consulte Filtros e Usar filtros.

Especificar chave de linha

Para recuperar uma única linha da tabela, forneça um valor de chave de linha. É possível adicionar várias cláusulas de chave de linha.

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Chave de linha.
  3. Insira o valor exato da chave de linha para a qual você quer conferir os valores.

Especificar um intervalo de chave de linha

Para recuperar um intervalo de linhas da tabela, especifique uma chave de linha inicial e final. O Bigtable armazena dados em ordem lexicográfica por chave de linha.

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Intervalo de chaves de linha.
  3. Insira a chave de linha inicial completa.
  4. Insira a chave de linha final completa.

Especificar um prefixo da chave de linha

Para recuperar apenas linhas com chaves que começam com um conjunto específico de caracteres, filtre por prefixo da chave de linha. Um prefixo de chave de linha é o primeiro N caracteres de uma chave de linha. Por convenção, geralmente há uma hashtag, um caractere de pipe ou outro símbolo entre o prefixo e o restante da chave de linha.

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Prefixo da chave de linha.
  3. Insira um prefixo da chave de linha. Não é necessário inserir símbolos curinga.

Filtrar por regex da chave de linha

Para receber apenas linhas com valores de chave de linha que correspondem a uma expressão regular especificada, use um filtro de regex de chave de linha. Para melhorar o desempenho, adicione um intervalo de chaves de linha ou uma cláusula de prefixo de chave de linha à consulta antes de adicionar o filtro de regex de chave de linha. Para orientações sobre como compor o regex, consulte Regex da chave de linha.

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Regex da chave de linha.
  3. Digite uma expressão regular que use a sintaxe RE2.

Filtrar por coluna

Para especificar uma ou mais colunas a serem incluídas na consulta, adicione uma cláusula columns, escolhendo o grupo de colunas e o qualificador de cada coluna que você quer usar como filtro. A solicitação de leitura gerada quando você adiciona essa cláusula inclui o filtro de regex de família de colunas e o filtro de intervalo de colunas.

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Colunas.
  3. Clique no campo "Colunas". Uma lista de famílias de colunas é exibida.
  4. Clique no ID de um grupo de colunas. Uma lista de qualificadores de colunas é exibida.
  5. Clique em um qualificador de coluna.

Filtrar por período

Para extrair apenas células com um carimbo de data/hora em um determinado intervalo, adicione uma cláusula de intervalo de tempo, que usa o filtro de intervalo de carimbo de data/hora.

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Período.
  3. Insira um carimbo de data/hora de início.
  4. Insira um carimbo de data/hora de término.

Informe um carimbo de data/hora em um dos seguintes formatos:

  • Um carimbo de data/hora Unix em microssegundos, como 3023483279876000
  • YYYY-MM-DDThh:mm:ss:ss[z]
  • YYYY/MM/DD-hh:mm:ss.sss[z]
  • MM/DD/AAAA
  • AAAA/MM/DD

O T opcional é um literal que indica o tempo, e o z opcional indica o horário UTC em vez do horário local. Para mais informações sobre formatos de carimbo de data/hora, consulte ISO 8601 .

Especificar um limite

Para especificar um número máximo de linhas retornadas, adicione uma cláusula de limite.

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Limite.
  3. Insira um número de 1 a 1.00.

Limitações

As limitações a seguir se aplicam ao criador de consultas.

  • 1.000 caracteres por célula: o Bigtable retorna um máximo de 1.000 caracteres por célula. Se uma célula tiver mais de 1.000 caracteres, um resultado truncado será mostrado, anotado com o número de caracteres não mostrados.
  • Máximo de 100 colunas: o Bigtable retorna as primeiras 100 colunas em cada linha que correspondem à consulta. Os grupos de colunas não são armazenados em nenhuma ordem específica, mas as colunas são classificadas lexicograficamente dentro do grupo de colunas.
  • Máximo de 1.000 linhas: o Builder de consultas retorna no máximo as primeiras 1.000 linhas de dados que correspondem à consulta.
  • Base64: o Bigtable faz o possível para mostrar com precisão os dados codificados em Base64, mas os resultados não são garantidos. Se o Bigtable não conseguir mostrar os dados em uma célula, ele vai mostrar o tamanho do valor da célula em bytes.

  • Dados mais antigos: só é possível recuperar a célula (ou versão) mais recente nas colunas consultadas. Para mais detalhes sobre esse conceito, consulte Modelo de armazenamento do Bigtable e Conceitos gerais.

  • Dados serializados: os dados armazenados como buffers de protocolo não são mostrados corretamente nos resultados da consulta. Os dados JSON têm melhor suporte, mas não são garantidos para parecer corretos.

  • Carimbos de data/hora artificiais: se o aplicativo atribuir números que não são de carimbo de data/hora à propriedade de carimbo de data/hora das células ao gravar dados na tabela, é possível usar filtros de período na consulta para receber um intervalo dos valores que você usa em vez de carimbos de data/hora, desde que eles sejam especificados como microssegundos. Para entender por que os dados da tabela podem usar carimbos de data/hora artificiais, consulte Carimbos de data/hora.

A seguir