Ao editar o LookML, o Looker IDE avisa sobre erros de sintaxe não resolvidos em um único arquivo. Consulte a página de documentação Visão geral do IDE do Looker.
Para realizar uma validação completa de um modelo, use o validador do LookML. Alguns erros, como uma referência de campo inválida devido a uma mesclagem ausente, exigem uma análise holística do modelo e, portanto, só são exibidos quando o validador do LookML é executado. Valide as alterações do LookML antes de publicá-las no ambiente de produção. Embora a validação não detecte todos os problemas, como problemas de permissão do banco de dados, ela evita a maioria dos erros.
O validador do LookML verifica somente os arquivos do LookML que foram atualizados desde a última validação do LookML ou arquivos afetados por atualizações:
- Se uma configuração no nível do modelo for alterada, tudo será validado novamente.
- Se uma visualização mudar, somente as Análises em que ela foi usada serão validadas novamente.
- Se uma Análise detalhada mudar, apenas ela será validada novamente.
Executando validação
Para executar o validador do LookML, selecione o botão Validar LookML no canto superior direito do ambiente de desenvolvimento integrado do Looker. Ou selecione o ícone Saúde do projeto na parte de cima do ambiente de desenvolvimento integrado para abrir o painel Saúde do projeto e clique no ícone Validar LookML.
Depois de executar o validador do LookML, você pode conferir uma lista de erros e outros avisos que precisam ser resolvidos. Selecione qualquer seta para expandir as listas de erros ou avisos.
O botão do validador no painel Saúde do projeto vai ficar disponível novamente se você fizer e salvar outra mudança.
Mensagens de validação
O Looker mostra mensagens de validação depois de executar a validação no LookML.
Nenhum erro do LookML encontrado
Quando o validador não encontra problemas, o Looker exibe uma marca de seleção verde com o texto Nenhum erro do LookML encontrado.
Erros do LookML
Erros do LookML são problemas que podem impedir a execução de consultas. O número entre parênteses é o número de erros encontrados (nove no exemplo a seguir):
Na lista expandida de problemas, você verá o motivo da falha na validação. Muitas vezes, se você clicar no erro, ele vai levar você diretamente para a linha de código com o problema. Um "X" vermelho vai aparecer ao lado da linha. Passe o cursor sobre ele para ver informações mais detalhadas sobre o erro em alguns casos:
Dica da equipe de chat: o erro de validação mais comum é "Campo desconhecido ou inacessível". Acesse a página de práticas recomendadas Erro: campo desconhecido ou inacessível para ver as causas e o que fazer a respeito.
Avisos do LookML
Os avisos do LookML podem não impedir a execução de uma consulta, mas ainda podem resultar em uma funcionalidade inativa ou indesejada para os usuários. Assim como nos erros, o número entre parênteses é o número de avisos encontrados (três avisos no exemplo abaixo):
Assim como nos erros do LookML, é possível expandir os avisos e pular para o código do problema selecionando o aviso no painel Saúde do projeto e passando o cursor sobre o ícone vermelho X para conferir mais informações:
Como implantar as alterações
Depois de validar se as alterações vão funcionar corretamente, use a integração do Git do Looker para confirmar e implantar as alterações na produção.