Dela via

Skapa distributionsregler

När du arbetar i en distributionspipeline kan olika steg ha olika konfigurationer. Varje fas kan till exempel ha olika databaser eller olika frågeparametrar. Utvecklingssteget kan köra frågor mot exempeldata från databasen, medan test- och produktionsstegen frågar hela databasen.

När du distribuerar innehåll mellan pipelinesteg kan du konfigurera distributionsregler för att ändra innehållet samtidigt som vissa inställningar hålls intakta. Du kan till exempel definiera en regel för semantisk modell i en produktionsfas för att peka på en produktionsdatabas i stället för en i testfasen. Regeln definieras i produktionsfasen under lämplig semantisk modell. När regeln har definierats ärver innehåll som distribueras från test till produktion värdet enligt definitionen i distributionsregeln. Den här regeln gäller alltid så länge den är oförändrad och giltig.

Anteckning

Det nya användargränssnittet för distributionspipelinen finns för närvarande i förhandsversion. Om du vill aktivera eller använda det nya användargränssnittet kan du läsa Börja använda det nya användargränssnittet.

Du kan konfigurera regler för datakällor, parameterregler och standardregler för lakehouse. I följande tabell visas vilken typ av objekt du kan konfigurera regler för och vilken typ av regel du kan konfigurera för var och en.

Artikel Datakällans regel Parameterregel Standardregel för lakehouse Detaljer
Dataflöde gen1 ✅ ✅ ❌ Använd för att fastställa datakällornas eller parametrarnas värden för ett specifikt dataflöde gen1.
Semantisk modell ✅ ✅ ❌ Använd för att fastställa datakällornas eller parametrarnas värden för en specifik semantisk modell.
Datamart ✅ ✅ ❌ Använd för att fastställa datakällornas eller parametrarnas värden för en specifik datamart.
Sidnumrerad rapport ✅ ❌ ❌ Definierade datakällor för varje sidnumrerad rapport. Använd för att fastställa datakällorna för den sidnumrerade rapporten.
Speglad databas ✅ ❌ ❌ Definierad för datakällorna för varje speglad databas.
Notebook ❌ ❌ ✅ Används för att fastställa standardlakehouse för en specifik anteckningsbok.

Anteckning

Datakällans regler 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 semantiska modeller med de nyligen skapade reglerna från källsteget till målfasen där reglerna skapades. Reglerna gäller inte förrän du distribuerar semantiska modeller från källan till målfasen.

  1. I pipelinefasen som du vill skapa en distributionsregel för väljer du Distributionsregler.

    En skärmbild av knappen distributionsregler som finns på menyn för distributionssteg.

  2. En lista över objekt som du kan ange regler för visas i fönstret. Alla objekt i pipelinen visas inte. Endast objekt av en typ som du kan skapa regler för visas (dataflöden gen1, semantisk modell, datamarter, notebook-filer och sidnumrerade rapporter). Om du vill hitta det objekt som du vill ange en regel för använder du sök- eller filterfunktionerna.

    En skärmbild av fönstret distributionsregler i det nya användargränssnittet som visar att du kan ange regler för dataflöden gen1, datauppsättningar, datamarts och sidnumrerade rapporter.

  3. Välj det objekt som du vill skapa en regel för. De typer av regler som du kan skapa för objektet visas. Om du till exempel skapar en regel för ett dataflöde gen1 kan du skapa en datakällsregel eller en parameterregel. Om du skapar en regel för en notebook-fil kan du skapa en standardregel för lakehouse.

  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 med nya distributionsregler. Den visar en vald datauppsättning och de två regeltyperna, datakällan och parametern, som du kan konfigurera för den.

    • Regler för datakälla

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

      • Välj från en lista.

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

      Anteckning

      • Datakällans regler är nedtonade om du inte äger objektet som du skapar en regel för, eller om objektet inte innehåller några datakällor.
      • För dataflöden gen1, semantiska modeller och sidnumrerade rapporter tas listan över datakällor från källpipelinesteget.
      • Du kan inte använda samma datakälla i mer än en regel.

    • Parameterregler Välj en parameter i listan över parametrar. Det aktuella värdet visas. Redigera värdet till det värde som du vill börja gälla efter varje distribution.

    • Standardregler för lakehouse Den här regeln gäller endast för notebooks. Välj ett lakehouse för att ansluta till notebook-filen i målfasen och ange den som standard. Mer information finns i Notebook i distributionspipelines.

Datakällor som stöds för dataflödesgen1 och semantiska modellregler

Datakällans regler kan definieras för följande datakällor:

  • Azure Analysis Services (AAS)
  • Azure Synapse
  • SQL Server Analysis Services (SSAS)
  • Azure SQL Server
  • SQL Server
  • Odatafeed
  • Oracle
  • SapHana (endast importläge, inte direkt frågeläge)
  • SharePoint
  • Teradata

För andra datakällor rekommenderar vi att du använder parametrar för att konfigurera din datakälla.

Beaktanden och begränsningar

I det här avsnittet visas begränsningarna för distributionsreglerna.

  • Om du vill skapa en distributionsregel måste du vara ägare till det objekt som du skapar en regel för.

  • Distributionsregler kan inte skapas i utvecklingsfasen.

  • När ett objekt tas bort eller tas bort tas även dess regler bort. Dessa regler kan inte återställas.

  • När du avtilldelar och omtilldelar en arbetsyta för att återupprätta anslutningar går reglerna för den arbetsytan förlorade. Om du vill använda dessa regler igen konfigurerar du om dem.

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

  • När du har distribuerat en sidnumrerad rapport med en datakällaregel kan du inte öppna rapporten med Power BI Report Builder.

  • Distributionsregler börjar gälla först nästa gång du distribuerar till den fasen. Men om du skapar regler och sedan jämför stegen innan du distribuerar görs jämförelsen baserat på de regler som skapades trots att de inte trädde i kraft ännu.

  • Följande scenarier stöds inte:

    • Datakällregler för dataflöden gen1 som har andra dataflöden som källor.
    • Regler för datakällor för CDM-mappar (Common Data Model) i ett dataflöde version 1.
    • Datakällsregler för semantiska modeller som använder dataflöden gen1 som källa.
    • Skapa datakällsregler för en semantisk modell som använder intern fråga och DirectQuery tillsammans.
    • Parameterregler stöds inte för sidnumrerade rapporter.
    • Lägga till datakällregler för semantiska modeller och dataflöden gen1 på datakällor som parametriseras.

Relaterat innehåll