Condividi tramite


Creare regole di distribuzione

Quando si lavora in una pipeline di distribuzione, le varie fasi potrebbero avere configurazioni diverse. Ogni fase, ad esempio, può avere database diversi o parametri di query diversi. La fase di sviluppo può eseguire query sui dati di esempio del 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, è possibile definire una regola perché un modello semantico in una fase di produzione punti a un database di produzione, anziché uno in una fase di test. La regola viene definita nella fase di produzione, sotto il modello semantico appropriato. Dopo aver definito la regola, i contenuti distribuiti dal test all'ambiente di produzione ereditano il valore definito nella regola di distribuzione. Questa regola verrà sempre applicata purché resti invariata e valida.

È possibile configurare le regole dell'origine dati, le regole dei parametri e le regole per impostazione predefinita dei lakehouse. 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 per impostazione predefinita dei lakehouse Dettagli
Flusso di dati Determinano i valori delle origini dati o dei parametri per un flusso di dati specifico.
Modello semantico Determinano i valori delle origini dati o dei parametri per un modello semantico specifico.
Data mart Determinano i valori delle origini dati o dei parametri per un data mart specifico.
Report impaginato Definito per le origini dati di ogni report impaginato. Determinano le origini dati del report impaginato.
Notebook Determinano il lakehouse per impostazione predefinita 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 vengono applicate fino a quando non si distribuiscono i modelli semantici dall'origine alla fase di destinazione.

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

    Screenshot del pulsante regole di distribuzione, che si trova nel menu di fase 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, data mart, notebook e report impaginati). Per trovare l'elemento per cui si vuole impostare una regola, usare le funzionalità di ricerca o di filtro.

    Screenshot del riquadro delle regole di distribuzione nella nuova interfaccia, che mostra che è possibile impostare regole per flussi di dati, set di dati, data mart e report impaginati.

  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 che si vuole creare, espandere l'elenco e quindi selezionare Aggiungi regola. È possibile creare due tipi di regole:

    Screenshot del nuovo riquadro delle regole di distribuzione. Mostra un set di dati selezionato e i due tipi di regole, l'origine dati e il parametro, che è possibile configurare per tale set di dati.

    • Regole origine dati

      Selezionare il nome di un'origine dati da aggiornare, dall’elenco delle origini dati. Usare uno dei metodi seguenti per selezionare un valore per sostituire quello della fase di origine:

      • Eseguire la selezione da un elenco.

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

      Nota

      • Le regole dell'origine dati verranno oscurate se non si è proprietari dell'elemento per cui si sta creando la 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 dei parametri Selezionare un parametro dall'elenco di parametri; viene visualizzato il valore corrente. Modificare il valore nel valore che si vuole rendere effettivo dopo ogni distribuzione.

    • Regole lakehouse per impostazione predefinita 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 in pipeline di distribuzione.

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

È possibile definire le regole delle origini dati per le origini dati seguenti:

  • Azure Analysis Services (AAS)

  • Azure Synapse

  • SQL Server Analysis Services (SSAS)

  • Azure SQL Server

  • SQL server

  • Feed OData

  • 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 la regola di distribuzione.

  • 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 si riassegna 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 per i flussi di dati che hanno 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 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 ha esito negativo.

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

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

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

Nota

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