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 para 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 para 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 un arnés 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 un arnés de pruebas listo parato-go con pruebas precompiladas para 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 un desarrollador

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 de Visual Studio Code del SDK de Power Query: Un desarrollador de conectores 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 el arnés de pruebas PQTest.exe. El arnés 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 DataConnectors: Clone el repositorio de GitHub DataConnectors para acceder a los datos de prueba y las pruebas contenidas en el marco de pruebas. Para más información sobre estas pruebas, vaya al marco de pruebas del SDK de PowerQuery, parte 3: Conjunto de pruebas.
3. Cargue 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 en su origen de datos, lo que garantiza que el esquema coincida con el archivo de esquema SQL proporcionado. Para más información, vaya al marco de pruebas del SDK de Power Query, parte 2: Datos de prueba.
4. Configure y ejecute las pruebas: Después, el desarrollador del conector debe ejecutar las pruebas mediante la utilidad de PowerShell RunPQSDKTestSuites proporcionada, que usa el comando PQTest compare para ejecutar las pruebas. Para más información, vaya al marco de pruebas del SDK de Power Query, parte 5: Prueba del conector de extensión.
5. Informes y CI/CD: El informe de prueba predeterminado se genera en la consola y también hay opciones para generar el informe en formatos summary, detailed, 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 más información, vaya al marco de pruebas del SDK de Power Query, 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 finalmente la barra de calidad y disminuyendo los esfuerzos de mantenimiento de los conectores.

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 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.
• Listo:to-go conjunto inicial 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 al minimizar las configuraciones necesarias. Después, los desarrolladores de conectores pueden centrarse en la creación de 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, podrá:

• Obtenga información sobre el marco de pruebas del SDK de Power Query.
• Aprenda a configurar el entorno de desarrollo mediante la instalación del marco de pruebas.
• Capture el conjunto de datos usado en el conjunto de pruebas y cárguelo en un origen de datos basado en el conector de extensión.
• Comprenda las especificaciones de formato de prueba que son, los formatos de archivo y su funcionalidad dentro del marco de pruebas.
• Capture y ejecute el conjunto de pruebas que contiene las pruebas para validar el conector de extensión.
• Ejecute pruebas individuales con distintas configuraciones.
• Agregue sus propias pruebas para comprobar la funcionalidad específica del conector.
• Automatice las ejecuciones de pruebas mediante la configuración de una canalización para las pruebas.

Partes