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

Esta referência com várias partes aborda a configuraçã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 em sequência para garantir que o ambiente esteja configurado para o teste do 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 corridas verdes da Comissão de táxis e limusines de Nova York (TLC). Nas seções posteriores você verá 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 agente de teste para verificar as funcionalidades do DirectQuery (DQ) de um conector de extensão. Essa nova funcionalidade oferece aos desenvolvedores uma maneira padrão de verificar conectores e uma plataforma para a adição de testes personalizados. Vemos essa novidade como a primeira etapa para aprimorar 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 agente de teste pronto para uso com testes predefinidos para padronizar o teste dos conectores de extensão novos e existentes. A estrutura tem a capacidade de execução de testes funcionais, de conformidade e de regressão em escala. Ela ajuda a proporcionar a estrutura de teste abrangente para atender às necessidades dos conectores de extensão.

Fluxo de trabalho para desenvolvedores

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

1. Instalar a extensão do Visual Studio Code do SDK do Power Query: os desenvolvedores de conector precisam instalar a extensão do Visual Studio Code do SDK do Power Query para desenvolver conectores de extensão. A extensão do Visual Studio Code encapsula o pacote NuGet Microsoft.PowerQuery.SdkTools, que também contém o agente de teste PQTest.exe. O agente de teste PQTest contém o novo comando compare para executar os testes presentes na estrutura de teste.
2. Clonar 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 mais detalhes sobre esses testes, acesse Estrutura de teste do SDK do Power Query, parte 3 – Conjunto de testes.
3. Carregar os dados de teste na fonte de dados: desenvolvedores de conector precisam carregar os dados de teste, contidos em dois arquivos CSV, como tabelas na fonte de dados. Dessa forma, o esquema corresponderá ao arquivo de esquema SQL fornecido. Para mais detalhes, acesse Estrutura de teste do SDK do Power Query, parte 2 – Dados de teste.
4. Configurar e executar os testes: desenvolvedores de conector precisam executar os testes usando o utilitário do PowerShell RunPQSDKTestSuites fornecido, que usa o comando compare do PQTest para executar os testes. Para mais detalhes, acesse Estrutura de teste do SDK do Power Query, parte 5 – Como testar seu conector de extensão.
5. Relatório e CI/CD: o relatório de teste padrão é gerado no console. Também há opções para gerar o relatório nos formatos de resumo, detalhado, TRX e JSON. O formato TRX (arquivo de resultados de teste do Visual Studio) é útil para exibir os resultados quando são executados como parte de pipelines. Para mais detalhes, acesse 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 é oferecer uma solução de teste robusta e integrada ao SDK do Visual Studio Code para testar conectores de extensão. A estrutura deve melhorar muito a experiência de desenvolvimento de conectores dos desenvolvedores. Ela também deve promover uma padronização para práticas de teste fragmentadas, consequentemente aumentando a qualidade e diminuindo os esforços de sustentação dos conectores. Também prevemos que a estrutura de teste se conectará ao processo de certificação de conectores e aprimorará a experiência dos parceiros.

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

• Utilitário de linha de comando fácil de usar para os usuários testarem com facilidade seus conectores de extensão: a estrutura de teste introduz o comando compare do PQTest com opções intuitivas para executar os testes. Ela também fornece o utilitário do PowerShell RunPQSDKTestSuites, que também ajuda na execução de testes em lote. Configurações fáceis e automáticas são oferecidas para configurar e executar os testes.
• Conjunto inicial pronto para uso de testes padrão a serem executados para verificar conectores: a estrutura de teste oferece 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 funções matemáticas, de tipos de dados, de data, de hora, de texto, operadores e junções.
• Forma fácil de adicionar testes manualmente para estender os testes: os testes na estrutura de teste usam o novo formato de teste PQ/PQOut, que simplifica o processo de criação de teste ao reduzir as configurações necessárias. Os desenvolvedores de conectores podem se concentrar na criação da consulta M para os 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 testes de dobragem de consultas: a estrutura de teste também gera o diagnóstico para os conectores. Atualmente, o recurso de diagnóstico é limitado à geração de consultas SQL durante a dobragem de consultas para um conector baseado em ODBC. Essa funcionalidade será estendida a outros diagnósticos no futuro.

Visão geral do guia de referência

Neste guia, você vai:

• Conhecer a estrutura de teste do SDK do Power Query.
• Aprender a configurar o ambiente de desenvolvimento por meio da instalação da estrutura de teste.
• Efetuar fetch do conjunto de dados usado no conjunto de testes e carregá-lo em uma fonte de dados baseada no conector de extensão.
• Compreender as especificações de formato de teste, ou seja, os formatos de arquivo e suas funcionalidades dentro da estrutura de teste.
• Efetuar fetch e executar o conjunto de testes que contém os testes para validar o conector de extensão.
• Executar testes individuais com configurações diferentes.
• Adicionar os próprios testes para verificar a funcionalidade específica do conector.
• Automatizar as execuções de teste ao configurar um pipeline para os testes.

Partes

Parte	section	Detalhes
1	Configuração	Configure seu ambiente.
2	Preparar dados	Preparar dados de teste.
3	Conjunto de testes	Efetuar fetch e entender o conjunto de testes.
4	Especificação de formato de teste	Compreender vários formatos de arquivo usados na estrutura de teste.
5	Testes do conector	Testar o conector de extensão.
6	Adicionar testes	Adicionar os próprios testes e entender várias opções e configurações na estrutura de teste.
7	Guia de configuração de pipeline	Executar testes em um pipeline.