Χειρισμός υποστήριξης πύλης

Έλεγχος σύνδεσης

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

Η μέθοδος υλοποίησης της δοκιμής Σύνδεση ion είναι πιθανό να αλλάξει ενώ τα προσαρμοσμένα δεδομένα του Power BI Σύνδεση ή λειτουργικότητα είναι σε προεπισκόπηση.

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

(dataSourcePath) as list => ...

Όπου dataSourcePath είναι η τιμή Διαδρομή προέλευσης δεδομένων για τη συνάκρισή σας και η τιμή επιστροφής είναι μια λίστα που αποτελείται από:

• Το όνομα της συνάρτησης που θα καλέσετε (αυτή η συνάρτηση πρέπει να επισημανθεί ως #sharedκαι είναι συνήθως η κύρια συνάρτηση προέλευσης δεδομένων).
• Ένα ή περισσότερα ορίσματα για μεταβίβαση στη συνάκησή σας.

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

Σημείωμα

Όπως προαναφέρθηκε, το όνομα της συνάρτησης που παρέχεται από τη συνάρτηση Test Σύνδεση ion πρέπει να είναι shared μέλος.

Παράδειγμα: Σύνδεση ή χωρίς απαιτούμενα ορίσματα

Το παρακάτω τμήμα κώδικα υλοποιεί τη δοκιμή Σύνδεση ion για μια προέλευση δεδομένων χωρίς τις απαιτούμενες παραμέτρους (όπως αυτή που βρέθηκε στο πρόγραμμα εκμάθησης TripPin). Σύνδεση ors χωρίς απαιτούμενες παραμέτρους (αναφέρονται ως "Singletons") δεν χρειάζονται είσοδο από τον χρήστη για να δοκιμάσουν μια σύνδεση (εκτός από τα διαπιστευτήρια). Σε αυτήν την περίπτωση, η dataSourcePath τιμή θα ισούται με το όνομα του είδους προέλευσης δεδομένων και μπορεί να αγνοηθεί. Η TripPin.Contents συνάρτηση καλείται χωρίς πρόσθετες παραμέτρους.

TripPin = [
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin"
];

Παράδειγμα: Σύνδεση ή με παράμετρο διεύθυνσης URL

Εάν η συνάρτηση προέλευσης δεδομένων σας έχει μια μοναδική απαιτούμενη παράμετρο του τύπου Uri.Type, θα είναι dataSourcePath ίση με τη διεύθυνση URL που παρέχεται από τον χρήστη. Το παρακάτω τμήμα εμφανίζει την υλοποίηση Test Σύνδεση ion από το δείγμα Github.

GithubSample = [
    TestConnection = (dataSourcePath) => {"GithubSample.Contents", dataSourcePath},
    Authentication = [
        OAuth = [
            StartLogin = StartLogin,
            FinishLogin = FinishLogin,
            Label = Extension.LoadString("AuthenticationLabel")
        ]
    ]
];

Παράδειγμα: Σύνδεση ή με τις απαιτούμενες παραμέτρους

Εάν η συνάρτηση προέλευσης δεδομένων έχει πολλές παραμέτρους ή μία παράμετρο που δεν είναι διεύθυνση URL, τότε η dataSourcePath τιμή θα είναι μια συμβολοσειρά JSON που περιέχει τις παραμέτρους. Το παρακάτω τμήμα προέρχεται από το δείγμα DirectQueryForSQL .

DirectSQL = [
    TestConnection = (dataSourcePath) =>
        let
            json = Json.Document(dataSourcePath),
            server = json[server],
            database = json[database]
        in
            { "DirectSQL.Database", server, database },
    Authentication = [
        Windows = [],
        UsernamePassword = []
    ],
    Label = "Direct Query for SQL"
];