Käyttöönottoputken automatisoiminen Fabric-ohjelmointirajapintojen avulla
Microsoft Fabric - käyttöönottoputkityökalun avulla tiimit voivat kehittää Fabric-sisällölleen tehokkaan ja uudelleenkäytettävän julkaisuprosessin.
Käytä käyttöönottoputkia Fabric REST -ohjelmointirajapinnat Fabric-integroimiseksi organisaatiosi automaatioprosessiin. Seuraavassa on muutama esimerkki siitä, mitä ohjelmointirajapinnoilla voidaan tehdä:
Integroi Fabric tutuihin DevOps-työkaluihin, kuten Azure DevOpsiin tai GitHub Actionsiin.
Voit ajoittaa putken käyttöönotot tapahtumaan automaattisesti tiettynä ajankohtana.
Ota käyttöön useita putkia samanaikaisesti.
Johdannaiset riippuen putkien käyttöönotoista. Jos sisältö on yhdistetty putkien välillä, voit varmistaa, että jotkin jaksot otetaan käyttöön ennen muita.
Edellytykset
Jotta voit käsitellä käyttöönottoputken ohjelmointirajapintoja, tarvitset seuraavat edellytykset:
- Samat edellytykset kuin käyttöönottoputkien käyttämisessä.
- Microsoft Entra -tunnus Fabric-palvelulle. Käytä tunnusta API-kutsun valtuutusotsikossa. Saat lisätietoja tunnuksen hankkimisesta Fabric-ohjelmointirajapinnan pika-aloituksesta.
Voit käyttää REST-ohjelmointirajapintoja ilman PowerShelliä, mutta tämän artikkelin komentosarjoissa käytetään PowerShelliä. Jotta voit suorittaa komentosarjoja, sinun on asennettava seuraavat ohjelmat:
Käyttöönottoputkien ohjelmointirajapintafunktiot
Käyttöönottoputkien Fabric REST -ohjelmointirajapintojen avulla voit suorittaa seuraavat funktiot:
Hae käyttöönottoputki: palauttaa tietoja määritetystä käyttöönottoputkesta.
Luettelo käyttöönottoputkista: palauttaa luettelon käyttöönottoputkista, joihin käyttäjällä on käyttöoikeus.
Luettele käyttöönottoputken vaiheet: Palauttaa määritetyn käyttöönoton vaiheet, mukaan lukien sen tunnuksen, näyttönimen, kuvauksen ja sen, onko vaihe julkinen vai ei.
Luettele käyttöönottoputken vaiheen kohteet: Palauttaa tuetut kohteet määritetyn käyttöönottoputken määritettyyn vaiheeseen määritetyssä työtilassa.
Käyttöönottovaiheen sisältö: Ottaa kohteet käyttöön määritetyn käyttöönottoputken määritetystä vaiheesta.
Tämän ohjelmointirajapinnan avulla voit ottaa käyttöön kaikki kohteet tai valita tietyt kohteet käyttöönottoa varten. Jos mitään tiettyjä kohteita ei valita, kaikki kohteet otetaan käyttöön.
Voit etsiä käyttöön otettavan vaiheen tunnuksen käyttämällä Luettelon käyttöönottoputken vaiheet -ohjelmointirajapintaa.
Tämä ohjelmointirajapinta on integroitu pitkäkestoisten toimintojen ohjelmointirajapintoihin käyttöönoton tilan seuraamiseksi.
- Hae toiminnon tila, jotta näet, onko toiminto valmis Hae pitkäkestoinen – Hae toiminnon tilan ohjelmointirajapinta -ohjelmointirajapinnalla.
- Laajennetut käyttöönottotiedot ovat saatavillaToiminnon tulos -ohjelmointirajapinnassa 24 tunnin ajan käyttöönoton valmistumisen jälkeen.
Voit myös käyttää muita Fabric REST -ohjelmointirajapinnan kutsuja liittyvien toimintojen suorittamiseen.
Esimerkkejä PowerShellistä
Voit käyttää seuraavia PowerShell-komentosarjoja useiden automaatioprosessien suorittamiseen. Jos haluat tarkastella tai kopioida tekstiä PowerShell-mallissa, käytä tämän osion linkkejä.
-
Anna seuraavat tiedot:
- Putken nimi
- Lähdevaiheen nimi
- Kohdevaiheen nimi
- Käyttöönottohuomautukset (valinnainen)
-
Anna seuraavat tiedot:
- Putken nimi
- Lähdevaiheen nimi
- Kohdevaiheen nimi
- Käyttöön otettavat kohteet (kohteiden näyttönimi ja kohdetyyppi)
- Käyttöönottohuomautukset (valinnainen)
Huomioitavat asiat ja rajoitukset
Kun käytät käyttöönottoputkien ohjelmointirajapintoja, ota huomioon seuraavat rajoitukset:
Kaikki käyttöönottoputkeen sovellettavat rajoitukset ovat voimassa ohjelmointirajapintoja käytettäessä. Lisätietoja on kohdassa Käyttöönottojaksojen parhaat käytännöt.
Tietovoita ei tueta tällä hetkellä. Tietovoita käyttävät asiakkaat voivat käyttää Power BI -ohjelmointirajapintoja.
Palvelun päänimiä tuetaan vain Power BI -kohteissa.
Kaikki Power BI -ohjelmointirajapinnoilla käytettävissä olevat käyttöönottovaihtoehdot eivät ole käytettävissä Fabricissa. Seuraavat ohjelmointirajapinnat eivät ole käytettävissä Fabricin Käyttöönottovaiheen sisällön ohjelmointirajapinnassa:
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
Jos tarvitset jonkin näistä ohjelmointirajapinnoista, käytä Power BI -ohjelmointirajapintaa käyttöönottoon. Nämä ohjelmointirajapinnat toimivat kuitenkin vain Power BI -kohteissa.