Πιστοποίηση Σύνδεση ή Power Query

  • Άρθρο

Σημείωμα

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

Εισαγωγή

Με το Power Query SDK, όλοι έχουν τη δυνατότητα να δημιουργήσουν μια προσαρμοσμένη σύνδεση Power Query για σύνδεση σε μια προέλευση δεδομένων από το Power Query. Προς το παρόν, οι προσαρμοσμένες συνδέσεις υποστηρίζονται μόνο σε σημασιολογικά μοντέλα Power BI (Power BI Desktop και Υπηρεσία Power BI) και απαιτούν τη χρήση μιας πύλης δεδομένων εσωτερικής εγκατάστασης για ανανέωση μέσω Υπηρεσία Power BI. Οι προσαρμοσμένες συνδέσεις πρέπει να διανέμονται μεμονωμένα από τον προγραμματιστή.

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

Η πιστοποίηση μιας προσαρμοσμένης σύνδεσης Power Query καθιστά τη σύνδεση διαθέσιμη δημοσίως και έτοιμες προς χρήση στα σημασιολογικά μοντέλα Power BI (Power BI Desktop και Υπηρεσία Power BI), στις ροές δεδομένων Power BI και στα σύνολα δεδομένων Power BI. Οι πιστοποιημένες συνδέσεις υποστηρίζονται σε PowerBI.com και σε όλες τις εκδόσεις του Power BI Premium.

Οι πιστοποιημένες συνδέσεις είναι οι εξής:

  • Διατήρηση από τον προγραμματιστή συνεργατών

  • Υποστηρίζεται από τον συνεργάτη προγραμματιστή

  • Πιστοποιήθηκε από τη Microsoft

  • Διανέμεται από τη Microsoft

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

Διαφορές πιστοποιημένων συνδέσεων και προσαρμοσμένων συνδέσεων

Οι πιστοποιημένες συνδέσεις ομαδοποιούνται έτοιμες προς χρήση στο Power BI Desktop και αναπτύσσονται στην υπηρεσία Power BI, στις ροές δεδομένων Power BI και στα datamarts του Power BI. Οι προσαρμοσμένες συνδέσεις υποστηρίζονται μόνο σε σημασιολογικά μοντέλα Power BI και πρέπει να φορτωθούν στο Power BI Desktop, όπως περιγράφεται στο θέμα Φόρτωση της επέκτασής σας στο Power BI Desktop. Τόσο οι πιστοποιημένες όσο και οι προσαρμοσμένες συνδέσεις μπορούν να ανανεωθούν μέσω του Power BI Desktop ή της υπηρεσίας Power BI μέσω της χρήσης μιας πύλης δεδομένων εσωτερικής εγκατάστασης με την υλοποίηση μιας δοκιμής Σύνδεση ion. Η πύλη δεδομένων εσωτερικής εγκατάστασης απαιτείται για προσαρμοσμένες συνδέσεις.

Οι πιστοποιημένες συνδέσεις στο Power BI Desktop με μια TestConnection υλοποίηση υποστηρίζουν επίσης την ολοκληρωμένη ανανέωση μέσω του cloud (Υπηρεσία Power BI) χωρίς την ανάγκη μιας πύλης δεδομένων εσωτερικής εγκατάστασης. Το Υπηρεσία Power BI περιβάλλον ουσιαστικά φιλοξενεί μια "πύλη cloud" που εκτελείται όμοια με την πύλη εσωτερικής εγκατάστασης. Μετά την πιστοποίηση, αναπτύσσουμε τη σύνδεσή σας σε αυτό το περιβάλλον, έτσι ώστε να είναι διαθέσιμη σε όλους τους πελάτες του Power BI.

Τόσο οι προσαρμοσμένες όσο και οι πιστοποιημένες συνδέσεις με επιπλέον στοιχεία (για παράδειγμα, το πρόγραμμα οδήγησης ODBC) χρειάζονται το επιπλέον στοιχείο για εγκατάσταση στον υπολογιστή τελικού χρήστη και απαιτούν την πύλη δεδομένων εσωτερικής εγκατάστασης, εκτός εάν το επιπλέον στοιχείο αναπτύσσεται στο Power BI cloud. Προς το παρόν, δεν πιστοποιούμε και αναπτύσσουμε νέα επιπλέον στοιχεία στο Power BI cloud, επομένως, η πιστοποίηση των συνδέσεων με εξάρτηση σε ένα επιπλέον στοιχείο δεν θα καταργήσει την απαίτηση πύλης δεδομένων εσωτερικής εγκατάστασης.

Κατανομή προσαρμοσμένων συνδέσεων

Οι προσαρμοσμένες συνδέσεις μπορούν και πρέπει να διανέμονται στους τελικούς χρήστες πριν από την πιστοποίηση.

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

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

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

Επισκόπηση πιστοποίησης

Προαπαιτούμενα στοιχεία

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

  • Η σύνδεση πρέπει να είναι για ένα δημόσιο προϊόν.

  • Η σύνδεση πρέπει να θεωρηθεί πλήρης κώδικας για μια αρχική έκδοση της έκδοσης. Το πρόγραμμα επιτρέπει συχνές επαναλήψεις και ενημερώσεις. Σημειώστε ότι η Microsoft δεν προσφέρει τεχνική βοήθεια ή συμβουλευτικές υπηρεσίες ανάπτυξης προσαρμοσμένων συνδέσεων. Συνιστούμε να αξιοποιούνται δημόσιοι πόροι, όπως η τεκμηρίωση SDK και το αποθετήριο δειγμάτων. Εάν χρειάζεστε περαιτέρω βοήθεια, μπορούμε να μοιραστούμε μια λίστα με γνωστούς συμβούλους ανάπτυξης προσαρμοσμένων συνδέσεων του τρίτου κατασκευαστή που μπορεί να θέλετε να συνεργαστείτε απευθείας, ξεχωριστά από οποιοδήποτε πρόγραμμα ή συνεργασία της Microsoft. Σημειώστε ότι η Microsoft δεν συνδέεται με αυτούς τους συμβούλους και δεν είναι υπεύθυνη για τη χρήση των υπηρεσιών της από μέρους σας. Η Microsoft παρέχει τη λίστα για τη διευκόλυνσή σας και χωρίς καμία διαβεβαίωση, συστάσεις ή εγγυήσεις. Επικοινωνήστε με την επαφή πιστοποίησης Microsoft για να μάθετε περισσότερα.

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

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

  • Η σύνδεση πρέπει να λειτουργεί με επιτυχία στο αναμενόμενο επίπεδο χρήσης από τους πελάτες.

  • Πρέπει να υπάρχει ένα νήμα στο φόρουμ Ιδεών Power BI που καθοδηγείται από τους πελάτες για να υποδείξει την απαίτηση για δημόσια διαθεσιμότητα της σύνδεσης στο Power BI Desktop. Δεν υπάρχει καθορισμένο όριο αλληλεπίδρασης. Ωστόσο, όσο περισσότερη δέσμευση, τόσο ισχυρότερη είναι η τεκμηριωμένη ζήτηση για τη σύνδεση.

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

Επεξεργασία και λωρίδες χρόνου

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

  • Καταχώρηση: ειδοποίηση πρόθεσης πιστοποίησης της προσαρμοσμένης σύνδεσής σας. Αυτή η καταχώρηση πρέπει να πραγματοποιηθεί μέχρι τις 15 του μήνα, δύο μήνες πριν από την έκδοση προορισμού του Power BI Desktop.

    • Για παράδειγμα, για την έκδοση Απριλίου του Power BI Desktop, η προθεσμία θα είναι 15 Φεβρουαρίου.

  • Υποβολή: υποβολή αρχείων σύνδεσης για έλεγχο από τη Microsoft. Αυτή η υποβολή πρέπει να πραγματοποιηθεί έως την 1η του μήνα πριν από την έκδοση προορισμού του Power BI Desktop.

    • Για παράδειγμα, για την έκδοση Απριλίου του Power BI Desktop, η προθεσμία θα είναι η 1η Μαρτίου.

  • Τεχνικός έλεγχος: οριστικοποίηση των αρχείων σύνδεσης, διαβίβαση ελέγχου και πιστοποίησης της Microsoft. Αυτή η αναθεώρηση πρέπει να πραγματοποιηθεί έως τις 15 του μήνα πριν από την έκδοση προορισμού του Power BI Desktop.

    • Για παράδειγμα, για την έκδοση Απριλίου του Power BI Desktop, η προθεσμία θα είναι 15 Μαρτίου.

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

Απαιτήσεις πιστοποίησης

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

Αρχεία υποβολής (Τεχνουργήματα)

Βεβαιωθείτε ότι τα αρχεία σύνδεσης που υποβάλετε περιλαμβάνουν όλα τα εξής:

  • αρχείο Σύνδεση ή (.mez)

    • Το αρχείο .mez πρέπει να ακολουθεί πρότυπα στυλ και να ονομάζεται όμοια με το όνομα του προϊόντος ή της υπηρεσίας. Δεν πρέπει να περιλαμβάνει λέξεις όπως "Power BI", "Σύνδεση or" ή "API".
    • Ονομάστε το αρχείο .mez: ProductName.mez

  • Αρχείο Power BI Desktop (.pbix) για δοκιμή

    • Απαιτείται ένα δείγμα αναφοράς Power BI (.pbix) για τον έλεγχο της σύνδεσής σας.
    • Η αναφορά θα πρέπει να περιλαμβάνει τουλάχιστον ένα ερώτημα για να ελέγξετε κάθε στοιχείο στον πίνακα περιήγησής σας.
    • Εάν δεν υπάρχει σχήμα συνόλου (για παράδειγμα, βάσεις δεδομένων), η αναφορά πρέπει να περιλαμβάνει ένα ερώτημα για κάθε "τύπο" του πίνακα που μπορεί να χειρίζεται η σύνδεση.

  • Δοκιμή λογαριασμού στην προέλευση δεδομένων σας

    • Χρησιμοποιούμε τον δοκιμαστικό λογαριασμό για να ελέγξουμε και να αντιμετωπίσουμε προβλήματα με τη σύνδεσή σας.
    • Καταχωρήστε έναν δοκιμαστικό λογαριασμό που είναι μόνιμος, ώστε να μπορούμε να χρησιμοποιήσουμε τον ίδιο λογαριασμό για την πιστοποίηση τυχόν μελλοντικών ενημερώσεων.

  • Οδηγίες δοκιμής

    • Καταχωρήστε οποιαδήποτε τεκμηρίωση σχετικά με τον τρόπο χρήσης της σύνδεσης και τη δοκιμή των λειτουργιών της.

  • Συνδέσεις σε εξωτερικές εξαρτήσεις (για παράδειγμα, προγράμματα οδήγησης ODBC)

Δυνατότητες και στυλ

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

  • Η σύνδεση ΠΡΕΠΕΙ να:

  • Το FunctionName θα πρέπει να έχει νόημα για τον τομέα (για παράδειγμα, "Περιεχόμενα", "Πίνακες", "Έγγραφο", "Βάσεις δεδομένων" και ούτω καθεξής).

  • Η σύνδεση ΠΡΕΠΕΙ:

    • Να έχετε εικονίδια.
    • Καταχωρήστε έναν πίνακα περιήγησης.
    • Τοποθετήστε συμβολοσειρές σε ένα resources.resx αρχείο. Οι διευθύνσεις URL και οι τιμές πρέπει να κωδικοποιούνται στον κώδικα σύνδεσης και να μην τοποθετούνται στο resources.resx αρχείο.

Ασφάλεια

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

  • Εάν Extension.CurrentCredentials() χρησιμοποιείται:

    • Απαιτείται η χρήση; Σε αυτή την περίπτωση, πού αποστέλλονται τα διαπιστευτήρια;
    • Είναι εγγυημένη η υποβολή των αιτήσεων μέσω HTTPS;
      • Μπορείτε να χρησιμοποιήσετε τη συνάρτηση βοηθητικής εφαρμογής HTTPS.
    • Αν τα διαπιστευτήρια αποστέλλονται μέσω Web.Contents() του GET:
      • Μπορεί να μετατραπεί σε POST;
      • Εάν απαιτείται GET, η σύνδεση ΠΡΕΠΕΙ να χρησιμοποιήσει την CredentialQueryString εγγραφή στην Web.Contents() εγγραφή επιλογών για τη μεταβίβαση ευαίσθητων διαπιστευτηρίων.

  • Εάν χρησιμοποιούνται συναρτήσεις Diagnostics.*:

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

  • Εάν Expression.Evaluate() χρησιμοποιείται:

    • Επαληθεύστε από πού προέρχεται η παράσταση και τι είναι (δηλαδή, μπορεί να πραγματοποιείται δυναμική κατασκευή κλήσεων προς Extension.CurrentCredentials() και ούτω καθεξής).
    • Δεν Expression θα πρέπει να παρέχεται ο χρήστης ούτε να λαμβάνει δεδομένα εισόδου από τον χρήστη.
    • Η Expression δεν πρέπει να είναι δυναμική (δηλαδή, ανακτώνται από μια κλήση Web).

Εγγραφή για πιστοποίηση

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

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

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

Μετά την πιστοποίηση

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

  • Εσείς και οι τελικοί χρήστες θα πρέπει να χρησιμοποιήσετε την έκδοση πιστοποιημένης σύνδεσης που περιλαμβάνεται στο Power BI Desktop και την πύλη δεδομένων εσωτερικής εγκατάστασης και να καταργήσετε τυχόν υπάρχοντα αρχεία .mez ή .pqx (προσαρμοσμένες συνδέσεις) που χρησιμοποιούνται πριν από την πιστοποίηση. Εάν δεν το κάνετε αυτό, η προσαρμοσμένη σύνδεσή σας θα χρησιμοποιηθεί κατά λάθος από το Power Query αντί για τη νέα πιστοποιημένη σύνδεση.
  • Οι προσαρμοσμένες συνδέσεις πρέπει να χρησιμοποιούνται μόνο για τη δοκιμή νέων εκδόσεων της σύνδεσης.
  • Όταν εργάζεστε με τελικούς χρήστες και πελάτες, βεβαιωθείτε ότι κατανοούν ότι κατανοούν ότι η έκδοση προσαρμοσμένης σύνδεσης που χρησιμοποιείται κατά τη δοκιμή πριν από την πιστοποίηση θα πρέπει να καταργηθεί μετά την ολοκλήρωση της δοκιμής και ότι η νέα έκδοση πιστοποιημένης σύνδεσης είναι διαθέσιμη.

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

Σημείωμα

Οι εφαρμογές προτύπου δεν υποστηρίζουν συνδέσεις που απαιτούν πύλη.