Creare regole di distribuzione

Quando si lavora in una pipeline di distribuzione, le diverse fasi potrebbero avere configurazioni diverse. Ad esempio, ogni fase può avere database diversi o parametri di query diversi. La fase di sviluppo potrebbe eseguire query sui dati di esempio dal database, mentre le fasi di test e produzione eseguono query sull'intero database.

Quando si distribuisce il contenuto tra le fasi della pipeline, è possibile configurare le regole di distribuzione per modificare il contenuto mantenendo intatte alcune impostazioni. Ad esempio, se si vuole che un modello semantico in una fase di produzione punti a un database di produzione anziché a uno nella fase di test, è possibile definire una regola per questo. La regola viene definita nella fase di produzione, nel modello semantico appropriato. Una volta definita la regola, il contenuto distribuito dal test all'ambiente di produzione erediterà il valore definito nella regola di distribuzione e verrà sempre applicato purché la regola sia invariata e valida.

È possibile configurare regole dell'origine dati, regole dei parametri e regole lakehouse predefinite. La tabella seguente elenca il tipo di elementi per cui è possibile configurare le regole e il tipo di regola che è possibile configurare per ognuno di essi.

Articolo	Regola origine dati	Regola dei parametri	Regola di lakehouse predefinita	Dettagli
Flusso di dati	✅	✅	❌	Usare per determinare i valori delle origini dati o dei parametri per un flusso di dati specifico.
Modello semantico	✅	✅	❌	Usare per determinare i valori delle origini dati o dei parametri per un modello semantico specifico.
Datamart	✅	✅	❌	Usare per determinare i valori delle origini dati o dei parametri per un datamart specifico.
Report impaginato	✅	❌	❌	Definito per le origini dati di ogni report impaginato. Utilizzare per determinare le origini dati del report impaginato.
Notebook	❌	❌	✅	Usare per determinare il lakehouse predefinito per un notebook specifico.

Nota

Le regole dell'origine dati funzionano solo quando si modificano le origini dati dallo stesso tipo.

Creare una regola di distribuzione

Per creare una regola di distribuzione, seguire la procedura descritta in questa sezione. Dopo aver creato tutte le regole di distribuzione necessarie, distribuire i modelli semantici con le regole appena create dalla fase di origine alla fase di destinazione in cui sono state create le regole. Le regole non verranno applicate fino a quando non si distribuiscono i modelli semantici dall'origine alla fase di destinazione.

1. Nella fase della pipeline per cui si vuole creare una regola di distribuzione selezionare Regole di distribuzione.

   

2. Un elenco di elementi per cui è possibile impostare le regole da visualizzare nella finestra. Non tutti gli elementi nella pipeline sono elencati. Vengono elencati solo gli elementi di un tipo per cui è possibile creare regole (flussi di dati, modello semantico, datamarts, notebook e report impaginati). Per trovare l'elemento per cui si vuole impostare una regola, usare le funzionalità di ricerca o filtro.

   

3. Selezionare l'elemento per cui si vuole creare una regola. Vengono visualizzati i tipi di regole che è possibile creare per tale elemento. Ad esempio, se si crea una regola per un flusso di dati, è possibile creare una regola di origine dati o una regola di parametro. Se si crea una regola per un notebook, è possibile creare una regola lakehouse predefinita.

4. Selezionare il tipo di regola da creare, espandere l'elenco e quindi selezionare Aggiungi regola. Esistono due tipi di regole che è possibile creare:

   

   • Regole origine dati

     Nell'elenco origine dati selezionare un nome di origine dati da aggiornare. Usare uno dei metodi seguenti per selezionare un valore per sostituire quello dalla fase di origine:

     • Selezionare da un elenco.

     • Selezionare Altro e aggiungere manualmente la nuova origine dati. È possibile passare a un'origine dati solo dallo stesso tipo.

     Nota

     • Le regole dell'origine dati verranno disattivate se non si è il proprietario dell'elemento per cui si sta creando una regola o se l'elemento non contiene origini dati.
     • Per i flussi di dati, i modelli semantici e i report impaginati, l'elenco delle origini dati viene ricavato dalla fase della pipeline di origine.
     • Non è possibile usare la stessa origine dati in più regole.

   • Regole parametro Consente di selezionare un parametro dall'elenco dei parametri. Viene visualizzato il valore corrente. Modificare il valore nel valore che si vuole rendere effettivo dopo ogni distribuzione.

   • Regole lakehouse predefinite Questa regola si applica solo ai notebook. Selezionare un lakehouse per connettersi al notebook nella fase di destinazione e impostarlo come predefinito. Per altre informazioni, vedere Notebook nelle pipeline di distribuzione.

Origini dati supportate per il flusso di dati e le regole del modello semantico

Le regole dell'origine dati possono essere definite per le origini dati seguenti:

• Azure Analysis Services (AAS)

• Azure Synapse

• SQL Server Analysis Services (SSAS)

• Azure SQL Server

• SQL server

• Odata Feed

• Oracle

• SapHana (solo modalità di importazione, non modalità query diretta)

• SharePoint

• Teradata

Per altre origini dati, è consigliabile usare i parametri per configurare l'origine dati.

Considerazioni e limitazioni

Questa sezione elenca le limitazioni per le regole di distribuzione.

• Per creare una regola di distribuzione, è necessario essere il proprietario dell'elemento per cui si sta creando una regola.

• Non è possibile creare regole di distribuzione nella fase di sviluppo.

• Quando un elemento viene rimosso o eliminato, vengono eliminate anche le relative regole. Queste regole non possono essere ripristinate.

• Quando si annulla l'assegnazione e la riassegnazione di un'area di lavoro per ristabilire le connessioni, le regole per tale area di lavoro andranno perse. Per usare di nuovo queste regole, riconfigurarle.

• Le regole dell'origine dati per i flussi di dati con altri flussi di dati come origini non sono supportate.

• Le regole dell'origine dati per le cartelle CDM (Common Data Model) in un flusso di dati non sono supportate.

• Le regole dell'origine dati per i modelli semantici che usano flussi di dati come origine non sono supportate.

• Se l'origine dati o il parametro definito in una regola viene modificato o rimosso dall'elemento a cui punta nella fase di origine, la regola non è più valida e la distribuzione non riesce.

• Dopo aver distribuito un report impaginato con una regola di origine dati, non è possibile aprire il report usando Power BI Generatore report.

• Le regole di distribuzione diventano effettive solo alla successiva distribuzione in tale fase. Tuttavia, se si creano regole e quindi si confrontano le fasi prima della distribuzione, il confronto viene eseguito in base alle regole create anche se non hanno ancora avuto effetto.

• La creazione di regole dell'origine dati in un modello semantico che usa query native e DirectQuery insieme non è supportata.

Nota

Le regole dei parametri non sono supportate per i report impaginati.

Contenuto correlato

• Introduzione alle pipeline di distribuzione
• Automatizzare la pipeline di distribuzione usando le API e DevOps