Validador de afirmação de integração contínua

O validador de asserções de integração contínua (CI) executa os testes de dados do LookML criados por desenvolvedores do Looker no seu projeto LookML e mostra os resultados de cada teste. Para testes de dados com falha, o validador de asserções mostra o erro.

Com os testes de dados do LookML, é possível validar a lógica do seu modelo do Looker. Os testes de dados podem testar proposições complexas, como as seguintes:

  • A receita em maio do ano passado deve 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 consulta explore_source e uma yesno expressão de asserçã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 Assert 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 Assert Validator, consulte a página de documentação Executar pacotes de integração contínua.

Na página de resultados da execução, o Assert Validator mostra os resultados de cada teste de dados. Para testes de dados com falha, o Assert Validator mostra o erro ou os erros da seguinte maneira:

Página de resultados da integração contínua mostrando descobertas do Assert Validator

Opções do validador Assert

Há várias opções que podem ser especificadas ao criar ou editar um conjunto de integração contínua para configurar como o Assert Validator é 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 asserção executa cada teste de dados no seu projeto LookML.

Os testes de dados são definidos usando um parâmetro explore_source que aponta para uma análise detalhada no seu projeto. Você pode usar o campo Análises detalhadas para consultar e limitar a validação de asserções a análises detalhadas específicas em que seus testes de dados se baseiam.

É 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 asserção executa cada teste de dados no seu projeto LookML. Use o campo Análises detalhadas a serem excluídas para excluir da validação de asserção análises detalhadas específicas em que seus testes de dados se baseiam. O Assert Validator não executa testes de dados com base nessas análises detalhadas excluídas.

É 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.

Simultaneidade de consultas

Por padrão, o Assert Validator executa no máximo 10 consultas por vez para evitar sobrecarregar sua instância do Looker. Use o campo Simultaneidade de consultas para especificar um número máximo diferente de consultas que o Validador Assert 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 de banco de dados.

Se você notar uma lentidão na sua instância do Looker ao executar a validação de asserção, diminua esse valor.