Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Una libreria di variabili di Microsoft Fabric è un bucket di variabili che altri elementi nell'area di lavoro possono usare come parte della gestione del ciclo di vita dell'applicazione. Funziona come elemento all'interno dell'area di lavoro che contiene un elenco di variabili, insieme ai rispettivi valori per ogni fase della pipeline di versione. Presenta un approccio unificato per una gestione efficiente delle configurazioni degli elementi all'interno di un'area di lavoro, per garantire scalabilità e coerenza tra le fasi del ciclo di vita.
Ad esempio, una libreria di variabili può contenere variabili che contengono valori per:
- Intero da usare in un'attività di attesa in una pipeline.
- Riferimento lakehouse che deve essere l'origine in un'attività di dati di copia . Ogni valore viene usato in una pipeline diversa, in base alla fase di rilascio della pipeline.
- Riferimento lakehouse da configurare come lakehouse predefinito del notebook. Ogni valore viene usato in una pipeline diversa, in base alla fase di rilascio del notebook.
La risoluzione dei valori nell'elemento consumer non è necessariamente associata alla relativa distribuzione. Invece, ogni elemento consumer risolve il valore in base al proprio contesto.
L'esperienza di una libreria di variabili è diversa in base al tipo di variabile, ma tutte le librerie di variabili consentono di definire e gestire variabili che altri elementi possono usare.
Libreria di variabili di Fabric:
- È compatibile con processi di integrazione continua e recapito continuo (CI/CD). Questa compatibilità consente l'integrazione con Git e la distribuzione tramite pipeline di distribuzione.
- Supporta l'automazione tramite le API pubbliche di Fabric.
Vantaggi
Le librerie di variabili consentono ai clienti di personalizzare e condividere le configurazioni.
Personalizzare le configurazioni
È possibile configurare un valore di variabile in base alla fase della pipeline di versione. È possibile configurare la libreria di variabili con set di valori: un valore per ogni fase della pipeline di versione. Quindi, dopo le impostazioni una tantum del valore attivo impostato per ogni fase, il valore corretto viene usato automaticamente nella fase della pipeline. Gli esempi includono:
- Modifica della connessione di un elemento in base alla fase.
- Passaggio a un'origine dati cloud diversa in base alla fase.
- Modifica della quantità di dati in una query in base alla fase.
Condividere le configurazioni
Le librerie di variabili offrono un modo centralizzato per gestire le configurazioni tra gli elementi dell'area di lavoro. Ad esempio, se nell'area di lavoro sono presenti più lakehouse e ognuno ha un collegamento che usa la stessa origine dati, è possibile creare una libreria di variabili con tale origine dati come una delle variabili. In questo modo, se si vuole modificare l'origine dati, è necessario modificarla una sola volta nella libreria di variabili. Non è necessario modificarlo separatamente in ogni lakehouse.
Struttura della libreria di variabili
Le librerie di variabili contengono una o più variabili. Ogni variabile ha un nome, un tipo e un valore predefinito. È anche possibile aggiungere una nota a ogni variabile per descriverne lo scopo o la modalità di utilizzo.
Valore predefinito
Il valore predefinito è il valore usato, a meno che non si definisca in modo specifico un valore diverso.
Tutte le variabili devono avere un valore predefinito. Se il tipo di variabile è string, il valore predefinito può essere null.
Set di valori alternativi
I set di valori definiscono i valori di ogni variabile nella libreria di variabili. Una libreria di variabili contiene in genere più set di valori. Il valore attivo (o effettivo) impostato contiene il valore ricevuto dall'elemento consumer per tale area di lavoro.
In ogni area di lavoro si seleziona un set di valori come attivo. Il set di valori attivi di un'area di lavoro non cambia durante una distribuzione o un aggiornamento da Git.
Quando si crea un set di valori alternativo, il nuovo set di valori viene creato con puntatori al valore predefinito per ogni variabile. È quindi possibile modificare il valore per ogni variabile nel nuovo set di valori.
Elementi supportati
Gli elementi seguenti supportano la libreria di variabili:
- Oleodotto
- Scorciatoia per una lakehouse
- Notebook, tramite NotebookUtils e
%%configure - Flusso di dati Gen 2
- Processo di copia
- Funzioni dati utente
Considerazioni e limitazioni
Limitazioni delle dimensioni
Possono essere presenti fino a 1.000 variabili e fino a 1.000 set di valori, purché siano soddisfatti entrambi i requisiti seguenti:
- Il numero totale di celle nei set di valori alternativi è minore di 10.000.
- Le dimensioni dell'elemento non superano 1 MB.
Questi requisiti vengono convalidati quando si salvano le modifiche.
Il campo della nota può contenere fino a 2.048 caratteri.
Il campo della descrizione del set di valori può contenere fino a 2.048 caratteri.
Limitazioni per i set di valori alternativi
- I set di valori alternativi in una libreria di variabili vengono visualizzati nell'ordine in cui sono stati aggiunti. Attualmente, non è possibile riordinarli nell'interfaccia utente. Per modificare l'ordine, modificare direttamente il file JSON.
- Il nome di ogni set di valori deve essere univoco all'interno di una libreria di variabili.
- I nomi delle variabili devono essere univoci all'interno di una libreria di variabili. Se si trovano in elementi diversi, è possibile avere due variabili con lo stesso nome in un'area di lavoro.
- Esiste sempre un valore attivo (e solo uno) impostato in una libreria di variabili alla volta. Non è possibile eliminare un valore impostato mentre è attivo. Per eliminarlo, configurare prima di tutto un altro valore impostato come attivo. È possibile impostare un valore attivo diverso per ogni fase di una pipeline di distribuzione.