Como usar o SQL Runner para criar tabelas derivadas

O SQL Runner oferece uma maneira de acessar diretamente o banco de dados e aproveitar esse acesso de várias maneiras. Com o SQL Runner, é fácil navegar pelas tabelas do esquema, usar uma Análise ad hoc de uma consulta SQL, executar consultas descritivas pré-escritas nos dados, ver o histórico do SQL Runner, fazer o download dos resultados, compartilhar consultas, adicionar a um projeto do LookML como uma tabela derivada e realizar outras tarefas úteis.

Nesta página, descrevemos 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 mais informações sobre:

• Princípios básicos do SQL Runner
• Como usar o SQL Runner para criar consultas e Análises detalhadas
• 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 e usá-lo como uma tabela derivada no projeto LookML. É possível até conseguir uma consulta SQL de uma ferramenta diferente, testá-la no SQL Runner e adicioná-la ao projeto do LookML.

Depois de criar uma consulta SQL no SQL Runner, crie uma tabela derivada da consulta usando a opção Add to Project ou Get Derived Table LookML. Essas duas opções permitem fazer uma consulta no SQL Runner e adicioná-las ao projeto LookML. Consulte as seções abaixo 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 e, em seguida, o Looker cria automaticamente um arquivo de visualização com a consulta no projeto selecionado. Se, em vez disso, você preferir criar manualmente o arquivo de visualização e adicionar o LookML da consulta por conta própria, 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 para 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 a tabela derivada.
4. Insira um nome de visualização para a tabela derivada.
5. Clique em Adicionar para incluir 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 de acordo com a organização do seu projeto.
7. Valide o LookML e implante as alterações na produção.

Acessar a tabela derivada do LookML

Outra maneira de criar uma tabela derivada da sua 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 disponibilizar o LookML necessário para transformar sua consulta SQL em uma tabela derivada. A partir daí, copie o LookML para colar no projeto, o que é útil se você quiser substituir uma tabela derivada existente.

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 para uma tabela derivada.
2. Clique no menu de engrenagem e selecione Obter tabela derivada do LookML.

3. No pop-up Get Derived Table LookML, clique no link add it to your project.

   Observação: é mais fácil usar o link adicionar ao seu projeto, mas você também tem a opção de copiar o LookML, criar um arquivo de visualização manualmente no 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. Digite um nome para a nova visualização no campo Nome da vista. Consulte a página Como gerenciar arquivos e pastas do LookML para conhecer as convenções de nomenclatura de arquivos.

6. Clique no botão Add. 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 de acordo com a organização do seu projeto.

8. Valide o LookML e implante as alterações 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 no 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 desses ou outros comportamentos.

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

Como usar o SQL Runner para testar tabelas derivadas

Se você vir um erro vindo de uma tabela derivada, determine a causa do erro 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 na Comunidade do Looker Como usar o SQL Runner para testar tabelas derivadas (em inglês).