Referenz zum Power Query SDK-Testframework

Diese mehrteilige Referenz behandelt das Einrichten und Ausführen einer Standardsuite von Tests für Power Query-Connectorentwickler. Der Verweis soll sequenziell befolgt werden, um sicherzustellen, dass Ihre Umgebung zum Testen des Erweiterungsconnectors eingerichtet ist.

Diese Referenz verwendet das Power Query SDK-Testframework, eine standardisierte Testsuite und eine modifizierte Version der NewYork City Taxi & Limousine Commission (TLC) Green Trip Record-Daten. In den nachfolgenden Abschnitten werden die Schritte zum Einrichten der Umgebung zum Überprüfen des Erweiterungsconnectors erläutert.

Das Testframework ermöglicht Es Power Query SDK-Entwicklern, Zugriff auf Standardtests und eine Testumgebung zu haben, um die DirectQuery-Funktionen (DQ) eines Erweiterungsconnectors zu überprüfen. Mit dieser neuen Funktion haben Entwickler eine Standardmethode zum Überprüfen von Connectors und einer Plattform zum Hinzufügen von benutzerdefinierten Tests. Wir sehen dies als ersten Schritt zur Steigerung der Produktivität des Testworkflows, der vom Power Query SDK bereitgestellt wird.

Was ist das Power Query SDK-Testframework?

Das Power Query SDK-Testframework ist eine einsatzbereiteto-go Testumgebung mit vorgefertigten Tests, um die Tests neuer und vorhandener Erweiterungsconnectors zu standardisieren. Sie verfügt über die Möglichkeit, funktions-, Compliance- und Regressionstests im großen Maßstab durchzuführen. Es hilft dabei, die Notwendigkeit eines umfassenden Testframeworks zu erfüllen, um die Anforderungen von Erweiterungsconnectors zu erfüllen.

Workflow für einen Entwickler

Die folgende Liste ist der typische Power Query SDK-Entwicklerworkflow mit dem Testframework:

1. Installieren Sie die Visual Studio Code-Erweiterung des Power Query SDK: Ein Connectorentwickler muss die PowerQuery SDK Visual Studio Code-Erweiterung für die Entwicklung eines Erweiterungsconnectors installieren. Die Visual Studio Code-Erweiterung umschließt das NuGet-Paket "Microsoft.PowerQuery.SdkTools", das auch Testumgebung PQTest.exeenthält. Die PQTest-Testumgebung enthält den neuen Vergleichsbefehl , um die im Testframework vorhandenen Tests auszuführen.
2. Klonen Sie das DataConnectors GitHub-Repo: Klonen Sie das DataConnectors GitHub-Repository , um auf die Testdaten und Tests zuzugreifen, die im Testframework enthalten sind. Weitere Informationen zu diesen Tests finden Sie unter PowerQuery SDK-Testframework Teil 3 – Testsuite.
3. Laden Sie die Testdaten in die Datenquelle: Der Connectorentwickler muss die Testdaten laden, bestehend aus zwei CSV-Dateien, als Tabellen für ihre Datenquelle, wodurch sichergestellt wird, dass das Schema mit der bereitgestellten SQL-Schemadatei übereinstimmt. Weitere Informationen finden Sie unter Power Query SDK-Testframework Teil 2 – Testdaten.
4. Konfigurieren und Ausführen der Tests: Der Connectorentwickler muss dann die Tests mit dem bereitgestellten RunPQSDKTestSuites PowerShell-Hilfsprogramm ausführen, das den PQTest-Vergleichsbefehl zum Ausführen der Tests verwendet. Weitere Informationen finden Sie unter Power Query SDK-Testframework Teil 5 – Testen des Erweiterungsconnectors.
5. Reporting & CI/CD: Der Standardtestbericht wird in der Konsole generiert, und es gibt auch Optionen zum Generieren des Berichts in zusammenfassungs-, detaillierten, TRX- und JSON-Formaten. Das TRX-Format (Visual Studio Test results file) ist nützlich, um die Ergebnisse anzuzeigen, wenn sie als Teil einer Pipeline ausgeführt werden. Weitere Informationen finden Sie im Power Query SDK-Testframework Teil 7 – Pipelinehandbuch.

Ziele des Testframeworks

Das langfristige Ziel des Power Query SDK-Testframeworks besteht darin, eine robuste Testlösung bereitzustellen, die in das Visual Studio Code SDK integriert ist, um Erweiterungsconnectors zu testen. Es sollte die Entwicklererfahrung für die Entwicklung der Connectors erheblich verbessern. Sie sollte auch die Standardisierung auf eher fragmentierte Testpraktiken bringen, schließlich die Qualitätsleiste erhöhen und die Erhaltungsbemühungen der Verbinder verringern.

Die Ziele der ersten Veröffentlichung des Testframeworks sind:

• Einfache Verwendung des Befehlszeilenprogramms für Benutzer, um ihre Erweiterungsconnectors einfach zu testen: Das Testframework führt den PQTest-Befehl mit intuitiven Optionen zum Ausführen der Tests ein. Es stellt auch das RunPQSDKTestSuites PowerShell-Hilfsprogramm bereit, das auch bei Batchtests hilft. Einfache und automatische Konfigurationen werden bereitgestellt, um die Tests zu konfigurieren und auszuführen.
• Bereit-to-go anfänglicher Satz von Standardtests, die ausgeführt werden sollen, um einen Connector zu überprüfen: Das Testframework stellt eine Reihe von Sanity-Tests bereit, um das Schema, die Zeilenanzahl und die Daten der Testtabellen zu überprüfen. Außerdem stellt sie eine Standardtestsuite bereit, um Datentypen, Mathematik, Datum, Uhrzeit, Textfunktionen, Operatoren und Verknüpfungen zu überprüfen.
• Mühelose Möglichkeit, Tests manuell hinzuzufügen, um die Tests zu erweitern: Die Tests im Testframework verwenden das neue PQ/PQOut-Testformat, das den Testerstellungsprozess vereinfacht, indem die erforderlichen Konfigurationen minimiert werden. Connectorentwickler können sich dann auf die Erstellung der M-Abfrage für ihre Tests konzentrieren. Jeder Test ist modular und in einzelne Dateien unterteilt, um die Wartung zu vereinfachen. Die erwartete Ausgabe wird auch bei der ersten Ausführung generiert.
• Möglichkeit zum Testen von Abfragefaltungstests: Das Testframework kann auch die Diagnose für einen Connector generieren. Derzeit ist die Diagnosefunktion während der Abfragefaltung für einen ODBC-basierten Connector auf die SQL-Abfragegenerierung beschränkt. Diese Funktion wird in Zukunft auf andere Diagnosen erweitert.

Übersicht über das Referenzhandbuch

In dieser Anleitung:

• Erhalten Sie ein Verständnis des Power Query SDK-Testframeworks.
• Erfahren Sie, wie Sie die Entwicklungsumgebung einrichten, indem Sie das Testframework installieren.
• Rufen Sie das dataset ab, das in der Testsuite verwendet wird, und laden Sie es basierend auf Ihrem Erweiterungsconnector in eine Datenquelle hoch.
• Grundlegendes zu Testformatspezifikationen, die Dateiformate und deren Funktionalität innerhalb des Testframeworks.
• Rufen Sie die Testsuite ab, die die Tests zum Überprüfen des Erweiterungsconnectors enthält, und führen Sie sie aus.
• Führen Sie einzelne Tests mit unterschiedlichen Konfigurationen aus.
• Fügen Sie Ihre eigenen Tests hinzu, um ihre connectorspezifische Funktionalität zu überprüfen.
• Automatisieren Sie Testausführungen, indem Sie eine Pipeline für die Tests einrichten.

Bestandteile