Κοινοποίηση μέσω

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

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

Μια σύνδεση δεδομένων αναδιπλώνει και προσαρμόζει τη συμπεριφορά μιας συνάρτησης προέλευσης δεδομένων στη βιβλιοθήκη M. Για παράδειγμα, μια επέκταση για ένα REST API θα χρησιμοποιούσε τη συνάρτηση 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")
];

Ιδιότητες

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

Πεδίο Τύπος Λεπτομέρειες
Authentication καταγράφω Καθορίζει έναν ή περισσότερους τύπους ελέγχου ταυτότητας που υποστηρίζονται από την προέλευση δεδομένων σας. Απαιτείται τουλάχιστον ένα είδος. Κάθε είδος θα εμφανίζεται ως επιλογή στη γραμμή εντολών διαπιστευτηρίων Power Query. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Είδη ελέγχου ταυτότητας.
Ετικέτα κείμενο (προαιρετικός) Φιλικό εμφανιζόμενο όνομα για αυτήν την επέκταση σε διαλόγους διαπιστευτηρίων.
ΥποστηρίζειΚρυπτογράφηση λογικός (προαιρετικός) Όταν είναι αληθές, το περιβάλλον εργασίας χρήστη θα παρουσιάσει την επιλογή σύνδεσης στην προέλευση δεδομένων χρησιμοποιώντας μια κρυπτογραφημένη σύνδεση. Αυτό χρησιμοποιείται συνήθως για προελεύσεις δεδομένων με μη κρυπτογραφημένο εναλλακτικό μηχανισμό (γενικά προελεύσεις που βασίζονται σε 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 που περιέχει περισσότερες πληροφορίες σχετικά με αυτήν την προέλευση δεδομένων ή τη σύνδεση.
Υποστηρίζει το DirectQuery λογικός (προαιρετικός) Ενεργοποιεί το Direct Query για την επέκτασή σας.
ΠηγήΕικόνα καταγράφω (προαιρετικός) Μια εγγραφή που περιέχει μια λίστα δυαδικών εικόνων (που προέρχονται από το αρχείο επέκτασης χρησιμοποιώντας τη μέθοδο Extension.Contents ). Η εγγραφή περιέχει δύο πεδία (Icon16, Icon32), το καθένα με τη δική του λίστα. Κάθε εικονίδιο πρέπει να έχει διαφορετικό μέγεθος.
ΤύποςΠηγήςΕικόνα καταγράφω (προαιρετικός) Παρόμοια με το SourceImage, εκτός από τη σύμβαση για πολλές έτοιμες συνδέσεις είναι να εμφανίζεται ένα εικονίδιο φύλλου με το εικονίδιο συγκεκριμένης πηγής στην κάτω δεξιά γωνία. Η ύπαρξη διαφορετικού συνόλου εικονιδίων για το SourceTypeImage είναι προαιρετική - πολλές επεκτάσεις απλώς επαναχρησιμοποιούν το ίδιο σύνολο εικονιδίων και για τα δύο πεδία.
  • Last updated on