Uw implementatiepijplijn automatiseren met Fabric-API's

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

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 automatisch pijplijnimplementaties op een specifiek 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:

• Dezelfde vereisten die u nodig hebt om implementatiepijplijnen te gebruiken.
• Een Microsoft Entra-token voor Fabric-service. Gebruik dit token in de autorisatieheader van de API-aanroep. Zie Fabric API quickstart voor informatie over hoe je een token kunt verkrijgen.

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:

• Powershell
• Az-module voor Azure PowerShell

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 weergeven: retourneert de fasen van de opgegeven implementatie, inclusief de id, weergavenaam, beschrijving en of de fase openbaar is of niet.

• Items van implementatiefase in pijplijn weergeven: retourneert de ondersteunde items uit de werkruimte die is toegewezen aan de gespecificeerde fase van de gespecificeerde implementatiepijplijn.

• Fase-inhoud implementeren: Implementeren van items 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.

  • Om de relevante fase-ID te vinden om uit te rollen, gebruikt u de List Deployment Pipeline Stages API.

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

    • Haal de bewerkingsstatus op om te zien of de bewerking is voltooid met de Get Long Running - Get Operation state-API .
    • Gedurende 24 uur nadat de implementatie is voltooid, is de uitgebreide implementatie-informatie beschikbaar in de Get Operation Result API.

• Implementatiepijplijn maken: Een implementatiepijplijn maken.

• Implementatiepijplijn verwijderen: Een implementatiepijplijn verwijderen.

• Implementatiepijplijn bijwerken: een implementatiepijplijn bijwerken.

• Implementatiepijplijnfase ophalen: details van een implementatiepijplijnfase ophalen.

• Implementatiepijplijnfase bijwerken: Een implementatiepijplijnfase bijwerken.

• Roltoewijzing voor implementatiepijplijn toevoegen: Voeg een roltoewijzing toe aan een implementatiepijplijn.

• Verwijder roltoewijzing van implementatiepijplijn: Verwijder een roltoewijzing uit een implementatiepijplijn.

• Toewijzingen van implementatiepijplijnrollen weergeven: geef alle roltoewijzingen voor een implementatiepijplijn weer.

• Werkruimte toewijzen aan implementatiepijplijnfase: Wijs een werkruimte toe aan een specifieke implementatiepijplijnfase.

• Werkruimte loskoppelen van de implementatiefase van de pijplijn: Een werkruimte loskoppelen van een specifieke fase binnen de implementatiepijplijn.

• Implementatiepijplijnbewerking ophalen: details van een implementatiepijplijnbewerking ophalen.

• Implementatiepijplijnbewerkingen weergeven: alle bewerkingen voor een implementatiepijplijn weergeven.

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.

U kunt ook de hele GitHub-map Fabric-Samples downloaden.

• Alles implementeren

  Geef de volgende informatie op:

  • Pijplijnnaam
  • Naam van bronfase
  • Doelfase naam
  • Opmerkingen bij de implementatie (optioneel)
  • Principal-type. Kies UserPrincipal of ServicePrincipal. Als u de service-principal bent, geef dan ook het volgende op:
    • Applicatie-ID (client) van de service-principal
    • Directory-id (tenant) van de service-principal
    • Geheime waarde van de service-principal

• Selectief implementeren

  Geef de volgende informatie op:

  • Pijplijnnaam
  • Naam van bronfase
  • Doelfase naam
  • Items om te implementeren (weergavenaam en itemtype)
  • Opmerkingen bij de implementatie (optioneel)
  • Principal-type. Kies UserPrincipal of ServicePrincipal. Als service-principal, geef ook het volgende:
    • Toepassings-id (client) van de serviceprincipal
    • Directory-id (tenant) van de service-principal
    • Geheime waarde van de service-principal

• Toewijzen aan nieuwe implementatiepijplijn en implementeren

  Geef de volgende informatie op:

  • ID van de ontwikkelwerkruimte
  • Naam van nieuwe productiewerkruimte
  • Pijplijnnaam
  • Opmerkingen bij de implementatie (optioneel)
  • Principal-type. Kies ofwel UserPrincipal of ServicePrincipal. Als het een service-principal betreft, geef dan ook het volgende op:
    • Toepassings-id (client) van de service-principal
    • Directory-ID (tenant) van de service-principal
    • Geheime waarde van de service-principal

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. Voor meer informatie, zie Best practices voor uitrolpijplijnen.

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

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

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

Gerelateerde inhoud

• Aan de slag met implementatiepijplijnen
• Best practices voor implementatiepijplijnen
• Problemen met implementatiepijplijnen oplossen