Condividi tramite

Usare librerie di variabili di Fabric in Dataflow Gen2

Annotazioni

Per altre informazioni su come sfruttare questa funzionalità negli scenari di integrazione continua/distribuzione continua (CI/CD), leggere l'articolo sulle architetture di soluzioni CI/CD e ALM per Dataflow Gen2 e l'esercitazione end-to-end sui riferimenti alle variabili in un flusso di dati.

Le librerie di variabili di Fabric offrono un modo centralizzato per gestire i valori di configurazione nei carichi di lavoro di Microsoft Fabric. Con la nuova integrazione in Dataflow Gen2, è possibile fare riferimento a queste variabili direttamente nel flusso di dati, abilitando il comportamento dinamico negli ambienti e semplificando i flussi di lavoro CI/CD.

Prerequisiti

Per usare le librerie di variabili di Fabric in Dataflow Gen2, verificare quanto segue:

Variabili di riferimento con widget di input

Le finestre di dialogo Flusso di dati Gen2 includono un widget di input che consente di scegliere come immettere un valore di campo. Nelle finestre di dialogo supportate è possibile selezionare le variabili usando questo widget.

Screenshot del widget di input all'interno di una finestra di dialogo delle righe di filtro che mostra le più opzioni disponibili per l'input.

Annotazioni

Per usare il widget di input, nella scheda Visualizza della barra multifunzione selezionare Consenti sempre nel gruppo Parametri. Screenshot della casella di controllo

Alcune finestre di dialogo supportano l'esperienza del widget di input e le librerie di variabili di Fabric, tra cui:

Quando si seleziona l'opzione variabile nel widget di input, viene visualizzata la finestra di dialogo selezione variabile. In questa finestra di dialogo è possibile esplorare le librerie di variabili e le variabili che contengono.

Screenshot della finestra di dialogo Seleziona variabile che mostra tutte le librerie e le variabili disponibili nell'area di lavoro corrente.

Dopo aver selezionato una variabile, la finestra di dialogo visualizza la libreria e il nome della variabile in modo da poter confermare la selezione prima del commit.

Screenshot di una variabile con il nome Ceiling dalla libreria La mia libreria mostrata come selezionata nella finestra di dialogo Filtra righe.

Annotazioni

Non tutte le esperienze di flusso di dati supportano il widget di input. Per le esperienze non supportate o gli scenari personalizzati, usare manualmente le funzioni delle variabili.

Funzioni variabili

All'interno di Dataflow Gen2 è possibile fare riferimento a una variabile usando una delle funzioni seguenti:

L'identificatore passato a una delle due funzioni deve usare il formato seguente:

$(/**/LibraryName/VariableName)

Gli esempi seguenti presuppongono una libreria di variabili denominata My Library e una variabile stringa denominata My Variable:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

L'uso di un valore predefinito tramite Variable.ValueOrDefault consente di assicurarsi che la formula venga risolta anche quando si copia o si sposta la soluzione in un altro ambiente che non dispone della libreria di variabili a cui si fa riferimento.

Suggerimento

Archiviare ogni variabile come query separata che non richiede staging. Questo approccio consente di usare questi valori nelle finestre di dialogo che supportano l'input della query e consente di mantenere una visualizzazione organizzata delle variabili nel flusso di dati.

Considerazioni e limitazioni

L'elenco seguente illustra i vincoli e i comportamenti importanti da tenere presenti quando si usano librerie di variabili di Fabric con Dataflow Gen2. Queste limitazioni influiscono sulla modalità di riferimento, valutazione e applicazione delle variabili durante la progettazione e il runtime.

  • Ambito dell'area di lavoro: le librerie variabili devono trovarsi nella stessa area di lavoro di Dataflow Gen2 con CI/CD.

  • Percorso di riferimento: le variabili possono essere usate solo all'interno del file mashup.pq di un dataflow Gen2 con CI/CD.

  • Comportamento di runtime: i valori delle variabili vengono recuperati all'inizio di un'operazione di esecuzione e resi persistenti durante l'operazione. Le modifiche apportate a una libreria durante un'esecuzione del flusso di dati non si interrompono o influiscono sull'esecuzione.

  • Uso di un valore predefinito: quando si usa un valore predefinito tramite la funzione Variable.ValueOrDefault, assicurarsi che il tipo di dati del valore predefinito corrisponda al tipo di dati della variabile a cui si fa riferimento.

  • Tipi supportati: sono supportate solo le variabili dei tipi di base (boolean, datetime, guidinteger, number, e string).

  • Connessioni fisse: le variabili non possono modificare le informazioni di connessione. Le connessioni rimangono ancorate alle configurazioni del percorso delle risorse definite.

  • Rischio di override: gli utenti con accesso per modificare le librerie di variabili possono eseguire l'override dei valori delle variabili, che potrebbero influire sull'output del flusso di dati.

  • Mappatura degli schemi: le variabili non possono modificare le mappature dello schema di destinazione; le mappature seguono la configurazione creata.

  • Visibilità della derivazione: le visualizzazioni di derivazione non mostrano collegamenti tra Dataflow Gen2 e le librerie di variabili a cui fa riferimento.

  • Last updated on