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


Εκτέλεση σάρωσης μετα-δεδομένων

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

Για τη λίστα των μετα-δεδομένων αντικειμένου σχεδίασης και subartifact που επιστρέφει η σάρωση μετα-δεδομένων, ανατρέξτε στην τεκμηρίωση για το API Διαχείριση - WorkspaceInfo GetScanResult API.

Ακολουθούν τα API του σαρωτή. Υποστηρίζουν τόσο δημόσια όσο και εθνικά cloud.

Σημαντικό

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

Βήμα 1: Εκτέλεση πλήρους σάρωσης

Καλέστε χώρους εργασίας/τροποποιημένους χωρίς την τροποποιημένη παράμετροSince για να λάβετε την πλήρη λίστα των αναγνωριστικών χώρου εργασίας στον μισθωτή. Αυτή η σάρωση ανακτά όλους τους χώρους εργασίας στον μισθωτή, συμπεριλαμβανομένων των προσωπικών χώρων εργασίας και των κοινόχρηστων χώρων εργασίας. Εάν θέλετε να εξαιρέσετε τους προσωπικούς χώρους εργασίας από τη σάρωση, χρησιμοποιήστε την παράμετρο χώροι εργασίας/τροποποιημένηεξαίρεσηΠροσωπικό Χώροι εργασίας.

Διαιρέστε τη λίστα σε τμήματα των 100 χώρων εργασίας το πολύ.

Για κάθε τμήμα 100 χώρων εργασίας:

Καλέστε χώρους εργασίας/getInfo για να ενεργοποιήσετε μια κλήση σάρωσης για αυτούς τους 100 χώρους εργασίας. Θα λάβετε το scanId στην απόκριση που θα χρησιμοποιήσετε στα επόμενα βήματα. Στην κεφαλίδα τοποθεσίας, θα λάβετε επίσης το Ενιαίο αναγνωριστικό πόρου (URI) που θα ζητήσει το επόμενο βήμα.

Σημείωμα

Δεν μπορούν να γίνουν ταυτόχρονα περισσότερες από 16 κλήσεις. Ο καλών θα πρέπει να περιμένει μια επιτυχημένη/αποτυχημένη απόκριση σάρωσης από το API scanStatus πριν από την κλήση μιας άλλης κλήσης.

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

Χρησιμοποιήστε το URI από την κεφαλίδα τοποθεσίας που λάβατε από την κλήση χώρων εργασίας/getInfo και τη δημοσκόπηση σε χώρους εργασίας/scanStatus/{scan_id} μέχρι η κατάσταση που επιστρέφεται να είναι "Ολοκληρώθηκε με επιτυχία". Αυτή η κατάσταση σημαίνει ότι το αποτέλεσμα της σάρωσης είναι έτοιμο. Συνιστάται να χρησιμοποιείτε ένα διάστημα ανίχνευσης 30-60 δευτερολέπτων. Στην κεφαλίδα τοποθεσίας, λαμβάνετε επίσης το URI για κλήση στο επόμενο βήμα. Χρησιμοποιήστε το μόνο όταν η κατάσταση είναι "Ολοκληρώθηκε με επιτυχία".

Χρησιμοποιήστε το URI από την κεφαλίδα τοποθεσίας που λάβατε από την κλήση χώρων εργασίας/scanStatus/{scan-id} και διαβάστε τα δεδομένα χρησιμοποιώντας χώρους εργασίας/scanResult/{scan_id}. Τα δεδομένα περιέχουν τη λίστα χώρων εργασίας, πληροφοριών στοιχείων και άλλων μετα-δεδομένων με βάση τις παραμέτρους που μεταβιβάζονται στην κλήση χώροι εργασίας/getInfo .

Βήμα 2: Εκτέλεση επαυξητικής σάρωσης

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

Καλέστε χώρους εργασίας/τροποποιημένους με την τροποποιημένη παράμετροSince ορισμένη στην ώρα έναρξης της τελευταίας σάρωσης, προκειμένου να λάβετε τους χώρους εργασίας που έχουν αλλάξει και οι οποίοι, επομένως, απαιτούν άλλη σάρωση. Η παράμετρος modifiedSince πρέπει να οριστεί για μια ημερομηνία εντός των τελευταίων 30 ημερών.

Διαιρέστε αυτή τη λίστα σε τμήματα έως και 100 χώρων εργασίας και λάβετε τα δεδομένα για αυτούς τους τροποποιημένους χώρους εργασίας χρησιμοποιώντας τις τρεις κλήσεις API, χώρους εργασίας/getInfo, χώρους εργασίας/scanStatus/{scan_id}και χώρους εργασίας/scanResult/{scan_id}, όπως περιγράφεται στο Βήμα 1.

Ζητήματα προς εξέταση και περιορισμοί

  • Τα σημασιολογικά μοντέλα που δεν έχουν ανανεωθεί ή αναδημοσιευτεί θα επιστραφούν σε αποκρίσεις API αλλά χωρίς τις πληροφορίες και τις παραστάσεις τους. Για παράδειγμα, το όνομα μοντέλου σημασιολογίας και η καταγωγή περιλαμβάνονται στην απόκριση, αλλά όχι στα ονόματα πινάκων και στηλών του μοντέλου σημασιολογίας.
  • Τα σημασιολογικά μοντέλα που περιέχουν μόνο πίνακες DirectQuery θα επιστρέφουν μετα-δεδομένα subartifact μόνο εάν έχει γίνει κάποιο είδος ενέργειας στο σημασιολογικό μοντέλο, όπως κάποιος που δημιουργεί μια αναφορά πάνω από αυτό, κάποιος που προβάλλει μια αναφορά βάσει αυτής κ.λπ.
  • Τα σύνολα δεδομένων σε πραγματικό χρόνο, τα σημασιολογικά μοντέλα με ασφάλεια σε επίπεδο αντικειμένου, τα σημασιολογικά μοντέλα με δυναμική σύνδεση σε AS-Azure και AS εσωτερικής εγκατάστασης και τα σύνολα δεδομένων πλήρους πιστότητας του Excel δεν υποστηρίζονται για μετα-δεδομένα subartifact. Για μη υποστηριζόμενα σύνολα δεδομένων, η απόκριση επιστρέφει την αιτία για τη μη λήψη των μετα-δεδομένων subartifact από το σύνολο δεδομένων. Βρίσκεται σε ένα πεδίο με την ονομασία schemaRetrievalError, για παράδειγμα, schemaRetrievalError: Μη υποστηριζόμενη αίτηση. Δεν υποστηρίζεται το σύνολο δεδομένων Σε πραγματικό χρόνο.
  • Το API δεν επιστρέφει μετα-δεδομένα subartifact για σημασιολογικά μοντέλα που είναι μεγαλύτερα από 1 GB σε κοινόχρηστους χώρους εργασίας. Στους premium χώρους εργασίας, δεν υπάρχει περιορισμός μεγέθους για τα σημασιολογικά μοντέλα.

Παραχώρηση αδειών χρήσης

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