Google BigQuery

nota

Em espaços de trabalho compatíveis com a versão 9 ou mais recente, essa fonte de dados pode exigir a instalação do plug-in apropriado. Para ter mais informações, consulte Plugins Grafana.

Fornece suporte para o Google BigQuery como um banco de dados de back-end.

nota

O Amazon Managed Grafana inclui duas fontes de dados diferentes para. BigQuery A fonte de dados atual é da Grafana Labs. Uma fonte de dados mais antiga, que não tem mais suporte ativo, é da DoIT International. Novas fontes de dados devem usar a fonte de dados fornecida pela Grafana Labs. Para saber mais sobre como migrar suas consultas existentes, consulte. Importando consultas criadas com o plug-in DoIt International BigQuery DataSource

Recursos:

• Configuração da consulta

• Editor SQL bruto

• Construtor de consultas

• Suporte a macros

• Funções adicionais

• Visualização da tabela

• Anotações

• Consultas BQ em variáveis

• Mesas fragmentadas

• Tabelas particionadas

• Alocação granular de slots (execução de consultas em um projeto com preço fixo)

Adicionando a fonte de dados

1. Abra o console do Grafana no espaço de trabalho do Amazon Managed Grafana e verifique se você está logado.

2. No menu lateral, em Configuração (o ícone de engrenagem), escolha Fontes de dados.

3. Escolha Adicionar fonte de dados.

   nota

   Se você não vê o link Fontes de dados no menu lateral, isso significa que seu usuário atual não tem a Admin função.

4. Selecione Google BigQueryby Grafana Labs na lista de fontes de dados.

5. Insira as seguintes informações:

   • Em Nome, insira o nome da fonte de dados.

   • Padrão significa que ele será pré-selecionado para novos painéis.

   • Em Chave da conta de serviço, insira o arquivo da chave da conta de serviço de um projeto do GCP. As instruções sobre como criar isso estão mais adiante neste documento.

Você pode definir a prioridade da consulta INTERACTIVE ou BATCH por fonte de dados.

Autenticação

Para autenticar o BigQuery plug-in, faça o upload de um arquivo JWT do Google. Você precisa criar uma conta de serviço do Google Cloud Platform (GCP) para o projeto do qual você quer mostrar dados. Uma fonte de dados Amazon Managed Grafana se integra a um projeto do GCP. Se você quiser visualizar dados de vários projetos do GCP, conceda permissões à conta de serviço em cada projeto ou crie uma fonte de dados por projeto do GCP.

Ativar APIs

Acesse a BigQuery API e ative a API.

Criar uma conta de serviço do GCP para um projeto

Para criar uma conta de serviço do GCP para um projeto

1. Navegue até a página de credenciais de API e serviço.

2. Escolha Criar credenciais e escolha Chave da conta de serviço.

3. Na página Criar chave da conta de serviço, escolha o tipo de chave JSON. Em seguida, no menu suspenso Conta de serviço, escolha a opção Nova conta de serviço.

4. Insira um nome para a conta de serviço no campo Nome da conta de serviço e escolha as funções BigQuery Data Viewer e BigQueryJob User no menu suspenso Role.

5. Escolha Criar. Um arquivo de chave JSON é criado e baixado para o seu computador. Armazene esse arquivo em um local seguro, pois ele permite o acesso aos seus BigQuery dados.

6. Faça o upload para o Amazon Managed Grafana na página de configuração da fonte de dados. Você pode carregar o arquivo ou colar seu conteúdo.

7. O conteúdo do arquivo é criptografado e salvo no banco de dados Grafana. Não se esqueça de salvar depois de fazer o upload do arquivo.

Usando o construtor de consultas

O criador de consultas fornece uma interface simples, mas fácil de usar, para ajudá-lo a redigir rapidamente uma consulta. O construtor permite que você defina as partes básicas da sua consulta. As mais comuns são:

• A tabela a partir da qual você deseja consultar

• O campo de hora e o campo métrico

• Cláusula WHERE: use uma das macros predefinidas para acelerar seu tempo de escrita ou configure sua própria expressão. As macros suportadas existentes são as seguintes:

  • Macro $__timeFiler com exemplo dos últimos 7 dias

    WHERE `createDate` BETWEEN TIMESTAMP_MILLIS (1592147699012) AND TIMESTAMP_MILLIS (1592752499012) AND _PARTITIONTIME >= '2020-06-14 18:14:59' AND _PARTITIONTIME < '2020-06-21 18:14:59'

  • Macro $__timeFrom com exemplo dos últimos 7 dias

    WHERE `createDate` > TIMESTAMP_MILLIS (1592223758609)  AND _PARTITIONTIME >= '2020-06-15 15:22:38' AND _PARTITIONTIME < '2020-06-22 15:22:38'

  • Macro $__timeTo com os últimos 7 dias

    WHERE `createDate` < TIMESTAMP_MILLIS (1592828659681)  AND _PARTITIONTIME >= '2020-06-15 15:24:19' AND _PARTITIONTIME < '2020-06-22 15:24:19'

• Opção GROUPBY: você pode usar uma macro predefinida ou usar um dos campos da sua consulta a. time ($_interval, none)

• Opção ORDER BY

nota

Observação: se seu local de processamento não for o padrão dos EUA, defina seu local no menu suspenso Local de processamento no canto superior direito do criador de consultas

Solução de problemas

Para solucionar problemas de uma consulta, use o Inspector de Consultas na parte superior do construtor de consultas. Isso ajuda você a ver a consulta limpa e solucionar erros de SQL.

Importando consultas criadas com o plug-in DoIt International BigQuery DataSource

Se você tiver consultas existentes que usam o BigQuery plug-in DoIT International, você pode importar essas consultas alterando a fonte de dados para Grafana. BigQuery Suas consultas serão importadas como consultas SQL brutas.