Co to jest Fabric Apps (wersja zapoznawcza)?

Fabric Apps (wersja zapoznawcza) ułatwia tworzenie aplikacji opartych na danych na Microsoft Fabric przez połączenie modeli danych, wygenerowanych interfejsów API, uwierzytelniania i hostingu w jednym przepływie pracy programowania. Modele danych definiuje się w języku TypeScript, a aplikacje Fabric używają ich do generowania elementów zaplecza potrzebnych aplikacji. Usługa Fabric Apps obsługuje język TypeScript jako język modeli danych, kodu klienta i logiki aplikacji.

Ważna

Ta funkcja jest dostępna w wersji zapoznawczej.

Kluczowe funkcje

Fabric Apps zapewnia następujące możliwości:

• Od modeli danych po interfejsy API – dekoruj klasy TypeScript za pomocą @entity(), @text(), @uuid() i innych dekoratorów. Fabric Apps automatycznie generuje schematy bazy danych i punkty końcowe GraphQL.
• Klienci z kontrolą typów – SDK klienta weryfikuje zapytania i mutacje, zanim trafią do backendu, wychwytując błędy już na etapie programowania.
• Wbudowane uwierzytelnianie — uwzględniane są zarządzanie sesjami, obsługa tokenów i przepływy uwierzytelniania. Skonfiguruj logowanie jednokrotne (SSO) w usłudze Fabric dla wdrożonych aplikacji lub użyj adresu e-mail i hasła podczas lokalnego programowania.
• Hosting statyczny — kompiluj i udostępniaj aplikację frontendową wraz z interfejsami API backendu za pomocą jednego polecenia wdrożenia.
• Lokalne środowisko programistyczne – Uruchom cały stos lokalnie za pomocą Dockera, aby szybko wprowadzać kolejne zmiany, a następnie wdroż go do Microsoft Fabric, gdy rozwiązanie będzie gotowe do wdrożenia produkcyjnego. Projekty szkieletowe, opracowywane za pomocą GitHub Copilot i wdrażane w Fabric przy użyciu interfejsu wiersza polecenia Rayfin.

Obsługiwane regiony

Fabric Apps nie są jeszcze dostępne we wszystkich regionach. Aby dowiedzieć się więcej, zobacz obsługiwane regiony dla aplikacji Fabric.

Wymagania wstępne

Pojemność sieci szkieletowej

Obszar roboczy musi mieć przypisaną pojemność Fabric. Podczas tworzenia nowego obszaru roboczego wybierz jednostkę pojemności Fabric, która ma zostać z nim skojarzona. Usługi Fabric Apps zużywają jednostki pojemności z przydzielonej pojemności.

Ustawienia administratora dzierżawy

Aby użytkownicy mogli tworzyć elementy, administrator dzierżawy usługi Fabric musi włączyć obciążenie robocze Fabric Apps.

1. Zaloguj się do portalu administracyjnego Fabric.
2. Przejdź do Ustawienia dzierżawy.
3. W obszarze Fabric Apps (wersja zapoznawcza) przełącz ustawienie na Enabled.
4. Wybierz, czy włączyć dla całej organizacji, czy określonych grup zabezpieczeń.
5. Wybierz i zastosuj.

Propagacja zmian może potrwać kilka minut.

Jak to działa

Aplikacja Fabric działa jako usługa zarządzana w Microsoft Fabric z zestawem usług, które definiują zaplecze, takie jak hostowanie aplikacji, baza danych, interfejsy API GraphQL i uwierzytelnianie. Fabric zarządza hostingiem, siecią i skalowaniem. Uwierzytelnianie odbywa się wyłącznie przy użyciu Fabric SSO (logowania jednokrotnego Microsoft Entra ID) — po wdrożeniu żadne inne dostawcy uwierzytelniania nie są dostępne.

Podczas wdrażania aplikacji przy użyciu rayfin up Fabric tworzy usługi podrzędne na podstawie konfiguracji rayfin.yml. Te usługi podrzędne są wyświetlane jako elementy podrzędne w aplikacji Fabric w portalu Fabric.

Usługa podrzędna	Co zapewnia	Możliwości portalu
Baza danych SQL w Fabric	Zarządzana baza danych SQL ze schematem utworzonym na podstawie dekoratorów modelu danych w TypeScript.	Wyświetlanie bazy danych, uruchamianie zapytań za pomocą edytora zapytań, kopiowanie parametry połączenia. Baza danych jest dostępna w portalu tylko do odczytu — zmiany schematu muszą być wprowadzane z poziomu kodu za pośrednictwem rayfin up.
Uwierzytelnianie	Uwierzytelnianie pośredniczone w usłudze Fabric za pomocą identyfikatora Microsoft Entra ID (SSO). Użytkownicy logują się przy użyciu istniejącej tożsamości Fabric.	Wyświetlanie uwierzytelnionych użytkowników w bazie danych SQL.
Zawartość statyczna	Zbudowane zasoby frontendu (HTML, CSS, JS) są udostępniane pod publicznym adresem URL z użyciem magazynu OneLake.	Wyświetl adres URL hostingu. Zasoby są aktualizowane w każdym wdrożeniu.

Adres URL zaplecza aplikacji

Każda aplikacja Fabric ma jeden punkt końcowy, który zapewnia dostęp do wszystkich usług:

https://<your-app>-app.rayfin.windows.net/

Punkt końcowy uwidacznia ścieżkę dla każdej usługi:

Ścieżka	Service
/api/graphql	Interfejs API danych (GraphQL) — używany przez RayfinClient do operacji odczytu i zapisu
/auth	Usługa uwierzytelniania
/storage	Przechowywanie plików

Zarządzanie w portalu Fabric

Po wdrożeniu możesz zarządzać aplikacją Fabric bezpośrednio w portalu Fabric.

Wyświetlanie właściwości elementu

Otwórz aplikację Fabric w portalu, aby zobaczyć:

• Adres URL zaplecza aplikacji — ten punkt końcowy jest używany dla wszystkich usług zaplecza używanych przez aplikację.
• Adres URL aplikacji — publiczny adres URL, w którym hostowana jest zawartość statyczna. Aby uzyskać dostęp do aplikacji, wymagane jest logowanie jednokrotne Fabric (SSO).

Zarządzaj elementami podrzędnymi

Wybierz aplikację Fabric, aby wyświetlić jej usługi podrzędne:

• SQL database in Fabric — otwiera element usługi Fabric SQL Database w celu wyświetlenia eksploratora obiektów. Zapytania odczytu można uruchamiać względem danych. Zmiany schematu należy zawsze wprowadzać w kodzie w rayfin/data folderze . Konflikty schematu mogą wystąpić, jeśli schemat zostanie zmieniony bezpośrednio w usłudze SQL Database i może przerwać działanie aplikacji.

Uprawnienia do elementu

Role obszaru roboczego nie zastępują uprawnień na poziomie elementu. Aby udostępnić aplikację innej osobie w organizacji, muszą mieć uprawnienia Do uruchamiania i interakcji (odczyt i wykonywanie), aby uruchomić aplikację i wywołać interfejsy API zaplecza.

Pozwolenie	Co to umożliwia
Uruchamianie i interakcja (ustawienie domyślne)	Otwórz i użyj wdrożonej aplikacji. Wszyscy członkowie obszaru roboczego domyślnie otrzymują ten poziom.
Edytuj (zapis)	Modyfikuj aplikację Fabric — wdrażaj kod za pomocą rayfin up, wprowadzaj zmiany schematu, aktualizuj ustawienia i zarządzaj usługami podrzędnymi.
Ponowne udostępnienie	Udziel innym użytkownikom dostępu do aplikacji Fabric. Wymaga roli administratora w obszarze roboczym.

Dowiedz się więcej o rolach obszaru roboczego.

Programowanie za pomocą interfejsu wiersza polecenia Rayfin

Szkielet interfejsu wiersza polecenia służy do tworzenia nowych projektów, uruchamiania lokalnej infrastruktury, synchronizowania zmian schematu i wdrażania w Fabric. Zainstaluj go za pomocą polecenia npm create @microsoft/rayfin@latest.

Kluczowe polecenia:

Polecenie	Purpose
npm create @microsoft/rayfin@latest	Utwórz nowy projekt na podstawie szablonu.
npx rayfin up	Wdróż projekt w Fabric.
npx rayfin up db apply	Zastosuj zmiany schematu bazy danych.

Pełny opis poleceń znajdziesz w sekcji Dokumentacja CLI.

Dekoratory modelu danych

Definiowanie modeli danych przy użyciu dekoratorów języka TypeScript:

import {
  entity,
  role,
  text,
  boolean,
  date,
  uuid,
} from '@microsoft/rayfin-core';

@entity()
@role('authenticated', '*', {
  policy: (claims, item) => claims.sub.eq(item.user_id),
})
export class Todo {
  @uuid() id!: string;
  @text({ min: 1, max: 100 }) title!: string;
  @boolean() isCompleted!: boolean;
  @date() createdAt!: Date;
  @date({ optional: true }) dueDate?: Date;
  @text() user_id!: string;
}

Fabric Apps analizuje te dekoratory i generuje:

• Definicje tabel bazy danych
• Punkty końcowe interfejsu API graphQL
• Reguły autoryzacji na poziomie wiersza
• Metody klienta bezpieczne typowo

Kiedy należy używać aplikacji Fabric

Fabric Apps jest idealnym rozwiązaniem dla:

• Szybkie tworzenie prototypów — przejdź od pomysłu do dynamicznego adresu URL w ciągu kilku minut ze wstępnie skonfigurowaną infrastrukturą.
• Narzędzia wewnętrzne i dashboardy – twórz interfejsy administracyjne z uwierzytelnianiem bez konieczności pisania szablonowego kodu backendowego.
• Eksploracja i wizualizacja danych – wysyłanie zapytań do danych Fabric za pomocą GraphQL i wyświetlanie ich w niestandardowych interfejsach frontendowych.
• Aplikacje AI i agentowe – Zapewniają ustrukturyzowane usługi backendowe dla agentów AI, które wymagają trwałego stanu.

Aplikacje Fabric mogą nie być odpowiednie dla:

• Aplikacje wymagające złożonych transakcji wieloetapowych lub procedur składowanych.
• Aplikacje wymagające niestandardowych dostawców uwierzytelniania poza Fabric SSO i uwierzytelnianiem za pomocą adresu e-mail i hasła.

Obowiązki dotyczące zabezpieczeń

Fabric zapewnia: Fabric logowanie jednokrotne (Microsoft Entra ID), zabezpieczenia na poziomie wierszy za pośrednictwem @role dekoratorów, HTTPS, PKCE oraz uprawnienia na poziomie obszaru roboczego i elementu.

Odpowiadasz za:

• Trzymanie sekretów, kluczy API i poufnych danych poza kodem, zasobami frontendowymi i repozytorium. Zawartość statyczna jest obsługiwana z publicznego adresu URL.
• To, co aplikacja udostępnia za pośrednictwem mechanizmu logowania jednokrotnego Fabric, decyduje o sposobie logowania, ponieważ Twój kod kontroluje, co uwierzytelnieni użytkownicy widzą i mogą robić.
• Przyznawanie współpracownikom tylko tych uprawnień, których potrzebują do wdrażania aplikacji lub zarządzania nią.
• Odpowiedzialność za prawa i zgodność danych, które aplikacja zbiera, przetwarza i przechowuje.

Następne kroki

• Utwórz swój pierwszy projekt Fabric Apps
• Definiowanie modeli danych za pomocą dekoratorów
• Wdróż do Microsoft Fabric
• Konfiguruj uwierzytelnianie