Share via


Αυτοματοποίηση εργασιών Premium χώρου εργασίας και σημασιολογικού μοντέλου με οντότητες υπηρεσίας

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

Το Power BI Premium χρησιμοποιεί την ίδια λειτουργικότητα κύριας υπηρεσίας με το Power BI Embedded. Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Ενσωμάτωση περιεχομένου Power BI με οντότητες υπηρεσίας.

Στο Power BI Premium, μπορείτε να χρησιμοποιήσετε οντότητες υπηρεσίας με το τελικό σημείο XMLA (ανάλυση XML) για την αυτοματοποίηση εργασιών διαχείρισης σημασιολογικών μοντέλων, όπως η παροχή χώρων εργασίας, η ανάπτυξη μοντέλων και η ανανέωση σημασιολογικών μοντέλων με:

  • Powershell.
  • Azure Automation.
  • Azure Logic Apps.
  • Προσαρμοσμένες εφαρμογές προγράμματος-πελάτη.

Μόνο οι νέοι χώροι εργασίας υποστηρίζουν συνδέσεις τελικού σημείου XMLA χρησιμοποιώντας οντότητες υπηρεσίας. Οι κλασικοί χώροι εργασίας δεν υποστηρίζονται. Μια κύρια υπηρεσία έχει μόνο τα απαραίτητα δικαιώματα για την εκτέλεση εργασιών σε χώρους εργασίας στους οποίους έχει ανατεθεί. Τα δικαιώματα εκχωρούνται μέσω της πρόσβασης στον χώρο εργασίας, όπως και οι κανονικοί λογαριασμοί UPN (κύριο όνομα χρήστη).

Για την εκτέλεση λειτουργιών εγγραφής, ο φόρτος εργασίας σημασιολογικών μοντέλων του συνόλου εκχωρημένων πόρων πρέπει να έχει ενεργοποιημένο το τελικό σημείο XMLA για λειτουργίες ανάγνωσης-εγγραφής. Τα σημασιολογικά μοντέλα που δημοσιεύονται από το Power BI Desktop θα πρέπει να έχουν ενεργοποιημένη τη δυνατότητα βελτιωμένης μορφής μετα-δεδομένων.

Δημιουργία οντότητας υπηρεσίας

Οι οντότητες υπηρεσίας δημιουργούνται ως καταχώρηση εφαρμογής στην πύλη Azure ή με χρήση του PowerShell. Κατά τη δημιουργία της κύριας υπηρεσίας σας, φροντίστε να αντιγράψετε και αποθηκεύσετε ξεχωριστά το όνομα της εφαρμογής, το αναγνωριστικό εφαρμογής (client), το αναγνωριστικό καταλόγου (μισθωτής) και τον μυστικό κωδικό προγράμματος-πελάτη. Για τα βήματα σχετικά με τον τρόπο δημιουργίας μιας κύριας υπηρεσίας, ανατρέξτε στο θέμα:

Δημιουργία ομάδας ασφαλείας Microsoft Entra

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

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

Ενεργοποίηση οντοτήτων υπηρεσίας

Για να μπορέσετε να αρχίσετε να χρησιμοποιείτε τις οντότητες υπηρεσίας στο Power BI, ένας διαχειριστής πρέπει να ενεργοποιήσει την πρόσβαση κύριας υπηρεσίας στην πύλη Power BI Διαχείριση.

  1. Μεταβείτε στην πύλη power BI Διαχείριση και, στη συνέχεια, επιλέξτε Ρυθμίσεις μισθωτή.
  2. Κάντε κύλιση στις Ρυθμίσεις προγραμματιστή και, στη συνέχεια, αναπτύξτε την επιλογή Να επιτρέπεται στις κύριες υπηρεσίες η χρήση των API του Power BI.
  3. Επιλέξτε Ενεργοποιημένο.
  4. Για να εφαρμόσετε δικαιώματα σε μια ομάδα ασφαλείας, επιλέξτε Συγκεκριμένες ομάδες ασφαλείας (Συνιστάται).
  5. Εισαγάγετε το όνομα της ομάδας.
  6. Επιλέξτε Εφαρμογή.

Στιγμιότυπο οθόνης που εμφανίζει την πύλη Διαχείριση με επιλεγμένες τις ρυθμίσεις μισθωτή. Να επιτρέπεται στις κύριες υπηρεσίες η χρήση των Power BI API να αναπτύσσονται με ενεργοποιημένη επισήμανση.

Πρόσβαση στον χώρο εργασίας

Για να έχει η κύρια υπηρεσία σας τα απαραίτητα δικαιώματα για την εκτέλεση λειτουργιών premium χώρου εργασίας και μοντέλου σημασιολογίας, πρέπει να προσθέσετε την κύρια υπηρεσία ως μέλος χώρου εργασίας ή Διαχείριση. Η χρήση της πρόσβασης στον χώρο εργασίας στο Υπηρεσία Power BI περιγράφεται εδώ, αλλά μπορείτε επίσης να χρησιμοποιήσετε την Προσθήκη REST API χρήστη ομάδας.

  1. Στην Υπηρεσία Power BI για έναν χώρο εργασίας, επιλέξτε Περισσότερα>πρόσβαση στον χώρο εργασίας.

    Στιγμιότυπο οθόνης που εμφανίζει μια λίστα χώρων εργασίας. Το εικονίδιο

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

    Στιγμιότυπο οθόνης που εμφανίζει το παράθυρο διαλόγου πρόσβασης που εμφανίζει ένα κύριο όνομα υπηρεσίας. Διαχείριση επιλέγεται.

συμβολοσειρές Σύνδεση ion για το τελικό σημείο XMLA

Αφού δημιουργήσετε μια οντότητα υπηρεσίας, ενεργοποιήστε τις οντότητες υπηρεσίας για τον μισθωτή σας και προσθέστε την κύρια υπηρεσία στην πρόσβαση στον χώρο εργασίας, χρησιμοποιήστε την ως ταυτότητα χρήστη στο συμβολοσειρά σύνδεσης s με το τελικό σημείο XMLA. Η διαφορά είναι ότι, αντί για τις user id παραμέτρους και password , καθορίζετε το αναγνωριστικό εφαρμογής, το αναγνωριστικό μισθωτή και τον μυστικό κωδικό εφαρμογής.

Data Source=powerbi://api.powerbi.com/v1.0/myorg/<workspace name>; Initial Catalog=<dataset name>;User ID=app:<appId>@<tenantId>;Password=<app_secret>;

PowerShell

Ανοίξτε μια περίοδο λειτουργίας του PowerShell για να εκτελέσετε το παρακάτω παράδειγμα κώδικα.

Χρήση λειτουργικής μονάδας SQLServer

Στο παρακάτω παράδειγμα, τα AppId, TenantIdκαι AppSecret χρησιμοποιούνται για τον έλεγχο ταυτότητας μιας λειτουργίας ανανέωσης μοντέλου σημασιολογίας:

Param (
        [Parameter(Mandatory=$true)] [String] $AppId,
        [Parameter(Mandatory=$true)] [String] $TenantId,
        [Parameter(Mandatory=$true)] [String] $AppSecret
       )
$PWord = ConvertTo-SecureString -String $AppSecret -AsPlainText -Force

$Credential = New-Object -TypeName "System.Management.Automation.PSCredential" -ArgumentList $AppId, $PWord

Invoke-ProcessTable -Server "powerbi://api.powerbi.com/v1.0/myorg/myworkspace" -TableName "mytable" -DatabaseName "mydataset" -RefreshType "Full" -ServicePrincipal -ApplicationId $AppId -TenantId $TenantId -Credential $Credential

Αντικείμενα διαχείρισης ανάλυσης (AMO) και ADOMD.NET

Όταν συνδέεστε με εφαρμογές-πελάτες και εφαρμογές Web, μπορείτε να χρησιμοποιήσετε βιβλιοθήκες προγραμμάτων-πελατών AMO και ADOMD έκδοση 15.1.42.26 (Ιούνιος 2020) και πακέτα με δυνατότητα εγκατάστασης μεταγενέστερης έκδοσης από το NuGet για την υποστήριξη οντοτήτων υπηρεσίας σε συμβολοσειρά σύνδεσης, χρησιμοποιώντας την ακόλουθη σύνταξη: app:AppID και κωδικό πρόσβασης ή cert:thumbprint.

Στο παρακάτω παράδειγμα, appID οι τιμές και password χρησιμοποιούνται για την εκτέλεση μιας λειτουργίας ανανέωσης βάσης δεδομένων μοντέλου:

string appId = "xxx";
string authKey = "yyy";
string connString = $"Provider=MSOLAP;Data source=powerbi://api.powerbi.com/v1.0/<tenant>/<workspacename>;Initial catalog=<datasetname>;User ID=app:{appId};Password={authKey};";
Server server = new Server();
server.Connect(connString);
Database db = server.Databases.FindByName("adventureworks");
Table tbl = db.Model.Tables.Find("DimDate");
tbl.RequestRefresh(RefreshType.Full);
db.Model.SaveChanges();