Ανάπτυξη σύνδεσης με χρήση του Power Query SDK
Το Power Query SDK είναι ένα σύνολο εργαλείων που έχουν σχεδιαστεί για να σας βοηθούν να δημιουργείτε συνδέσεις Power Query. Αυτές οι συνδέσεις αναφέρονται συχνά ως προσαρμοσμένες συνδέσεις ή επεκτάσεις Power Query.
Οι προσαρμοσμένες συνδέσεις σάς επιτρέπουν να δημιουργείτε νέες προελεύσεις δεδομένων ή να προσαρμόζετε και να επεκτείνετε μια υπάρχουσα προέλευση. Συνήθεις περιπτώσεις χρήσης είναι οι εξής:
- Δημιουργία μιας προβολής φιλικής προς τους επιχειρηματικούς αναλυτές για ένα REST API.
- Παροχή εμπορικής προσαρμογής για μια προέλευση που υποστηρίζει το Power Query με μια υπάρχουσα σύνδεση (όπως μια υπηρεσία OData ή ένα πρόγραμμα οδήγησης ODBC).
- Υλοποίηση ροής ελέγχου ταυτότητας OAuth v2 για μια προσφορά SaaS.
- Εκθέτοντας μια περιορισμένη ή φιλτραρισμένη προβολή της προέλευσης δεδομένων για τη βελτίωση της χρηστικότητας.
- Ενεργοποίηση του DirectQuery για μια προέλευση δεδομένων με χρήση ενός προγράμματος οδήγησης ODBC.
Εγκαταστήστε το Power Query SDK του Visual Studio Code από την ενότητα Κώδικας Visual Studio του Visual Studio Marketplace. Επιλέξτε Εγκατάσταση για να εγκαταστήσετε το SDK.
Οι παρακάτω ενότητες περιγράφουν, σε υψηλό επίπεδο, την πιο συνηθισμένη διαδικασία για τη δημιουργία μιας σύνδεσης Power Query με χρήση του SDK.
Όταν δημιουργείτε έναν νέο χώρο εργασίας (Visual Studio Code Power Query SDK), ξεκινάτε με τα ακόλουθα βασικά αρχεία:
- Αρχείο ορισμού σύνδεσης (<connectorName.pq>)
- Ένα αρχείο ερωτήματος (<connectorName.query.pq>)
- Ένα αρχείο πόρου συμβολοσειράς (resources.resx)
- Αρχεία PNG διαφόρων μεγεθών που χρησιμοποιούνται για τη δημιουργία εικονιδίων
Το αρχείο ορισμού σύνδεσης ξεκινά με μια κενή περιγραφή προέλευσης δεδομένων. Μπορείτε να μάθετε περισσότερα σχετικά με μια προέλευση δεδομένων στο περιβάλλον του Power Query SDK από το άρθρο σχετικά με τον χειρισμό πρόσβασης δεδομένων.
Το Power Query SDK παρέχει βασικές δυνατότητες εκτέλεσης ερωτημάτων, οι οποίες σας επιτρέπουν να δοκιμάσετε την επέκτασή σας χωρίς να χρειάζεται να μεταβείτε σε διαφορετική εφαρμογή προγράμματος-πελάτη. Μπορείτε να ελέγξετε περαιτέρω τη σύνδεσή σας σε μια εφαρμογή, όπως:
Εκτός από το αρχείο επέκτασης, τα έργα σύνδεσης δεδομένων μπορούν να έχουν ένα αρχείο ερωτήματος (name.query.pq). Αυτό το αρχείο μπορεί να χρησιμοποιηθεί για την εκτέλεση ερωτημάτων δοκιμής εντός του Visual Studio Code. Η αξιολόγηση του ερωτήματος θα περιλαμβάνει αυτόματα τον κωδικό επέκτασής σας, χωρίς να χρειάζεται να καταχωρήσετε το αρχείο σας.pqx, επιτρέποντάς σας να καλέσετε ή να δοκιμάσετε τυχόν κοινόχρηστες συναρτήσεις στον κωδικό επέκτασής σας.
Το αρχείο ερωτήματος μπορεί να περιέχει μια μοναδική παράσταση (για παράδειγμα, HelloWorld.Contents()
), μια let
παράσταση (όπως τι θα δημιουργούσε το Power Query) ή ένα έγγραφο ενότητας.
Η δημιουργία του έργου σας παράγει το αρχείο .mez ή το αρχείο επέκτασης. Οι επεκτάσεις Του Power Query ομαδοποιούνται σε ένα αρχείο ZIP και λαμβάνουν μια επέκταση αρχείου .mez.
Οι επεκτάσεις ορίζονται μέσα σε ένα έγγραφο ενότητας M. Ένα έγγραφο ενότητας έχει ελαφρά διαφορετική μορφή από τα έγγραφα ερωτήματος που δημιουργούνται στο Power Query. Ο κώδικας που εισάγετε από το Power Query συνήθως απαιτεί τροποποίηση για να χωρέσει σε ένα έγγραφο ενότητας, αλλά οι αλλαγές είναι δευτερεύουσες. Οι διαφορές εγγράφων ενότητας που θα πρέπει να γνωρίζετε περιλαμβάνουν τα εξής:
- Ξεκινούν με μια δήλωση ενότητας (για παράδειγμα,
section HelloWorld;
). - Κάθε παράσταση τελειώνει με ελληνικό ερωτηματικό (για παράδειγμα,
a = 1;
ήb = let c = 1 + 2 in c;
). - Όλες οι συναρτήσεις και μεταβλητές είναι τοπικές για το έγγραφο ενότητας, εκτός εάν επισημαίνονται ως κοινόχρηστες. Οι κοινόχρηστες συναρτήσεις γίνονται ορατές σε άλλα ερωτήματα/συναρτήσεις και μπορούν να θεωρηθούν ως οι εξαγωγές για την επέκτασή σας (δηλαδή, καθίστανται δυνατή η κλήση τους από το Power Query).
Μπορείτε να βρείτε περισσότερες πληροφορίες σχετικά με τα έγγραφα ενότητας M στην προδιαγραφή γλώσσας M.
Έχετε δύο διαδρομές στις οποίες μπορείτε να διανείμετε τη σύνδεσή σας:
- Αυτόματη κατανομή
- Πιστοποίηση σύνδεσης
Ένας μηχανισμός αυτοεξυπηρέτησης όπου μπορείτε να εφαρμόσετε προσαρμοσμένες συνδέσεις Power Query στις κατάλληλες εμπειρίες προϊόντος
Με τη σύνδεση που δημιουργήσατε, μπορείτε να στείλετε αυτό το αρχείο όπως θέλετε στους χρήστες σας και μπορούν να χρησιμοποιήσουν τη σύνδεση στις κατάλληλες εμπειρίες προϊόντος, όπως το Microsoft Power BI.
Μπορείτε να χρησιμοποιήσετε τη δική σας προσαρμοσμένη σύνδεση στο Microsoft Power BI Desktop και την υπηρεσία Microsoft Power BI για σημασιολογικά μοντέλα για ανανέωση και συνδεσιμότητα στο cloud.
Οι συνδέσεις Power Query μπορούν να φορτωθούν σε τρεις εμπειρίες:
- Πύλη δεδομένων εσωτερικής εγκατάστασης: Η σύνδεσή σας μπορεί να φορτωθεί μέσω της πύλης για χρήση στις υπηρεσίες Microsoft Fabric και Microsoft Power BI
- Power Query Online: μέσα σε εμπειρίες όπως τα Power BI Datamarts, Fabric Dataflow Gen2 και πολλές άλλες
- Power Query Desktop: μέσα σε εμπειρίες όπως το Power BI Desktop.
Μπορείτε να μάθετε περισσότερα σχετικά με τον τρόπο χρήσης της προσαρμοσμένης σύνδεσής σας για αυτόματη διανομή, χρησιμοποιώντας τα παρακάτω άρθρα:
- Φόρτωση προσαρμοσμένης σύνδεσης Power Query στο Power BI Desktop
- Ενεργοποίηση και χρήση προσαρμοσμένων συνδέσεων στην υπηρεσία Power BI
Το πρόγραμμα πιστοποίησης σύνδεσης Data Factory σάς επιτρέπει να υποβάλετε τη σύνδεσή σας στη Microsoft για πιστοποίηση, όπου η Microsoft φροντίζει για τη δημοσίευση και διανομή της σύνδεσής σας τόσο στο Microsoft Fabric όσο και στο Microsoft Power BI για τα προϊόντα και τις εμπειρίες που ισχύουν:
- Power Query Desktop: Microsoft Power BI Desktop.
- Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 και άλλα
- Πύλη δεδομένων εσωτερικής εγκατάστασης: Τόσο για το Microsoft Fabric όσο και για το Microsoft Power BI που χρησιμοποιούν μια πύλη για ανανέωση με έλεγχο ταυτότητας ή συνδεσιμότητα.
Μάθετε περισσότερα σχετικά με το πρόγραμμα πιστοποίησης Data Factory Connector.