Αυτοματοποιήστε τη διοχέτευση ανάπτυξής σας με API Fabric
Το εργαλείο διοχετεύσεων ανάπτυξης Microsoft Fabric επιτρέπει στις ομάδες να δημιουργήσουν μια αποτελεσματική και επαναχρησιμοποιήσιμη διαδικασία έκδοσης για το περιεχόμενό τους Fabric.
Σημαντικό
Αυτή η δυνατότητα είναι σε προεπισκόπηση.
Χρησιμοποιήστε τα API REST διοχετεύσεων ανάπτυξης για να ενσωματώσετε το Fabric στη διαδικασία αυτοματισμού του οργανισμού σας. Ακολουθούν μερικά παραδείγματα σχετικά με το τι μπορεί να γίνει χρησιμοποιώντας τα API:
Ενσωματώστε το Fabric σε οικεία εργαλεία DevOps όπως οι Ενέργειες Azure DevOps ή GitHub.
Προγραμματίστε αναπτύξεις διοχέτευσης να πραγματοποιούνται αυτόματα σε μια συγκεκριμένη ώρα.
Αναπτύξτε πολλές διοχετεύσεις ταυτόχρονα.
Επικάλυψη ανάλογα με τις αναπτύξεις διοχέτευσης. Εάν έχετε περιεχόμενο συνδεδεμένο μεταξύ διοχετεύσεων, μπορείτε να βεβαιωθείτε ότι ορισμένες διοχετεύσεις αναπτύσσονται πριν από άλλες.
Προαπαιτούμενα στοιχεία
Για να εργαστείτε με API διοχέτευσης ανάπτυξης, χρειάζεστε τις ακόλουθες προϋποθέσεις:
- Οι ίδιες προϋποθέσεις που χρειάζεστε για να χρησιμοποιήσετε διοχετεύσεις ανάπτυξης.
- Ένα διακριτικό Microsoft Entra για την υπηρεσία Fabric. Χρησιμοποιήστε αυτό το διακριτικό στην κεφαλίδα εξουσιοδότησης της κλήσης API. Για πληροφορίες σχετικά με τον τρόπο λήψης ενός διακριτικού, ανατρέξτε στο θέμα Γρήγορη εκκίνηση API Fabric.
Μπορείτε να χρησιμοποιήσετε τα REST API χωρίς το PowerShell, αλλά οι δέσμες ενεργειών σε αυτό το άρθρο χρησιμοποιούν το PowerShell. Για να εκτελέσετε τις δέσμες ενεργειών, πρέπει να εγκαταστήσετε τα ακόλουθα προγράμματα:
Συναρτήσεις API διοχετεύσεων ανάπτυξης
Τα API REST διοχετεύσεων ανάπτυξης σάς επιτρέπουν να εκτελείτε τις ακόλουθες συναρτήσεις:
Λήψη διοχέτευσης ανάπτυξης: Επιστρέφει πληροφορίες σχετικά με την καθορισμένη διοχέτευση ανάπτυξης.
Λίστα Διοχετεύσεων ανάπτυξης: Επιστρέφει μια λίστα με τις διοχετεύσεις ανάπτυξης στις οποίες έχει πρόσβαση ο χρήστης.
Λίστα σταδίων διοχέτευσης ανάπτυξης: Επιστρέφει τα στάδια της καθορισμένης ανάπτυξης, συμπεριλαμβανομένου του αναγνωριστικού, του εμφανιζόμενου ονόματος, της περιγραφής και του αν το στάδιο είναι δημόσιο ή όχι.
Λίστα Στοιχείων σταδίου διοχέτευσης ανάπτυξης: Επιστρέφει τα υποστηριζόμενα στοιχεία από τον χώρο εργασίας που έχει αντιστοιχιστεί στο καθορισμένο στάδιο της καθορισμένης διοχέτευσης ανάπτυξης.
Ανάπτυξη περιεχομένου σταδίου: Αναπτύσσει στοιχεία από το καθορισμένο στάδιο της καθορισμένης διοχέτευσης ανάπτυξης.
Χρησιμοποιήστε αυτό το API για να αναπτύξετε όλα τα στοιχεία ή για να επιλέξετε συγκεκριμένα στοιχεία για ανάπτυξη. Εάν δεν έχουν επιλεγεί συγκεκριμένα στοιχεία, αναπτύσσονται όλα τα στοιχεία.
Για να βρείτε το σχετικό αναγνωριστικό σταδίου για ανάπτυξη, χρησιμοποιήστε το API σταδίων διοχέτευσης ανάπτυξης λίστας.
Αυτό το API είναι ενσωματωμένο με τα API μεγάλων λειτουργιών για την παρακολούθηση της κατάστασης ανάπτυξης.
- Λάβετε την κατάσταση λειτουργίας για να δείτε εάν η λειτουργία ολοκληρώθηκε με το API κατάστασης "Λήψη μεγάλης διάρκειας - Λήψη λειτουργίας ".
- Για 24 ώρες μετά την ολοκλήρωση της ανάπτυξης, οι πληροφορίες εκτεταμένης ανάπτυξης είναι διαθέσιμες στοAPI Λήψη αποτελέσματος λειτουργίας.
Μπορείτε επίσης να χρησιμοποιήσετε άλλες κλήσεις REST API Fabric, για την ολοκλήρωση σχετικών λειτουργιών.
Παραδείγματα Του PowerShell
Μπορείτε να χρησιμοποιήσετε τις ακόλουθες δέσμες ενεργειών PowerShell για να κατανοήσετε τον τρόπο εκτέλεσης πολλών διαδικασιών αυτοματοποίησης. Για να προβάλετε ή να αντιγράψετε το κείμενο σε ένα δείγμα PowerShell, χρησιμοποιήστε τις συνδέσεις σε αυτήν την ενότητα.
-
Δώστε τις παρακάτω πληροφορίες:
- Όνομα διοχέτευσης
- Όνομα σταδίου προέλευσης
- Όνομα σταδίου προορισμού
- Σημειώσεις ανάπτυξης (προαιρετικό)
-
Δώστε τις παρακάτω πληροφορίες:
- Όνομα διοχέτευσης
- Όνομα σταδίου προέλευσης
- Όνομα σταδίου προορισμού
- Στοιχεία για ανάπτυξη (εμφανιζόμενο όνομα στοιχείων και τύπος στοιχείου)
- Σημειώσεις ανάπτυξης (προαιρετικό)
Ζητήματα προς εξέταση και περιορισμοί
Όταν χρησιμοποιείτε τα API διοχετεύσεων ανάπτυξης, λάβετε υπόψη τους ακόλουθους περιορισμούς:
Όλοι οι περιορισμοί που ισχύουν για τη διοχέτευση ανάπτυξης ισχύουν κατά τη χρήση των API. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Βέλτιστες πρακτικές διοχετεύσεων ανάπτυξης.
Προς το παρόν, οι ροές δεδομένων δεν υποστηρίζονται. Οι πελάτες που χρησιμοποιούν ροές δεδομένων μπορούν να χρησιμοποιήσουν τα Power BI API.
Οι οντότητες υπηρεσίας υποστηρίζονται μόνο για στοιχεία Power BI.
Δεν είναι διαθέσιμες όλες οι επιλογές ανάπτυξης στα Power BI API στο Fabric. Τα παρακάτω API δεν είναι διαθέσιμα στο API ανάπτυξης του σταδίου Deploy του Fabric:
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
Εάν χρειάζεστε ένα από αυτά τα API, χρησιμοποιήστε το Power BI API για ανάπτυξη. Ωστόσο, αυτά τα API λειτουργούν μόνο για στοιχεία Του Power BI.