O validador de conteúdo de integração contínua (CI, na sigla em inglês) identifica dashboards e Looks que têm erros. Muitas vezes, esses erros são causados por referências ausentes a campos do LookML.
O validador de conteúdo de CI executa uma validação semelhante ao validador de conteúdo padrão do Looker, com algumas diferenças:
O validador de conteúdo de CI oferece suporte ao seguinte:
- É possível configurar o Validador de Conteúdo de CI para ser executado automaticamente quando um desenvolvedor do Looker envia uma solicitação de envio para o repositório do LookML ou manualmente quando você executa um pacote de CI.
- É possível definir o escopo dos resultados do validador de conteúdo de CI para pastas de conteúdo específicas do Looker ou para modelos e análises específicos no projeto do LookML. Por padrão, os resultados do validador de conteúdo de CI são definidos automaticamente para o projeto do LookML. O escopo do validador de conteúdo de CI é pós-processamento: o validador é executado em toda a instância do Looker e, em seguida, filtra os resultados para o escopo especificado ao criar o pacote de CI.
O validador de conteúdo padrão do Looker oferece suporte ao seguinte:
- É possível executar o validador de conteúdo do Looker manualmente apenas.
- É possível definir o escopo do validador de conteúdo do Looker para pastas de conteúdo específicas do Looker ou para projetos específicos do LookML. O escopo do validador de conteúdo do Looker ocorre antes da validação: o validador é executado apenas nas pastas e projetos especificados ao iniciar a validação de conteúdo.
- É possível usar o validador de conteúdo do Looker para substituir nomes de campos, visualizações, análises e modelos, para remover campos e para excluir Looks.
Consulte a seção Opções do validador de conteúdo desta página para mais detalhes sobre as opções que podem ser configuradas ao criar ou editar um pacote de CI. Para informações sobre como executar o validador de conteúdo, consulte a página de documentação Execução de pacotes de integração contínua.
Na página de resultados da execução, o validador de conteúdo fornece a mensagem de erro para cada Look ou dashboard com erro, além de um link para o conteúdo:
Opções do validador de conteúdo
É possível especificar várias opções ao criar um pacote de integração contínua para configurar como o validador de conteúdo é executado. As opções são descritas nas seções a seguir desta página:
- Análises para consulta
- Análises para exclusão
- Pastas para validação
- Pastas para exclusão
- Excluir conteúdo em pastas pessoais
- Validação incremental
Análises para consulta
Por padrão, o validador de conteúdo executa a validação de conteúdo em todos os modelos e análises do projeto do LookML.
É possível usar o campo Análises para consulta para especificar a análise e os modelos que você quer incluir na validação de conteúdo.
É possível especificar análises no seguinte formato: model_name/explore_name
Por exemplo, para especificar as análises chamadas users e orders no arquivo thelook.model.lkml, insira o seguinte: thelook/users, thelook/orders
Consulte a página de documentação do validador de SQL para mais informações e exemplos de como especificar análises e modelos nesse campo.
Análises para exclusão
Por padrão, o validador de conteúdo executa a validação de conteúdo em todos os modelos e análises do projeto do LookML.
É possível usar o campo Análises para exclusão para especificar a análise e os modelos que você quer excluir da validação de conteúdo.
É possível especificar análises no seguinte formato: model_name/explore_name
Consulte a página de documentação do validador de SQL para mais informações e exemplos de como especificar análises e modelos nesse campo.
Pastas para validação
É possível definir o escopo da validação de conteúdo para pastas de conteúdo específicas na instância do Looker, especificando um ID de pasta ou uma lista de IDs de pastas separados por vírgulas.
Para receber o ID de uma pasta, use o menu de navegação principal do Looker para abrir a pasta e, em seguida, receba o ID da pasta no URL do navegador. O ID da pasta é o último elemento do URL. Por exemplo, no URL a seguir, o ID da pasta é 45:
https://myinstance.looker.com/folders/45
Pastas para exclusão
É possível excluir pastas de conteúdo específicas da validação de conteúdo especificando um ID de pasta ou uma lista de IDs de pastas separados por vírgulas no campo Pastas para exclusão.
Excluir conteúdo em pastas pessoais
Se você quiser que o validador de conteúdo valide apenas o conteúdo em pastas compartilhadas, ative o campo Excluir conteúdo em pastas pessoais. Quando o campo Excluir conteúdo em pastas pessoais está ativado, o validador de conteúdo ignora o conteúdo nas pastas pessoais da instância do Looker.
Validação incremental
A validação incremental é um método para encontrar erros exclusivos de uma ramificação de desenvolvimento específica, erros que ainda não existem em produção. A validação incremental ajuda os desenvolvedores a encontrar e corrigir os erros de que são responsáveis sem serem distraídos por erros existentes no projeto. Ela também pode acelerar a validação, especialmente para projetos do LookML que contêm muitas análises.
Nos resultados do validador, o validador de conteúdo indica cada análise que foi ignorada porque não houve mudanças no SQL compilado na ramificação ou confirmação que estava sendo validada. Consulte Como visualizar resultados para validação incremental para um exemplo de resultados de validação incremental.
É possível ativar a validação incremental para o validador de conteúdo selecionando a caixa de seleção Somente erros incrementais na seção Validador de conteúdo ao criar ou editar um pacote de integração contínua.
Observe o seguinte para validação incremental:
- A configuração de validação incremental não se aplica quando o validador de conteúdo está validando a própria ramificação de produção, como acontece com as execuções manuais na ramificação de produção. Ao validar a ramificação de produção, o validador de conteúdo mostra a validação completa dos resultados.
Limitações da validação de conteúdo
Se você excluir um modelo ou mudar o nome dele, o validador de conteúdo não vai retornar esses erros de conteúdo "pendentes", porque o modelo não pode mais ser associado ao projeto que está sendo testado.