Como usar o SQL Runner para criar consultas e explorações

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, você pode navegar pelas tabelas no seu esquema, usar um Explorar ad hoc de uma consulta SQL, executar consultas descritivas pré-criadas nos seus dados, ver seu histórico do SQL Runner, fazer o download de resultados, compartilhar consultas, adicionar a um Projeto LookML como uma tabela derivada e executar outras tarefas úteis.

Nesta página, descrevemos como executar consultas no SQL Runner, criar explorações ad hoc e como usar o SQL Runner para depurar consultas. Consulte estas outras páginas de documentação para ver informações sobre:

Como executar consultas no SQL Runner

Para fazer uma consulta no banco de dados, é possível escrever a consulta SQL do zero, usar uma ferramenta Explorar para criar a consulta ou executar uma consulta em um modelo LookML. Também é possível usar o histórico para executar novamente uma consulta anterior.

Como criar uma consulta SQL do zero

É possível usar o SQL Runner para gravar e executar suas próprias consultas SQL no banco de dados. O Looker passa sua consulta para seu banco de dados como você a escreveu. Portanto, verifique se a sintaxe da consulta SQL é válida para o dialeto do seu banco de dados. Por exemplo, cada dialeto tem funções SQL um pouco diferentes, com parâmetros específicos que precisam ser transmitidos para a função.

  1. Clique na área "Consulta SQL" e digite o comando SQL.
  2. Clique duas vezes no nome ou campo de uma tabela na lista para incluí-la na consulta no local do cursor.
  3. Clique em Executar para executar a consulta no seu banco de dados.
  4. Veja os resultados na área "Resultados". O SQL Runner vai carregar até 5.000 linhas do conjunto de resultados da consulta. Para dialetos SQL compatíveis com streaming, faça o download dos resultados para ver 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 em consultas, incluindo espaços em branco.

Quando tiver uma consulta de que gosta, você poderá adicionar a consulta a um projeto, receber o LookML de uma tabela derivada ou compartilhar a consulta.

Também é possível usar o SQL Runner para fazer consultas com novas consultas ou testar as atuais. O destaque de erros do SQL Runner ajuda a testar e depurar consultas.

Como usar o recurso Explorar para criar uma consulta SQL

Também é possível usar uma exploração para criar uma consulta e, em seguida, receber o comando SQL que ela usará no SQL Runner:

  1. Em uma guia Explorar, clique na guia SQL na barra Dados.
  2. Selecione o texto da consulta SQL e copie-o para o SQL Runner ou
  3. Clique em Abrir no SQL Runner ou Explicar no SQL Runner para abrir a consulta no SQL Runner.

Depois que uma consulta é adicionada à área de consulta SQL do SQL Runner, você pode clicar em Executar para consultar o banco de dados. Como alternativa, é possível editar e executar a nova consulta.

Como criar visualizações com o SQL Runner

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

Com o SQL Runner Vis ativado, os painéis do SQL Runner são reorganizados. O painel de visualização aparece na parte superior, o painel de resultados está no meio e o painel de consulta aparece na parte inferior.

  1. Depois que uma consulta SQL for criada e executada, será possível abrir a guia Visualização para saber mais sobre a visualização e escolher um tipo de visualização, como você 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 será alterado.

Há alguns detalhes a serem considerados sobre o funcionamento das visualizações do SQL Runner:

  • A tabela e a visualização de resultados interpretam qualquer campo numérico como uma medida.
  • O nome completo do campo é sempre usado na tabela de resultados e na visualização. Portanto, a opção Mostrar nome do campo completo no menu Configurações está inativa.
  • Para usar campos personalizados, cálculos de tabela, tabelas dinâmicas, totais de colunas e subtotais, explore com base na sua consulta do SQL Runner.
  • As visualizações de mapas estáticos (regiões) não são compatíveis com as visualizações do SQL Runner. No entanto, mapas que usam dados de latitude e longitude (visualizações de mapas e estáticos (pontos)) são compatíveis.
  • As visualizações da linha do tempo não são compatíveis com as visualizações do SQL Runner.

Dimensões dinâmicas

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

  1. Clique no menu de engrenagem de uma coluna na área Resultados para ver as opções da coluna.
  2. Clique em Coluna dinâmica.

Os resultados dinâmicos são exibidos na visualização do SQL Runner:

Os resultados na área Resultados não parecem dinâmicos.

Para desativar os resultados, clique no menu de engrenagem da coluna dinâmica e selecione Coluna dinâmica:

Como alterar o tipo de campo

Ao exibir 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), faça o seguinte:

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

A visualização mostra o novo tipo de campo:

Como executar uma consulta em um modelo do LookML

É possível usar o SQL Runner para gravar e executar consultas SQL em um modelo LookML, e não diretamente no seu banco de dados. Ao criar sua consulta com base em um modelo, é possível usar operadores de substituição LookML, como ${view_name.field_name} ou ${view_name.SQL_TABLE_NAME}. Isso pode economizar tempo ao criar uma consulta para resolver problemas em uma tabela derivada, por exemplo.

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

Para executar uma consulta no seu modelo LookML no SQL Runner:

  1. Clique na guia Modelo.
  2. Selecione o modelo que você quer consultar.
  3. Clique na área de consulta SQL e insira a consulta SQL usando os campos LookML.
  4. Se quiser, clique duas vezes em uma visualização na lista para incluir a visualização na sua consulta no local do cursor.
  5. Para ver a lista de campos em uma visualização, clique nela na seção Visualizações. Você também pode clicar duas vezes em um campo na lista para incluí-lo na consulta no local do cursor.
  6. Na área Consulta SQL preparada, você pode ver a consulta SQL resultante que é criada após as substituições do LookML serem traduzidas em SQL.
  7. Clique em Executar para executar a consulta no seu modelo.
  8. Veja os resultados na área Resultados. O SQL Runner carrega até 5.000 linhas do conjunto de resultados da consulta. Para dialetos SQL compatíveis com streaming, faça o download dos resultados para ver todo o conjunto de resultados.

Quando tiver uma consulta de que gosta, você poderá adicionar a consulta a um projeto, receber o LookML de uma tabela derivada ou compartilhar a consulta.

Também é possível usar o SQL Runner para brincar com novas consultas, testar consultas existentes ou abrir uma nova exploração nos resultados. O destaque de erros do SQL Runner ajuda a testar e depurar consultas.

Como visualizar um LookML de um campo no SQL Runner

Na lista de campos na guia Modelo, você também pode ver o LookML de um campo. Passe o cursor sobre o campo na lista e clique no í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 ver um histórico recente de todas as consultas executadas no SQL Runner.

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

Clique em uma consulta no histórico para preenchê-la no SQL Runner e depois em Executar para executá-la novamente:

Classificar a 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. Você pode classificar por várias colunas mantendo a tecla Shift pressionada e clicando nos cabeçalhos das colunas na ordem em que você quer classificá-las. A ordem de classificação de um campo também é indicada por um número que diferencia 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 Como classificar dados da página de documentação Como analisar dados no Looker.

Compartilhamento de consultas

É possível compartilhar uma consulta no SQL Runner com outro usuário com acesso ao SQL Runner. Para compartilhar uma consulta, basta copiar o URL na barra de URL:

Fazendo o download dos resultados

Depois de executar a consulta SQL, é possível 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 arquivo do download (arquivo de texto, CSV, JSON etc.).

  4. Para ver os resultados em uma nova janela do navegador, clique em Abrir no navegador ou em Fazer o download para salvar os resultados em um arquivo no seu computador.

    Quando você clicar em Abrir no navegador ou Fazer o download, o Looker executará a consulta novamente e fará o download.

Para dialetos SQL compatíveis com streaming, a opção Download do SQL Runner fará o download de todo o conjunto de resultados. Para dialetos SQL que não são compatíveis com streaming, a opção Download do SQL Runner fará o download somente das linhas da consulta exibidas na seção Resultados (até 5.000 linhas).

Copiando valores de coluna

Copie valores de coluna da seção Resultados no SQL Runner. Clique no menu de engrenagem de uma coluna para copiar os valores para a área de transferência. A partir daí, é possível colar os valores da coluna em um arquivo de texto, um documento do Excel ou outro local.

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

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

Estimativas de custo das consultas do SQL Runner

Para conexões do BigQuery, MySQL, Amazon RDS for MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL para PostgreSQL e Microsoft Azure PostgreSQL, o SQL Runner oferece uma estimativa do custo da consulta. Após a consulta SQL, o SQL Runner calcula a quantidade de dados que a consulta vai exigir e exibe as informações próximas ao botão Run.

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

Como criar uma exploração ad hoc

No SQL Runner, é possível receber insights rápidos nos dados ao criar um recurso "Explorar" ad hoc para uma consulta SQL ou tabela de banco de dados. É possível usar o Looker Explore para selecionar campos, adicionar filtros, visualizar os resultados e criar consultas SQL.

Há duas maneiras de abrir um Explorar ad hoc no SQL Runner:

  • Explorar dos resultados de consulta do SQL Runner
  • Explorar da lista de tabelas do SQL Runner

Como analisar os resultados da consulta SQL Runner

Com o SQL Runner, é possível abrir uma exploração a partir de uma consulta SQL. Isso cria uma exploração temporária da consulta escrita 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ê pretende usar para tabelas derivadas.

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

  1. Use o SQL Runner para criar a consulta SQL que você quer usar.
  2. Clique em Explorar no menu de engrenagem no canto superior direito. Isso abre uma nova guia Explorar, em que é possível explorar a consulta SQL como se ela fosse uma tabela salva no seu modelo.
  3. Você pode copiar o URL nesta exploração para compartilhar.
  4. Para adicionar essa consulta como uma tabela derivada no seu projeto diretamente aqui, clique em Adicionar visualização ao projeto.

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

Se você tiver acesso ao recurso campos personalizados, poderá usar os campos personalizados para visualizar campos não modelados no SQL Runner. Conforme descrito na seção anterior, clique em Explorar no menu de engrenagem. Em seguida, no seletor de campo, faça o seguinte:

Como analisar uma tabela listada no SQL Runner

Use a opção Explorar tabela na guia Banco de dados para criar uma exploração ad hoc de qualquer tabela na conexão. Isso permite usar o Looker em uma tabela antes de modelá-la, explorando a tabela como uma visualização LookML.

Depois de abrir uma guia "Explorar" para a tabela, você decidirá se quer adicioná-la ao seu projeto. Também é possível usar a guia SQL do Explore&#39 para ver as consultas SQL que o Looker envia ao banco de dados e, em seguida, usar o botão Abrir no SQL Runner para trazer a consulta de volta ao SQL Runner.

  1. Clique na guia Banco de dados.
  2. No SQL Runner, clique no ícone de engrenagem de uma tabela e selecione Explore Table (Explorar tabela).
  3. O Looker gera um modelo temporário com uma visualização para a tabela e exibe o "Explorar".
  4. O Looker tem um campo de dimensão para cada coluna na tabela. É dessa mesma forma que o Looker gera um modelo no início de um projeto.
  5. O Looker inclui automaticamente períodos para todos os campos de data.
  6. O Looker também inclui uma medida de contagem.

Ao usar a opção Explorar tabela, não há arquivos LookML associados à ferramenta Explorar. Isso é apenas uma visualização ad hoc da tabela.

Como depurar usando o SQL Runner

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

Destaque de erros do SQL Runner

O SQL Runner destaca a localização 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 destes ou outros comportamentos.

O SQL Runner também destaca a localização do primeiro erro de sintaxe no comando SQL, sublinhando em vermelho e marcando a linha com ""x". Passe o cursor sobre ""x" para ver mais informações sobre o erro. Depois de corrigir o problema, clique em Executar para ver se há mais erros na consulta.

Como usar o SQL Runner para verificar erros em Explorações

Se você encontrar erros de sintaxe SQL em "Explorar", use o SQL Runner para determinar o local e o tipo de erros, como erros de ortografia ou comandos ausentes.

  1. Em "Explorar", clique na guia SQL na barra de dados.
  2. Clique em Abrir no SQL Runner para abrir a consulta no SQL Runner.

Isso copia o SQL gerado do Explore, para o SQL Runner. Conforme mostrado acima, o SQL Runner destaca o local dos erros no comando SQL e inclui a posição do erro na mensagem de erro. É possível fazer alterações e executar novamente a consulta no SQL Runner até os erros serem corrigidos.

Como usar o SQL Runner para verificar erros em tabelas derivadas

Para mais informações sobre como usar o SQL Runner para verificar erros de SQL em tabelas derivadas, consulte o artigo Como usar o SQL Runner para testar tabelas derivadas da Comunidade do Looker.