O validador de declaração de integração contínua (CI, na sigla em inglês) executa os testes de dados do LookML criados por desenvolvedores do Looker no seu projeto do LookML e mostra os resultados de cada teste de dados. Para testes de dados com falha, o validador de declaração mostra o erro.
Os testes de dados do LookML permitem validar a lógica do modelo do Looker. Os testes de dados podem testar suposições complexas, como as seguintes:
- A receita de maio do ano passado precisa ser igual a US $204.259.
- A taxa de conversão precisa ser maior que zero.
- O status do pedido não pode ser nulo.
Um teste de dados do LookML é composto por uma pequena explore_source consulta e uma yesno expressão de declaração, como no exemplo a seguir:
test: historic_revenue_is_accurate {
explore_source: orders {
column: total_revenue { field: orders.total_revenue }
filters: [orders.created_date: "2024"]
}
assert: revenue_is_expected_value {
expression: ${orders.total_revenue} = 626000 ;;
}
}
Consulte a seção Opções do validador de declaração desta página para detalhes sobre as opções que podem ser configuradas ao criar ou editar um conjunto de testes de CI. Para informações sobre como executar o validador de declaração, consulte a página de documentação Execução de conjuntos de testes de integração contínua.
Na página de resultados da execução, o validador de declaração mostra os resultados de cada teste de dados. Para testes de dados com falha, o validador de declaração mostra o erro ou erros, da seguinte maneira:
Opções do validador de declaração
Há várias opções que podem ser especificadas ao criar ou editar um conjunto de testes de integração contínua para configurar como o validador de declaração é executado. As opções são descritas nas seções a seguir desta página:
Análises para consulta
Por padrão, o validador de declaração executa cada teste de dados no seu projeto do LookML.
Os testes de dados são definidos usando um parâmetro explore_source que aponta para uma análise no seu projeto. Você pode usar o campo Análises para consulta para limitar a validação de declaração a análises específicas em que os testes de dados são baseados.
É 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 declaração executa cada teste de dados no seu projeto do LookML. Você pode usar o campo Análises para exclusão para excluir da validação de declaração análises específicas em que os testes de dados são baseados. O validador de declaração não executa testes de dados baseados nessas análises excluídas.
É 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.
Simultaneidade de consultas
Por padrão, o validador de declaração não executa mais de 10 consultas por vez para evitar sobrecarregar a instância do Looker. Você pode usar o campo Simultaneidade de consultas para especificar um número máximo diferente de consultas que o validador de declaração pode executar simultaneamente.
O valor máximo do campo Simultaneidade de consultas é limitado à configuração Número máximo de consultas simultâneas para esta conexão na conexão do banco de dados.
Se você notar uma lentidão na instância do Looker ao executar a validação de declaração, diminua esse valor.