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


Αυτοματοποιήστε τη διοχέτευση ανάπτυξής σας για στοιχεία Power BI χρησιμοποιώντας API

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

Σημείωση

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

Για να επιτευχθεί συνεχής ενοποίηση και συνεχής παράδοση (CI/CD) περιεχομένου, πολλοί οργανισμοί χρησιμοποιούν εργαλεία αυτοματισμού, συμπεριλαμβανομένου του Azure DevOps. Οι οργανισμοί που χρησιμοποιούν το Azure DevOps μπορούν να χρησιμοποιήσουν την επέκταση εργαλείων αυτοματισμού του Power BI, η οποία υποστηρίζει πολλές από τις λειτουργίες API διοχετεύσεων ανάπτυξης.

Μπορείτε να χρησιμοποιήσετε τα API POWER BI REST διοχετεύσεων ανάπτυξης για να ενσωματώσετε το Fabric στη διαδικασία αυτοματισμού του οργανισμού σας. Ακολουθούν μερικά παραδείγματα σχετικά με το τι μπορεί να γίνει χρησιμοποιώντας τα API:

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

  • Εκχώρηση και κατάργηση εκχώρησης χρηστών από και προς μια διοχέτευση.

  • Ενσωματώστε το Fabric σε οικεία εργαλεία DevOps όπως οι Ενέργειες Azure DevOps ή GitHub.

  • Προγραμματίστε αναπτύξεις διοχέτευσης να πραγματοποιούνται αυτόματα σε μια συγκεκριμένη ώρα.

  • Αναπτύξτε πολλές διοχετεύσεις ταυτόχρονα.

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

Προαπαιτούμενα στοιχεία

Προτού χρησιμοποιήσετε τα API διοχετεύσεων ανάπτυξης, βεβαιωθείτε ότι έχετε τα εξής:

Συναρτήσεις API διοχετεύσεων ανάπτυξης

Τα Power BI REST API διοχετεύσεων ανάπτυξης σάς επιτρέπουν να εκτελείτε τις ακόλουθες συναρτήσεις:

  • Λήψη πληροφοριών διοχέτευσης - Ανακτήστε πληροφορίες σχετικά με τις διοχετεύσεις σας και το περιεχόμενό τους. Η λήψη των πληροφοριών διοχέτευσης σάς επιτρέπει να δημιουργείτε δυναμικά τις κλήσεις API ανάπτυξης. Μπορείτε επίσης να ελέγξετε την κατάσταση μιας ανάπτυξης ή το ιστορικό ανάπτυξης.

  • Ανάπτυξη - Οι κλήσεις REST επιτρέπουν στους προγραμματιστές να χρησιμοποιούν οποιονδήποτε τύπο ανάπτυξης είναι διαθέσιμος στην υπηρεσία Fabric.

  • Δημιουργία και διαγραφή διοχετεύσεων - Χρησιμοποιήστε τις επιλογές Δημιουργία διοχέτευσης και Διαγραφή για την εκτέλεση αυτών των λειτουργιών.

  • Διαχείριση χώρων εργασίας - Με την εκχώρηση χώρου εργασίας και τον Μη εκχωρημένο χώρο εργασίας, μπορείτε να αντιστοιχίσετε και να καταργήσετε την εκχώρηση χώρων εργασίας σε συγκεκριμένα στάδια διοχέτευσης.

  • Διαχείριση χρηστών διοχέτευσης - Η διαγραφή χρήστη διοχέτευσης σάς επιτρέπει να καταργήσετε έναν χρήστη από μια διοχέτευση. Η ενημέρωση χρήστη διοχέτευσης σάς επιτρέπει να προσθέσετε έναν χρήστη στη διοχέτευση.

Ποιοι τύποι ανάπτυξης υποστηρίζουν τα API;

Τα API υποστηρίζουν τους ακόλουθους τύπους ανάπτυξης:

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

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

  • Ανάπτυξη προς τα πίσω - Αναπτύσσει νέα στοιχεία στο προηγούμενο στάδιο. Η ανάπτυξη προς τα πίσω λειτουργεί μόνο εάν τα στοιχεία που έχουν αναπτυχθεί δεν υπάρχουν ήδη στο στάδιο προορισμού. Για αυτήν τη λειτουργία, χρησιμοποιήστε είτε τα API Ανάπτυξης όλων είτε τα API επιλεκτικής ανάπτυξης , με isBackwardDeployment την επιλογή να έχει οριστεί σε True.

  • Ενημέρωση εφαρμογής - Ως μέρος της κλήσης API ανάπτυξης, μπορείτε να ενημερώσετε το περιεχόμενο της εφαρμογής που σχετίζεται με αυτό το στάδιο. Τα ενημερωμένα στοιχεία είναι αυτόματα διαθέσιμα στους τελικούς χρήστες, μετά την ολοκλήρωση μιας ανάπτυξης. Για αυτήν τη λειτουργία, χρησιμοποιήστε είτε τα API Ανάπτυξη όλων είτε τα API Επιλεκτικής ανάπτυξης , με το PipelineUpdateAppSettings.

Ενοποίηση της διοχέτευσης σας με το Azure DevOps

Για να αυτοματοποιήσετε τις διαδικασίες ανάπτυξης μέσα από τη διοχέτευση έκδοσης στο Azure DevOps, χρησιμοποιήστε μία από αυτές τις μεθόδους:

  • PowerShell - Η δέσμη ενεργειών εισέρχεται στο Fabric χρησιμοποιώντας μια κύρια υπηρεσία ή έναν χρήστη.

  • Εργαλεία αυτοματισμού του Power BI - Αυτή η επέκταση λειτουργεί με μια κύρια υπηρεσία ή έναν χρήστη.

Μπορείτε επίσης να χρησιμοποιήσετε άλλες κλήσεις Power BI REST API , για την ολοκλήρωση σχετικών λειτουργιών, όπως η εισαγωγή ενός .pbix στη διοχέτευση, η ενημέρωση προελεύσεων δεδομένων και παραμέτρων.

Χρήση της επέκτασης εργαλείων αυτοματισμού του Power BI

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

Αφού προσθέσετε την επέκταση εργαλείων αυτοματισμού του Power BI στο DevOps, πρέπει να δημιουργήσετε μια σύνδεση υπηρεσίας. Οι παρακάτω συνδέσεις είναι διαθέσιμες:

  • Κύρια υπηρεσία (συνιστάται) - Αυτή η σύνδεση πραγματοποιεί έλεγχο ταυτότητας χρησιμοποιώντας μια κύρια υπηρεσία και απαιτεί τον μυστικό κωδικό και το αναγνωριστικό εφαρμογής της εφαρμογής Microsoft Entra. Όταν χρησιμοποιείτε αυτήν την επιλογή, επαληθεύστε ότι οι ρυθμίσεις διαχειριστή υπηρεσίας για την κύρια υπηρεσία είναι ενεργοποιημένες.

  • Όνομα χρήστη και κωδικός πρόσβασης – Ρυθμίστηκε ως γενική σύνδεση υπηρεσίας με όνομα χρήστη και κωδικό πρόσβασης. Αυτή η μέθοδος σύνδεσης δεν υποστηρίζει έλεγχο ταυτότητας πολλών παραγόντων. Συνιστούμε να χρησιμοποιήσετε τη μέθοδο σύνδεσης κύριας υπηρεσίας καθώς δεν απαιτεί την αποθήκευση διαπιστευτηρίων χρήστη στο Azure DevOps.

Σημείωση

Η επέκταση εργαλείων αυτοματισμού του Power BI χρησιμοποιεί μια σύνδεση υπηρεσίας Azure DevOps για την αποθήκευση διαπιστευτηρίων. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Τρόπος αποθήκευσης των διαπιστευτηρίων σας για τις υπηρεσίες Azure DevOps.

Αφού ενεργοποιήσετε μια σύνδεση υπηρεσίας για τα εργαλεία αυτοματισμού Του Power BI Azure DevOps, μπορείτε να δημιουργήσετε εργασίες διοχέτευσης. Η επέκταση περιλαμβάνει τις ακόλουθες εργασίες διοχετεύσεων ανάπτυξης:

  • Δημιουργία νέας διοχέτευσης

  • Εκχώρηση χώρου εργασίας σε στάδιο διοχέτευσης

  • Προσθήκη χρήστη σε διοχέτευση ανάπτυξης

  • Προσθήκη χρήστη σε χώρο εργασίας

  • Ανάπτυξη περιεχομένου σε διοχέτευση ανάπτυξης

  • Κατάργηση χώρου εργασίας από διοχέτευση ανάπτυξης

  • Διαγραφή διοχέτευσης

Πρόσβαση στα δείγματα PowerShell

Μπορείτε να χρησιμοποιήσετε τις ακόλουθες δέσμες ενεργειών PowerShell για να κατανοήσετε τον τρόπο εκτέλεσης πολλών διαδικασιών αυτοματοποίησης. Για να προβάλετε ή να αντιγράψετε το κείμενο σε ένα δείγμα PowerShell, χρησιμοποιήστε τις συνδέσεις σε αυτήν την ενότητα.

Μπορείτε επίσης να κάνετε λήψη ολόκληρου PowerBI-Developer-Samples του φακέλου GitHub.

Παράδειγμα PowerShell

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

Για να εκτελέσετε μια δέσμη ενεργειών PowerShell που εκτελεί μια ανάπτυξη, χρειάζεστε τα ακόλουθα στοιχεία. Μπορείτε να προσθέσετε οποιοδήποτε από αυτά τα τμήματα σε εργασίες στα στάδια διοχέτευσης Azure.

  1. Είσοδος - Για να αναπτύξετε το περιεχόμενό σας, πρέπει να εισέλθετε στο Fabric χρησιμοποιώντας μια κύρια υπηρεσία ή έναν χρήστη. Χρησιμοποιήστε την εντολή Connect-PowerBIServiceAccount για να εισέλθετε.

  2. Δημιουργία του σώματος της αίτησης - Σε αυτό το τμήμα της δέσμης ενεργειών καθορίζετε τα στοιχεία (όπως αναφορές και πίνακες εργαλείων) που αναπτύσσετε.

    $body = @{ 
        sourceStageOrder = 0 # The order of the source stage. Development (0), Test (1).   
        datasets = @(
            @{sourceId = "Insert your dataset ID here" }
        )      
        reports = @(
            @{sourceId = "Insert your report ID here" }
        )            
        dashboards = @(
            @{sourceId = "Insert your dashboard ID here" }
        )
    
        options = @{
            # Allows creating new item if needed on the Test stage workspace
            allowCreateArtifact = $TRUE
    
            # Allows overwriting existing item if needed on the Test stage workspace
            allowOverwriteArtifact = $TRUE
        }
    } | ConvertTo-Json
    
  3. Ανάπτυξη - Εδώ μπορείτε να εκτελέσετε την ανάπτυξη.

    $url = "pipelines/{0}/Deploy" -f "Insert you pipeline ID here"
    $deployResult = Invoke-PowerBIRestMethod -Url $url  -Method Post -Body $body | ConvertFrom-Json
    
  4. (Προαιρετικό) Ειδοποίηση ολοκλήρωσης ανάπτυξης - Επειδή το API ανάπτυξης είναι ασύγχρονο, μπορείτε να προγραμματίσετε τη δέσμη ενεργειών για να σας ειδοποιεί όταν ολοκληρωθεί η ανάπτυξη.

    $url =  "pipelines/{0}/Operations/{1}" -f "Insert you pipeline ID here",$deployResult.id
    $operation = Invoke-PowerBIRestMethod -Url $url -Method Get | ConvertFrom-Json    
    while($operation.Status -eq "NotStarted" -or $operation.Status -eq "Executing")
    {
        # Sleep for 5 seconds
        Start-Sleep -s 5
        $operation = Invoke-PowerBIRestMethod -Url $url -Method Get | ConvertFrom-Json
    }
    

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

  • Η ανάπτυξη με τη χρήση API υπόκειται στους ίδιους περιορισμούς με το περιβάλλον εργασίας χρήστη διοχετεύσεων ανάπτυξης.

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

  • Η ανάπτυξη ροών δεδομένων με χρήση μιας κύριας υπηρεσίας δεν υποστηρίζεται.

  • Ο μέγιστος αριθμός στοιχείων που μπορούν να αναπτυχθούν σε μία μόνο ανάπτυξη είναι 300.

  • Τα API διοχετεύσεων ανάπτυξης προς το παρόν υποστηρίζουν μόνο στοιχεία Power BI.

  • Η δημιουργία μιας προσαρμοσμένης διοχέτευσης 2-10 σταδίων υποστηρίζεται προς το παρόν μόνο μέσω του περιβάλλοντος εργασίας χρήστη.