Del via

Automatiser utrullingssamlebåndet med Fabric API-er

  • Artikkel

Distribusjonssamlebåndverktøyet for Microsoft Fabric gjør det mulig for team å bygge en effektiv og gjenbrukbar utgivelsesprosess for fabric-innholdet.

Viktig

Denne funksjonen er i forhåndsvisning.

Bruk rest-API-ene for distribusjonssamlebånd til å integrere Fabric i organisasjonens automatiseringsprosess. Her er noen eksempler på hva som kan gjøres ved hjelp av API-ene:

  • Integrer Stoff i kjente DevOps-verktøy, for eksempel Azure DevOps eller GitHub Actions.

  • Planlegg at utrulling av datasamlebånd skal skje automatisk på et bestemt tidspunkt.

  • Distribuer flere datasamlebånd samtidig.

  • Gjennomgripende avhengig av utrullinger av datasamlebånd. Hvis du har innhold koblet til på tvers av datasamlebånd, kan du sørge for at noen datasamlebånd distribueres før andre.

Forutsetning

Hvis du vil arbeide med API-er for utrullingssamlebånd, trenger du følgende forutsetninger:

Du kan bruke REST-API-er uten PowerShell, men skriptene i denne artikkelen bruker PowerShell. Hvis du vil kjøre skriptene, må du installere følgende programmer:

API-funksjoner for utrullingssamlebånd

Rest-API-ene for distribusjonssamlebånd gir deg mulighet til å utføre følgende funksjoner:

  • Hent datasamlebånd for distribusjon: Returnerer informasjon om det angitte utrullingssamlebåndet.

  • Datasamlebånd for listedistribusjon: Returnerer en liste over utrullingssamlebånd som brukeren har tilgang til.

  • Faser for datasamlebånd for listedistribusjon: Returnerer fasene i den angitte distribusjonen, inkludert ID-en, visningsnavnet, beskrivelsen og om fasen er offentlig eller ikke.

  • Faseelementer for listedistribusjonsforløp: Returnerer de støttede elementene fra arbeidsområdet som er tilordnet til den angitte fasen av det angitte utrullingssamlebåndet.

  • Distribuer faseinnhold: Distribuerer elementer fra den angitte fasen av det angitte utrullingssamlebåndet.

    • Bruk denne API-en til å distribuere alle elementer eller for å velge bestemte elementer som skal distribueres. Hvis ingen bestemte elementer er valgt, distribueres alle elementer.

    • Hvis du vil finne den relevante fase-ID-en som skal distribueres, bruker du API-en for utrullingsforløpsfaser for listedistribusjon.

    • Denne API-en er integrert med API-ene for langvarige operasjoner for å overvåke distribusjonsstatusen.

Du kan også bruke andre FABRIC REST API-kall til å fullføre relaterte operasjoner.

Eksempler på PowerShell

Du kan bruke følgende PowerShell-skript til å forstå hvordan du utfører flere automatiseringsprosesser. Hvis du vil vise eller kopiere teksten i et PowerShell-eksempel, bruker du koblingene i denne inndelingen.

  • Distribuer alle

    Angi følgende informasjon:

    • Navn på pipeline
    • Navn på kildefase
    • Navn på målfase
    • Distribusjonsnotater (valgfritt)

  • Selektiv distribuering

    Angi følgende informasjon:

    • Navn på pipeline
    • Navn på kildefase
    • Navn på målfase
    • Elementer som skal distribueres (elementer viser navn og elementtype)
    • Distribusjonsnotater (valgfritt)

Hensyn og begrensninger

Når du bruker API-er for utrullingssamlebånd, bør du vurdere følgende begrensninger:

  • Alle begrensninger som gjelder for datasamlebånd for distribusjon, gjelder når du bruker API-ene. Hvis du vil ha mer informasjon, kan du se anbefalte fremgangsmåter for distribusjonssamlebånd.

  • Dataflyter støttes for øyeblikket ikke. Kunder som bruker dataflyter, kan bruke Power BI-API.

  • Tjenestekontohavere støttes bare for Power BI-elementer.

  • Ikke alle distribusjonsalternativer som er tilgjengelige i Power BI-API er tilgjengelige i Fabric. Følgende API-er er ikke tilgjengelige i fabric's Deploy stage content API:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    Hvis du trenger én av disse API-ene, kan du bruke Power BI-API til å distribuere. Disse API-ene fungerer imidlertid bare for Power BI-elementer.

Relatert innhold