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 генерує схему бази даних, GraphQL API, вхід і хостинг. Функція призначена для розробників, а не для авторів звітів, і вона окрема від застосунків Power BI.
Головне
- Fabric Apps — це функція в попередньому перегляді, побудована на основі SDK Rayfin. Розробники визначають моделі даних на TypeScript, а Fabric генерує базу даних, GraphQL API, автентифікацію та хостинг.
- Спочатку адміністратор клієнта має увімкнути Fabric Apps (попередній перегляд) у розділі «Параметри клієнта» на порталі адміністрування Fabric — для всієї організації або для окремих груп безпеки.
- Для робочої області потрібно призначити ємність Fabric. Служби Fabric Apps споживають із неї одиниці ємності.
- Після розгортання вхід здійснюється через Fabric SSO за допомогою Microsoft Entra ID — і лише так. Електронна адреса та пароль працюють тільки для локальної розробки.
- Microsoft перелічує обмеження, зокрема відсутність зв'язків «багато-до-багатьох», складених ключів, ALM і підтримки приватного посилання, тож перевірте їх, перш ніж затверджувати дизайн.
Що робить 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, warehouse, SQL-бази даних у Fabric або семантичної моделі, а також типізоване сховище файлів із політиками доступу.
Де це доречно
Microsoft називає такі сценарії вдалими: швидке прототипування, внутрішні інструменти та панелі, дослідження даних із коннекторами Fabric, а також застосунки ШІ або агентів, яким потрібен збережений стан. Як можливо невдалі сценарії названо застосунки, яким потрібні складні багатокрокові транзакції чи збережені процедури, та застосунки, яким потрібні власні постачальники автентифікації.
Крок 1. Увімкніть параметр клієнта
Це завдання адміністратора, і його потрібно виконати до того, як користувачі зможуть створювати елемент.
- Увійдіть на портал адміністрування Fabric.
- Відкрийте Параметри клієнта.
- У розділі Fabric Apps (попередній перегляд) перемикач установіть у положення Увімкнено.
- Виберіть усю організацію або окремі групи безпеки.
- Натисніть Apply.
Зміни можуть поширюватися кілька хвилин.
Крок 2. Підготуйте робочу область
Робочий простір має мати призначену Fabric capacity. Виберіть ємність під час створення робочого простору. Щоб створити застосунок, потрібні дозволи Contributor або Admin у ньому. Для локальної роботи встановіть 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 або дозволяти анонімний доступ.
Автентифікація та дозволи
Learn описує SSO Fabric для розгорнутих застосунків і вхід за електронною поштою та паролем для локальної розробки. Вхід за електронною поштою та паролем після розгортання не працює, а для розгортання має бути увімкнено автентифікацію Fabric.
Дозволи на елементи відрізняються від ролей у робочому просторі:
| Дозвіл | Що дозволяє | |---|---| | Запуск і взаємодія | Відкривати й використовувати застосунок та викликати його API бекенду. За замовчуванням цей дозвіл мають усі учасники робочого простору. | | Редагування (Write) | Розгортати, змінювати схему, оновлювати параметри, керувати дочірніми службами | | Повторне надання доступу | Надавати доступ іншим. Потрібна роль адміністратора в робочому просторі. |
Адміністратор Fabric може тимчасово заблокувати іншим користувачам завантаження застосунку, тоді як власник і далі зможе його відкрити.
Частина безпеки залишається за вами. Microsoft радить не зберігати секрети в коді та ресурсах фронтенду, а також зазначає, що саме ваш код визначає, що і які дії можуть виконувати користувачі, які увійшли в систему.
Обмеження, які варто перевірити насамперед
У поширених запитаннях перелічено такі поточні обмеження:
- немає зв’язків «багато до багатьох» і складених первинних ключів (кожна сутність потребує одного поля UUID з назвою
id) - немає власних провайдерів автентифікації
- немає керування кількома середовищами «з коробки»
- немає захисту від вихідного доступу на рівні робочого простору
- немає приватних посилань на рівні клієнта або робочого простору
- немає управління життєвим циклом застосунку (ALM)
count()недоступна в fluent-клієнті GraphQL
Моделі даних пишуться мовою TypeScript з використанням декораторів.
Типові проблеми
Microsoft називає відсутню збірку для production найпоширенішою причиною помилок збірки, тож спершу виконайте 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, warehouse або SQL-бази даних у Fabric, додайте коннектор.
Чи пояснюють сторінки Microsoft ціноутворення для Fabric Apps?
Ні. У переглянутих сторінках немає жодної інформації про ціни. В огляді лише зазначено, що для робочої області потрібна ємність Fabric і що служби Fabric Apps споживають із неї одиниці ємності, а в поширених запитаннях сказано, що продуктивність залежить від вашої ємності Fabric.