Delen via

Uw implementatiepijplijn automatiseren met Fabric-API's

  • Artikel

Met het hulpprogramma implementatiepijplijnen voor Microsoft Fabric kunnen teams een efficiënt en herbruikbaar releaseproces bouwen voor hun Fabric-inhoud.

Belangrijk

Deze functie is beschikbaar als preview-versie.

Gebruik de REST API's van Fabric voor implementatiepijplijnen om Fabric te integreren in het automatiseringsproces van uw organisatie. Hier volgen enkele voorbeelden van wat u kunt doen met behulp van de API's:

  • Integreer Fabric in bekende DevOps-hulpprogramma's, zoals Azure DevOps of GitHub Actions.

  • Plan pijplijnimplementaties automatisch op een bepaald tijdstip.

  • Implementeer meerdere pijplijnen tegelijk.

  • Trapsgewijs afhankelijk van pijplijnimplementaties. Als u inhoud tussen pijplijnen hebt verbonden, kunt u ervoor zorgen dat sommige pijplijnen worden geïmplementeerd voordat anderen.

Vereisten

Als u wilt werken met API's voor implementatiepijplijnen, hebt u de volgende vereisten nodig:

U kunt de REST API's zonder PowerShell gebruiken, maar de scripts in dit artikel gebruiken PowerShell. Als u de scripts wilt uitvoeren, moet u de volgende programma's installeren:

API-functies voor implementatiepijplijnen

Met de REST API's voor implementatiepijplijnen kunt u de volgende functies uitvoeren:

  • Implementatiepijplijn ophalen: retourneert informatie over de opgegeven implementatiepijplijn.

  • Implementatiepijplijnen weergeven: retourneert een lijst met implementatiepijplijnen waartoe de gebruiker toegang heeft.

  • Implementatiepijplijnfasen ophalen: retourneert de fasen van de opgegeven implementatie, inclusief de id, weergavenaam, beschrijving en of de fase openbaar is of niet.

  • Items voor implementatiepijplijnfase ophalen: retourneert de ondersteunde items uit de werkruimte die is toegewezen aan de opgegeven fase van de opgegeven implementatiepijplijn.

  • Inhoud van fase implementeren: items implementeren vanuit de opgegeven fase van de opgegeven implementatiepijplijn.

    • Gebruik deze API om alle items te implementeren of om specifieke items te selecteren die u wilt implementeren. Als er geen specifieke items zijn geselecteerd, worden alle items geïmplementeerd.

    • Gebruik de API Implementatiepijplijnfasen ophalen om de relevante fase-id te vinden die u wilt implementeren.

    • Deze API is geïntegreerd met de Long Running Operations API's om de implementatiestatus te bewaken.

U kunt ook andere Rest API-aanroepen van Fabric gebruiken om gerelateerde bewerkingen te voltooien.

PowerShell-voorbeelden

U kunt de volgende PowerShell-scripts gebruiken om te begrijpen hoe u verschillende automatiseringsprocessen uitvoert. Als u de tekst in een PowerShell-voorbeeld wilt weergeven of kopiëren, gebruikt u de koppelingen in deze sectie.

  • Alles implementeren

    Geef de volgende informatie op:

    • Pijplijnnaam
    • Naam van bronfase
    • Naam van doelfase
    • Opmerkingen bij de implementatie (optioneel)

  • Selectief implementeren

    Geef de volgende informatie op:

    • Pijplijnnaam
    • Naam van bronfase
    • Naam van doelfase
    • Te implementeren items (weergavenaam en itemtype van items)
    • Opmerkingen bij de implementatie (optioneel)

Overwegingen en beperkingen

Houd rekening met de volgende beperkingen bij het gebruik van de API's voor implementatiepijplijnen:

  • Alle beperkingen die van toepassing zijn op de implementatiepijplijn, zijn van toepassing wanneer u de API's gebruikt. Zie Best practices voor implementatiepijplijnen voor meer informatie.

  • Gegevensstromen worden momenteel niet ondersteund. Klanten die gegevensstromen gebruiken, kunnen de API van Power BI s gebruiken.

  • Service-principals worden alleen ondersteund voor Power BI-items.

  • Niet alle implementatieopties die beschikbaar zijn in de API van Power BI s zijn beschikbaar in Fabric. De volgende API's zijn niet beschikbaar in de api voor het implementeren van fase-inhoud van Fabric:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    Als u een van deze API's nodig hebt, gebruikt u de API van Power BI om te implementeren. Deze API's werken echter alleen voor Power BI-items.

Gerelateerde inhoud