Usar o SQL Runner para criar tabelas derivadas

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 criar uma tabela derivada usando o SQL Runner e como usar o SQL Runner para depurar tabelas derivadas. Consulte estas outras páginas de documentação para saber mais sobre:

Como adicionar uma consulta do SQL Runner a um projeto do LookML

O SQL Runner é um ótimo lugar para testar o SQL para usar como uma tabela derivada no seu projeto do LookML. Você pode até extrair uma consulta SQL de uma ferramenta diferente, testá-la no SQL Runner e, em seguida, adicionar ao seu projeto do LookML.

Depois de criar uma consulta SQL no SQL Runner, você pode criar uma tabela derivada usando a opção Adicionar ao projeto ou Extrair o LookML da tabela. Com essas duas opções, você pode fazer uma consulta no SQL Runner e adicionar ao seu projeto do LookML. Consulte as seções a seguir para mais informações.

Adicionar ao projeto

Usar a opção Adicionar ao projeto é a maneira mais fácil de adicionar uma consulta do SQL Runner ao seu projeto:

Página do SQL Runner com o menu de engrenagem aberto e o link "Adicionar ao projeto" destacado.

Com a opção Adicionar ao projeto, você pode selecionar um projeto do LookML e o Looker cria automaticamente um arquivo de visualização com a consulta no projeto selecionado. Se preferir criar o arquivo de visualização manualmente e adicionar o LookML da consulta, use a opção Get Derived Table LookML.

Siga estas etapas para usar a opção Adicionar ao projeto:

  1. Use o SQL Runner para criar uma consulta SQL que você quer usar em uma tabela derivada.
  2. Clique em Adicionar ao projeto no menu de engrenagem no canto superior direito.
  3. Selecione o projeto em que você quer adicionar essa tabela derivada.
  4. Insira um nome de visualização para a tabela derivada.
  5. Clique em Adicionar para adicionar a consulta como uma tabela derivada no projeto. O Looker vai mudar para o Modo de desenvolvimento, se ainda não estiver nele, criar um novo arquivo de visualização com o LookML da consulta do SQL Runner e abrir o navegador de arquivos do ambiente de desenvolvimento integrado para o novo arquivo de visualização.
  6. Mova o arquivo para se adequar à organização de arquivos do projeto.
  7. Valide o LookML e implante as mudanças na produção.

Acessar a tabela derivada do LookML

Outra maneira de criar uma tabela derivada da consulta do SQL Runner é usar a opção Get Derived Table LookML no menu de engrenagem do SQL Runner. Assim como na opção Adicionar ao projeto, o Looker vai fornecer o LookML necessário para transformar sua consulta SQL em uma tabela derivada. Em seguida, você pode copiar o LookML para colar no seu projeto, o que é útil se você quiser substituir uma tabela derivada.

Para criar uma tabela derivada de uma consulta do SQL Runner:

  1. Use o SQL Runner para criar uma consulta SQL que você quer usar em uma tabela derivada.
  2. Clique no menu de engrenagem e selecione Acessar a tabela derivada do LookML.

  3. No pop-up Acessar a tabela derivada do LookML, clique no link Adicionar ao projeto.

  4. Use a lista suspensa Project para escolher o projeto em que você quer adicionar a tabela derivada.

  5. Insira um nome para a nova visualização no campo Nome da visualização. Consulte a página Gerenciar arquivos e pastas do LookML para conferir as convenções de nomenclatura de arquivos.

  6. Clique no botão Adicionar. O Looker vai mudar para o Modo de desenvolvimento, se ainda não estiver nele, criar um novo arquivo de visualização com o LookML da consulta do SQL Runner e abrir o navegador de arquivos do ambiente de desenvolvimento integrado para o novo arquivo de visualização.

  7. Mova o arquivo para se adequar à organização de arquivos do projeto.

  8. Valide o LookML e implante as mudanças na produção.

Depurar usando o SQL Runner

O SQL Runner também é uma ferramenta útil para verificar erros de SQL na definição de uma tabela derivada.

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 um "x". Passe o cursor sobre a "x" para conferir mais informações sobre o erro. Depois de corrigir esse problema, clique em Executar para conferir se há mais erros na consulta.

Como usar o SQL Runner para testar tabelas derivadas

Se você encontrar um erro vindo de uma tabela derivada, poderá determinar a causa dele copiando a instrução SQL no SQL Runner e testando diferentes partes do SQL para restringir o local do erro. Para mais informações, consulte a postagem da Comunidade do Looker Usar o SQL Runner para testar tabelas derivadas.