Share via

Power BI -kohteiden käyttöönottoputken automatisoiminen ohjelmointirajapintojen avulla

  • Artikkeli

Microsoft Power BI:n käyttöönottoputkityökalun avulla liiketoimintatietotiimit voivat kehittää Power BI -sisällölleen tehokkaan ja uudelleenkäytettävän julkaisuprosessin.

Muistiinpano

Tässä luetellut käyttöönottoputkien ohjelmointirajapinnat koskevat vain Power BI -kohteita. Fabric-ohjelmointirajapinnat, tutustu Fabric-ohjelmointirajapinnan dokumentaatioon.

Monet organisaatiot käyttävät automaatiotyökaluja, kuten Azure DevOpsia, jatkuvan integroinnin ja jatkuvan toimituksen (CI/CD) tarjoamiseksi. Azure DevOpsia käyttävät organisaatiot voivat käyttää Power BI -automaatiotyökalujen laajennusta, joka tukee monia käyttöönottojaksojen ohjelmointirajapinnan toimintoja.

Voit integroida Fabricin organisaatiosi automaatioprosessiin käyttöönottojaksojen Power BI REST -ohjelmointirajapintojen avulla. Seuraavassa on muutama esimerkki siitä, mitä ohjelmointirajapinnoilla voidaan tehdä:

  • Hallitse putkia alusta loppuun, mukaan lukien putken luominen, työtilan määrittäminen mihin tahansa vaiheeseen sekä putken käyttöönotto ja poistaminen.

  • Määritä käyttäjiä putkelle ja poista ne putkesta.

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

Käyttöönottoputkien ohjelmointirajapintafunktiot

Käyttöönottoputkien Power BI REST -ohjelmointirajapintojen avulla voit suorittaa seuraavat funktiot:

  • Hae jakson tiedot – nouda tietoja putkista ja niiden sisällöstä. Putkitietojen avulla voit luoda käyttöönoton API-kutsuja dynaamisesti. Voit myös tarkistaa käyttöönoton tilan tai käyttöönottohistorian.

  • Käyttöönotto – REST-kutsujen avulla kehittäjät voivat käyttää mitä tahansa Fabric-palvelussa käytettävissä olevia käyttöönottoja.

  • Luo ja poista putkia: voit suorittaa nämä toiminnot luomalla putken ja poistamalla putken .

  • Työtilojen hallinta: Määritä työtila- ja Määrittämätön-työtila -parametrin avulla voit määrittää ja delegoida työtiloja tiettyihin jakson vaiheisiin.

  • Jakson käyttäjien - Poistoputken käyttäjän avulla voit poistaa käyttäjän putkesta. Päivitä jakson käyttäjä antaa sinun lisätä käyttäjän jaksoon.

Mitä käyttöönottotyyppejä ohjelmointirajapinnat tukevat?

Ohjelmointirajapinnat tukevat seuraavia käyttöönottotyyppejä:

  • Ota kaikki käyttöön – Yksittäinen ohjelmointirajapintakutsu, joka ottaa käyttöön työtilan kaiken sisällön putken seuraavassa vaiheessa. Käytä tätä toimintoa Ota kaikki ohjelmointirajapinta käyttöön.

  • Valikoiva käyttöönotto – ottaa käyttöön vain tietyt kohteet, kuten raportit tai koontinäytöt, putkessa. Käytä tätä toimintoa Valikoiva käyttöönotto -ohjelmointirajapintaa.

  • Käyttöönotto taaksepäin : ottaa käyttöön uusia kohteita edellisessä vaiheessa. Käyttöönotto taaksepäin toimii vain, jos käyttöönotetut kohteet eivät ole jo olemassa kohdevaiheessa. Käytä tässä toiminnossa joko Ota käyttöön kaikki - tai Valikoiva käyttöönotto -ohjelmointirajapintoja, joiden isBackwardDeployment asetuksena on True.

  • Päivitä sovellus – Osana käyttöönoton ohjelmointirajapinnan kutsua voit päivittää kyseiseen vaiheeseen liittyvän sovelluksen sisällön. Päivitetyt kohteet ovat automaattisesti käyttäjien käytettävissä käyttöönoton jälkeen. Käytä tässä toiminnossa joko Ota käyttöön kaikki- tai Valikoiva käyttöönotto -ohjelmointirajapintoja PipelineUpdateApp Asetukset kanssa.

Alkutoimet

Ennen kuin käytät käyttöönottoputkien ohjelmointirajapintoja, varmista, että sinulla on seuraavat:

Jakson integrointi Azure DevOpsiin

Voit automatisoida käyttöönottoprosesseja Azure DevOpsin julkaisuputkesta jollakin seuraavista menetelmistä:

  • PowerShell – Komentosarja kirjautuu Fabriciin palvelun päänimellä tai käyttäjällä.

  • Power BI -automaatiotyökalut – Tämä laajennus toimii palvelun päänimentai käyttäjän kanssa.

Voit käyttää myös muita Power BI REST -ohjelmointirajapinnan kutsuja liittyvien toimintojen suorittamiseen, kuten .pbix-tiedoston tuomiseen putkeen, tietolähteiden ja parametrien päivittämiseen.

Power BI -automaatiotyökalujen laajennuksen käyttäminen

Power BI -automaatiotyökalujen laajennus on avoin lähdekoodi Azure DevOps -laajennus, joka tarjoaa joukon käyttöönottoputkien toimintoja, jotka voidaan suorittaa Azure DevOpsissa. Laajennus poistaa tarpeen ohjelmointirajapinnoille tai komentosaroille putkien hallintaan. Kutakin toimintoa voidaan käyttää yksitellen tehtävän suorittamiseen, kuten putken luomiseen. Toimintoja voidaan käyttää yhdessä Azure DevOps -putkessa monimutkaisemman skenaarion luomiseksi, kuten putken luomiseksi, työtilan määrittämiseksi putkelle, käyttäjien lisäämiseksi ja käyttöönottoksi.

Kun olet lisännyt Power BI -automaatiotyökalujen laajennuksen DevOpsiin, sinun on luotava palveluyhteys. Seuraavat yhteydet ovat käytettävissä:

  • Palvelun päänimi (suositus) – Tämä yhteys todennetaan palvelun päänimen avulla ja edellyttää Microsoft Entra -sovelluksen salaista koodia ja sovellustunnusta. Kun käytät tätä vaihtoehtoa, varmista, että palvelun päänimen järjestelmänvalvojan asetukset ovat käytössä.

  • Käyttäjänimi ja salasana – Määritetty yleisiksi palveluyhteyksiksi käyttäjänimellä ja salasanalla. Tämä yhteysmenetelmä ei tue monimenetelmäistä todentamista. Suosittelemme, että käytät palvelun päänimen yhteysmenetelmää, koska se ei vaadi käyttäjien tunnistetietojen tallentamista Azure DevOpsiin.

Muistiinpano

Power BI -automaation työkalulaajennus käyttää Azure DevOps -palveluyhteyttä tunnistetietojen tallentamiseen. Lisätietoja on artikkelissa Azure DevOps Services -tunnistetietojen tallentaminen.

Kun olet ottanut palveluyhteyden käyttöön Azure DevOps Power BI -automaatiotyökaluillesi, voit luoda putkitehtäviä. Laajennus sisältää seuraavat käyttöönottoputkien tehtävät:

  • Luo uusi putki

  • Työtilan määrittäminen jakson vaiheeseen

  • Käyttäjän lisääminen käyttöönottoputkeen

  • Käyttäjän lisääminen työtilaan

  • Sisällön käyttöönotto käyttöönottoputkessa

  • Työtilan poistaminen käyttöönottoputkesta

  • Jakson poistaminen

PowerShell-mallien käyttäminen

Voit käyttää seuraavia PowerShell-komentosarjoja useiden automaatioprosessien suorittamiseen. Jos haluat tarkastella tai kopioida tekstiä PowerShell-mallissa, käytä tämän osion linkkejä.

Voit myös ladata koko PowerBI-Developer-Samples GitHub-kansion.

Esimerkki PowerShellistä

Tässä osiossa kuvataan esimerkki PowerShell-komentosarjasta, jossa semanttinen malli, raportti ja koontinäyttö otetaan käyttöön kehitysvaiheesta testivaiheeseen. Komentosarja tarkistaa sitten, onnistuiko käyttöönotto.

Jotta voit suorittaa PowerShell-komentosarjan, joka suorittaa käyttöönoton, tarvitset seuraavat osat. Voit lisätä minkä tahansa näistä osista tehtäviin Azure-jakson vaiheissa.

  1. Kirjaudu sisään: Ennen kuin voit ottaa sisältöä käyttöön, sinun on kirjauduttava Fabriciin palvelun päänimellä tai käyttäjällä. Kirjaudu sisään Näyttöyhteys-PowerBIServiceAccount-komennolla.

  2. Luo pyynnön runko – Tässä komentosarjan osassa voit määrittää, mitä kohteita (kuten raportteja ja koontinäyttöjä) olet ottamassa käyttöön.

    $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. Käyttöönotto – Tässä voit suorittaa käyttöönoton.

    $url = "pipelines/{0}/Deploy" -f "Insert you pipeline ID here"
$deployResult = Invoke-PowerBIRestMethod -Url $url  -Method Post -Body $body | ConvertFrom-Json

  4. (Valinnainen) Käyttöönoton valmistumisilmoitus – Koska käyttöönoton ohjelmointirajapinta on asynkroninen, voit ohjelmoida komentosarjan ilmoittamaan sinulle, kun käyttöönotto on valmis.

    $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
}

Huomioitavat asiat ja rajoitukset

  • Käyttöönotto ohjelmointirajapintojen avulla koskee samoja rajoituksia kuin käyttöönottoputkien käyttöliittymää.

  • Palvelun päänimi ei voi määrittää OAuth-tunnistetietoja. Kun uudet kohteet on otettu käyttöön, kirjautuneen palvelun päänimestä tulee käyttöönotettujen sivutettujen raporttien ja semanttisten mallien omistaja. Tässä tapauksessa päivitystä ei voi suorittaa loppuun.

  • Tietovoiden käyttöönottoa palvelun päänimen avulla ei tueta.

  • Yksittäisessä käyttöönotossa voidaan ottaa käyttöön enintään 300 kohdetta.

  • Käyttöönottoputkien ohjelmointirajapinnat tukevat tällä hetkellä vain Power BI -kohteita.

  • Mukautetun 2–10 vaiheen jakson luomista tuetaan tällä hetkellä vain käyttöliittymän kautta.

Liittyvä sisältö