Power Query SDK-testrammeverk del 4 – spesifikasjon av testformat

Artikkel
03/21/2024

Denne flerdelte referansen dekker konfigurasjonen og kjøringen av en standard testserie for Power Query-koblingsutviklere. Referansen er ment å gjøres sekvensielt for å sikre at miljøet er konfigurert for testing av den egendefinerte koblingen.

Nå som du har konfigurert miljøet, lastet opp testdataene og konfigurert testserien, er du klar til å begynne å bekrefte utvidelseskoblingen med testserien. Før du kjører testene, må du forstå ulike typer filer og formater i testrammeverket.

I denne delen:

Lær hvilke typer filformater som brukes i testrammeverket og deres funksjonalitet

Spesifikasjon for tester i PQ/PQOut-format

Testene for å verifisere utvidelseskoblinger med Power Query SDK-testrammeverket er skrevet i PQ/PQOut-format.

Listen nedenfor beskriver filtypene du må være oppmerksom på mens du arbeider med power query SDK-testrammeverket:

Test spørringsfil, også kjent som en PQ-fil, med filtypen .query.pq.
Utdatafil, også kjent som en PQOut-fil, med filtypen .query.pqout.
Valgfri parameterspørringsfil med filtypen PARAmeterquery.pq.
Valgfri innstillingsfil med filtypen .settings.
Valgfri diagnosefil med filtypen .diagnostics.

Test spørringsfil, også kjent som en PQ-fil, med filtypen .query.pq

Testspørringsfilen (.query.pq) inneholder én enkelt power query M-formelspråkspørring. Mashup-spørringen består av variabler, uttrykk og verdier innkapslet av et let uttrykk med et egendefinert funksjonsnavn for koblingsdatakilde og nødvendige metadata for å kjøre.

let
   Source = Snowflake.Databases("POWERBI.snowflakecomputing.com", "DEMO_WH"),
   Database = Source{[Name="NYCTAXIDB”, Kind="Database"]}[Data],
   Schema = Database{[Name="PUBLIC”, Kind="Schema"]}[Data],
   Table = Schema{[Name="NYCTAXIDATA”, Kind="Table"]}[Data],
   SelectColumns = Table.SelectColumns(Table, {"lpep_pickup_datetime"}),
   FirstN = Table.FirstN(SelectColumns, 1)
in
   FirstN

Utdatafil, også kjent som en PQOut-fil, med filtypen .query.pqout

Utdatafilen (.query.pqout) inneholder de genererte utdataene som et resultat av å kjøre sammenligningskommandoen for en test.

Følgende eksempel viser et eksempel på en utdatafil (PQOut), for eksempel SnowflakeFirstNTests.query.pqout:

#table(type table [TIMESTAMP = datetime], {{#datetime(2014, 1, 1, 16, 0, 0.12345)}})

Valgfri parameterspørringsfil med filtypen .parameterquery.pq

Hvis du vil at testtilfellene skal kjøre uavhengig av datakilden, kan støtte for PQ/test-spørringsfilen deles inn i to deler: parameterspørringsfilen og testspørringsfilen.

Parameterspørringen er datakildespesifikk og henter testdata fra datakilden. Hvis du vil kjøre testene for en annen kobling, må du oppdatere denne filen for å peke til den bestemte datakilden.

Følgende eksempel viser et eksempel på en parameterspørringsfil, for eksempel Taxi.parameterquery.pq:

let
   Source = Snowflake.Databases("POWERBI.snowflakecomputing.com", "DEMO_WH"),
   Database = Source{[Name="NYCTAXIDB", Kind="Database"]}[Data],
   Schema = Database{[Name="PUBLIC", Kind="Schema"]}[Data],
   Table = Schema{[Name="NYCTAXIDATA", Kind="Table"]}[Data],
in
   Table

Når den valgfrie parameterspørringsfilen er angitt, trenger testspørringen bare å inneholde transformasjoner til testdataene. Disse transformasjonene er M-uttrykkene som kreves for tester og gjør det uavhengig av datakilden. Testspørringen må også da deklarere en M lambda-funksjon som tar resultatene fra parameterspørringen og kjører testlogikken på inndataresultater.

Følgende eksempel viser et eksempel for en testspørring, for eksempel SnowflakeFirstNTest.query.pq:

(parameter) => 
let
   SelectColumns = Table.SelectColumns(parameter, {"lpep_pickup_datetime"}),
   FirstN = Table.FirstN(SelectColumns, 1)
in
   FirstN

Valgfri innstillingsfil med filtypen .settings

Den valgfrie innstillingsfilen er en JSON-fil, som inneholder konfigurasjonsparameterne som nøkkelverdipar.

Følgende eksempel viser et eksempel på en innstillingsfil når den valgfrie parameterspørringsfilen er angitt:

{
    'Extension': 'snowflake.mez',
    'ParameterQueryFilePath': 'contoso.parameterquery.pq'
    'QueryFilePath': 'contoso.query.pq',
    'FailOnMissingOutputFile': true
}

Valgfri diagnosefil med filtypen .diagnostics

Den valgfrie diagnosefilen inneholder for øyeblikket en liste over kommandotekst som genereres når en M-spørring er brettet. Bruk den til regresjonstesting av spørringsdelegering.

Følgende eksempel viser et eksempel for en diagnosefil, for eksempel SnowflakeFirstNTest Innstillinger.diagnostics:

[
  {
    "Command": "select \"lpep_pickup_datetime\" from \"NYCTAXIDB\".\"PUBLIC\".\"NYCTAXIDATA\" LIMIT 1 OFFSET 0"
  }
]

Konklusjon

Denne delen introduserte deg for ulike filformater som du må være kjent med mens du arbeider med testrammeverket for Power Query SDK.

I neste del oppretter du spørringer og innstillinger for å arbeide med datakilden for utvidelseskoblingen.

Neste trinn

Power Query SDK-testrammeverk del 5 – Testing av utvidelseskoblingen

Del via