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. Om du till exempel vill att en semantisk modell i en produktionsfas ska peka på en produktionsdatabas i stället för en i testfasen kan du definiera en regel för detta. 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 och tillämpas alltid så länge regeln är oförändrad och giltig.

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	Details
Dataflöde	✅	✅	❌	Använd för att fastställa datakällornas eller parametrarnas värden för ett specifikt dataflöde.
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	✅	❌	❌	Definierad för datakällorna för varje sidnumrerad rapport. Använd för att fastställa datakällorna för den sidnumrerade rapporten.
Notebook-fil	❌	❌	✅	Använd för att fastställa standard lakehouse för en specifik notebook-fil.

Kommentar

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.

   

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, 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.

   

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 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:

   

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

     Kommentar

     • 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, semantiska modeller och sidnumrerade rapporter hämtas 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 notebook-filer. 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öde 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

• Odata-feed

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

• Datakällregler 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.

• Datakällregler för semantiska modeller som använder dataflöden som källa stöds inte.

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

• Det går inte att skapa datakällsregler för en semantisk modell som använder intern fråga och DirectQuery tillsammans.

Kommentar

Parameterregler stöds inte för sidnumrerade rapporter.

Relaterat innehåll

• Kom igång med distributionspipelines
• Automatisera din distributionspipeline med API:er och DevOps