Usar o SQL Runner para criar tabelas derivadas

O SQL Runner oferece uma forma de aceder diretamente à sua base de dados e tirar partido desse acesso de várias formas. Com a execução de SQL, pode navegar facilmente pelas tabelas no seu esquema, usar uma análise detalhada ad hoc a partir de uma consulta SQL, executar consultas descritivas pré-escritas nos seus dados, ver o histórico da execução de SQL, transferir resultados, partilhar 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 com o SQL Runner e como usar o SQL Runner para depurar tabelas derivadas. Consulte estas outras páginas de documentação para obter informações sobre:

Adicionar uma consulta do SQL Runner a um projeto do LookML

A execução de SQL é um ótimo local para testar o SQL a usar como uma tabela derivada no seu projeto do LookML. Pode até obter uma consulta SQL de uma ferramenta diferente, testá-la na execução de SQL e, em seguida, adicioná-la ao seu projeto do LookML.

Depois de criar uma consulta SQL na execução de SQL, pode criar uma tabela derivada a partir da consulta através da opção Adicionar ao projeto ou da opção Obter LookML da tabela derivada. Ambas as opções permitem-lhe usar uma consulta na execução de SQL e adicioná-la ao seu projeto do LookML. Consulte as secções seguintes para ver informações.

Adicionar ao projeto

A opção Adicionar ao projeto é a forma 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 realçado.

A opção Adicionar ao projeto permite-lhe selecionar um projeto LookML e, em seguida, o Looker cria automaticamente um ficheiro de visualização com a consulta no projeto selecionado. Se preferir criar manualmente o ficheiro de vista e adicionar o LookML da consulta, pode usar a opção Get Derived Table LookML.

Siga estes passos para usar a opção Adicionar ao projeto:

  1. Use o SQL Runner para criar uma consulta SQL que quer usar para uma tabela derivada.
  2. Clique em Adicionar ao projeto no menu de engrenagem no canto superior direito.
  3. Selecione o projeto ao qual quer adicionar esta tabela derivada.
  4. Introduza um nome de vista para a tabela derivada.
  5. Clique em Adicionar para adicionar a consulta como uma tabela derivada no seu projeto. O Looker muda para o modo de desenvolvimento, se ainda não estiver nesse modo, cria um novo ficheiro de visualização com o LookML da consulta do SQL Runner e, em seguida, abre o explorador de ficheiros do IDE para o novo ficheiro de visualização.
  6. Mova o ficheiro de acordo com a organização de ficheiros do seu projeto.
  7. Valide o LookML e implemente as alterações na produção.

Obter LookML da tabela derivada

Outra forma de criar uma tabela derivada a partir da consulta do SQL Runner é usar a opção Get Derived Table LookML (Obter LookML da tabela derivada) no menu de engrenagem do SQL Runner. Tal como acontece com a opção Adicionar ao projeto, o Looker fornece o LookML necessário para transformar a sua consulta SQL numa tabela derivada. A partir daí, pode copiar o LookML para colar no seu projeto, o que é útil se quiser substituir uma tabela derivada existente.

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

  1. Use o SQL Runner para criar uma consulta SQL que quer usar para uma tabela derivada.
  2. Clique no menu de roda dentada e selecione Get Derived Table LookML (Obter LookML da tabela derivada).

  3. No pop-up Obter LookML da tabela derivada, clique no link adicioná-lo ao seu projeto.

  4. Use a lista pendente Projeto para escolher o projeto ao qual quer adicionar a tabela derivada.

  5. Introduza um nome para a nova vista no campo Nome da vista. Consulte a página Gerir ficheiros e pastas LookML para ver as convenções de nomenclatura de ficheiros.

  6. Clique no botão Adicionar. O Looker muda para o modo de desenvolvimento, se ainda não estiver nesse modo, cria um novo ficheiro de visualização com o LookML da consulta do SQL Runner e, em seguida, abre o explorador de ficheiros do IDE para o novo ficheiro de visualização.

  7. Mova o ficheiro de acordo com a organização de ficheiros do seu projeto.

  8. Valide o LookML e implemente as alterações na produção.

Depuração com a execução de SQL

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

Realce de erros do Execução de SQL

O SQL Runner realça 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 consoante o dialeto da base 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 caráter do erro. Outros dialetos de base de dados podem ter um destes ou outros comportamentos.

O SQL Runner também realça a localização do primeiro erro de sintaxe no comando SQL sublinhando-o a vermelho e marcando a linha com um "x". Passe o cursor do rato sobre o "x" para ver mais informações sobre o erro. Depois de corrigir esse problema, clique em Executar para ver se existem mais erros na consulta.

Usar a execução de SQL para testar tabelas derivadas

Se vir um erro proveniente de uma tabela derivada, pode determinar a causa do erro copiando a declaração SQL para o SQL Runner e testando diferentes partes do SQL para restringir a localização do erro. Para mais informações, consulte a publicação da comunidade do Looker Usar o SQL Runner para testar tabelas derivadas.