Πλαίσιο δοκιμής SDK Power Query, μέρος 4 - Προδιαγραφή μορφής δοκιμής

Άρθρο
03/21/2024

Αυτή η αναφορά σε πολλά μέρη καλύπτει τη ρύθμιση και την εκτέλεση μιας τυπικής οικογένειας δοκιμών για προγραμματιστές συνδέσεων Power Query. Η αναφορά προορίζεται να γίνει διαδοχικά για να διασφαλιστεί ότι το περιβάλλον σας έχει ρυθμιστεί για δοκιμή της προσαρμοσμένης σύνδεσής σας.

Τώρα που έχετε ρυθμίσει το περιβάλλον, έχετε αποστείλει τα δεδομένα δοκιμής και ρυθμίσετε την οικογένεια δοκιμών, είστε έτοιμοι να αρχίσετε να επαληθεύετε τη σύνδεση επέκτασης με την οικογένεια δοκιμών. Πριν την εκτέλεση των δοκιμών, πρέπει να κατανοήσετε διαφορετικούς τύπους αρχείων και μορφών στο πλαίσιο δοκιμής.

Σε αυτήν την ενότητα, θα κάνετε τα εξής:

Μάθετε τους τύπους μορφών αρχείων που χρησιμοποιούνται στο πλαίσιο δοκιμής και τις λειτουργίες τους

Προδιαγραφή για δοκιμές σε μορφή PQ/PQOut

Οι δοκιμές για την επαλήθευση συνδέσεων επέκτασης με το πλαίσιο δοκιμής Power Query SDK συντάσσονται σε μορφή PQ/PQOut.

Η παρακάτω λίστα περιγράφει τους τύπους αρχείων που πρέπει να γνωρίζετε κατά την εργασία σας με το πλαίσιο δοκιμής Του Power Query SDK:

Δοκιμάστε το αρχείο ερωτήματος, γνωστό και ως αρχείο PQ, με επέκταση .query.pq.
Αρχείο εξόδου, γνωστό και ως αρχείο PQOut, με επέκταση .query.pqout.
Προαιρετικό αρχείο ερωτήματος παραμέτρου με επέκταση .parameterquery.pq.
Προαιρετικό αρχείο ρυθμίσεων με επέκταση .settings.
Προαιρετικό αρχείο διαγνωστικού ελέγχου με επέκταση .diagnostics.

Δοκιμή αρχείου ερωτήματος, γνωστό και ως αρχείο PQ, με επέκταση .query.pq

Το αρχείο ερωτήματος δοκιμής (.query.pq) περιέχει ένα μεμονωμένο ερώτημα γλώσσας τύπων Power Query M. Το ερώτημα συνδυασμού δεδομένων αποτελείται από μεταβλητές, παραστάσεις και τιμές που ενσωματώνονται από μια let παράσταση με ένα όνομα συνάρτησης προέλευσης δεδομένων προσαρμοσμένης σύνδεσης και απαιτούμενα μετα-δεδομένα για εκτέλεση.

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

Αρχείο εξόδου, γνωστό και ως αρχείο PQOut, με επέκταση .query.pqout

Το αρχείο εξόδου (.query.pqout) περιέχει το αποτέλεσμα που δημιουργήθηκε ως αποτέλεσμα της εκτέλεσης της εντολής σύγκρισης για μια δοκιμή.

Το παρακάτω δείγμα εμφανίζει ένα παράδειγμα ενός αρχείου εξόδου (PQOut), για παράδειγμα, SnowflakeFirstNTests.query.pqout:

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

Προαιρετικό αρχείο ερωτήματος παραμέτρου με επέκταση .parameterquery.pq

Για να κάνετε τις υποθέσεις δοκιμής να εκτελούνται ανεξάρτητα από την προέλευση δεδομένων, η υποστήριξη για το αρχείο ερωτήματος PQ/δοκιμής μπορεί να διαιρεθεί σε δύο μέρη: το αρχείο ερωτήματος παραμέτρου και το αρχείο ερωτήματος δοκιμής.

Το ερώτημα παραμέτρου είναι μια συγκεκριμένη προέλευση δεδομένων και ανακτά δεδομένα δοκιμής από την προέλευση δεδομένων. Εάν θέλετε να εκτελέσετε τις δοκιμές για μια άλλη σύνδεση, πρέπει να ενημερώσετε αυτό το αρχείο ώστε να παραπέμπει στη συγκεκριμένη προέλευση δεδομένων.

Το παρακάτω δείγμα παρουσιάζει ένα παράδειγμα ενός αρχείου ερωτήματος παραμέτρου, για παράδειγμα, 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

Όταν παρέχεται το προαιρετικό αρχείο ερωτήματος παραμέτρου, το ερώτημα δοκιμής χρειάζεται μόνο να περιέχει μετασχηματισμούς στα δεδομένα δοκιμής. Αυτοί οι μετασχηματισμοί είναι οι παραστάσεις M που απαιτούνται για τις δοκιμές και την καθιστούν ανεξάρτητη από την προέλευση δεδομένων. Το ερώτημα δοκιμής θα πρέπει επίσης να δηλώσει μια συνάρτηση M lambda που λαμβάνει τα αποτελέσματα από το ερώτημα παραμέτρου και εκτελεί τη λογική δοκιμής στα αποτελέσματα εισόδου.

Το παρακάτω δείγμα εμφανίζει ένα παράδειγμα για ένα ερώτημα δοκιμής, για παράδειγμα, SnowflakeFirstNTest.query.pq:

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

Αρχείο προαιρετικών ρυθμίσεων με επέκταση .settings

Το προαιρετικό αρχείο ρυθμίσεων είναι ένα αρχείο JSON, το οποίο περιέχει τις παραμέτρους ρύθμισης παραμέτρων ως ζεύγη τιμών κλειδιού.

Το παρακάτω δείγμα εμφανίζει ένα παράδειγμα για ένα αρχείο ρυθμίσεων όταν καθορίζεται το προαιρετικό αρχείο ερωτήματος παραμέτρου:

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

Προαιρετικό αρχείο διαγνωστικού ελέγχου με επέκταση .diagnostics

Το προαιρετικό αρχείο διαγνωστικών αυτήν τη στιγμή περιέχει μια λίστα κειμένου εντολών που δημιουργείται όταν αναδιπλώνεται ένα ερώτημα M. Χρησιμοποιήστε το για δοκιμή παλινδρόμησης της αναδίπλωσης ερωτήματος.

Το παρακάτω δείγμα εμφανίζει ένα παράδειγμα για ένα αρχείο διαγνωστικού ελέγχου, για παράδειγμα, SnowflakeFirstNTest Ρυθμίσεις.diagnostics:

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

Συμπέρασμα

Αυτή η ενότητα σάς παρουσίασε τις διάφορες μορφές αρχείων που πρέπει να είστε εξοικειωμένοι κατά την εργασία σας με το πλαίσιο δοκιμής του Power Query SDK.

Στην επόμενη ενότητα, δημιουργείτε ερωτήματα και ρυθμίσεις για να εργαστείτε με την προέλευση δεδομένων σας για τη σύνδεση επέκτασης.

Επόμενα βήματα

Μέρος 5 του πλαισίου δοκιμής SDK του Power Query - Δοκιμή της σύνδεσης επέκτασης

Κοινή χρήση μέσω