Power Query SDK -testikehys, osa 4 – Testimuodon määritys

Artikkeli
03/21/2024

Tämä moniosainen viittaus kattaa Power Query -liitinkehittäjille tarkoitettujen vakiotestipakettien määrittämisen ja suorittamisen. Viittaus on tarkoitettu tehtäväksi järjestyksessä sen varmistamiseksi, että ympäristösi on määritetty mukautetun liittimen testaamista varten.

Nyt kun olet määrittänyt ympäristön, ladannut testitiedot ja määrittänyt testiohjelmiston, olet valmis aloittamaan laajennuksen liittimen vahvistamisen testiohjelmiston avulla. Ennen testien suorittamista testikehyksessä on ymmärrettävä erityyppiset tiedostot ja muodot.

Tässä osiossa:

Tutustu testikehyksessä käytettävien tiedostomuotojen tyyppeihin ja niiden toimintoihin

PQ/PQOut-muodon testien määritys

Testit laajennusliittimien todentamiseksi Power Query SDK -testikehyksen avulla kirjoitetaan PQ/PQOut-muodossa.

Seuraavassa luettelossa kuvataan tiedostotyypit, jotka sinun on otettava huomioon käyttäessäsi Power Query SDK -testikehystä:

Testaa kyselytiedostoa, joka tunnetaan myös PQ-tiedostona, jonka tunniste on .query.pq.
Tulostetiedosto, joka tunnetaan myös PQOut-tiedostona, jonka tunniste on .query.pqout.
Valinnainen parametrikyselytiedosto, jonka tunniste on .parameterquery.pq.
Valinnainen asetustiedosto, jossa on .settings-tunniste.
Valinnainen diagnostiikkatiedosto, jossa on .diagnostics-tunniste.

Testaa kyselytiedostoa, joka tunnetaan myös PQ-tiedostona, jonka tunniste on .query.pq

Testikyselytiedosto (.query.pq) sisältää yhden Power Query M -kaavakielen kyselyn. Koostekysely koostuu muuttujista, lausekkeista ja arvoista, jotka on kapseloitu let lausekkeella, jolla on mukautetun liittimen tietolähteen funktion nimi ja suoritettavat vaaditut metatiedot.

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

Tulostetiedosto, joka tunnetaan myös PQOut-tiedostona, jonka tunniste on .query.pqout

Tulostetiedosto (.query.pqout) sisältää luodun tuloksen testin Vertaa-komennon suorittamisen tuloksena.

Seuraavassa esimerkissä on esimerkki tulostiedostosta (PQOut), esimerkiksi SnowflakeFirstNTests.query.pqout:

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

Valinnainen parametrikyselytiedosto, jonka tunniste on .parameterquery.pq

Jotta testitapaukset voidaan suorittaa erillään tietolähteestä, PQ/test-kyselytiedoston tuki voidaan jakaa kahteen osaan: parametrikyselytiedostoon ja testikyselytiedostoon.

Parametrikysely on tietolähdekohtainen, ja se noutaa testitiedot tietolähteestä. Jos haluat suorittaa testit toiselle liittimelle, sinun on päivitettävä tämä tiedosto osoittamaan kyseiseen tietolähteeseen.

Seuraavassa esimerkissä on esimerkki parametrikyselytiedostosta, esimerkiksi 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

Kun valinnainen parametrikyselytiedosto on annettu, testikyselyn tarvitsee sisältää vain muunnoksia testitietoihin. Nämä muunnokset ovat M-lausekkeita, joita tarvitaan testeissä ja tekevät siitä riippumattoman tietolähteestä. Testikyselyn on myös määritettävä M-lambda-funktio, joka ottaa parametrikyselyn tulokset ja suorittaa syötetulosten testilogiikan.

Seuraavassa esimerkissä on esimerkki testikyselystä, esimerkiksi SnowflakeFirstNTest.query.pq:

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

Valinnainen asetustiedosto, jossa on .settings-tunniste

Valinnainen asetustiedosto on JSON-tiedosto, joka sisältää määritysparametrit avainarvopareina.

Seuraavassa esimerkissä näytetään esimerkki asetustiedostosta, kun valinnainen parametrikyselytiedosto määritetään:

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

Valinnainen diagnostiikkatiedosto, jossa on .diagnostics-tunniste

Valinnainen diagnostiikkatiedosto sisältää tällä hetkellä luettelon komentotekstistä, joka luodaan, kun M-kysely on taitettu. Käytä sitä kyselyn lähteeseen delegoinnin regressiotestaukseen.

Seuraavassa esimerkissä näytetään diagnostiikkatiedoston esimerkki, esimerkiksi SnowflakeFirstNTest Asetukset.diagnostics:

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

Yhteenveto

Tässä osiossa tutustuit erilaisiin tiedostomuotoihin, jotka sinun on tunnettava käyttäessäsi Power Query SDK -testikehystä.

Seuraavassa osiossa luot kyselyjä ja asetuksia, jotka toimivat oman tietolähteesi kanssa laajennusliittimessäsi.

Seuraavat vaiheet

Power Query SDK -testikehys, osa 5 – Laajennusliittimen testaaminen

Jaa