Referência da estrutura de teste do SDK do Power Query

Essa referência de várias partes aborda a instalação e a execução de um conjunto padrão de testes para desenvolvedores do conector do Power Query. A referência deve ser seguida sequencialmente para garantir que seu ambiente esteja configurado para testar seu conector de extensão.

Essa referência usa a estrutura de teste do SDK do Power Query, um conjunto de testes padronizado e uma versão modificada dos dados de registro de viagem verde da TLC (NewYork City Taxi &Limão Commission ). As seções subsequentes percorrem as etapas para fazer com que o ambiente seja configurado para validar o conector de extensão.

A estrutura de teste permite que os desenvolvedores do SDK do Power Query tenham acesso a testes padrão e a um arreio de teste para verificar os recursos do DirectQuery (DQ) de um conector de extensão. Com essa nova funcionalidade, os desenvolvedores têm uma maneira padrão de verificar conectores e uma plataforma para adicionar testes personalizados. Imaginamos isso como a primeira etapa para aumentar a produtividade do fluxo de trabalho de teste fornecido pelo SDK do Power Query.

O que é a estrutura de teste do SDK do Power Query?

A estrutura de teste do SDK do Power Query é um arreio de teste prontoto-go com testes predefinidos para padronizar o teste de conectores de extensão novos e existentes. Ele tem a capacidade de executar testes funcionais, de conformidade e de regressão em escala. Ele ajuda a atender à necessidade de uma estrutura de teste abrangente para atender às necessidades dos conectores de extensão.

Fluxo de trabalho para um desenvolvedor

A lista a seguir é o fluxo de trabalho típico do desenvolvedor do SDK do Power Query com a estrutura de teste:

1. Instale a extensão do SDK do Power Query no Visual Studio Code: Um desenvolvedor de conector precisa instalar a extensão do Visual Studio Code do SDK do PowerQuery para desenvolver um conector de extensão. A extensão do Visual Studio Code encapsula o pacote NuGet Microsoft.PowerQuery.SdkTools, que também contém PQTest.exede arreios de teste. O arreio de teste do PQTest contém o novo comando compare para executar os testes presentes na estrutura de teste.
2. Clone o repositório GitHub do DataConnectors: Clone o repositório GitHub do DataConnectors para acessar os dados de teste e os testes contidos na estrutura de teste. Para obter mais detalhes sobre esses testes, acesse a estrutura de teste do SDK do PowerQuery parte 3 – Pacote de testes.
3. Carregue os dados de teste na fonte de dados: O desenvolvedor do conector precisa carregar os dados de teste, consistindo em dois arquivos CSV, como tabelas para sua fonte de dados, o que garante que o esquema corresponda ao arquivo de esquema SQL fornecido. Para obter mais detalhes, acesse a estrutura de teste do SDK do Power Query parte 2 – Testar dados.
4. Configure e execute os testes: O desenvolvedor do conector precisa executar os testes usando o utilitário RunPQSDKTestSuites PowerShell fornecido, que usa o comando de comparação PQTest para executar os testes. Para obter mais detalhes, acesse a estrutura de teste do SDK do Power Query parte 5 – Testando seu conector de extensão.
5. Relatórios e CI/CD: O relatório de teste padrão é gerado no console e também há opções para gerar o relatório em formatos resumo, detalhado, TRX e JSON. O formato TRX (arquivo de resultados de teste do Visual Studio) é útil para exibir os resultados quando eles são executados como parte de um pipeline. Para obter mais detalhes, acesse a estrutura de teste do SDK do Power Query parte 7 – Guia do pipeline.

Metas da estrutura de teste

A meta de longo prazo da estrutura de teste do SDK do Power Query é fornecer uma solução de teste robusta integrada ao SDK do Visual Studio Code para testar conectores de extensão. Ele deve melhorar muito a experiência do desenvolvedor para o desenvolvimento dos conectores. Ele também deve trazer a padronização para práticas de teste bastante fragmentadas, aumentando eventualmente a barra de qualidade e diminuindo os esforços de sustentação dos conectores.

As metas da versão inicial da estrutura de teste são fornecer:

• Utilitário de linha de comando fácil de usar para os usuários testarem facilmente seus conectores de extensão: A estrutura de teste apresenta o comando de comparação PQTest com opções intuitivas para executar os testes. Ele também fornece o utilitário Do PowerShell RunPQSDKTestSuites, que também ajuda no teste em lote. Configurações fáceis e automáticas são fornecidas para configurar e executar os testes.
• Pronto-to-go conjunto inicial de testes padrão a serem executados para verificar um conector: A estrutura de teste fornece um conjunto de testes de sanidade para validar o esquema, a contagem de linhas e os dados das tabelas de teste. Ele também fornece um conjunto de testes padrão para verificar tipos de dados, matemática, data, hora, funções de texto, operadores e junções.
• Maneira fácil de adicionar testes manualmente para estender o teste: Os testes na estrutura de teste usam o novo formato de teste PQ/PQOut, que simplifica o processo de criação de teste minimizando as configurações necessárias. Os desenvolvedores de conectores podem então se concentrar na criação da consulta M para seus testes. Cada teste é modular e separado em arquivos individuais para simplificar a manutenção. A saída esperada também é gerada na primeira execução.
• Capacidade de testar testes de dobragem de consulta: A estrutura de teste também pode gerar o diagnóstico para um conector. Atualmente, o recurso de diagnóstico é limitado à geração de consulta SQL durante a dobragem de consulta para um conector baseado em ODBC. Esse recurso será estendido para outros diagnósticos no futuro.

Visão geral do guia de referência

Neste guia, você:

• Obtenha uma compreensão da estrutura de teste do SDK do Power Query.
• Saiba como configurar o ambiente de desenvolvimento instalando a estrutura de teste.
• Busque o conjunto de dados usado no conjunto de testes e carregue-o em uma fonte de dados com base no conector de extensão.
• Entenda as especificações de formato de teste que são, os formatos de arquivo e suas funcionalidades dentro da Estrutura de Teste.
• Busque e execute o conjunto de testes que contém os testes para validar o conector de extensão.
• Execute testes individuais com configurações diferentes.
• Adicione seus próprios testes para verificar sua funcionalidade específica do conector.
• Automatize as execuções de teste configurando um pipeline para os testes.

Partes