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.

Tärkeä

Tämä ominaisuus on esikatselutilassa.

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:

• PowerShell
• Azure PowerShell Az -moduuli

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.

• Hae 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.

• Hae käyttöönottoputken vaiheen kohteet: Palauttaa tuetut kohteet työtilasta, joka on määritetty määritetyn käyttöönottoputken määritettyyn vaiheeseen.

• 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ä käyttöönottoputken vaiheiden 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ä.

• Ota kaikki käyttöön

  Anna seuraavat tiedot:

  • Putken nimi
  • Lähdevaiheen nimi
  • Kohdevaiheen nimi
  • Käyttöönottohuomautukset (valinnainen)

• Valikoiva käyttöönotto

  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.

Liittyvä sisältö

• Käyttöönottoputkien käytön aloittaminen
• Käyttöönottojaksojen parhaat käytännöt
• Käyttöönottoputkien vianmääritys