Kom igång med distributionspipelines

Den här artikeln går igenom de grundläggande inställningar som krävs för att använda distributionspipelines Power BI tjänsten. Vi rekommenderar att du läser introduktionen av distributionspipelineernainnan du fortsätter.

I en distributionspipeline tilldelas en arbetsyta till varje fas. Innan du börjar arbeta med din pipeline i produktion granskar du kapacitetskraven för pipelinens arbetsytor.

Åtkomst till distributionspipelines

Du kommer att kunna komma åt distributionspipelinen om följande villkor är uppfyllda:

Anteckning

Du kan också se knappen distributionspipeliner om du tidigare har skapat en pipeline eller om en pipeline har delats med dig.

En skärmbild av landningssida för distributionspipelines.

Steg 1 – Skapa en distributionspipeline

Du kan skapa en pipeline från fliken distributionspipeliner eller från en arbetsyta.

När pipelinen har skapats kan du dela den med andra användare eller ta bort den. När du delar en pipeline med andra får de användare som du delar pipelinen med åtkomst till pipelinen. Med pipelineåtkomst kan användarna visa, dela, redigera och ta bort pipelinen.

Skapa en pipeline från fliken distributionspipelines

Om du vill skapa en pipeline från fliken distributionspipelines gör du följande:

  1. I Power BI-tjänsten går du till navigeringsfönstret. Välj distributionspipelines och välj sedan Skapa pipeline.

  2. I dialogrutan Skapa en distributionspipeline anger du ett namn och en beskrivning för pipelinen och väljer Skapa.

Skapa en pipeline från en arbetsyta

Du kan skapa en pipeline från en befintlig arbetsyta, vilket innebär att du är administratör för en ny arbetsyteupplevelse.

  1. Från arbetsytan väljer du Skapa en pipeline.

    En skärmbild av knappen Skapa en pipeline i en arbetsyta.

  2. I dialogrutan Skapa en distributionspipeline anger du ett namn och en beskrivning för pipelinen och väljer Skapa.

Anteckning

Om arbetsytan inte är tilldelad till din organisations Premium-kapacitet eller till din PPU-kapacitet, får du ett meddelande om att tilldela den till en kapacitet.

Steg 2 – tilldela en arbetsyta till en distributionspipeline

När du har skapat en pipeline måste du lägga till det innehåll som du vill hantera i pipelinen. Att lägga till innehåll i pipelinen görs genom att tilldela en arbetsyta till pipelinefasen. Du kan tilldela en arbetsyta till alla faser.

Du kan bara tilldela en arbetsyta till en distributionspipeline. Distributionspipelines skapar kloner av innehållet i arbetsytan som ska användas i olika steg i pipelinen.

Följ dessa steg om du vill tilldela en arbetsyta i en distributionspipeline:

  1. I den nyligen skapade distributionspipelinen väljer du Tilldela en arbetsyta.

  2. Välj den arbetsyta som du vill tilldela pipelinen i Välj arbetsyta i listrutan.

    Anteckning

    Om du skapar en pipeline från en arbetsyta kan du hoppa över det här steget eftersom arbetsytan redan har valts.

  3. Välj den fas som du vill tilldela arbetsytan till.

Tilldelningsbegränsningar för arbetsytan

Anteckning

Endast arbetsytor som kan användas med distributionspipelines visas i listan över arbetsytor som du kan välja från.

Steg 3 – distribuera till en tom fas

Alla Pro-användare som är medlemar eller administratörer på källarbetsytan kan distribuera innehåll till en tom fas (en fas som inte innehåller innehåll). Arbetsytan måste finnas på en kapacitet för att distributionen ska kunna slutföras.

Du kan också använda REST API:er för distributionspipelines för att programmatiskt utföra distributioner. Mer information finns i Automatisera din distributionspipeline med API:er och DevOps.

Anteckning

Om du vill distribuera en sidnumrerad rapport behöver du en kapacitet som stöder sidnumrerade rapporter.

När du distribuerar innehåll till en tom fas bibehålls relationerna mellan objekten. Till exempel kommer en rapport som är kopplad till en datauppsättning i källfasen att klonas tillsammans med dess datauppsättning och klonerna är på samma sätt kopplade till målarbetsytan.

Uppdatera datauppsättningen när distributionen är klar. Mer information finns i distribuera innehåll till en tom fas.

Distribuera allt innehåll

Välj den fas du vill distribuera från och välj sedan distributionsknappen. Distributionsprocessen skapar en duplicerad arbetsyta i målfasen. Den här arbetsytan innehåller allt befintligt innehåll i den aktuella fasen.

En skärmbild som visar distributionsknappen för utvecklings- och testfaserna i en distributionspipeline.

Selektiv distribution

Om du endast vill distribuera vissa objekt väljer du länken Visa fler och väljer sedan de objekt som du vill distribuera. När du klickar på knappen distribuera distribueras endast de markerade objekten till nästa steg.

Eftersom instrumentpaneler, rapporter, datauppsättningar och dataflöden är relaterade och har beroenden kan du använda knappen Välj relaterade för att kontrollera alla objekt som dessa objekt är beroende av. Om du till exempel vill distribuera en rapport till nästa fas kan du klicka på knappen Välj relaterad så markeras den datauppsättning som rapporten är ansluten till, så att båda ska distribueras samtidigt och rapporten inte bryts.

En skärmbild som visar alternativet för selektiv distribution i pipelines, vilket är tillgängligt när du har valt alternativet att visa mer.

Anteckning

  • Du kan inte distribuera Power BI ett objekt till nästa steg om objekten som det är beroende av inte finns i den fas som du distribuerar till. Till exempel misslyckas distributionen av en rapport utan datauppsättning, såvida inte datauppsättningen redan finns i målfasen.
  • Du kan få oväntade resultat om du väljer att distribuera Power BI objekt utan det objekt som det är beroende av. Detta kan inträffa när en datauppsättning eller ett dataflöde i målfasen har ändrats och inte längre är identiskt med den i fasen som du distribuerar från.

Omvänd distribution

Du kan välja att distribuera till ett tidigare stadium, till exempel i ett scenario där du tilldelar en befintlig arbetsyta till en produktionsfas och sedan distribuerar den omvänt, först till testfasen och sedan till utvecklingsfasen.

Distribution till en tidigare fas fungerar bara om den föregående fasen är tom. När du distribuerar till en tidigare fas kan du inte välja vissa objekt. Allt innehåll i steget kommer att distribueras.

En skärmbild som visar knappen Distribuera till föregående steg, som är tillgänglig från test- och produktionsstegens menyer.

Steg 4 – Skapa distributionsregler

När du arbetar i en distributionspipeline kan olika fas ha olika konfigurationer. Varje fas kan till exempel ha olika databaser eller olika frågeparametrar. Utvecklingsfasen kan fråga exempeldata från databasen, medan test- och produktionsfaserna frågar hela databasen.

När du distribuerar innehåll mellan pipelinefaser kan du konfigurera distributionsregler för att tillåta ändringar av innehåll, samtidigt som vissa inställningar förblir intakta. Om du till exempel vill att en datauppsättning i en produktionsfas ska peka på en produktionsdatabas kan du definiera en regel för detta. Regeln definieras i produktionsfasen under motsvarande uppsättning. När regeln har definierats ärver innehåll som distribueras från test till produktion värdet enligt definitionen i distributionsregeln och gäller alltid så länge regeln är oförändrad och giltig.

Du kan konfigurera regler för datakällsregler och parameterregler. I följande tabell visas vilken typ Power BI som du kan konfigurera regler för och vilken typ av regel du kan konfigurera för var och en.

Regel för datakälla Parameterregel Information
Dataflöde Gäller för. Gäller för. Använd för att fastställa värdena för datakällorna eller parametrarna för ett specifikt dataflöde.
Datamängd Gäller för. Gäller för. Använd för att fastställa värdena för datakällorna eller parametrarna för en specifik datauppsättning.
Sidnumrerad rapport Gäller för. Gäller inte för. Definieras för datakällorna för varje sidnumrerad rapport. Du kan använda dessa regler för att fastställa datakällorna för den sidnumrerade rapporten.

Anteckning

Datakällsregler fungerar bara när du ändrar datakällor från samma typ.

Skapa en distributionsregel

Följ stegen i det här avsnittet om du vill skapa en distributionsregel. När du har skapat alla distributionsregler som du behöver distribuerar du datauppsättningarna med de nyligen skapade reglerna från källfasen till målfasen där reglerna skapades. Reglerna gäller inte förrän du distribuerar datauppsättningarna från källan till målfasen.

  1. I pipelinesteget som du vill skapa en distributionsregel för väljer du Distributionsinställningar.

    En skärmbild av knappen distributionsinställningar som finns i distributionsinställningarna.

  2. Du kan ange regler för dataflöden, datauppsättningar och sidnumrerade rapporter. I fönstret Distributionsinställningar väljer du den typ av regel som du vill ange.

    En skärmbild av fönstret distributionsregler som visar att du kan ange regler för dataflöden, datauppsättningar och sidnumrerade rapporter.

  3. Välj det dataflöde, den datauppsättning eller den sidnumrerade rapport som du vill skapa en regel för.

    En skärmbild av fönstret för distributionsregler som visar två datauppsättningar på fliken datauppsättningar. Om du vill konfigurera en regel väljer du ett objekt på någon av flikarna.

  4. Välj den typ av regel som du vill skapa, expandera listan och välj sedan Lägg till regel. Det finns två typer av regler som du kan skapa:

    En skärmbild av fönstret distributionsregler som visar en vald datauppsättning och de två regeltyperna, datakälla och parameter, som du kan konfigurera för den.

    • Datakällregler

      I listan med datakällor väljer du ett datakällnamn som ska uppdateras. Använd någon av följande metoder för att välja ett värde som ska ersätta det från källfasen:

      • Välj från listan.

      • Välj Annan och lägg till den nya datakällan manuellt. Du kan endast ändra till en datakälla från samma typ.

      Anteckning

      • Regler för datakälla är nedtonade om du inte är ägare till det Power BI-objekt som du skapar en regel för, eller om ditt Power BI-objekt inte innehåller några datakällor.
      • För dataflöden, datauppsättningar och sidnumrerade rapporter , tas datakällslistan från källpipelinens fas.
    • Parameterregler – Välj en parameter i listan över parametrar. det aktuella värdet visas. Redigera värdet till det värde som du vill ska gälla efter varje distribution.

Begränsningar för distributionsregel

Det här avsnittet innehåller begränsningar för distributionsregler.

  • Om du vill skapa en distributionsregel måste du vara ägare till det dataflöde, den datauppsättning eller den sidnumrerade rapport som du skapar en regel för.

  • Det går inte att skapa distributionsregler i utvecklingssteget.

  • När ett objekt tas bort raderas även dess regler. Det går inte att återställa dessa regler.

  • Regler för dataflöden som har andra dataflöden som källor stöds inte.

  • Datakällsregler för CDM-mappar (Common Data Model) i ett dataflöde stöds inte.

  • Regler för datauppsättningar som använder dataflöden som källa stöds inte.

  • Om datakällan som definierats i en regel ändras eller tas bort från objektet som den pekar på i källfasen är regeln inte giltig och distributionen misslyckas.

  • Om parametern som definieras i en regel ändras eller tas bort från objektet som den pekar på i källfasen är regeln inte giltig och distributionen misslyckas.

Anteckning

Parameterregler stöds inte för sidnumrerade rapporter.

Datakällor som stöds för dataflödes- och datauppsättningsregler

Regler för datakällor kan bara definieras för följande datakällor:

  • Azure Analysis Services

  • Azure Synapse

  • SQL Server Analysis Services (SSAS)

  • Azure SQL-server

  • SQL-server

  • OData-feed

  • Oracle

  • SapHana (stöds endast för importläge, inte direkt frågeläge)

  • SharePoint

  • Teradata

För andra datakällor rekommenderar vi att använda parametrar för att konfigurera datakällan.

Steg 5 – Distribuera innehåll från ett steg till ett annat

När du har innehåll i en pipelinefas kan du distribuera den till nästa steg. Distributionen av innehåll till en annan fas sker vanligtvis när du har genomfört några åtgärder i pipelinen. Du kan till exempel göra utvecklingsändringar i ditt innehåll i utvecklingsfasen eller testa innehållet i testfasen. Ett typiskt arbetsflöde för att flytta innehåll från fas till fas är utveckling till test och sedan test till produktion. Du kan lära dig mer om den här processen i avsnittet distribuera innehåll till en befintlig arbetsyta.

Om du vill distribuera innehåll till nästa steg i distributionspipelinen väljer du knappen distribuera längst ned i fasen.

När du har granskat test- och produktionsfaserna kan du se den senaste distributionstiden. Detta anger det senaste tillfället då innehållet distribuerades till fasen.

Distributionstiden är användbar för att fastställa när en fas senast uppdaterades. Det kan också vara användbart om du vill spåra tiden mellan test- och produktionsdistributioner.

Jämföra faser

När två sekventiella faser har innehåll jämförs innehållet baserat på metadata för innehållsobjekten. Jämförelsen omfattar inte jämförelse av data eller uppdateringstid mellan faser.

En skärmbild som visar en distributionspipeline med dess jämförelseindikatorer.

För att få en snabb visuell insyn i skillnaderna mellan två sekventiella steg visas en jämförelseikon mellan dem. Jämförelseikonen har två tillstånd:

  • Grön indikator – Metadata för varje innehållsobjekt i båda faserna är samma.

  • Orange indikator – visas om något av dessa villkor uppfylls:

    • Några av innehållsobjekten i varje fas har ändrats eller uppdaterats (har olika metadata).
    • Det finns en skillnad i antalet objekt mellan faserna.

När två sekventiella steg inte är identiska visas en jämförelselänk under den orange jämförelseikonen. När du klickar på länken öppnas innehållsobjektlistan i båda stegen i vyn Jämför. Med vyn Jämför kan du spåra ändringar eller skillnader mellan objekt, i varje pipelinefas. Ändrade objekt får en av följande etiketter:

  • Ny – ett nytt objekt i källfasen. Detta är ett objekt som inte finns i målfasen. Efter distributionen kommer det här objektet att klonas till målfasen.

  • Olika – ett objekt som finns både i käll- och målfasen där en av versionerna ändrades efter den senaste distributionen. Efter distributionen kommer objektet i källfasen att skriva över objektet i målfasen, oavsett var ändringen gjordes.

    Datauppsättningar med konfigurerade distributionsregler som inte har distribuerats markeras också som olika. Det beror på att distributionsregler inte tillämpas förrän datauppsättningarna har distribuerats från källfasen till målfasen, som innehåller de konfigurerade reglerna.

  • Saknas från – den här etiketten anger att ett objekt visas i målfasen, men inte i källfasen.

    Anteckning

    Distributionen kommer inte att påverka saknas från-objekt.

En skärmbild som visar jämförelsealternativet som utökar jämförelsevyn och tillåter jämförelse av objekt i olika faser i distributionspipelinen.

Åsidosätta innehåll

När du distribuerar efter att ha ändrat innehållet i källfasen skrivs det innehåll som du ändrade i målfasen över. När du klickar på Distribuera får du en varning om antalet objekt som skrivs över.

En skärmbild av varningen om ersatt innehåll som visas när en distribution är på väg att orsaka ändringar av objekt i den fas som du distribuerar till.

Du kan lära dig mer om vilka objekt som kopieras till nästa fas och vilka objekt som inte kopieras i Förstå distributionsprocessen.

Nästa steg