A validação de conteúdo de integração contínua (IC) identifica painéis de controlo e Looks com erros. Muitas vezes, estes erros são causados por referências em falta a campos do LookML.
O validador de conteúdo de CI executa uma validação semelhante à do validador de conteúdo do Looker padrão, com algumas diferenças:
O validador de conteúdo de CI suporta o seguinte:
- Pode configurar o validador de conteúdo de CI para ser executado automaticamente quando um programador do Looker envia um pedido de envio para o seu repositório LookML ou manualmente quando executa manualmente um conjunto de CI.
- Pode restringir os resultados da Validação de conteúdo de CI a pastas de conteúdo específicas do Looker ou a modelos e explorações específicos no seu projeto LookML. Por predefinição, os resultados do validador de conteúdo de IC são automaticamente definidos para o seu projeto do LookML. O âmbito da validação de conteúdo da CI é pós-processamento: o validador é executado na instância completa do Looker e, em seguida, filtra os resultados para o âmbito especificado quando criou o conjunto de testes de CI.
O validador de conteúdo do Looker padrão suporta o seguinte:
- Só pode executar o validador de conteúdo do Looker manualmente.
- Pode restringir a Validação de conteúdo do Looker a pastas de conteúdo específicas do Looker ou a projetos específicos do LookML. A definição do âmbito da Validação de conteúdo do Looker ocorre antes da validação: o validador é executado apenas nas pastas e nos projetos que especificou quando iniciou a validação de conteúdo.
- Pode usar o validador de conteúdo do Looker para substituir nomes de campos, vistas, Explores e modelos, remover campos e eliminar Looks.
Consulte a secção Opções do validador de conteúdo desta página para ver detalhes sobre as opções que pode configurar quando cria ou edita um conjunto de CI. Para obter informações sobre a execução do validador de conteúdo, consulte a página de documentação Executar conjuntos de integração contínua.
Na página de resultados da execução, o validador de conteúdo apresenta a mensagem de erro para cada Look ou painel de controlo com erros, juntamente com um link para o conteúdo:
Opções de validação de conteúdo
Pode especificar várias opções quando cria um conjunto de integração contínua para configurar a forma como o Content Validator é executado. As opções estão descritas nas seguintes secções desta página:
- Explores a consultar
- Explores a excluir
- Pastas a validar
- Pastas a excluir
- Exclua conteúdo em pastas pessoais
- Validação incremental
Explorações a consultar
Por predefinição, a Validação de conteúdo executa a validação de conteúdo em todos os modelos e elementos Explorar no seu projeto LookML.
Pode usar o campo Explorações a consultar para especificar a exploração e os modelos que quer incluir na validação de conteúdo.
Pode especificar as explorações no seguinte formato: model_name/explore_name
Por exemplo, para especificar as explorações denominadas users e orders no ficheiro thelook.model.lkml, introduziria o seguinte: thelook/users, thelook/orders
Consulte a página de documentação do validador de SQL para ver mais informações e exemplos de como especificar explorações e modelos neste campo.
Explorações a excluir
Por predefinição, a Validação de conteúdo executa a validação de conteúdo em todos os modelos e elementos Explorar no seu projeto LookML.
Pode usar o campo Explorações a excluir para especificar a exploração e os modelos que quer excluir da validação de conteúdo.
Pode especificar as explorações no seguinte formato: model_name/explore_name
Consulte a página de documentação do validador de SQL para ver mais informações e exemplos de como especificar explorações e modelos neste campo.
Pastas a validar
Pode restringir a validação de conteúdo a 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 obter o ID de uma pasta, use o menu de navegação principal do Looker para abrir a pasta e, em seguida, obter o ID da pasta a partir do URL do navegador. O ID da pasta é o último elemento do URL. Por exemplo, no URL seguinte, o ID da pasta é 45:
https://myinstance.looker.com/folders/45
Pastas a excluir
Pode 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 excluir.
Exclua conteúdo em pastas pessoais
Se quiser que a Validação de conteúdo valide apenas conteúdo em pastas partilhadas, ative o campo Excluir conteúdo em pastas pessoais. Quando o campo Excluir conteúdo em pastas pessoais está ativado, a Validação de conteúdo ignora o conteúdo nas pastas pessoais na sua instância do Looker.
Validação incremental
A validação incremental é um método de deteção de erros exclusivos de um ramo de desenvolvimento específico, ou seja, erros que ainda não existem em produção. A validação incremental ajuda os programadores a encontrar e corrigir os erros pelos quais são responsáveis sem se distraírem com os erros existentes no projeto. Também pode tornar a validação mais rápida, especialmente para projetos LookML que contêm muitos elementos Explorar.
Nos resultados da validação, o validador de conteúdo indica cada análise detalhada que foi ignorada porque não tinha alterações ao respetivo SQL compilado na ramificação ou na confirmação que estava a ser validada. Consulte o artigo Ver resultados da validação incremental para ver um exemplo de resultados da validação incremental.
Pode ativar a validação incremental para o validador de conteúdo selecionando a caixa de verificação Apenas erros incrementais na secção Validador de conteúdo quando cria ou edita um conjunto de integração contínua.
Tenha em atenção o seguinte para a validação incremental:
- A definição de validação incremental não se aplica quando o validador de conteúdo está a validar o próprio ramo de produção, como com execuções manuais no ramo de produção. Quando valida o ramo de produção, a Validação de conteúdo mostra a validação de resultados completa.
Limitações da validação de conteúdo
Se eliminar um modelo ou alterar o respetivo nome, a Validação de conteúdo não devolve estes erros de conteúdo "pendentes", porque o modelo já não pode ser associado ao projeto que está a ser testado.