Che cos'è una libreria di variabili? (anteprima)

Una libreria di variabili di Microsoft Fabric può essere considerata come un bucket di variabili che possono essere utilizzate da altri elementi nell'area di lavoro. 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 che consente ai clienti di gestire in modo efficiente le configurazioni degli elementi all'interno di un'area di lavoro, garantendo scalabilità e coerenza nelle diverse fasi del ciclo di vita.

Ad esempio, una libreria di variabili può contenere variabili che contengono valori diversi per:

• Intero da usare in un'attività di attesa in una pipeline.
• Riferimento a lakehouse da usare come origine nell'attività Copia dati. Ogni valore viene usato in una pipeline diversa in base alla fase di rilascio in cui si trova la pipeline.
• Riferimento a lakehouse da configurare come lakehouse predefinito del notebook. Ogni valore viene usato in una pipeline diversa in base alla fase di rilascio in cui si trova il 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 della libreria di variabili è diversa in base al tipo di variabile, ma il concetto di base rimane invariato: consente di definire e gestire variabili che possono essere usate in altri elementi.

La libreria di variabili di Fabric:

• È compatibile con i processi CI/CD, consentendo l'integrazione con Git e la distribuzione tramite pipeline di distribuzione.
• Supporta l'automazione tramite le API pubbliche di Microsoft Fabric.

Le librerie di variabili consentono ai clienti di:

• Personalizzare le configurazioni:

  Un valore di variabile può essere configurato in base alla fase della pipeline di versione. L'utente può configurare la libreria di variabili con set di valori diversi, uno per ogni fase della pipeline di versione. In seguito, dopo le impostazioni una tantum del valore attivo impostato per ogni fase, il valore corretto viene usato automaticamente nella fase della pipeline. Alcuni esempi includono:

  • Modifica della connessione degli elementi 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 solo una volta nella libreria delle variabili anziché modificarla separatamente in ogni lakehouse.

Struttura della libreria di variabili

Componenti principali

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 da usare.
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 set di valori attivo (o effettivo) contiene il valore ricevuto dagli elementi consumer per tale area di lavoro. In ogni area di lavoro si seleziona un set di valori come attivo. Il set di valori attivo di un'area di lavoro non cambia durante la distribuzione o l'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:

• Pipeline di dati (anteprima)

• Assegnare variabili alle scorciatoie (anteprima)

Considerazioni e limitazioni

Limitazioni delle dimensioni

• Possono essere presenti fino a 1.000 variabili e fino a 1.000 set di valori, purché il numero totale di celle nei set di valori alternativi sia inferiore a 10.000 celle e le dimensioni dell'elemento non siano maggiori di 1 MB. Queste condizioni vengono convalidate quando l'utente salva 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 dei set di valori alternativi

• I set di valori alternativi nella 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 della 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 solo valore attivo alla volta impostato in una libreria di variabili. Non è possibile eliminare il set di valori attivo. Per eliminarlo, impostare prima un altro set di valori come attivo. È possibile impostare un set di valori attivo diverso per ogni fase di una pipeline di distribuzione.

Contenuti correlati

• Autorizzazioni per la libreria di variabili
• Introduzione alle librerie di variabili