Referencia del marco de pruebas del SDK de Power Query

Esta referencia de varias partes abarca la configuración y ejecución de un conjunto estándar de pruebas para desarrolladores de conectores de Power Query. La referencia está pensada para seguirse secuencialmente a fin de asegurarse de que el entorno está configurado para probar el conector de extensión.

Esta referencia usa el marco de pruebas del SDK de Power Query, un conjunto de pruebas estandarizado y una versión modificada de los datos de registro de carreras verdes de NewYork City Taxi & Limousine Commission (TLC). En las secciones siguientes se describen los pasos para configurar el entorno a fin de validar el conector de extensión.

El marco de pruebas permite a los desarrolladores del SDK de Power Query tener acceso a pruebas estándar y a una herramienta de ejecución de pruebas para comprobar las funcionalidades de DirectQuery (DQ) de un conector de extensión. Con esta nueva funcionalidad, los desarrolladores tienen una manera estándar de comprobar los conectores y una plataforma para agregar pruebas personalizadas. Esto se prevé como el primer paso para mejorar la productividad del flujo de trabajo de prueba proporcionado por el SDK de Power Query.

¿Qué es el marco de pruebas del SDK de Power Query?

El marco de pruebas del SDK de Power Query es una herramienta de ejecución de pruebas lista para usar con pruebas precompiladas a fin de estandarizar las pruebas de conectores de extensión nuevos y existentes. Tiene la capacidad de realizar pruebas funcionales, de cumplimiento y regresión a escala. Ayuda a abordar la necesidad de un marco de prueba completo para satisfacer las necesidades de los conectores de extensión.

Flujo de trabajo para desarrolladores

La lista siguiente es el flujo de trabajo típico para desarrolladores del SDK de Power Query con el marco de pruebas:

1. Instale la extensión Visual Studio Code del SDK de Power Query: un desarrollador del conector tiene que instalar la extensión de Visual Studio Code del SDK de PowerQuery para desarrollar un conector de extensión. La extensión de Visual Studio Code incluye el paquete NuGet Microsoft.PowerQuery.SdkTools, que también contiene la herramienta de ejecución de pruebas PQTest.exe. La herramienta de ejecución de pruebas de PQTest contiene el nuevo comando compare para ejecutar las pruebas presentes en el marco de pruebas.
2. Clone el repositorio de GitHub Data Connectors: Clone el repositorio de GitHub Data Connectors para acceder a los datos de prueba y las pruebas contenidas en el marco de pruebas. Para obtener más información sobre estas pruebas, vaya a Marco de pruebas del SDK de PowerQuery, parte 3: conjunto de pruebas.
3. Cargar los datos de prueba en el origen de datos: el desarrollador del conector tiene que cargar los datos de prueba, que constan de dos archivos CSV, como tablas a su origen de datos, lo que garantiza que el esquema coincida con el archivo de esquema SQL proporcionado. Para obtener más información, vaya a Marco de pruebas del SDK de PowerQuery, parte 2: datos de pruebas.
4. Configure y ejecute las pruebas: el desarrollador del conector tiene que ejecutar las pruebas mediante la utilidad de PowerShell RunPQSDKTestSuites proporcionada, que usa el comando PQTest compare para ejecutar las pruebas. Para obtener más información, vaya a Marco de pruebas del SDK de PowerQuery, parte 5: probar el conector de extensión.
5. Reporting & CI/CD: el informe de prueba predeterminado se genera en la consola y también hay opciones para generar el informe en formatos resumen, detallado, TRX y JSON. El formato TRX (archivo de resultados de pruebas de Visual Studio) es útil para ver los resultados cuando se ejecutan como parte de una canalización. Para obtener más información, vaya a Marco de pruebas del SDK de PowerQuery, parte 7: guía de canalización.

Objetivos del marco de pruebas

El objetivo a largo plazo del marco de pruebas del SDK de Power Query es proporcionar una solución de prueba sólida integrada con el SDK de Visual Studio Code para probar los conectores de extensión. Debe mejorar considerablemente la experiencia del desarrollador para el desarrollo de los conectores. También debe llevar la estandarización a prácticas de prueba fragmentadas, aumentando eventualmente la barra de calidad y disminuyendo los esfuerzos de mantenimiento de los conectores. También se prevé el marco de pruebas para conectar el proceso de certificación del conector y mejorar la experiencia de los asociados.

Los objetivos de la versión inicial del marco de pruebas son proporcionar:

• Utilidad de línea de comandos fácil de usar para que los usuarios prueben fácilmente sus conectores de extensión: el marco de pruebas presenta el comando de PQTest compare con opciones intuitivas para ejecutar las pruebas. También proporciona la utilidad RunPQSDKTestSuites de PowerShell, que también ayuda con las pruebas por lotes. Se proporcionan configuraciones fáciles y automáticas para configurar y ejecutar las pruebas.
• Conjunto inicial listo para usar de pruebas estándar que se ejecutarán para comprobar un conector: el marco de pruebas proporciona un conjunto de pruebas de integridad para validar el esquema, el recuento de filas y los datos de las tablas de prueba. También proporciona un conjunto de pruebas estándar para comprobar tipos de datos, matemáticas, fecha, hora, funciones de texto, operadores y combinaciones.
• Forma sencilla de agregar pruebas manualmente para ampliar las pruebas: las pruebas del marco de pruebas usan el nuevo formato de prueba PQ/PQOut, lo que simplifica el proceso de creación de pruebas minimizando las configuraciones necesarias. Los desarrolladores del conector pueden centrarse en crear la consulta M para sus pruebas. Cada prueba es modular y se separa en archivos individuales para simplificar el mantenimiento. La salida esperada también se genera en la primera ejecución.
• Capacidad de probar pruebas de plegado de consultas: el marco de pruebas también puede generar los diagnósticos de un conector. Actualmente, la funcionalidad de diagnóstico se limita a la generación de consultas SQL durante el plegado de consultas para un conector basado en ODBC. Esta funcionalidad se extenderá a otros diagnósticos en el futuro.

Información general de la guía de referencia

En esta guía, hará lo siguiente:

• Obtener información sobre el marco de pruebas del SDK de Power Query.
• Aprender a configurar el entorno de desarrollo mediante la instalación del marco de pruebas.
• Capturar el conjunto de datos usado en el conjunto de pruebas y cargarlo en un origen de datos basado en el conector de extensión.
• Comprender las especificaciones de formato de prueba, los formatos de archivo y su funcionalidad dentro del marco de pruebas.
• Capturar y ejecutar el conjunto de pruebas que contiene las pruebas para validar el conector de extensión.
• Ejecutar pruebas individuales con distintas configuraciones.
• Agregar sus propias pruebas para comprobar la funcionalidad específica del conector.
• Automatizar las ejecuciones de pruebas mediante la configuración de una canalización para las pruebas.

Partes

Parte	section	Detalles
1	Configuración	Configure el entorno.
2	Preparación de los datos	Preparación de datos de prueba.
3	Conjunto de pruebas	Captura y comprensión del conjunto de pruebas.
4	Especificación de formato de prueba	Descripción de varios formatos de archivo usados en el marco de pruebas.
5	Pruebas del conector	Prueba del conector de extensión.
6	Adición de pruebas	Agregar sus propias pruebas y comprender varias opciones y configuraciones en el marco de pruebas.
7	Guía de configuración de canalización	Ejecución de las pruebas en una canalización.