Nomi e tipi di variabili

Un elemento della libreria di variabili in Microsoft Fabric contiene un elenco di variabili e i relativi valori predefiniti. Può anche contenere altri set di valori che contengono valori alternativi.

Ogni variabile nella libreria di variabili ha le proprietà seguenti:

• Nome
• Nota (facoltativo), fino a 2.048 caratteri
• TIPO
• Set di valori predefinito
• Set di valori alternativi (facoltativo)

Convenzioni di denominazione

Nome della libreria di variabili

Il nome dell'elemento della libreria di variabili deve seguire queste convenzioni:

• Non è vuoto
• Non dispone di spazi iniziali o finali
• Inizia con una lettera
• Può includere lettere, numeri, caratteri di sottolineatura, trattini e spazi
• Non supera i 256 caratteri di lunghezza

Il nome della libreria di variabili non fa distinzione tra maiuscole e minuscole.

Nome variabile

Il nome di una variabile all'interno della libreria di variabili deve seguire queste convenzioni:

• Non è vuoto
• Non dispone di spazi iniziali o finali
• Inizia con una lettera o un carattere di sottolineatura
• Può includere lettere, numeri, caratteri di sottolineatura e trattini
• Non supera i 256 caratteri di lunghezza

Il nome della variabile non distingue tra maiuscole e minuscole.

Nome del set di valori

I nomi dei set di valori hanno le stesse restrizioni dei nomi delle variabili.

Tipi di variabili

Prima di poter aggiungere un valore a una variabile, è necessario definire il tipo di variabile. Le variabili nella libreria di variabili possono essere uno dei tipi seguenti:

• Stringa: qualsiasi carattere. Può essere null o vuoto.

• Boolean: True o False.

• DateTime: data e ora rappresentate come ISO 8601 standard a-MM-ggTHH:mm:ss.xxxZ, dove:

  • aaaa-MM-gg è l'anno a quattro cifre, seguito dal mese a due cifre e dal giorno a due cifre.
  • T separa la data e l'ora.
  • HH:mm:ss.xxx è l'ora a due cifre in formato 24 ore, seguita dal minuto a due cifre, dal secondo a due cifre e dal millisecondo a tre cifre.
  • Z indica che l'ora è nell'ora UTC (Coordinated Universal Time).

  Un esempio è 2025-01-14T16:15:20.123Z.

• Numero: qualsiasi numero.

• GUID: identificatore univoco globale.

• Integer: numero intero che può essere positivo, negativo o zero.

Dopo che una variabile ha un valore definito, se si tenta di modificarne il tipo, viene visualizzata una finestra di dialogo di consenso. La finestra di dialogo avvisa che tutti i valori delle variabili verranno reimpostati e che questa modifica potrebbe essere una modifica che causa un'interruzione sul lato dell'elemento consumer.

Set di valori alternativi

Quando si crea un nuovo valore impostato in una libreria di variabili, i nuovi valori vengono impostati come puntatori ai valori predefiniti. È possibile modificarli in modo che siano un valore fisso.

Se si modifica il valore di una variabile nel set di valori alternativi, il valore alternativo viene salvato nel file JSON per i set di valori. È possibile modificare l'ordine in cui vengono visualizzati i set di valori o modificare il valore di una variabile nel set di valori alternativi, in questo file JSON in Git.

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.