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

Ανάπτυξη σύνδεσης με χρήση του Power Query SDK

  • Άρθρο

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

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

  • Δημιουργία μιας προβολής φιλικής προς τους επιχειρηματικούς αναλυτές για ένα REST API.
  • Παροχή εμπορικής προσαρμογής για μια προέλευση που υποστηρίζει το Power Query με μια υπάρχουσα σύνδεση (όπως μια υπηρεσία OData ή ένα πρόγραμμα οδήγησης ODBC).
  • Υλοποίηση ροής ελέγχου ταυτότητας OAuth v2 για μια προσφορά SaaS.
  • Εκθέτοντας μια περιορισμένη ή φιλτραρισμένη προβολή της προέλευσης δεδομένων για τη βελτίωση της χρηστικότητας.
  • Ενεργοποίηση του DirectQuery για μια προέλευση δεδομένων με χρήση ενός προγράμματος οδήγησης ODBC.

Εγκατάσταση του Power Query SDK

Εγκαταστήστε το 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

Έχετε δύο διαδρομές στις οποίες μπορείτε να διανείμετε τη σύνδεσή σας:

  • Αυτόματη κατανομή
  • Πιστοποίηση σύνδεσης

Αυτόματη κατανομή

Ένας μηχανισμός αυτοεξυπηρέτησης όπου μπορείτε να εφαρμόσετε προσαρμοσμένες συνδέσεις Power Query στις κατάλληλες εμπειρίες προϊόντος

Με τη σύνδεση που δημιουργήσατε, μπορείτε να στείλετε αυτό το αρχείο όπως θέλετε στους χρήστες σας και μπορούν να χρησιμοποιήσουν τη σύνδεση στις κατάλληλες εμπειρίες προϊόντος, όπως το Microsoft Power BI.

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.

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

Πιστοποίηση σύνδεσης

Το πρόγραμμα πιστοποίησης σύνδεσης 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.