Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Библиотека переменных в Microsoft Fabric — это специализированный элемент, который централизует определение и управление переменными, что позволяет масштабируемую и автоматизированную конфигурацию в рабочих областях и элементах.
Переменные в библиотеке переменных могут быть базовыми или расширенными типами, и каждая переменная однозначно определяется его именем в элементе библиотеки.
- Базовые типы переменных в библиотеке переменных включают простые типы данных, такие как boolean, DateTime (в формате ISO 8601 UTC), GUID, целочисленное число, число и строка. Это простые значения, которые можно напрямую назначать и использовать в разных этапах и средах.
- Расширенные типы переменных предназначены для более сложных вариантов использования, таких как ссылка на внутренние элементы Fabric или внешние подключения. К этим типам относятся «ссылки на элементы», которые хранят идентификаторы рабочей области и элементов, указывая на определённые элементы Fabric.
Поддерживаемые типы в библиотеках переменных
Переменные в библиотеке переменных имеют следующие поддерживаемые типы переменных
| TypeType | Категория | Description |
|---|---|---|
| Boolean | Базовый | Представляет значения истина/ложь. |
| Целое число | Базовый | Целые числа без десятичных разрядов. |
| Number | Базовый | Числовые значения, включая десятичные значения. |
| String | Базовый | Текстовые значения или последовательности символов. |
| DateTime | Базовый | Дата и время, представленные в формате ISO 8601 standard yy-MM-ddTHH:mm:ss.xxxZ, где: Гггг-ММ-дд является четырехзначным годом, за которым следует двухзначный месяц и двухзначный день. T разделяет дату и время. HH:mm:ss.xxx — это двухзначный час в формате 24-часового формата, за которым следует двухзначная минута, двухзначная секунда и три цифры миллисекунда. Z указывает, что время находится в формате UTC. |
| Гид | Базовый | Глобальный уникальный идентификатор, используемый для идентификации отдельных объектов. |
| Справочник по элементам | Advanced | Используется в библиотеке переменных Fabric для хранения ссылки на существующий элемент Fabric, например lakehouse, записная книжка или конвейер данных, сохраняя идентификатор рабочей области и идентификатор элемента. |
| Справочник по подключению | Advanced | Переменная рабочей области, которая хранит идентификатор подключения к внешним данным (например, Snowflake, Azure SQL), позволяя элементам ссылаться на внешние ресурсы без внедрения учетных данных или строк подключения. |
Свойства переменной
Каждая переменная в библиотеке переменных имеет следующие свойства:
| Недвижимость | Description |
|---|---|
| Имя | Уникальный идентификатор переменной. Используется для ссылки на переменную в скриптах или рабочих процессах. |
| Примечание (необязательно) | Описательный комментарий или заметка о переменной. Может включать контекст, заметки об использовании или специальные инструкции. Максимальная длина: 2 048 символов. |
| Тип | Определяет тип данных переменной (например, string, integer, boolean, array). Определяет, как интерпретируется и проверяется значение. |
| Набор значений по умолчанию | Начальное значение, назначенное переменной, если другое значение не указано. Обеспечивает согласованное поведение в рабочих процессах. Не удается переименовать набор значений по умолчанию. |
| Альтернативные наборы значений (необязательно) | Дополнительные предопределенные наборы значений, которые могут применяться в определенных условиях или сценариях. Полезно для конфигураций конкретной среды или резервных параметров. |
Соглашения об именах
Имя переменной
Имя переменной в библиотеке переменных должно соответствовать следующим соглашениям:
- Не пуст
- Не содержит начальных или конечных пробелов
- Начинается с буквы или подчеркивания
- Может включать буквы, цифры, символы подчеркивания и дефисы
- Длина не превышает 256 символов
Имя переменной не чувствительно к регистру.
После того как переменная имеет определенное значение, при попытке изменить его тип появится диалоговое окно согласия. В диалоговом окне отображается предупреждение о том, что все значения переменной будут сброшены и что это изменение может быть критическим изменением на стороне элемента потребителя.
Рекомендации и ограничения
Ограничения размера
До 1000 переменных и до 1000 наборов значений, если вы соответствуете обоим из этих требований:
- Общее количество ячеек в альтернативных наборах значений меньше 10 000.
- Размер элемента не превышает 1 МБ.
Эти требования проверяются при сохранении изменений.
Поле заметки может содержать до 2048 символов.
Поле описания набора значений может содержать до 2 048 символов.