Criar consultas no console

É possível consultar e visualizar seus dados do Bigtable usando o Bigtable Studio criador de consultas. 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.

Com o criador de consultas do Bigtable Studio, é possível usar seletores suspensos especificar uma combinação de cláusulas de consulta sem precisar escrever uma ou usar uma CLI. Quando você executa a consulta, o console faz uma chamada para a API Bigtable Data, que retorna dados que correspondem à sua 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 possibilidade de consultar os dados do Bigtable no O console do Google Cloud é útil quando você precisa fazer o seguinte:

  • Receba uma representação visual do esquema da tabela.
  • Verifique se alguns dados foram gravados.
  • Valide a integridade dos dados durante uma migração.
  • Depurar possíveis problemas de dados.
  • Visualizar os resultados que uma combinação específica de cláusulas retorna antes você as usa no seu 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 ter as permissões necessárias para usar o criador de consultas, peça ao administrador para conceder a você 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 permissões a seguir 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 tem uma tabela para consultar, pode criar uma pequena tabela de teste e executar consultas nele.

Abrir o criador de consultas

Quando você abre o criador de consultas, uma consulta padrão é executada e exibida para o 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 consulta.

  3. No painel de navegação, clique em Bigtable Studio. O Bigtable Studio a página abre no modo Criador de consultas. O painel Explorer apresenta uma lista de na instância. O painel Resultados da consulta mostra os resultados da a 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 exibidos em uma tabela. O primeiro cabeçalho e a primeira coluna são Chave de linha. Os títulos restantes representam uma coluna na Tabela do Bigtable, expressa como o grupo de colunas e a coluna qualificador separado por dois pontos. Por exemplo, o título cell_plan: data_plan_01gb indica que os valores nessa coluna são do Coluna data_plan_01gb no grupo de colunas cell_plan.

menu suspenso

Somente o valor mais recente de uma coluna é retornado. As marcações de tempo estão ocultas por padrão, mas é possível clicar no botão para exibi-los.

Selecione uma tabela

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

Opcional: especificar um perfil de app

Você pode 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 executar a próxima consulta com outro perfil de aplicativo, 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 ler mais sobre as vantagens de usar diferentes perfis de aplicativos para diferentes cargas de trabalho, consulte Sobre o perfis , 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 detalhes 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 à sua consulta. Quando você executa a consulta, o criador de consultas cria e envia uma solicitação de leitura para sua 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 buscados no armazenamento. As cláusulas de regex da chave de linha, colunas e período adicionam um filtro à solicitação de leitura gerada. Filtros usados na consulta builder funcionam da mesma forma que são usados nas bibliotecas de cliente. Para mais detalhes sobre os filtros do Bigtable e como o uso deles pode afetar o desempenho, ver Filtros e Use filtros ,

Especificar chave de linha

Para recuperar uma única linha da tabela, forneça um valor de chave de linha. Você pode adicionar múltiplas 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 chave 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, há frequentemente uma hashtag, barra vertical ou outro símbolo entre as 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 de 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 chaves de linha à consulta antes de adicionar o filtro de regex de chaves de linha. Para receber orientações sobre como escrever o regex, consulte Chave de linha regex ,

  1. Clique em Adicionar à consulta.
  2. Na lista suspensa, selecione Chave de linha regex.
  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 um columns oração, escolhendo o grupo de colunas e o qualificador de coluna para cada coluna que você que você quer filtrar. 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 em um ID de grupo de colunas. Uma lista de qualificadores de colunas é exibida.
  5. Clique em um qualificador de coluna.

Filtrar por período

Para recuperar apenas células com um carimbo de data/hora em um determinado intervalo, adicione um intervalo de tempo , que usa o intervalo de carimbo de data/hora filtro ,

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

Forneça um carimbo de data/hora em um dos seguintes formatos:

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

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

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. Digite 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 uma máximo de 1.000 caracteres por célula. Se uma célula tiver mais de 1.000 caracteres, um resultado truncado será exibido, anotado com o número de caracteres não exibidos.
  • Máximo de 100 colunas: o Bigtable retorna as 100 primeiras colunas em cada linha que correspondem à consulta. Os grupos de colunas não são armazenados qualquer ordem específica, mas as colunas são classificadas lexicograficamente dentro de 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 ajustar com precisão exibir dados codificados em Base64, mas os resultados não são garantidos. Se O Bigtable não consegue exibir os dados em uma célula, ele exibe 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 exibidos corretamente nos resultados da consulta. Os dados JSON são mais aceitos, mas não é garantido que está certo.

  • 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 usados 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