Referenz Power Query SDK-Testframework

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

Diese Referenz verwendet das Power Query SDK-Testframework, eine standardisierte Testsammlung 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 Erweiterungskonnektors 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 einsatzbereite Testumgebung mit vorgefertigten Tests, um die Tests neuer und von vorhandenen Erweiterungskonnektoren 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 Erweiterungskonnektors installieren. Die Visual Studio Code-Erweiterung umschließt das NuGet-Paket "Microsoft.PowerQuery.SdkTools", das auch die Testumgebungs-PQTest.exe enthält. Die PQTest-Testumgebung enthält den neuen Vergleichsbefehl, um die im Testframework vorhandenen Tests auszuführen.
2. Klonen Sie die DataConnectors-GitHub-Repository: Klonen Sie die DataConnectors GitHub-Repository um auf die im Testframework enthaltenen Testdaten und Tests zuzugreifen. Weitere Informationen zu diesen Tests finden Sie unter PowerQuery SDK-Testframework Teil 3 – Testsammlung.
3. Laden Sie die Testdaten in die Datenquelle: Der Connectorentwickler muss die Testdaten laden, bestehend aus zwei CSV-Dateien, als Tabellen zu ihrer Datenquelle, wodurch sichergestellt wird, dass das Schema mit der bereitgestellten SQL-Schemadatei übereinstimmt. Weitere Informationen finden Sie unter Power Query SDK-Testframework Teil 2 – Testsammlung.
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 Erweiterungskonnektors.
5. Berichte und CI/CD: Der Standardtestbericht wird in der Konsole generiert und es gibt auch Optionen zum Generieren des Berichts in zusammenfassenden, detaillierten, TRX- und JSON-Formaten. Das TRX-Format (Visual Studio Testergebnis-Datei) ist nützlich, um die Ergebnisse anzuzeigen, wenn sie als Teil einer Pipeline ausgeführt werden. Weitere Informationen finden Sie unter Power Query SDK-Testframework Teil 7 – Pipeline-Anleitung.

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 Erweiterungskonnektors zu testen. Es sollte die Entwicklererfahrung für die Entwicklung der Connectors erheblich verbessern. Sie sollte auch die Standardisierung auf eher fragmentierte Testpraktiken bringen, nach und nach den Qualitätsstandard erhöhen und die Erhaltungsbemühungen der Connectoren verringern. Wir sehen uns auch das Testframework an, um den Connector-Zertifizierungsprozess zu verbinden und die Erfahrung für die Partner zu verbessern.

Die Ziele der ersten Veröffentlichung des Testframeworks sind:

• Leicht zu bedienende Befehlszeilen-Hilfsprogramme für Benutzer zum einfachen Testen ihrer Erweiterungskonnektors: Das Testframework führt den PQTest-Vergleichsbefehl mit intuitiven Optionen ein, um die Tests auszuführen. 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.
• Ready-to-go anfänglicher Satz von Standardtests zur Überprüfung eines Connectors: 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 Standardtestsammlung 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. Connector-Entwickler 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 Query Folding-Tests: Das Testframework kann auch die Diagnose für einen Connector generieren. Derzeit ist die Diagnosefunktion während dem Query Folding für einen ODBC-basierten Connector auf die SQL-Abfragegenerierung beschränkt. Diese Funktion wird künftig auf andere Diagnose erweitert.

Übersicht über die Referenz-Anleitung

In dieser Anleitung werden Sie:

• 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 Testsammlung verwendet wird, und laden Sie es basierend auf Ihrem Erweiterungskonnektor 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 Erweiterungskonnektors 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

Teil	section	Details
1	Einstellungen	Einrichten Ihrer Umgebung.
2	Vorbereiten der Daten	Vorbereiten von Testdaten.
3	Testsammlung	Abrufen und Verstehen der Testsammlung.
4	Testformatspezifikation	Grundlegendes zu verschiedenen Dateiformaten, die im Testframework verwendet werden.
5	Konnektor-Prüfung	Testen des Erweiterungskonnektors.
6	Hinzufügen von Tests	Hinzufügen eigener Tests und Grundlegendes zu verschiedenen Optionen und Konfigurationen im Testframework.
7	Anleitung zum Einrichten von Pipelines	Ausführen der Tests in einer Pipeline.