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

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

  • Άρθρο

Σημαντικό

Το πρόγραμμα πιστοποίησης σύνδεσης υποβάλλεται αυτήν τη στιγμή σε αλλαγές και η εγγραφή για νέες πιστοποιήσεις σύνδεσης είναι αυτήν τη στιγμή σε αναμονή. Σκοπεύουμε να ενεργοποιήσουμε εκ νέου αυτήν τη διαδικασία εγγραφής κατά τη διάρκεια του πρώτου τριμήνου του ημερολογιακού έτους 2025. Εάν έχετε μια πιστοποιημένη σύνδεση που θέλετε να ενημερώσετε, επικοινωνήστε με την ομάδα μας στη dataconnectors@microsoft.com διεύθυνση για οδηγίες σχετικά με τον τρόπο υποβολής μιας νέας έκδοσης.

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

Η πιστοποίηση μιας σύνδεσης Data Factory καθιστά τη σύνδεση διαθέσιμη δημοσίως, έτοιμες για χρήση, microsoft Fabric Data Factory και Microsoft Power BI στις εξής εμπειρίες:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Σημασιολογικό μοντέλο Microsoft Power BI (στην υπηρεσία Power BI)
  • Microsoft Power BI Desktop
  • Πύλη δεδομένων εσωτερικής εγκατάστασης για το Microsoft Fabric και το Microsoft Power BI

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

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

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

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

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

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

Σημείωμα

Σήμερα μπορείτε να αξιοποιήσετε το Power Query SDK για να δημιουργήσετε μια σύνδεση που μπορεί να πιστοποιηθεί μέσω του προγράμματος πιστοποίησης της σύνδεσης Data Factory. Μεταβείτε στην επισκόπηση του Power Query SDK για να μάθετε περισσότερα σχετικά με αυτό το εργαλείο.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Χρησιμοποιήστε τη μορφή εγγράφου ενότητας.
    • Περιέχουν μια κεφαλίδα/στολισμό έκδοσης πάνω από το έγγραφο ενότητας.
    • Δώστε μετα-δεδομένα τεκμηρίωσης συνάρτησης.
    • Να έχετε τον χειρισμό TestConnection.
    • Ακολουθήστε τους κανόνες ονομασίας (για παράδειγμα, DataSourceKind.FunctionName). Δεν πρέπει να περιλαμβάνει λέξεις όπως "Fabric", "Power BI", "Connector" ή "API".
    • Επιστρέφει δεδομένα σε μορφή πίνακα, οργανωμένα σε πίνακες με στήλες, όπως για μια σχεσιακή προέλευση δεδομένων. Δεν υποστηρίζονται πολυδιάστατες μορφές που βασίζονται σε κύβους, διαστάσεις και μετρήσεις.
    • Συμπεριφέρεται όμοια στη λειτουργία Εισαγωγή και DirectQuery, επιστρέφοντας πανομοιότυπα αποτελέσματα.
    • Ορίστε τη σημαία Beta σε True κατά την αρχική έκδοση.

  • Το 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).

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

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

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