O Validador de conteúdo de integração contínua (CI) identifica painéis e Looks com erros. Muitas vezes, esses erros são causados por referências ausentes a campos da LookML.
O CI Content Validator realiza uma validação semelhante ao Content Validator padrão do Looker, com algumas diferenças:
O CI Content Validator é compatível com o seguinte:
- É possível configurar o CI Content Validator para ser executado automaticamente quando um desenvolvedor do Looker envia uma solicitação de envio ao seu repositório LookML ou manualmente quando você executa manualmente um pacote de CI.
- É possível restringir os resultados do Validador de conteúdo da CI a pastas de conteúdo específicas do Looker ou a modelos e análises específicos no seu projeto do LookML. Por padrão, os resultados do CI Content Validator são automaticamente definidos para seu 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 depois filtra os resultados para o escopo especificado ao criar o conjunto de CI.
O validador de conteúdo padrão do Looker é compatível com o seguinte:
- Só é possível executar o Content Validator do Looker manualmente.
- É possível definir o escopo do Content Validator 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.
- Use o Content Validator do Looker para substituir nomes de campos, visualizações, análises detalhadas e modelos, remover campos e excluir Looks.
Consulte a seção Opções do Content Validator desta página para mais detalhes sobre as opções que podem ser configuradas ao criar ou editar um conjunto de CI. Para informações sobre como executar o Content Validator, consulte a página de documentação Executar conjuntos de integração contínua.
Na página de resultados da execução, o Content Validator fornece a mensagem de erro para cada painel ou Look com erros, 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 conjunto de integração contínua para configurar como o Content Validator é 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 a serem excluídas
- 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 em todos os modelos e análises detalhadas do projeto LookML.
Use o campo Análises detalhadas para consultar e especifique a análise detalhada e os modelos que você quer incluir na validação de conteúdo.
É possível especificar as análises detalhadas no seguinte formato: model_name/explore_name
Por exemplo, para especificar as análises detalhadas 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 detalhadas e modelos nesse campo.
Análises a serem excluídas
Por padrão, o Validador de conteúdo executa a validação em todos os modelos e análises detalhadas do projeto LookML.
Use o campo Análises detalhadas a serem excluídas para especificar a análise detalhada e os modelos que você quer excluir da validação de conteúdo.
É possível especificar as análises detalhadas 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 detalhadas e modelos nesse campo.
Pastas a serem validadas
É possível definir o escopo da validação de conteúdo para pastas específicas na sua instância do Looker especificando um ID de pasta ou uma lista separada por vírgulas de IDs de pastas.
Para acessar o ID de uma pasta, use o menu de navegação principal do Looker para abrir a pasta e extraia o ID do 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 a serem excluídas
É 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 a serem excluídas.
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 sua 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 se distrair com erros existentes no projeto. Ela também pode acelerar a validação, especialmente para projetos LookML que contêm muitas análises.
Nos resultados do validador, o Content Validator indica cada análise detalhada que foi ignorada porque não teve mudanças no SQL compilado na ramificação ou no commit que estava sendo validado. Consulte Como ver os resultados da validação incremental para um exemplo de resultados.
Para ativar a validação incremental no Content Validator, marque a caixa de seleção Somente erros incrementais na seção Content Validator ao criar ou editar um conjunto de integração contínua.
Observações sobre a 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.