Δικαιώματα REST API σημασιολογικού μοντέλου
Αυτό το άρθρο περιγράφει γενικά τα δικαιώματα του Power BI και τα δικαιώματα μοντέλου σημασιολογίας στο περιβάλλον των Power BI REST API.
Δικαιώματα Power BI
Το Power BI διαθέτει δύο σύνολα δικαιωμάτων:
Δικαιώματα χώρου εργασίας
Τα δικαιώματα χώρου εργασίας, γνωστά επίσης ως δικαιώματα ή ρόλοι φακέλων, είναι το υψηλότερο επίπεδο δικαιωμάτων στο Power BI. Αυτά τα δικαιώματα παρακάμπτουν τα δικαιώματα που εκχωρούνται σε ένα συγκεκριμένο στοιχείο στον φάκελο του χώρου εργασίας.
Ο παρακάτω πίνακας παραθέτει τους τέσσερις τύπους ρόλων φακέλων. Εμφανίζει το επίπεδο κάθε ρόλου και τη συμβολοσειρά κώδικα που επιστρέφεται από τα Power BI REST API. Διαχείριση είναι το υψηλότερο επίπεδο δικαιωμάτων χώρου εργασίας και ο θεατής είναι ο χαμηλότερος. Κάθε επίπεδο δικαιωμάτων περιλαμβάνει τις δυνατότητες των δικαιωμάτων που ακολουθούν. Μπορείτε να εξετάσετε τις δυνατότητες κάθε δικαιώματος σε ρόλους χώρου εργασίας.
| Ρόλος φακέλου | Επίπεδο | Παραγόμενα δικαιώματα για σημασιολογικά μοντέλα που δημιουργήθηκαν στον χώρο εργασίας |
|---|---|---|
| Διαχείριση | 4 | ReadWriteReshareExplore |
| Μέλος | 3 | ReadWriteReshareExplore |
| Συμβάλλων | 2 | ReadWriteExplore |
| Θεατής | 1 | Read |
Σημείωμα
Το δικαίωμα εγγραφής εφαρμόζεται σε σημασιολογικά μοντέλα Power BI που έχουν δημιουργηθεί από διαχειριστές, μέλη και συμβάλλοντες χρήστες σε έναν χώρο εργασίας που κατέχουν. Το δικαίωμα εγγραφής μπορεί να εκχωρηθεί ή να διαγραφεί μόνο με χρήση δικαιωμάτων χώρου εργασίας. Δεν είναι δυνατή η απευθείας εκχώρηση ή διαγραφή του από ένα στοιχείο Power BI.
Λήψη και προσθήκη δικαιωμάτων χώρου εργασίας με API
Για να λάβετε και να προσθέσετε δικαιώματα χώρου εργασίας μέσω προγραμματισμού, χρησιμοποιήστε αυτά τα API:
Ομάδες - Προσθήκη χρήστη ομάδας - Ένα API POST για την προσθήκη δικαιωμάτων χώρου εργασίας
Ομάδες - Ενημέρωση χρήστη ομάδας - Ένα API PUT για την αλλαγή δικαιωμάτων χώρου εργασίας
Ομάδες - Λήψη χρηστών ομάδας - A GET API για τη λήψη δικαιωμάτων χώρου εργασίας
Δικαιώματα στοιχείου
Τα στοιχεία Power BI, όπως οι αναφορές, τα σημασιολογικά μοντέλα και οι πίνακες εργαλείων έχουν τα δικά τους δικαιώματα. Τα δικαιώματα στοιχείων δεν μπορούν να αντικαταστήσουν τα δικαιώματα χώρου εργασίας και μπορούν να εκχωρηθούν μόνο από κάποιον που έχει τουλάχιστον το ίδιο επίπεδο δικαιωμάτων.
Δικαιώματα μοντέλου σημασιολογίας και API REST
Τα δικαιώματα μοντέλου σημασιολογίας αποτελούν μέρος των δικαιωμάτων στοιχείων. Ο παρακάτω πίνακας παραθέτει τα δικαιώματα σημασιολογικού μοντέλου Power BI και την αναπαράσταση στα Power BI REST API.
Φιλοδώρημα
Παρόλο που τα δικαιώματα API είναι πανομοιότυπα με τα δικαιώματα Υπηρεσία Power BI, build τα δικαιώματα αναφέρονται ως δικαιώματα εξερεύνησης στα API.
| Δικαίωμα | Αναγνωσμένη | Εξερευνήστε | Επανάληψη κοινής χρήσης |
|---|---|---|---|
| Περιγραφή | Επιτρέπει στο χρήστη να διαβάσει το περιεχόμενο του μοντέλου σημασιολογίας | Ισοδύναμο με τα δικαιώματα δημιουργίας | Επιτρέπει στο χρήστη να κάνει κοινή χρήση του περιεχομένου του μοντέλου σημασιολογίας με άλλους χρήστες που θα λάβουν δικαιώματα ανάγνωσης, εκ νέου κοινής χρήσης ή εξερεύνησης για αυτό |
| ReadReshareExplore | 
|
|
|
| ReadReshare |
|
|
|
| ReadExplore |
|
|
|
| Αναγνωσμένη |
|
|
|
Σημείωμα
Για να επιτρέψετε σε έναν χρήστη να εκτελεί λειτουργίες εγγραφής σε ένα μοντέλο σημασιολογίας, αλλάξτε πρώτα τα δικαιώματα χώρου εργασίας.
Δικαιώματα δημιουργίας και API REST
Στα Power BI REST API, το build δικαίωμα επιστρέφεται ως εξερεύνηση. Για παράδειγμα, μια συμβολοσειρά με τα δικαιώματα ανάγνωσης, κοινής χρήσης εκ νέου και δόμησης , θα μοιάζει κάπως έτσι: ReadReshareExplore.
Όταν παραχωρείτε σε έναν χρήστη build το δικαίωμα, μπορεί να δημιουργήσει νέο περιεχόμενο στο σημασιολογικό μοντέλο σας. Παραδείγματα περιεχομένου που μπορούν να δημιουργήσουν είναι αναφορές, πίνακες εργαλείων, καρφιτσωμένα πλακίδια από ερωτήσεις και απαντήσεις, σελιδοποιημένες αναφορές και Πληροφορίες Discovery.
Οι χρήστες χρειάζονται build επίσης δικαιώματα για εργασία με δεδομένα εκτός του Power BI:
Για να εξαγάγετε τα υποκείμενα δεδομένα.
Για να δημιουργήσετε νέο περιεχόμενο στο μοντέλο σημασιολογίας όπως με την Ανάλυση στο Excel.
Για πρόσβαση στα δεδομένα μέσω του τελικού σημείου XMLA.
Ασφάλεια σε επίπεδο γραμμών
Για ένα σημασιολογικό μοντέλο που χρησιμοποιεί ασφάλεια σε επίπεδο γραμμών (RLS), οποιαδήποτε δικαιώματα υψηλότερα από build αυτά θα επιτρέψουν στον χρήστη να προβάλει όλα τα δεδομένα στο μοντέλο σημασιολογίας. BuildΤα δικαιώματα , και που είναι χαμηλότερα από buildτο , θα παρέχουν μόνο στον χρήστη μοντέλου σημασιολογίας πρόσβαση στα δεδομένα που επιτρέπεται να βλέπουν όπως έχουν ρυθμιστεί στις ρυθμίσεις RLS.
Λήψη και ενημέρωση δικαιωμάτων μοντέλου σημασιολογίας με API
Τα API POST σάς επιτρέπουν να προσθέσετε νέα δικαιώματα σε ένα μοντέλο σημασιολογίας. Μπορείτε να χρησιμοποιήσετε αυτά τα API για να προσθέσετε δικαιώματα για χρήστες, όχι όμως για να καταργήσετε δικαιώματα. Για παράδειγμα, μπορείτε να προσθέσετε το
Reshareδικαίωμα σε έναν χρήστη που έχει τοReadδικαίωμα. Ωστόσο, δεν μπορείτε να καταργήσετε τοReshareδικαίωμα από έναν χρήστη που διαθέτει δικαιώματα καιReshareτα δύοRead, επιχειρώντας να προσθέσετε τοReadδικαίωμα.ΤΑ API PUT ενημερώνουν τα δικαιώματα του χρήστη σε ένα συγκεκριμένο σύνολο δεδομένων. Το PUT API δεν μπορεί να χρησιμοποιηθεί για την αλλαγή δικαιωμάτων εγγραφής ή τυχόν δικαιωμάτων μεταβίβασης σε επίπεδο φακέλου. Αυτό το API υποστηρίζει επίσης την κατάργηση όλων των δικαιωμάτων για ένα σύνολο δεδομένων για έναν συγκεκριμένο προορισμό.
Τα API GET επιστρέφουν μια λίστα με τις κύριες αρχές που έχουν πρόσβαση στο καθορισμένο σύνολο δεδομένων.
Ζητήματα προς εξέταση και περιορισμοί
Καθένα από τα παραπάνω API συνοδεύεται από ορισμένους περιορισμούς σχετικά με το ποιος μπορεί να τα χρησιμοποιήσει και πώς. Για να δείτε τους περιορισμούς κάθε API, επιλέξτε τη σύνδεση για αυτό το API.