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 pela falta de referências a campos do LookML.
O Content Validator do CI realiza uma validação semelhante à do Content Validator padrão do Looker, com algumas diferenças:
O validador de conteúdo de CI oferece suporte para:
- É possível configurar o validador de conteúdo da CI para ser executado automaticamente quando um desenvolvedor do Looker envia uma solicitação de envio para seu repositório do LookML ou manualmente quando você executa manualmente um pacote de CI.
- É possível definir o escopo dos resultados do validador de conteúdo do CI para pastas de conteúdo específicas do Looker ou para modelos e análises específicas no projeto do LookML. Por padrão, os resultados do validador de conteúdo de CI são automaticamente delimitados para seu projeto do LookML. O escopo do validador de conteúdo do CI é pós-processado: ele é 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 é compatível com o seguinte:
- O Validador de conteúdo do Looker só pode ser executado manualmente.
- É possível definir o escopo do validador de conteúdo do Looker para pastas de conteúdo específicas ou para projetos do LookML específicos. O escopo do validador de conteúdo do Looker ocorre antes da validação: ele é executado apenas nas pastas e projetos especificados quando você iniciou a validação de conteúdo.
- Você pode usar o validador de conteúdo do Looker para substituir nomes de campos, visualizações, análises e modelos, remover campos e excluir Looks.
Consulte a seção Opções do validador de conteúdo desta página para saber quais opções podem ser configuradas ao criar ou editar um pacote de CI. Para informações sobre como executar o Content Validator, consulte a página de documentação Como executar pacotes de integração contínua.
Na página de resultados da execução, o Validador de conteúdo mostra a mensagem de erro para cada visual ou painel 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 conjunto 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:
- Análises para consulta
- Análises para excluir
- Pastas para validação
- Pastas a serem excluídas
- Excluir conteúdo em espaços 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 no seu projeto do LookML.
Use o campo Análises detalhadas para consulta para especificar as análises detalhadas 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 com os nomes 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 sobre como especificar análises e modelos nesse campo.
Análises para excluir
Por padrão, o validador de conteúdo vai executar a validação de conteúdo em todos os modelos e análises no seu projeto do LookML.
Use o campo Análises a serem excluídas para especificar as análises 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 sobre como especificar análises e modelos nesse campo.
Pastas para validar
É possível definir o escopo da validação de conteúdo para pastas de conteúdo específicas na sua instância do Looker especificando um ID de pasta ou uma lista de IDs de pastas separados por vírgulas.
Para conferir o ID de uma pasta, use o menu de navegação principal do Looker para abrir a pasta e, em seguida, extraia o ID da pasta 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 para excluir
É 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 espaços 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 espaços pessoais. Quando o campo Excluir conteúdo em espaços 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 de encontrar erros exclusivos de uma ramificação de desenvolvimento específica, erros que ainda não existem na 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 que foi ignorada porque não tinha alterações no SQL compilado no branch ou commit que estava sendo validado. Consulte Como conferir os resultados da validação incremental para conferir 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 Only incremental errors na seção Content Validator ao criar ou editar um pacote de integração contínua.
Observe o seguinte para a validação incremental:
- A configuração de validação incremental não se aplica quando o Content Validator está validando a própria ramificação de produção, como em execuções manuais na ramificação de produção. Ao validar a ramificação de produção, o Content Validator 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 poderá mais ser associado ao projeto que está sendo testado.