Επισκόπηση του Power Query SDK

Ο σκοπός αυτού του άρθρου είναι να σας δώσει μια επισκόπηση των συνολικών δυνατοτήτων και της εμπειρίας ανάπτυξης που βρίσκονται μέσα στο Power Query SDK για κώδικα Visual Studio.

Δημιουργία νέου έργου

Φιλοδώρημα

Πριν από τη δημιουργία ενός έργου επέκτασης, συνιστούμε να δημιουργήσετε έναν νέο φάκελο όπου θα αποθηκεύσετε το έργο επέκτασης. Κατά τη δημιουργία ενός νέου έργου, εάν δεν έχει επιλεγεί κανένας φάκελος, το Power Query SDK θα σας βοηθήσει να εντοπίσετε ή να δημιουργήσετε έναν νέο φάκελο πριν από τη δημιουργία του έργου επέκτασης.

Μόλις βρεθείτε στο Visual Studio Code, στο κύριο τμήμα παραθύρου Explorer του Visual Studio Code υπάρχει μια ενότητα με το όνομα Power Query SDK. Αυτή η ενότητα έχει μόνο ένα κουμπί που διαβάζει Δημιουργία έργου επέκτασης. Επιλέξτε αυτό το κουμπί.

Αυτό το κουμπί ανοίγει ένα πεδίο εισόδου στο επάνω μέρος του περιβάλλοντος εργασίας του Visual Studio Code. Εισαγάγετε το όνομα του νέου έργου επέκτασης και, στη συνέχεια, επιλέξτε Enter.

Μετά από μερικά δευτερόλεπτα, το παράθυρο Visual Studio Code ανοίγει το κύριο αρχείο *.pq για το έργο επέκτασης που περιέχει τη λογική της σύνδεσής σας. Το Power Query SDK εκτελεί αυτόματα ορισμένες απαραίτητες εργασίες για την ολοκλήρωση της ρύθμισης του χώρου εργασίας σας. Μπορείτε να ελέγξετε αυτές τις εργασίες στην κονσόλα εξόδου στο Visual Studio Code.

Το Power Query SDK δημιουργεί αυτόματα το ακόλουθο σύνολο αρχείων:

• Ένα αρχείο settings.json που υπαγορεύει συγκεκριμένες ρυθμίσεις για εργασία σε επίπεδο χώρου εργασίας.
• Δημιουργεί την επέκταση ως αρχείο .mez και την αποθηκεύει σε έναν νέο φάκελο bin\AnyCPU\Debug.
• Ένα σύνολο εικονιδίων σύνδεσης ως .png αρχεία.
• Ένα αρχείο resources.resx που λειτουργεί ως ο κύριος χώρος αποθήκευσης για συμβολοσειρές που χρησιμοποιούνται στην επέκταση.
• Ένα αρχείο .pq που διατηρεί την κύρια λογική της επέκτασης ή της σύνδεσής σας.
• Ένα αρχείο .query.pq του οποίου ο κύριος σκοπός είναι να χρησιμοποιηθεί ως ένας τρόπος για να δημιουργήσετε δοκιμαστικά ερωτήματα που μπορείτε αργότερα να αξιολογήσετε.
• Ένα αρχείο .proj που περιέχει πληροφορίες σχετικά με το έργο επέκτασης.

Όταν ένα έργο επέκτασης αναγνωριστεί από το Visual Studio Code, η ενότητα για το SDK Power Query αλλάζει την εμφάνισή του και τώρα εμφανίζει μια λίστα εργασιών που μπορείτε να εκτελέσετε στο νέο έργο επέκτασης.

βεβαίωση αναγνώρισης

Σημαντικό

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

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

Ορισμός διαπιστευτηρίων

Το Power Query SDK καθοδηγείται κυρίως από εργασίες που μπορούν να ενεργοποιηθούν μέσω πολλαπλών σημείων εισόδου. Η ρύθμιση ενός διαπιστευτηρίων μπορεί να γίνει με δύο τρόπους (οι άλλες εργασίες διαπιστευτηρίων μπορούν να γίνουν με τον ίδιο τρόπο).

• Μέσω της καταχώρησης στην ενότητα Power Query SDK στο τμήμα παραθύρου εξερεύνησης.

  

• Μέσω του τερματικού , επιλέγοντας Εκτέλεση εργασίας και, στη συνέχεια, επιλέγοντας την εργασία Ορισμός διαπιστευτηρίων .

  

Όταν εκτελείτε αυτήν την εργασία, το Visual Studio Code θα σας καθοδηγήσει σε μια σειρά προτροπών που θα σας επιτρέψει να ορίσετε τα διαπιστευτήρια. Αυτές οι σειρές προτροπών είναι προβλέψιμες και αποτελούνται πάντα από τα ίδια στάδια:

1. Επιλέξτε το είδος της προέλευσης δεδομένων.
2. Επιλέξτε το αρχείο σύνδεσης.
3. Επιλέξτε τη μέθοδο ελέγχου ταυτότητας.

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

Διαπιστευτήρια λίστας

Παρόμοια με τον ορισμό διαπιστευτηρίων, η εργασία για τη λίστα διαπιστευτηρίων έχει δύο σημεία καταχώρησης στα ίδια σημεία: την ενότητα Power Query SDK στο τμήμα παραθύρου Explorer και μέσα στο μενού τερματικό .

Όταν εκτελεστεί αυτή η εργασία, παρουσιάζει τα διαθέσιμα διαπιστευτήρια μέσα στο τερματικό εξόδου.

Απαλοιφή όλων των διαπιστευτηρίων

Παρόμοια με τις προηγούμενες δύο εργασίες, η εργασία για την εκκαθάριση όλων των διαπιστευτηρίων έχει δύο σημεία εισόδου στα ίδια σημεία: την ενότητα Power Query SDK στο τμήμα παραθύρου Explorer και μέσα στο μενού Τερματικό .

Αυτή η εργασία χρησιμεύει ως ένας τρόπος για να απαλείψετε όλα τα διαπιστευτήρια από την τρέχουσα περίοδο λειτουργίας σας, όταν χρειάζεται να ορίσετε νέα διαπιστευτήρια για να αξιολογήσετε τα ερωτήματά σας.

Τα πληροφοριακά μηνύματα για αυτή την εργασία εμφανίζονται επίσης στην κονσόλα εξόδου.

Αξιολόγηση ενός ερωτήματος και του πίνακα αποτελεσμάτων

Για να μπορέσετε να αξιολογήσετε οποιαδήποτε δοκιμαστικά ερωτήματα, πρέπει να οριστεί ένα διαπιστευτήριο. Χρησιμοποιώντας τη σύνδεση που δημιουργήθηκε στην προηγούμενη ενότητα, μπορείτε να ανοίξετε το *.query.pq αρχείο που χρησιμεύει ως το αρχείο του ερωτήματος δοκιμής.

Για τη συγκεκριμένη σύνδεση όπου το όνομα του έργου ήταν MyConnector, ο κώδικας έχει την ακόλουθη εμφάνιση:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents()
in
    result

Πριν από την αξιολόγηση του ερωτήματος, ας αλλάξουμε τον κώδικα ως εξής:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents("Hello World")
in
    result

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

Για να αξιολογήσετε αυτό το ερώτημα, έχετε τρεις επιλογές:

• Επιλέξτε το αρχείο που χρησιμοποιείται και επιλέξτε Αξιολόγηση τρέχοντος αρχείου power query.

• Μεταβείτε από το μενού Τερματικό και επιλέξτε την εργασία Αξιολόγηση τρέχοντος αρχείου .

• Χρησιμοποιήστε την εγγενή επιλογή Εκτέλεση και εντοπισμός σφαλμάτων από το Visual Studio Code, επιλέξτε την υπερ-σύνδεση για να δημιουργήσετε ένα αρχείο launch.json και, στη συνέχεια, αξιολογήστε το αρχείο.

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

Ο πίνακας αποτελεσμάτων περιέχει τρεις καρτέλες:

• Καρτέλα "Έξοδος": Εμφανίζει μια προεπισκόπηση δεδομένων του ερωτήματος που αξιολογείται. Εάν τα δεδομένα είναι ένας πίνακας, εμφανίζονται ως πλέγμα.

  

• Σύνοψη: Εμφανίζει μια σύνοψη της δραστηριότητας που πραγματοποίησε τις αξιολογήσεις, μαζί με τα στατιστικά στοιχεία που σχετίζονται με αυτήν τη δραστηριότητα.

  

• Προέλευση δεδομένων: Εμφανίζει γενικές πληροφορίες σχετικά με την προέλευση δεδομένων που χρησιμοποιείται για την αξιολόγηση.

  

Για να αξιολογήσετε ένα διαφορετικό ερώτημα, απλώς τροποποιείτε το αρχείο *.query.pq, το αποθηκεύετε και, στη συνέχεια, εκτελείτε ξανά την εργασία αξιολόγησης με οποιαδήποτε από τις τρεις μεθόδους.

Σημείωμα

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

Μεταφορά ενός έργου επέκτασης παλαιού τύπου στο νέο SDK

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

Για να ακολουθήσετε τις οδηγίες της εκμάθησης, συνιστούμε να κάνετε λήψη των έργων σύνδεσης που είναι διαθέσιμα από το αποθετήριο δεδομένων μας DataConnectors για το δείγμα TripPin, συγκεκριμένα το δείγμα 9-TestConnection.

Για να μεταφέρετε το έργο επέκτασης παλαιού τύπου στο νέο SDK, ακολουθήστε τα εξής βήματα:

1. Στο Visual Studio Code, επιλέξτε Αρχείο>Άνοιγμα φακέλου και, στη συνέχεια, μεταβείτε στον φάκελο όπου βρίσκεται το έργο επέκτασης.

2. Ρυθμίστε έναν χώρο εργασίας χρησιμοποιώντας τον υπάρχοντα φάκελο και τα περιεχόμενά του, χρησιμοποιώντας μία από τις ακόλουθες δύο μεθόδους:

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

     

   • Εκτελέστε τον χώρο εργασίας Ρύθμιση και την Εργασία δόμησης από το μενού του τερματικού. Αυτά θα δημιουργήσουν αποτελεσματικά το αρχείο .mez και τα settings.json αρχεία που απαιτούνται για τον χώρο εργασίας.

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

Ρύθμιση χώρου εργασίας

Αυτό που κάνει η εργασία Ρύθμιση χώρου εργασίας είναι να δημιουργήσει αποτελεσματικά ένα αρχείο settings.json για τον χώρο εργασίας σας που υπαγορεύει ορισμένες μεταβλητές που θα χρησιμοποιηθούν για τον χώρο εργασίας σας όταν πρόκειται για αξιολογήσεις και γενικές ρυθμίσεις.

Δημιουργία αρχείου επέκτασης

Η εργασία δόμησης σάς επιτρέπει να δημιουργήσετε το αρχείο .mez για την επέκτασή σας κατ' απαίτηση.

Εκτέλεση της συνάρτησης TestConnection

Το TestConnection είναι μια συνάρτηση που επιτρέπει την ανανέωση της σύνδεσής σας στο Microsoft Cloud μέσω υπηρεσιών όπως το Power BI. Είναι μια εγγραφή που υλοποιείται μέσα στην εγγραφή προέλευσης δεδομένων σύνδεσης. Μπορείτε να μάθετε περισσότερα σχετικά με την υλοποίηση του προγράμματος χειρισμού TestConnection από το διαθέσιμο δείγμα για τη Σύνδεση δοκιμής.

Η εργασία για την εκτέλεση του TestConnection σάς επιτρέπει να δοκιμάσετε τον χειρισμό εντός του SDK Power Query χωρίς να χρειάζεται να δοκιμάσετε με μη αυτόματο τρόπο αυτόν τον χειρισμό στο Microsoft Cloud.

Για να εκτελέσετε αυτή την εργασία, ορίστε πρώτα ένα διαπιστευτήριο για τη σύνδεσή σας και, στη συνέχεια, εκτελέστε την εργασία είτε από την ενότητα Power Query SDK στην Εξερεύνηση είτε μέσω της λίστας εργασιών στο μενού του τερματικού.

Το αποτέλεσμα αυτής της εργασίας εμφανίζεται στο τερματικό εξόδου στο κάτω μέρος του παραθύρου.

Σχόλια και σφάλματα

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

Μπορείτε επίσης να χρησιμοποιήσετε το φόρουμ της κοινότητας του Power BI για να δημοσιεύσετε γενικές ερωτήσεις σχετικά με το Power Query, τη γλώσσα M και την ανάπτυξη προσαρμοσμένων συνδέσεων.