O validador de declarações 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. Para testes de dados com falha, o validador de declarações 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ções 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ções, 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ções mostra os resultados de cada teste de dados. Para testes de dados com falha, o validador de declarações mostra o erro ou erros, da seguinte maneira:
Opções do validador de declarações
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ções é executado. As opções são descritas nas seções a seguir desta página:
Análises a serem consultadas
Por padrão, o validador de declarações executa cada teste de dados no seu projeto do LookML.
Os testes de dados são definidos usando um explore_source parâmetro que aponta para uma análise no seu projeto. Você pode usar o campo Análises a serem consultadas para limitar a validação de declarações 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 a serem excluídas
Por padrão, o validador de declarações executa cada teste de dados no seu projeto do LookML. Você pode usar o campo Análises a serem excluídas para excluir da validação de declarações análises específicas em que os testes de dados são baseados. O validador de declarações 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ções 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ções 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ções, diminua esse valor.