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

Χειρισμός πρόσβασης δεδομένων

  • Άρθρο

Συναρτήσεις προέλευσης δεδομένων

Ένας Σύνδεση ή δεδομένων αναδιπλώνει και προσαρμόζει τη συμπεριφορά μιας συνάρτησης προέλευσης δεδομένων στη βιβλιοθήκη M. Για παράδειγμα, μια επέκταση για ένα API REST θα έκανε χρήση της συνάρτησης Web.Contents για την πραγματοποίηση αιτήσεων HTTP. Προς το παρόν, έχει ενεργοποιηθεί ένα περιορισμένο σύνολο συναρτήσεων προέλευσης δεδομένων για την υποστήριξη της επεκτασιμότητας.

Παράδειγμα:

[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;

Είδος προέλευσης δεδομένων

Οι συναρτήσεις που επισημαίνονται ως shared στην επέκτασή σας μπορούν να συσχετιστούν με μια συγκεκριμένη προέλευση δεδομένων, συμπεριλαμβάνοντας ένα DataSource.Kind χαρακτηριστικό λεκτικής σταθεράς στη συνάρτηση με το όνομα μιας εγγραφής ορισμού προέλευσης δεδομένων. Η εγγραφή Προέλευση δεδομένων ορίζει τους τύπους ελέγχου ταυτότητας που υποστηρίζονται από την προέλευση δεδομένων σας και βασικές πληροφορίες εμπορικής προσαρμογής (όπως το εμφανιζόμενο όνομα/ετικέτα). Το όνομα της εγγραφής μετατρέπεται σε μοναδικό αναγνωριστικό της.

Κάθε συνάρτηση που συσχετίζεται με την ίδια προέλευση δεδομένων πρέπει να έχει τις ίδιες απαιτούμενες παραμέτρους συνάρτησης, συμπεριλαμβανομένου του ονόματος, του τύπου και της σειράς. (Για σκοπούς τύπου προέλευσης δεδομένων, μια παράμετρος δεν θεωρείται υποχρεωτική εάν επισημανθεί optional ή αν τα μετα-δεδομένα της περιέχουν DataSource.Path = false.)

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

Παράδειγμα:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Ιδιότητες

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

Πεδίο Τύπος Λεπτομέρειες
Έλεγχος ταυτότητας Εγγραφή Καθορίζει έναν ή περισσότερους τύπους ελέγχου ταυτότητας που υποστηρίζονται από την προέλευση δεδομένων σας. Απαιτείται τουλάχιστον ένα είδος. Κάθε είδος θα εμφανίζεται ως επιλογή στη γραμμή εντολών για διαπιστευτήρια του Power Query. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Είδη ελέγχου ταυτότητας.
Ετικέτα κείμενο (προαιρετικό) Φιλικό εμφανιζόμενο όνομα για αυτήν την επέκταση στα παράθυρα διαλόγου διαπιστευτηρίων.
ΥποστήριξηΚρυπτογράφηση Λογική (προαιρετικό) Όταν είναι true, το περιβάλλον εργασίας χρήστη θα παρουσιάσει την επιλογή σύνδεσης στην προέλευση δεδομένων χρησιμοποιώντας μια κρυπτογραφημένη σύνδεση. Αυτό χρησιμοποιείται συνήθως για προελεύσεις δεδομένων με μη κρυπτογραφημένο εναλλακτικό μηχανισμό (γενικά προελεύσεις ODBC ή ADO.NET).

Δημοσίευση στο περιβάλλον εργασίας χρήστη

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

Παράδειγμα:

HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];

HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Ιδιότητες

Ο παρακάτω πίνακας παραθέτει τα πεδία για την εγγραφή σας Δημοσίευση.

Πεδίο Τύπος Λεπτομέρειες
Κείμενο κουμπιού λίστα Λίστα στοιχείων κειμένου. Το πρώτο στοιχείο ορίζει το όνομα που εμφανίζεται δίπλα στο εικονίδιο της προέλευσης δεδομένων στο παράθυρο διαλόγου Λήψη δεδομένων του Power BI. Το δεύτερο στοιχείο (προαιρετικό) ορίζει τη συμβουλή εργαλείου που θα εμφανίζεται όταν το προηγούμενο όνομα βρίσκεται πάνω από το ποντίκι.
Category κείμενο Όπου θα πρέπει να εμφανίζεται η επέκταση στο παράθυρο διαλόγου Λήψη δεδομένων . Προς το παρόν, οι μοναδικές τιμές κατηγορίας με ειδικές τιμές είναι Azure και Database. Όλες οι άλλες τιμές θα καταλήξουν στην κατηγορία Άλλο.
Βήτα Λογική (προαιρετικό) Όταν οριστεί σε true, το περιβάλλον εργασίας χρήστη θα εμφανίζει ένα αναγνωριστικό προεπισκόπησης/beta δίπλα στο όνομα της σύνδεσης και ένα παράθυρο διαλόγου προειδοποίησης ότι η υλοποίηση της σύνδεσης υπόκειται σε νέες αλλαγές.
LearnMoreUrl κείμενο (προαιρετικό) Διεύθυνση URL προς τοποθεσία Web που περιέχει περισσότερες πληροφορίες σχετικά με αυτή την προέλευση δεδομένων ή σύνδεση.
SupportsDirectQuery Λογική (προαιρετικό) Ενεργοποιεί το Direct Query για την επέκτασή σας.
SourceImage Εγγραφή (προαιρετικό) Μια εγγραφή που περιέχει μια λίστα δυαδικών εικόνων (που προέρχεται από το αρχείο επέκτασης χρησιμοποιώντας τη μέθοδο Extension.Contents ). Η εγγραφή περιέχει δύο πεδία (Icon16, Icon32), το καθένα με τη δική του λίστα. Κάθε εικονίδιο πρέπει να έχει διαφορετικό μέγεθος.
SourceTypeImage Εγγραφή (προαιρετικό) Παρόμοια με το SourceImage, εκτός από τη σύμβαση για πολλές έτοιμες συνδέσεις είναι να εμφανίζεται ένα εικονίδιο φύλλου με το εικονίδιο συγκεκριμένης προέλευσης στην κάτω δεξιά γωνία. Η ύπαρξη ενός διαφορετικού συνόλου εικονιδίων για το SourceTypeImage είναι προαιρετική— πολλές επεκτάσεις απλώς χρησιμοποιούν ξανά το ίδιο σύνολο εικονιδίων και για τα δύο πεδία.