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 criar uma tabela derivada usando o SQL Runner e como usar o executor do SQL para depurar tabelas derivadas. Consulte estas outras páginas de documentação para ver informações sobre:
- Noções básicas sobre o SQL Runner
- Como usar o SQL Runner para criar consultas e explorações
- Como gerenciar funções de banco de dados com o SQL Runner
Criar uma tabela derivada de uma consulta
Há várias maneiras de criar uma tabela derivada de uma consulta no SQL Runner.
Como adicionar a um projeto LookML
O SQL Runner é um ótimo local para testar o SQL de tabelas derivadas antes de adicioná-las ao modelo. Você pode até receber uma consulta de uma ferramenta diferente, testá-la no SQL Runner e adicioná-la ao projeto.
- Use o SQL Runner para criar uma consulta SQL que você quer usar para uma tabela derivada.
- Clique em Adicionar ao projeto no menu de engrenagem no canto superior direito.
- Selecione o projeto em que você quer adicionar essa tabela derivada.
- Insira um nome de visualização para a tabela derivada.
- Clique em Adicionar para incluir a consulta como uma tabela derivada no projeto.
- O Looker alternará para o modo de desenvolvimento (se ainda não estiver nele) e abrirá a nova visualização derivada de tabela no projeto selecionado. Se você tiver selecionado um projeto que usa o LookML mais antigo baseado em YAML, o Looker fornecerá a tabela derivada no LookML baseado em YAML. Se você tiver selecionado um projeto que usa o novo LookML, o Looker fornecerá a tabela derivada no novo LookML.
Como encontrar o LookML de uma tabela derivada
Outra maneira de criar uma tabela derivada da consulta do SQL Runner é usar a opção Get Looked Table LookML no menu de engrenagem do SQL Runner. Assim como na opção Adicionar ao projeto, o Looker fornecerá o LookML necessário para transformar sua consulta SQL em uma tabela derivada. É possível copiar o LookML para colar no seu projeto, o que é útil se você quiser substituir uma tabela derivada atual.
Para criar uma tabela derivada de uma consulta do SQL Runner:
- Use o SQL Runner para criar uma consulta SQL que você quer usar para uma tabela derivada.
- Clique no menu de engrenagem e selecione Get Looked Table LookML.
- Copie o LookML que foi gerado. Se preferir, clique em adicionar ao projeto, escolha o projeto a que você quer adicionar a tabela derivada e insira um nome para a visualização em Nome da visualização.
Caso você não tenha adicionado a tabela derivada ao seu projeto clicando em add it to your project, abra o projeto e clique em + na parte superior da lista de arquivos do projeto no ambiente de desenvolvimento integrado do Looker. Também é possível clicar no menu de uma pasta para criar o arquivo dentro da pasta.
Escolha Criar vista.
O Looker exibe uma caixa vazia na parte superior da sua lista de visualizações. Digite o nome da nova visualização e pressione Enter. O Looker oferece suporte ao uso de caracteres maiúsculos e minúsculos, números, sublinhados e caracteres Unicode em nomes de arquivos. Se o nome do arquivo de visualização incluir caracteres incompatíveis com o Looker, esses caracteres serão substituídos por sublinhados.
O Looker abre a nova visualização.
Exclua todo o conteúdo da nova visualização e cole a tabela derivada LookML que você copiou anteriormente.
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 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 testar tabelas derivadas
Se você vir um erro proveniente de uma tabela derivada, será possível determinar 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 o tópico Como usar o SQL Runner para testar tabelas derivadas da Comunidade do Looker.