Microsoft Fabric Apps: что это такое и как их использовать
By Mirko Peters ·
Fabric Apps (предварительная версия) позволяет разработчикам создавать управляемые данными приложения на Microsoft Fabric с помощью TypeScript. В этом руководстве рассказано, что представляет собой эта функция, как включить её для администратора, как создать и развернуть приложение, как работают разрешения и каковы текущие ограничения.
Automatically translated with AI from the original post. Read the English original
Fabric Apps — это функция Microsoft Fabric, которая сейчас находится в предварительной версии и предназначена для создания приложений, управляемых данными. Разработчики описывают модели данных на TypeScript, а Fabric генерирует схему базы данных, API GraphQL, вход и хостинг. Функция ориентирована на разработчиков, а не на авторов отчетов, и она отделена от приложений Power BI.
Ключевые выводы
- Fabric Apps — это функция в предварительной версии, построенная на основе SDK Rayfin. Разработчики определяют модели данных на TypeScript, а Fabric создает базу данных, API GraphQL, аутентификацию и хостинг.
- Сначала администратор клиента должен включить Fabric Apps (предварительная версия) в разделе «Параметры клиента» на портале администрирования Fabric, для всей организации или для отдельных групп безопасности.
- Рабочей области нужно назначить емкость Fabric. Службы Fabric Apps расходуют из неё единицы емкости.
- После развертывания вход выполняется только через Fabric SSO с использованием Microsoft Entra ID. Электронная почта и пароль работают только для локальной разработки.
- Microsoft перечисляет ограничения, например отсутствие связей «многие ко многим», составных ключей, ALM и поддержки Private Link, поэтому проверьте их, прежде чем принимать архитектурное решение.
Что делает Fabric Apps
Microsoft Learn описывает Fabric Apps как построенные на SDK Rayfin. Вы добавляете декораторы к классам TypeScript, например @entity(), @text() или @uuid(). На основе этой модели Fabric создает:
- таблицы базы данных, где управляемым хранилищем выступает база данных SQL в Fabric
- конечную точку GraphQL по адресу
/api/graphqlна URL серверной части приложения - правила авторизации на уровне строк через декораторы
@role - методы клиента с строгой типизацией
- статический хостинг для клиентской части
При развертывании с помощью rayfin up Fabric создает дочерние элементы приложения: базу данных SQL в Fabric, Authentication и Static Content. У каждого приложения есть одна конечная точка серверной части вида https://<your-app>-app.rayfin.windows.net/ с путями /api/graphql для данных и /auth для аутентификации.
Среди других описанных возможностей — типизированные соединители к lakehouse, хранилищу, базе данных SQL в Fabric или семантической модели, а также типизированное файловое хранилище с политиками доступа.
Где это уместно
Microsoft называет следующие сценарии хорошо подходящими: быстрое прототипирование, внутренние инструменты и дашборды, исследование данных с помощью соединителей Fabric, а также приложения ИИ и агенты, которым нужно постоянное состояние. Возможно неудачными для этой функции названы приложения со сложными многошаговыми транзакциями или хранимыми процедурами, а также приложения, которым нужны собственные поставщики аутентификации.
Шаг 1: включите параметр клиента
Это задача администратора, и её нужно выполнить до того, как пользователи смогут создавать элемент.
- Войдите на портал администрирования Fabric.
- Откройте Параметры клиента.
- В разделе Fabric Apps (предварительная версия) переведите переключатель в положение Включено.
- Выберите всю организацию или конкретные группы безопасности.
- Нажмите Применить.
Изменения могут применяться в течение нескольких минут.
Шаг 2: подготовьте рабочую область
Для рабочей области должна быть назначена емкость Fabric. Выберите емкость при создании рабочей области. Чтобы создать приложение, вам нужны разрешения «Участник» или «Администратор» в этой рабочей области. Для локальной работы установите Node.js 20 или более позднюю версию.
Шаг 3. Создайте элемент приложения
- В левой навигации выберите Рабочие области и откройте свою рабочую область.
- Выберите Создать элемент, найдите App и выберите его.
- Введите имя и выберите Создать.
Затем портал покажет команду для загрузки проекта на локальный компьютер. Она выглядит так:
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
Шаг 4. Разработка и развертывание
Отредактируйте проект или работайте с GitHub Copilot, затем протестируйте его с бэкендом Fabric командой npm run dev. Развертывайте приложение командой npx rayfin up. Чтобы развернуть его в другой рабочей области, добавьте --workspace <workspacename>. Проверить бэкенд можно командой npx rayfin up status.
В примере комментария из раздела «Часто задаваемые вопросы» сказано, что развертывание только статического контента командой npx rayfin up staticapp deploy занимает от 30 до 60 секунд после первоначального развертывания. Но на прочитанных страницах не указано время для первого развертывания. Развертывание только статического контента не может создать начальное удаленное приложение, поэтому сначала один раз выполните npx rayfin up. Чтобы откатить изменения, переключитесь на предыдущий коммит git и снова выполните npx rayfin up.
Что вы видите в портале Fabric
После выполнения rayfin up элемент приложения отображает дочерние элементы, которые Fabric создал на основе конфигурации rayfin.yml:
- SQL-база данных в Fabric: управляемая база данных со схемой из ваших декораторов. В портале она доступна только для чтения, поэтому меняйте схему через код.
- Аутентификация: вход через Microsoft Entra ID, который обеспечивает Fabric. Просмотреть аутентифицированных пользователей можно в SQL-базе данных.
- Static Content: собранные ресурсы фронтенда, которые доступны по URL хостинга и обновляются при каждом развертывании. В обзоре указано, что статический хостинг может требовать доступа к элементу Fabric или разрешать анонимный доступ.
Аутентификация и разрешения
В Microsoft Learn перечислены вход через SSO Fabric для развернутых приложений и вход по электронной почте и паролю для локальной разработки. Вход по электронной почте и паролю после развертывания не работает, а для развертывания требуется включенная аутентификация Fabric.
Разрешения на элементы отделены от ролей в рабочей области:
| Разрешение | Что разрешает | |---|---| | Запуск и взаимодействие | Открывать и использовать приложение и вызывать его API бэкенда. По умолчанию это доступно всем участникам рабочей области. | | Редактирование (Write) | Развертывать, менять схему, обновлять настройки, управлять дочерними службами | | Повторный общий доступ | Предоставлять доступ другим пользователям. Требуется роль администратора в рабочей области. |
Администратор Fabric может временно запретить другим пользователям загружать приложение, при этом владелец по-прежнему может его открыть.
Часть ответственности за безопасность остается за вами. Microsoft рекомендует не хранить секреты в коде и ресурсах фронтенда, а также отмечает, что ваш код определяет, что и какие действия могут выполнять вошедшие пользователи.
Ограничения, которые стоит проверить в первую очередь
В FAQ перечислены следующие текущие ограничения:
- нет связей «многие ко многим» и составных первичных ключей (каждая сущность должна иметь одно поле UUID с именем
id) - нет пользовательских провайдеров аутентификации
- нет управления несколькими средами из коробки
- нет защиты исходящего доступа рабочей области
- нет приватных ссылок на уровне клиента или рабочей области
- нет управления жизненным циклом приложений (ALM)
count()недоступна в клиенте fluent GraphQL
Модели данных пишутся на TypeScript с использованием декораторов.
Типичные проблемы
Microsoft называет отсутствие сборки для продакшена наиболее частой причиной ошибок сборки, поэтому сначала выполните npm run build. При ошибках, связанных с емкостью или разрешениями, убедитесь, что в рабочей области есть емкость и что вы можете создавать или изменять элементы в ней. При ошибках схемы проверьте изменения, внесенные после последнего успешного развертывания. На странице устранения неполадок сказано, что источником истины является код приложения. Не меняйте удаленную схему через портал Fabric или инструменты SQL, так как удаление или изменение существующего столбца может нарушить работу приложения и его развертывание. Вносите изменения схемы в коде и применяйте их командой npx rayfin up db apply.
Связанное
Источники
- Обзор Fabric Apps (предварительная версия)
- Создание первого проекта Fabric Apps
- Часто задаваемые вопросы о Fabric Apps
- Устранение неполадок Fabric Apps
FAQ
Доступны ли Fabric Apps в общедоступной версии?
Нет. В документации Microsoft Learn Fabric Apps помечены как функция в предварительной версии, и сказано, что она пока доступна не во всех регионах. В страницах, на которые опирается эта статья, не указана дата общедоступности.
Кто может создать приложение Fabric?
По данным Microsoft Learn, нужны разрешения «Участник» или «Администратор» в рабочей области Fabric, которая имеет емкость Fabric, а администратор клиента должен включить параметр клиента Fabric Apps (предварительная версия). Для локальной разработки требуется Node.js 20 или более поздней версии.
Какие методы входа поддерживают развернутые приложения Fabric?
Microsoft Learn сообщает, что развернутые приложения используют исключительно Fabric SSO, то есть единый вход Microsoft Entra. Вход по электронной почте и паролю доступен только для локальной разработки, и развернуть приложение без включенной аутентификации нельзя.
Может ли приложение Fabric использовать существующую базу данных?
Нет. В часто задаваемых вопросах Microsoft Learn сказано, что Fabric Apps управляет схемой на основе ваших моделей TypeScript и не может подключаться к базе данных с заранее заданной схемой. Чтобы обратиться к существующему lakehouse, хранилищу или базе данных SQL в Fabric, нужно добавить соединитель.
Описывают ли страницы Microsoft ценообразование Fabric Apps?
Нет. В просмотренных страницах нет информации о ценах. В обзоре лишь сказано, что рабочей области нужна емкость Fabric и что службы Fabric Apps расходуют из неё единицы емкости, а в часто задаваемых вопросах указано, что производительность зависит от вашей емкости Fabric.