Usar o SQL Runner para criar tabelas derivadas

O SQL Runner oferece acesso direto ao banco de dados, que pode ser usado para criar e depurar tabelas derivadas para seus projetos do LookML. Use o SQL Runner para definir novas tabelas derivadas e solucionar problemas nas existentes, ajudando a garantir a precisão dos dados e melhorar o fluxo de trabalho de desenvolvimento. Este guia mostra como usar o SQL Runner para essas tarefas.

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 informações sobre:

• Noções básicas do SQL Runner
• Como usar o SQL Runner para criar consultas e análises
• Como gerenciar funções de banco de dados com o SQL Runner

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

O SQL Runner é um ótimo lugar para testar o SQL a ser usado como uma tabela derivada no seu projeto do LookML. Você pode até mesmo receber uma consulta SQL de outra ferramenta, testá-la no SQL Runner e adicioná-la ao seu projeto do LookML.

Depois de criar uma consulta SQL no SQL Runner, você pode criar uma tabela derivada a partir da consulta usando a opção Adicionar ao projeto ou Acessar a tabela derivada do LookML. Essas duas opções permitem que você faça uma consulta no SQL Runner e a adicione 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:

A opção Adicionar ao projeto permite selecionar um projeto do LookML. Em seguida, o Looker cria automaticamente um arquivo de visualização com a consulta no projeto selecionado. Se você preferir criar o arquivo de visualização manualmente e adicionar o LookML da consulta, use a opção Acessar a tabela derivada do 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 para uma tabela derivada.
2. Clique em Adicionar ao projeto no menu de engrenagem no canto superior direito.
3. Selecione o projeto a 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 seu 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 adequá-lo à organização de arquivos do seu 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 na consulta do SQL Runner é usar a opção Acessar a tabela derivada do 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. A partir daí, 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 em uma consulta do SQL Runner:

1. Use o SQL Runner para criar uma consulta SQL que você quer usar para 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.

   Observação: é mais fácil usar o link Adicionar ao projeto, mas você também tem a opção de copiar o LookML, criar manualmente um arquivo de visualização no seu projeto e colar o LookML no novo arquivo de visualização.

4. Use a lista suspensa Projeto para escolher o projeto a 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 Como gerenciar arquivos e pastas do LookML para 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 adequá-lo à organização de arquivos do seu projeto.

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

Como 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.

Destaque 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 ou outros comportamentos.

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

Como usar o SQL Runner para testar tabelas derivadas

Se você encontrar um erro em uma tabela derivada, determine a causa do erro copiando a instrução SQL para o 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 Como usar o SQL Runner para testar tabelas derivadas.