Reference til Power Query SDK-teststruktur

Denne reference med flere dele dækker konfiguration og kørsel af en standardpakke med test til udviklere af Power Query-connectors. Referencen er beregnet til at blive fulgt sekventielt for at sikre, at dit miljø er konfigureret til at teste din udvidelsesconnector.

Denne reference bruger Power Query SDK-teststrukturen, en standardiseret testpakke og en ændret version af de grønne TLC-data (NewYork City Taxi & Limousine Commission). I de efterfølgende afsnit gennemgås trinnene for at få dit miljø konfigureret til at validere din udvidelsesconnector.

Teststrukturen gør det muligt for Udviklere af Power Query SDK at få adgang til standardtest og en test-sele til at bekræfte DirectQuery-funktionerne (DQ) for en udvidelsesconnector. Med denne nye funktion har udviklere en standardmulighed for at bekræfte connectors og en platform til tilføjelse af brugerdefinerede test. Vi forestiller os dette som det første skridt til at forbedre produktiviteten i den testarbejdsproces, der leveres af Power Query SDK.

Hvad er Test Framework til Power Query SDK?

Power Query SDK-teststrukturen er en klar til brug-test-sele med færdigbyggede test for at standardisere test af nye og eksisterende udvidelsesconnectors. Det har mulighed for at udføre funktions-, overholdelses- og regressionstest i stor skala. Det hjælper med at håndtere behovet for en omfattende teststruktur, der opfylder behovene for udvidelsesconnectors.

Arbejdsproces for en udvikler

Følgende liste er den typiske udviklerarbejdsproces i Power Query SDK med teststrukturen:

1. Installér udvidelsen Power Query SDK Visual Studio Code: En connectorudvikler skal installere udvidelsen PowerQuery SDK Visual Studio Code til udvikling af en udvidelsesconnector. Udvidelsen Visual Studio Code ombryder Pakken Microsoft.PowerQuery.SdkTools NuGet, som også indeholder testsele PQTest.exe. PQTest-test-selen indeholder den nye sammenligningskommando til udførelse af de test, der findes i teststrukturen.
2. Klon GitHub-lageret for data Forbind orer: Klon GitHub-lageret for data Forbind orer for at få adgang til testdataene og testene i teststrukturen. Du kan finde flere oplysninger om disse test i PowerQuery SDK-teststruktur del 3 – Testpakke.
3. Indlæs testdataene i datakilden: Connectorudvikleren skal indlæse testdataene, der består af to CSV-filer, som tabeller til deres datakilde, hvilket sikrer, at skemaet stemmer overens med den angivne SQL-skemafil. Du kan finde flere oplysninger ved at gå til Test framework for Power Query SDK del 2 – Test data.
4. Konfigurer og kør testene: Connectorudvikleren skal derefter køre testene ved hjælp af det angivne RunPQSDKTestSuites PowerShell-værktøj, som bruger kommandoen PQTest compare til at køre testene. Du kan finde flere oplysninger i Power Query SDK-teststrukturdelen 5 – Test af din udvidelsesconnector.
5. Rapportering & CI/CD: Standardtestrapporten genereres i konsollen, og der er også muligheder for at generere rapporten i formaterne oversigt, detaljeret, TRX og JSON. TRX-formatet (Visual Studio-testresultater) er nyttigt til at få vist resultaterne, når de køres som en del af en pipeline. Du kan finde flere oplysninger i Power Query SDK-teststruktur del 7 – Pipelinevejledning.

Mål for teststrukturen

Det langsigtede mål for Power Query SDK-teststrukturen er at levere en robust testløsning, der er integreret med Visual Studio Code SDK til test af udvidelsesconnectors. Det bør forbedre udvikleroplevelsen i høj grad for udviklingen af connectorerne. Det bør også bringe standardisering til temmelig fragmenterede testpraksis, i sidste ende øge kvalitet bar og mindske fastholdelse indsats af connectors. Vi forestiller os også, at teststrukturen skal tilsluttes certificeringsprocessen for connectoren og forbedre oplevelsen for partnerne.

Målene for den indledende version af teststrukturen er at levere:

• Brugervenligt kommandolinjeværktøj, så brugerne nemt kan teste deres udvidelsesconnectors: Teststrukturen introducerer kommandoen PQTest compare med intuitive muligheder for at køre testene. Den indeholder også PowerShell-værktøjet RunPQSDKTestSuites, som også hjælper med batchtest. Der leveres nemme og automatiske konfigurationer til konfiguration og kørsel af testene.
• Det indledende sæt standardtest, der skal udføres, når du er klar til at udføre for at bekræfte en connector: Teststrukturen indeholder en pakke med sanitetstest, der validerer skemaet, rækkeantallet og dataene i testtabellerne. Den indeholder også en standardtestpakke til bekræftelse af datatyper, matematik, dato, klokkeslæt, tekstfunktioner, operatorer og joinforbindelser.
• Det er nemt at tilføje test manuelt for at udvide testen: Testene i teststrukturen bruger det nye PQ/PQOut-testformat, hvilket forenkler processen til oprettelse af test ved at minimere de nødvendige konfigurationer. Forbind eller udviklere kan derefter fokusere på at oprette M-forespørgslen til deres test. Hver test er modulopbygget og opdelt i individuelle filer for at forenkle vedligeholdelsen. Det forventede output genereres også i den første kørsel.
• Mulighed for at teste test af forespørgselsdelegering: Teststrukturen kan også generere diagnosticering for en connector. I øjeblikket er diagnosticeringsfunktionen begrænset til oprettelse af SQL-forespørgsler under forespørgselsdelegering for en ODBC-baseret connector. Denne funktion vil blive udvidet til andre diagnosticering i fremtiden.

Oversigt over referencevejledningen

I denne vejledning kan du:

• Få en forståelse af teststrukturen i Power Query SDK.
• Få mere at vide om, hvordan du konfigurerer udviklingsmiljøet ved at installere teststrukturen.
• Hent det datasæt, der bruges i testpakken, og upload det til en datakilde baseret på din udvidelsesconnector.
• Forstå specifikationer for testformat, dvs. filformaterne og deres funktionalitet i Test Framework.
• Hent og kør den testpakke, der indeholder testene til validering af udvidelsesconnectoren.
• Kør individuelle test med forskellige konfigurationer.
• Tilføj dine egne test for at bekræfte din connectorspecifikke funktionalitet.
• Automatiser testkørsler ved at konfigurere en pipeline til testene.

Dele

Del	Afsnit	Oplysninger
0	Opsætning	Konfigurer dit miljø.
2	Forbereder data	Forbereder testdataene.
3	Testpakke	Henter og forstår testpakken.
4	Specifikation af testformat	Forstå de forskellige filformater, der bruges i teststrukturen.
5	Forbind eller test	Test din udvidelsesconnector.
6	Tilføjelse af test	Tilføjelse af dine egne test og forståelse af forskellige indstillinger og konfigurationer i teststrukturen.
7	Vejledning til konfiguration af rørledning	Kørsel af testene i en pipeline.