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

Esta referência com várias partes abrange a configuração e a execução de um conjunto padrão de testes para programadores de conectores do Power Query. A referência deve ser seguida sequencialmente para garantir que seu ambiente esteja configurado para testar seu conector de extensão.

Esta 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 NewYork City Taxi & Limousine Commission (TLC). As seções subsequentes percorrem as etapas para configurar o ambiente 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 conjunto de testes para verificar os recursos do DirectQuery (DQ) de um conector de extensão. Com esse novo recurso, os desenvolvedores têm uma maneira padrão de verificar conectores e uma plataforma para adicionar testes personalizados. Imaginamos isso como o primeiro passo para melhorar 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 conjunto de testes pronto a utilizar com testes pré-construídos 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 satisfazer as necessidades de 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. Instalar a extensão de código do Visual Studio do SDK do Power Query: um desenvolvedor de conector precisa instalar a extensão de código do Visual Studio do SDK do PowerQuery para desenvolver um conector de extensão. A extensão Visual Studio Code encapsula o pacote NuGet Microsoft.PowerQuery.SdkTools, que também contém PQTest.exe de conjunto de teste. O conjunto de teste PQTest contém o novo comando compare para executar os testes presentes na estrutura de teste.
2. Clone the DataConnectors GitHub Repo: Clone the DataConnectors GitHub repo para acessar os dados de teste e testes contidos na estrutura de teste. Para obter mais detalhes sobre esses testes, vá para PowerQuery SDK test framework part 3 - Test suite.
3. Carregue os dados de teste para a fonte de dados: O desenvolvedor do conector tem que 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, vá para a estrutura de teste do SDK do Power Query, parte 2 - Dados de teste.
4. Configurar e executar os testes: O desenvolvedor do conector deve executar os testes usando o utilitário RunPQSDKTestSuites PowerShell fornecido, que usa o comando PQTest compare para executar os testes. Para obter mais detalhes, vá para a estrutura de teste do SDK do Power Query, parte 5 - Testando seu conector de extensão.
5. Reporting & CI/CD: O relatório de teste padrão é gerado no console e também há opções para gerar o relatório nos 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, vá para a estrutura de teste do SDK do Power Query, parte 7 - Guia de pipeline.

Objetivos da estrutura de teste

O objetivo 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. Também deve trazer padronização para práticas de teste bastante fragmentadas, eventualmente aumentando a barra de qualidade e diminuindo os esforços de sustentação dos conectores. Também imaginamos a estrutura de teste para se conectar ao processo de certificação do conector e melhorar a experiência para os parceiros.

Os objetivos da versão inicial da estrutura de teste são fornecer:

• Utilitário de linha de comando fácil de usar para que os usuários testem facilmente seus conectores de extensão: A estrutura de teste introduz o comando PQTest compare com opções intuitivas para executar os testes. Ele também fornece o utilitário PowerShell RunPQSDKTestSuites, que também ajuda com testes em lote. Configurações fáceis e automáticas são fornecidas para configurar e executar os testes.
• Conjunto inicial pronto para uso 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 do conector 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 o dobramento de consulta para um conector baseado em ODBC. Essa capacidade será estendida a 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.
• Aprenda a configurar o ambiente de desenvolvimento instalando a estrutura de teste.
• Buscar o conjunto de dados usado no conjunto de testes e carregá-lo em uma fonte de dados com base no conector de extensão.
• Compreenda as especificações de formato de teste que são, os formatos de arquivo e sua funcionalidade dentro da estrutura de teste.
• Procure 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 a funcionalidade específica do conector.
• Automatize as execuções de teste configurando um pipeline para os testes.

Partes