Como usar o SQL Runner para criar consultas e análises detalhadas

O SQL Runner oferece uma maneira de acessar diretamente seu banco de dados e aproveitar esse acesso de várias maneiras. Com o SQL Runner, é possível navegar facilmente pelas tabelas no seu esquema, usar uma análise detalhada ad hoc com base em uma consulta SQL, executar consultas descritivas pré-escritas nos seus dados, conferir o histórico do SQL Runner, fazer o download de resultados, compartilhar consultas, adicionar a um projeto do LookML como uma tabela derivada e realizar outras tarefas úteis.

Esta página descreve como executar consultas no SQL Runner, criar análises detalhadas ad hoc e usar o SQL Runner para depurar consultas. Consulte estas outras páginas de documentação para saber mais sobre:

Como executar consultas no SQL Runner

Para executar uma consulta no seu banco de dados, grave a consulta SQL do zero, use uma análise detalhada para criar a consulta ou execute uma consulta em um modelo do LookML. Também é possível usar o histórico para executar novamente uma consulta anterior.

Escrever uma consulta SQL do zero

Você pode usar o SQL Runner para escrever e executar suas próprias consultas SQL no banco de dados. O Looker transmite sua consulta ao banco de dados exatamente como você a escreveu. Portanto, verifique se a sintaxe da consulta SQL é válida para o dialeto do banco de dados. Por exemplo, cada dialeto tem funções SQL ligeiramente diferentes com parâmetros específicos que precisam ser transmitidos para a função.

  1. Insira uma consulta SQL na caixa de texto abaixo da barra Query.
  2. Opcionalmente, selecione um nome de tabela ou campo na lista de campos para incluir na consulta no local do cursor.
  3. Selecione Executar para executar a consulta no seu banco de dados.
  4. Confira os resultados na área Resultados. O SQL Runner carrega até 5.000 linhas do conjunto de resultados da consulta. Para dialetos SQL com suporte a streaming, é possível fazer o download dos resultados para conferir todo o conjunto de resultados.

Alguns programas SQL permitem executar várias consultas em uma série. No entanto, só é possível executar uma consulta por vez no SQL Runner. O SQL Runner também tem um limite de 65.535 caracteres nas consultas, incluindo espaços em branco.

Depois de executar uma consulta, você pode adicionar a consulta a um projeto, receber o LookML para uma tabela derivada ou compartilhar a consulta.

Você também pode usar o SQL Runner para testar novas consultas ou consultas já existentes. O realce de erros do SQL Runner ajuda a testar e depurar consultas.

Usar uma Análise detalhada para criar uma consulta SQL

Também é possível usar uma Análise para criar uma consulta e, em seguida, receber o comando SQL para usar no SQL Runner:

  1. Em uma Análise detalhada, selecione a guia SQL na barra Dados.
  2. A consulta SQL vai aparecer na barra Dados.
  3. Selecione Abrir no SQL Runner ou Explicar no SQL Runner para abrir a consulta no SQL Runner.

Depois que uma consulta for adicionada à caixa de texto abaixo da barra Consulta, selecione Executar para consultar o banco de dados. Como alternativa, você pode editar a consulta e executar a nova.

Criar visualizações com o SQL Runner

Se o administrador do Looker tiver ativado o recurso de laboratórios da SQL Runner Vis, será possível criar visualizações diretamente no SQL Runner.

Com a visão do SQL Runner ativada, os painéis do SQL Runner são reorganizados. O painel de visualização aparece na parte de cima, o painel de resultados está no meio e o painel de consulta aparece na parte de baixo.

  1. Depois que uma consulta SQL é criada e executada, você pode abrir a guia Visualização para conferir a visualização e escolher um tipo de visualização, assim como faria na página "Explorar".
  2. Você pode editar a visualização usando o menu Configurações.
  3. Para compartilhar as visualizações criadas com o SQL Runner, compartilhe o URL. Todas as personalizações feitas usando o menu Configurações da visualização serão salvas, e o link não vai mudar.

Considere o seguinte sobre o funcionamento das visualizações do SQL Runner:

  • A tabela de resultados e a visualização interpretam qualquer campo numérico como uma métrica.
  • O nome completo do campo é sempre usado na tabela de resultados e na visualização. Portanto, a opção Mostrar nome de campo completo no menu Configurações está inativa.
  • Para usar campos personalizados, cálculos de tabela, pivots, totais de coluna e subtotais, acesse sua consulta do SQL Runner.
  • As visualizações de mapa estático (regiões) não são compatíveis com o SQL Runner, mas os mapas que usam dados de latitude e longitude (visualizações de mapa e mapa estático (pontos)) são compatíveis.
  • As visualizações de linha do tempo não são compatíveis com o SQL Runner.

Criar uma representação dinâmica de dimensões

É possível editar os resultados da consulta para girar por uma ou mais dimensões nas visualizações do SQL Runner. Para girar um campo:

  1. Selecione o menu de engrenagem de uma coluna na área Resultados para mostrar as opções da coluna.
  2. Selecione Coluna dinâmica.

Os resultados pivotados são mostrados na visualização do SQL Runner.

Os resultados na área Resultados não aparecem pivotados.

Para desfazer a pivotagem dos resultados, selecione o menu de engrenagem da coluna pivotada e clique em Desfazer pivotagem da coluna.

Como mudar o tipo de campo

Ao mostrar os resultados e a visualização da consulta, o SQL Runner interpreta automaticamente qualquer campo numérico como uma medida e qualquer campo não numérico como uma dimensão. Para substituir o tipo de campo padrão e converter uma dimensão em uma medida ou vice-versa, siga estas etapas:

  1. Selecione o menu de engrenagem de uma coluna na área Resultados para mostrar as opções da coluna.
  2. Selecione Converter para dimensão ou Converter para medida para mudar o tipo de campo.

A visualização vai mostrar o novo tipo de campo.

Executar uma consulta em um modelo LookML

Você pode usar o SQL Runner para escrever e executar consultas SQL em um modelo do LookML, em vez de diretamente no seu banco de dados. Ao criar sua consulta em um modelo, você pode usar operadores de substituição do LookML, como ${view_name.field_name} ou ${view_name.SQL_TABLE_NAME}. Isso pode economizar tempo ao criar uma consulta para solucionar problemas em uma tabela derivada, por exemplo.

O Looker resolve todas as substituições do LookML e transmite a consulta ao banco de dados. Portanto, ela precisa estar em SQL válido para o dialeto do seu banco de dados. Por exemplo, cada dialeto tem funções SQL ligeiramente diferentes com parâmetros específicos que precisam ser transmitidos para a função.

Para executar uma consulta no modelo LookML no SQL Runner:

  1. Selecione a guia Modelo.
  2. Selecione o modelo que você quer consultar.
  3. Na caixa de texto abaixo da barra Dados, insira sua consulta SQL usando campos do LookML.
  4. Opcionalmente, selecione uma visualização na lista para incluir a visualização na consulta no local do cursor.
  5. Para conferir a lista de campos em uma visualização, selecione a visualização na seção Visualizações. Você também pode selecionar um campo na lista para incluí-lo na consulta no local do cursor.
  6. Na área Consulta SQL preparada, você pode conferir a consulta SQL resultante que é criada depois que todas as substituições do LookML são traduzidas para SQL.
  7. Selecione Executar para processar a consulta no modelo.
  8. Confira os resultados na área Results. O SQL Runner carrega até 5.000 linhas do conjunto de resultados da consulta. Para dialetos SQL que oferecem suporte a streaming, é possível fazer o download dos resultados para conferir todo o conjunto de resultados.

Você pode usar o SQL Runner para brincar com novas consultas, testar consultas existentes ou abrir uma nova Análise nos resultados. O realce de erros do SQL Runner ajuda a testar e depurar consultas.

Quando você tiver uma consulta que goste, poderá compartilhar e até adicionar a consulta a um projeto do LookML.

Como visualizar o LookML de um campo no SQL Runner

Na lista de campos da guia Modelo, você também pode conferir o LookML de um campo. Passe o cursor sobre o campo na lista e selecione o ícone do Looker à direita do nome do campo.

O Looker abre o ambiente de desenvolvimento integrado do LookML e carrega o arquivo em que o campo é definido.

Histórico do SQL Runner

Também é possível conferir um histórico recente de todas as consultas executadas no SQL Runner.

Para conferir seu histórico, selecione a guia Histórico na parte de cima do painel de navegação. O SQL Runner mostra todas as consultas que foram executadas na conexão do banco de dados. Vermelho indica uma consulta que não foi executada devido a um erro.

Selecione uma consulta no histórico para preenchê-la no SQL Runner e, em seguida, selecione Run para executar a consulta novamente.

Como classificar sua consulta

A ordem de classificação de uma tabela é indicada por uma seta para cima ou para baixo ao lado do nome do campo classificado, dependendo se os resultados estão em ordem crescente ou decrescente. Para ordenar por várias colunas, mantenha a tecla Shift pressionada e selecione os cabeçalhos de coluna na ordem que você quer. A ordem de classificação de um campo também é indicada por um número que distingue a ordem de classificação em comparação com outros campos, por uma seta ao lado do nome do campo que mostra a direção de classificação (crescente ou decrescente) e por um pop-up que aparece quando você passa o cursor sobre o nome de um campo.

Para mais informações e exemplos, consulte a seção Ordenação de dados da página de documentação Como analisar dados no Looker.

Compartilhamento de consultas

Você pode compartilhar uma consulta no SQL Runner com outro usuário que tenha acesso a ele. Para compartilhar uma consulta, copie o URL na barra de endereço do navegador.

Como fazer o download dos resultados

Depois de executar a consulta SQL, você pode fazer o download dos resultados em vários formatos.

  1. Escreva uma consulta na caixa Consulta SQL. Não é necessário executar a consulta no SQL Runner neste momento.
  2. Selecione Fazer o download no menu de engrenagem no canto superior direito.
  3. Selecione o formato do download (arquivo de texto, CSV, JSON etc.).

  4. Selecione Abrir no navegador para conferir os resultados em uma nova janela do navegador ou Fazer o download para salvar os resultados em um arquivo no computador.

    Quando você seleciona Abrir no navegador ou Fazer o download, o Looker reexecuta a consulta e faz o download.

Para dialetos SQL que oferecem suporte a streaming, a opção Download do SQL Runner faz o download de todo o conjunto de resultados. Para dialetos SQL que não oferecem suporte a streaming, a opção Download do SQL Runner faz o download apenas das linhas da consulta que aparecem na seção Results (até 5.000 linhas).

Como copiar valores de colunas

É possível copiar valores de coluna da seção Results no SQL Runner. Selecione o menu de engrenagem de uma coluna para copiar os valores para a área de transferência. Em seguida, cole os valores da coluna em um arquivo de texto, uma planilha do Excel ou em outro local.

Se o administrador do Looker tiver ativado o recurso de laboratórios da SQL Runner Vis, você também terá outras opções no menu de engrenagem da coluna:

Também é possível mover, fixar e redimensionar colunas manualmente na tabela de resultados.

Estimativas de custo para consultas do SQL Runner

Para conexões com o BigQuery, MySQL, Amazon RDS para MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL para PostgreSQL e Microsoft Azure PostgreSQL, o SQL Runner fornece uma estimativa do custo da consulta. Depois que você inserir a consulta SQL, o SQL Runner vai calcular a quantidade de dados que a consulta vai exigir e mostrar as informações perto do botão Run.

Para conexões do BigQuery, MySQL e Amazon RDS para MySQL, as estimativas de custo estão sempre ativadas. Para conexões de banco de dados do Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL para PostgreSQL e Microsoft Azure PostgreSQL, ative a opção Estimativa de custo. É possível ativar a Estimativa de custo ao criar a conexão. Para conexões existentes, é possível editar a conexão na página Conexões na seção Banco de dados do painel Administrador do Looker.

Criar uma Análise ad hoc

No SQL Runner, é possível criar uma análise detalhada ad hoc para uma consulta SQL ou tabela de banco de dados e ter insights rápidos sobre os dados. Você pode usar a Análise do Looker para selecionar campos, adicionar filtros, visualizar os resultados e criar consultas SQL.

Há duas maneiras de abrir uma análise ad hoc no SQL Runner:

  • Analisar os resultados da consulta do SQL Runner
  • Acessar a lista de tabelas do SQL Runner

Como analisar os resultados da consulta do SQL Runner

O SQL Runner permite abrir uma Análise a partir de uma consulta SQL. Isso cria uma Análise temporária com base na consulta gravada no SQL Runner. Isso permite testar o que é retornado pela consulta e visualizar os resultados. Isso pode ser usado para qualquer consulta, mas é especialmente útil para testar consultas que você planeja usar para tabelas derivadas.

Se o administrador do Looker tiver ativado o recurso de laboratórios do SQL Runner Vis, você poderá criar visualizações diretamente no SQL Runner.

  1. Use o SQL Runner para criar a consulta SQL que você quer usar.
  2. Selecione Explorar no menu de engrenagem no canto superior direito. Isso leva a uma nova análise detalhada, em que você pode analisar a consulta SQL como se fosse uma tabela salva no modelo.
  3. Você pode copiar o URL dessa Análise para compartilhar.
  4. Para adicionar essa consulta como uma tabela derivada no seu projeto diretamente daqui, selecione Adicionar visualização ao projeto.

Como criar campos personalizados durante a análise no SQL Runner

Se você tiver acesso ao recurso de campos personalizados, poderá usar campos personalizados para visualizar campos não modelados no SQL Runner. Conforme descrito na seção anterior, selecione Explorar no menu de engrenagem. Em seguida, no seletor de campos, siga estas etapas:

Como analisar uma tabela listada no SQL Runner

Use a opção Analisar tabela na guia Banco de dados para criar uma análise detalhada ad hoc para qualquer tabela na conexão. Assim, você pode usar o Looker em uma tabela antes de modelá-la, conferindo-a como uma visualização do LookML.

Depois de abrir uma Análise detalhada da tabela, você pode decidir se ela será adicionada ao projeto. Também é possível usar a guia SQL da Análise para conferir as consultas SQL que o Looker envia para o banco de dados e, em seguida, usar o botão Abrir no SQL Runner para trazer a consulta de volta para o SQL Runner.

  1. Selecione a guia Banco de dados.
  2. No SQL Runner, selecione a engrenagem de uma tabela e Analisar tabela.
  3. O Looker gera um modelo temporário com uma visualização para a tabela e depois mostra a Análise.
  4. O Looker fornece um campo de dimensão para cada coluna na tabela. É da mesma forma que o Looker gera um modelo no início de um projeto.
  5. O Looker inclui automaticamente prazos para todos os campos de data.
  6. O Looker também inclui uma medida de contagem.

Ao usar a opção Analisar tabela, não há um arquivo LookML associado à análise. Ela é apenas uma visualização ad hoc da tabela.

Depurar usando o SQL Runner

O SQL Runner também é uma ferramenta útil para verificar erros de SQL em consultas.

Realce de erros do SQL Runner

O SQL Runner destaca o local dos erros no comando SQL e inclui a posição do erro na mensagem de erro:

As informações de posição fornecidas variam de acordo com o dialeto do banco de dados. Por exemplo, o MySQL fornece o número da linha que contém o erro, enquanto o Redshift fornece a posição do caractere do erro. Outros dialetos de banco de dados podem ter um desses comportamentos ou outros.

O SQL Runner também destaca o local do primeiro erro de sintaxe no comando SQL, sublinhando-o em vermelho e marcando a linha com uma x. Mantenha o cursor sobre o x para conferir mais informações sobre o erro. Depois de corrigir esse problema, selecione Executar para conferir se há mais erros na consulta.

Como usar o SQL Runner para verificar erros em análises detalhadas

Se você encontrar erros de sintaxe SQL em uma Análise, use o SQL Runner para determinar a localização e o tipo de erro, como erros ortográficos ou comandos ausentes.

  1. Na seção "Explorar", selecione a guia SQL da barra "Dados".
  2. Selecione Abrir no SQL Runner para abrir a consulta no SQL Runner.

Isso copia o SQL gerado pela Análise para o SQL Runner. Conforme mostrado na seção Destaque de erros do SQL Runner, o SQL Runner destaca a localização de erros no comando SQL e inclui a posição do erro na mensagem de erro. Em seguida, faça mudanças e execute a consulta novamente no SQL Runner até corrigir os erros.

Como usar o SQL Runner para verificar erros em tabelas derivadas

Para saber como usar o SQL Runner para verificar erros de SQL em tabelas derivadas, consulte a postagem da Comunidade do Looker Usar o SQL Runner para testar tabelas derivadas.