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.
Kommentar
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 | 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.
- Skapa en distributionsregel i det nya användargränssnittet
- Skapa en distributionsregel i det ursprungliga användargränssnittet
I pipelinefasen som du vill skapa en distributionsregel för väljer du Distributionsregler.
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.
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.
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.
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 som har andra dataflöden som källor.
- Datakällsregler för CDM-mappar (Common Data Model) i ett dataflöde.
- Datakällsregler för semantiska modeller som använder dataflöden 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 på datakällor som parametriseras.