Тип ссылочной переменной подключения (предварительная версия)

Эталонная переменная подключения — это переменная рабочей области, которая хранит идентификатор подключения к внешним данным (например, Snowflake, Azure SQL) и позволяет элементам ссылаться на внешние ресурсы без внедрения учетных данных или строк подключения.

Использование

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

  1. Вход в Microsoft Fabric
  2. Перейдите в рабочую область и библиотеку переменных
  3. В верхней части нажмите кнопку +Создать переменную
  4. Укажите имя переменной, выберите ссылку на подключение для типа, а затем щелкните ... , чтобы выбрать значение.

Снимок экрана: элементы, доступные для ссылки на подключение. 5. После выбора ссылка на подключение должна быть готова к использованию.

Снимок экрана ссылки на подключение.

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

Снимок экрана: всплывающее окно ссылки на подключение.

Принцип работы

Значение ссылочной переменной подключения — это статический указатель на объект подключения, определяемый его идентификатором подключения. Значение хранится в виде строки, соответствующей идентификатору целевого подключения. Рассмотрим пример.

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Этот идентификатор однозначно идентифицирует указанное соединение. Статическая ссылка не регулируется автоматически в различных окружениях развертывания. Для этого необходимо, чтобы целевое подключение существовало во время выбора и оставалось привязанным к этому конкретному подключению, если только не было изменено вручную.

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

  • Хранит предварительно определенный идентификатор подключения на уровне клиента.
  • Во время развертывания ссылки на подключения не привязываются автоматически. Их значения остаются фиксированными в разных средах.
  • Поддерживает CI/CD и автоматизацию через параметризацию внешних подключений для сред разработки, тестирования и продакшн.
  • Включает динамическую конфигурацию внешних связей (например, переключение источников данных или учетных данных для каждой среды).
  • Значения выбираются с помощью диалогового окна пользовательского интерфейса, а не свободного текста, обеспечивая возможность выбора только авторизованных подключений.
  • Для выбора доступны только подключения с разрешениями на чтение.

Представление в Git и API

Ссылка на подключение — это сложный тип переменной, значение которого хранит идентификатор подключения, а платформа идентифицирует и отображает метаданные. Нагрузка разработки включает:

  • name: displayName для переменной ссылки на подключение
  • примечание. Необязательно, можно использовать для описания или других заметок.
  • тип: "connectionReference" (расширенный тип)
  • значение: для каждого набора значений каждое значение сохраняет { connectionId: "<GUID/ID string>" }

Пример:


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

Разрешения, необходимые для создания и использования ссылок на подключения

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

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

Дополнительные сведения о разрешениях и проверке разрешений см. в разделе "Разрешения библиотеки переменных"

Поддерживаемые элементы

Ниже приведен список элементов, поддерживающих ссылочные переменные подключения:

Пример кода Python

В следующем примере кода показано, как использовать ссылку на подключение в скрипте Python.

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

Этот код выполняет следующие действия:

  • Разрешает переменную ссылки на подключение из библиотеки переменных Fabric
  • Извлекает объект метаданных подключения
  • Извлекает идентификатор подключения
  • Выводит идентификатор, чтобы его можно было использовать в вызовах кода или API.

Ограничения

Следующие ограничения применяются к ссылочным переменным подключения:

  • Встроенные подключения в записных книжках не поддерживаются, так как connection_id для подключения к записной книжке не совпадают.

Связанный контент

  • Last updated on