Como 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, é fácil navegar pelas tabelas do esquema, usar uma Análise ad hoc de uma consulta SQL, executar consultas descritivas pré-escritas nos dados, consultar 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.

Nesta página, descrevemos como criar uma tabela derivada usando o SQL Runner e como usar o SQL Runner para depurar tabelas derivadas. Consulte as seguintes páginas de documentação para obter informações sobre:

• Princípios básicos 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 e usar como uma tabela derivada no projeto do LookML. É possível até mesmo acessar uma consulta SQL de outra ferramenta, testá-la no SQL Runner e adicioná-la ao projeto do LookML.

Depois de criar uma consulta SQL no SQL Runner, use a opção Add to Project ou Get Derived Table LookML para gerar uma tabela derivada da consulta. Essas duas opções permitem fazer uma consulta no SQL Runner e adicioná-las ao projeto LookML. Consulte as seções a seguir para mais informações.

Adicionar ao projeto

Usar a opção Add to Project é 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 preferir criar manualmente o arquivo de visualização e adicionar o LookML da consulta por conta própria, use a opção Obter LookML da tabela derivada.

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 Add to Project 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 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 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 com a 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í, 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 LookML da tabela derivada.

3. No pop-up Get Derived Table LookML, clique no link adicionar ao projeto.

   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 em que você quer adicionar a tabela derivada.

5. Digite um nome para a nova vista no campo Nome da vista. Consulte a página Como gerenciar arquivos e pastas do LookML para ver 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 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 SQL na definição de uma tabela derivada.

Destaque de erros no 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 conferir 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 da Comunidade do Looker Como usar o SQL Runner para testar tabelas derivadas (em inglês).