Имена и типы переменных

Элемент библиотеки переменных в Microsoft Fabric содержит список переменных и их значения по умолчанию. Он также может содержать другие наборы значений, содержащие альтернативные значения.

Каждая переменная в библиотеке переменных имеет следующие свойства:

• Имя
• Примечание (необязательно), до 2048 символов
• Тип
• Набор значений по умолчанию
• Альтернативные наборы значений (необязательно)

Соглашения об именах

Имя библиотеки переменных

Имя элемента библиотеки переменной должно соответствовать следующим соглашениям:

• Не пуст
• Не имеет начальных или конечных пространств
• Начинается с буквы
• Может включать буквы, цифры, подчеркивания, дефисы и пробелы
• Длина не превышает 256 символов

Имя библиотеки переменных не учитывает регистр.

Имя переменной

Имя переменной в библиотеке переменных должно соответствовать следующим соглашениям:

• Не пуст
• Не имеет начальных или конечных пространств
• Начинается с буквы или подчеркивания
• Может включать буквы, цифры, символы подчеркивания и дефисы
• Длина не превышает 256 символов

Имя переменной не чувствительно к регистру.

Имя набора значений

Имена наборов значений имеют те же ограничения, что и имена переменных.

Типы переменных

Прежде чем добавить значение в переменную, необходимо определить тип переменной. Переменные в библиотеке переменных могут быть любым из следующих типов:

• Строка: любой символ. Может быть null или пустым.

• Логический: True или False.

• DateTime: дата и время, представленные в формате ISO 8601 standard yy-MM-ddTHH:mm:ss.xxxZ, где:

  • Гггг-ММ-дд является четырехзначным годом, за которым следует двухзначный месяц и двухзначный день.
  • T разделяет дату и время.
  • HH:mm:ss.xxx — это двухзначный час в формате 24-часового формата, за которым следует двухзначная минута, двухзначная секунда и три цифры миллисекунда.
  • Z указывает, что время находится в формате UTC.

  Примером является 2025-01-14T16:15:20.123Z.

• Число: любое число.

• GUID: глобальный уникальный идентификатор.

• Целое число: целое число, которое может быть положительным, отрицательным или нулевым.

После того как переменная имеет определенное значение, при попытке изменить его тип появится диалоговое окно согласия. В диалоговом окне отображается предупреждение о том, что все значения переменной будут сброшены и что это изменение может быть критическим изменением на стороне элемента потребителя.

Альтернативные наборы значений

При создании нового набора значений в библиотеке переменных новые значения задаются в качестве указателей на значения по умолчанию. Их можно изменить, чтобы быть фиксированным значением.

Если изменить значение переменной в альтернативном наборе значений, альтернативное значение сохраняется в JSON-файле для наборов значений. Вы можете изменить порядок отображения наборов значений или изменить значение переменной в альтернативном наборе значений в этом JSON-файле в Git.

Рекомендации и ограничения

Ограничения размера

• До 1000 переменных и до 1000 наборов значений, если вы соответствуете обоим из этих требований:

  • Общее количество ячеек в альтернативных наборах значений меньше 10 000.
  • Размер элемента не превышает 1 МБ.

  Эти требования проверяются при сохранении изменений.

• Поле заметки может содержать до 2048 символов.

• Поле описания набора значений может содержать до 2 048 символов.

Ограничения для альтернативных наборов значений

• Альтернативные наборы значений в библиотеке переменных отображаются в порядке их добавления. В настоящее время вы не можете переупорядочение их в пользовательском интерфейсе. Чтобы изменить порядок, измените JSON-файл напрямую.
• Имя каждого набора значений должно быть уникальным в библиотеке переменных.
• Имена переменных должны быть уникальными в библиотеке переменных. Вы можете иметь две переменные с одинаковым именем в рабочей области, если они в разных элементах.
• Всегда один (и только один) активный параметр, заданный в библиотеке переменных одновременно. Вы не можете удалить набор значений, пока он активен. Чтобы удалить его, сначала настройте другое значение, которое должно быть активным. Для каждого этапа конвейера развертывания можно задать другое активное значение.