M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Microsoft Fabric Apps: czym są i jak ich używać

By ·

Fabric Apps (wersja zapoznawcza) umożliwia deweloperom tworzenie aplikacji opartych na danych w usłudze Microsoft Fabric przy użyciu języka TypeScript. Ten przewodnik opisuje, czym jest ta funkcja, jak ją włączyć jako administrator, jak utworzyć i wdrożyć aplikację, jakie są uprawnienia oraz jakie obecnie obowiązują ograniczenia.

Automatically translated with AI from the original post. Read the English original

Fabric Apps to funkcja Microsoft Fabric, obecnie w wersji zapoznawczej, służąca do tworzenia aplikacji opartych na danych. Deweloperzy definiują modele danych w języku TypeScript, a Fabric generuje schemat bazy danych, interfejsy GraphQL API, logowanie i hosting. Funkcja jest przeznaczona dla deweloperów, a nie dla autorów raportów, i jest odrębna od aplikacji Power BI.

Najważniejsze wnioski

  • Fabric Apps to funkcja w wersji zapoznawczej, oparta na zestawie SDK Rayfin. Deweloperzy definiują modele danych w języku TypeScript, a Fabric generuje bazę danych, interfejs GraphQL API, uwierzytelnianie i hosting.
  • Administrator dzierżawy musi najpierw włączyć Fabric Apps (wersja zapoznawcza) w sekcji Ustawienia dzierżawy w centrum administracyjnym Fabric, dla całej organizacji lub wybranych grup zabezpieczeń.
  • Obszar roboczy wymaga przypisanej pojemności Fabric. Usługi Fabric Apps zużywają z niej jednostki pojemności.
  • Po wdrożeniu logowanie odbywa się wyłącznie przez Fabric SSO z użyciem usługi Microsoft Entra ID. Adres e-mail i hasło działają tylko w lokalnym programowaniu.
  • Microsoft wymienia ograniczenia, takie jak brak relacji wiele-do-wielu, brak kluczy złożonych, brak ALM i brak obsługi Private Link, dlatego sprawdź je, zanim zdecydujesz się na dany projekt.

Co robi Fabric Apps

Microsoft Learn opisuje Fabric Apps jako funkcję opartą na zestawie SDK Rayfin. Dekorujesz klasy TypeScript, na przykład za pomocą @entity(), @text() lub @uuid(). Na podstawie tego modelu Fabric tworzy:

  • tabele bazy danych, przy czym zarządzaną magazyną jest baza danych SQL w Fabric
  • punkt końcowy GraphQL pod adresem /api/graphql na adresie URL zaplecza aplikacji
  • reguły autoryzacji na poziomie wiersza za pomocą dekoratorów @role
  • metody klienta z bezpiecznym typowaniem
  • hosting statyczny dla warstwy frontend

Podczas wdrażania za pomocą polecenia rayfin up Fabric tworzy elementy podrzędne aplikacji: bazę danych SQL w Fabric, Uwierzytelnianie i Zawartość statyczną. Każda aplikacja ma jeden punkt końcowy zaplecza o postaci https://<your-app>-app.rayfin.windows.net/, z ścieżkami /api/graphql dla danych i /auth dla uwierzytelniania.

Inne udokumentowane możliwości obejmują typowane łączniki do lakehouse, magazynu danych, bazy danych SQL w Fabric lub modelu semantycznego oraz typowane przechowywanie plików z zasadami dostępu.

Do jakich zastosowań pasuje

Microsoft wskazuje następujące zastosowania jako dobre: szybkie prototypowanie, narzędzia wewnętrzne i pulpity, eksplorację danych za pomocą łączników Fabric oraz aplikacje AI lub agentowe wymagające trwałego stanu. Jako prawdopodobnie słabe dopasowanie wskazuje aplikacje wymagające złożonych wieloetapowych transakcji lub procedur składowanych oraz aplikacje wymagające niestandardowych dostawców uwierzytelniania.

Krok 1: włącz ustawienie dzierżawy

Jest to zadanie administratora, które musi zostać wykonane, zanim użytkownicy będą mogli utworzyć ten element.

  1. Zaloguj się do centrum administracyjnego Fabric.
  2. Otwórz Ustawienia dzierżawy.
  3. W sekcji Fabric Apps (wersja zapoznawcza) ustaw przełącznik na Włączone.
  4. Wybierz całą organizację lub określone grupy zabezpieczeń.
  5. Wybierz Zastosuj.

Zmiany mogą być widoczne po kilku minutach.

Krok 2: przygotuj obszar roboczy

Obszar roboczy musi mieć przypisaną pojemność Fabric. Wybierz pojemność podczas tworzenia obszaru roboczego. Aby utworzyć aplikację, potrzebujesz roli Współautor lub Administrator w tym obszarze roboczym. Do pracy lokalnej zainstaluj Node.js 20 lub nowszy.

Krok 3: Utwórz element aplikacji

  1. W lewym panelu nawigacji wybierz Obszary robocze i otwórz swój obszar roboczy.
  2. Wybierz Nowy element, wyszukaj App i wybierz ten element.
  3. Wpisz nazwę i wybierz Utwórz.

Portal wyświetli wtedy polecenie pobrania projektu na komputer lokalny. Ma ono następującą postać:

npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>

Krok 4: Tworzenie i wdrażanie

Edytuj projekt lub pracuj z GitHub Copilot, a następnie przetestuj go na zapleczu Fabric poleceniem npm run dev. Wdróż aplikację poleceniem npx rayfin up. Aby wdrożyć ją w innym obszarze roboczym, dodaj --workspace <workspacename>. Stan zaplecza sprawdzisz poleceniem npx rayfin up status.

Przykładowy komentarz w sekcji Często zadawane pytania mówi, że wdrożenie samej zawartości statycznej poleceniem npx rayfin up staticapp deploy trwa od 30 do 60 sekund po pierwszym wdrożeniu. Przeczytane przeze mnie strony nie podają czasu pierwszego wdrożenia. Wdrożenie tylko zawartości statycznej nie może utworzyć początkowej zdalnej aplikacji, dlatego najpierw uruchom raz polecenie npx rayfin up. Aby wycofać zmiany, przełącz się na wcześniejszy commit git i ponownie uruchom polecenie npx rayfin up.

Co widać w portalu Fabric

Po uruchomieniu polecenia rayfin up element aplikacji wyświetla elementy podrzędne, które usługa Fabric utworzyła na podstawie konfiguracji z pliku rayfin.yml:

  • Baza danych SQL w usłudze Fabric: zarządzana baza danych ze schematem z Twoich dekoratorów. W portalu jest tylko do odczytu, dlatego schemat zmieniaj w kodzie.
  • Uwierzytelnianie: logowanie pośredniczone przez Fabric za pośrednictwem Microsoft Entra ID. Uwierzytelnionych użytkowników możesz zobaczyć w bazie danych SQL.
  • Zawartość statyczna: zbudowane zasoby interfejsu, udostępniane z adresu hostingu i aktualizowane przy każdym wdrożeniu. Z przeglądu wynika, że hosting statyczny może wymagać dostępu do elementu Fabric lub zezwalać na dostęp anonimowy.

Uwierzytelnianie i uprawnienia

Dokumentacja Learn opisuje logowanie jednokrotne Fabric dla wdrożonych aplikacji oraz adres e-mail i hasło dla pracy lokalnej. Logowanie adresem e-mail i hasłem nie działa po wdrożeniu, a wdrożenie wymaga włączonego uwierzytelniania Fabric.

Uprawnienia do elementów są oddzielone od ról w obszarze roboczym:

| Uprawnienie | Umożliwia | |---|---| | Uruchamianie i interakcja | Otwieranie i używanie aplikacji oraz wywoływanie jej interfejsów API zaplecza. Domyślnie mają je wszyscy członkowie obszaru roboczego. | | Edycja (zapis) | Wdrażanie, zmienianie schematu, aktualizowanie ustawień, zarządzanie usługami podrzędnymi | | Udostępnij ponownie | Przyznawanie dostępu innym osobom. Wymaga roli administratora w obszarze roboczym. |

Administrator Fabric może tymczasowo zablokować innym użytkownikom ładowanie aplikacji, a jej właściciel nadal może ją otworzyć.

Część odpowiedzialności za bezpieczeństwo pozostaje po Twojej stronie. Microsoft zaleca, by sekrety nie znajdowały się w kodzie ani w zasobach interfejsu, a Twój kod decyduje o tym, co zalogowani użytkownicy widzą i co mogą robić.

Ograniczenia do sprawdzenia w pierwszej kolejności

Często zadawane pytania wymieniają następujące obecne ograniczenia:

  • brak relacji wiele-do-wielu i brak kluczy głównych składających się z wielu kolumn (każda encja wymaga jednego pola UUID o nazwie id)
  • brak niestandardowych dostawców uwierzytelniania
  • brak zarządzania wieloma środowiskami w standardzie
  • brak ochrony przed dostępem wychodzącym na poziomie obszaru roboczego
  • brak prywatnych linków na poziomie dzierżawy i obszaru roboczego
  • brak zarządzania cyklem życia aplikacji (ALM)
  • count() nie jest dostępne w klientcie fluent GraphQL

Modele danych pisze się w TypeScript, używając dekoratorów.

Typowe problemy

Microsoft wskazuje brakujący build produkcyjny jako najczęstową przyczynę błędów kompilacji, dlatego najpierw uruchom npm run build. W przypadku błędów pojemności lub uprawnień sprawdź, czy obszar roboczy ma pojemność oraz czy możesz tworzyć lub zmieniać elementy w tym obszarze. W przypadku błędów schematu przejrzyj zmiany od ostatniego udanego wdrożenia. Strona rozwiązywania problemów mówi, że źródłem prawdy jest kod aplikacji. Nie zmieniaj zdalnego schematu w portalu Fabric ani narzędziami SQL, ponieważ usunięcie lub zmiana istniejącej kolumny może zepsuć aplikację i jej wdrożenie. Wprowadzaj zmiany schematu w kodzie i stosuj je poleceniem npx rayfin up db apply.

Powiązane

Źródła

FAQ

Czy Fabric Apps jest ogólnie dostępne?

Nie. Microsoft Learn oznacza Fabric Apps jako funkcję w wersji zapoznawczej i informuje, że nie jest jeszcze dostępna we wszystkich regionach. Strony, na których oparto ten artykuł, nie podają daty ogólnej dostępności.

Kto może utworzyć aplikację Fabric?

Zgodnie z Microsoft Learn potrzebne są uprawnienia Współautora lub Administratora w obszarze roboczym Fabric, który ma przydzieloną pojemność Fabric, a administrator dzierżawy musi włączyć ustawienie dzierżawy Fabric Apps (wersja zapoznawcza). Do lokalnego programowania wymagany jest Node.js 20 lub nowszy.

Jakich metod logowania obsługują wdrożone aplikacje Fabric?

Microsoft Learn podaje, że wdrożone aplikacje korzystają wyłącznie z logowania jednokrotnego Fabric SSO, czyli z jednokrotnego logowania Microsoft Entra. Logowanie za pomocą adresu e-mail i hasła jest dostępne wyłącznie do lokalnego programowania, a nie da się wdrożyć aplikacji bez włączonego uwierzytelniania.

Czy aplikacja Fabric może korzystać z istniejącej bazy danych?

Nie. Według najczęściej zadawanych pytań Microsoft Learn Fabric Apps zarządza schematem na podstawie modeli TypeScript i nie może wskazywać bazy danych z predefiniowanym schematem. Aby połączyć się z istniejącym lakehouse, magazynem danych lub bazą danych SQL w Fabric, należy dodać łącznik.

Czy strony Microsoft wyjaśniają cennik Fabric Apps?

Nie. Przeczytane strony nie podają cen. Przegląd jedynie stwierdza, że obszar roboczy wymaga pojemności Fabric, a usługi Fabric Apps zużywają z niej jednostki pojemności. Z kolei sekcja najczęściej zadawanych pytań podaje, że wydajność zależy od pojemności Fabric.

Entities in this article

Tematy tego artykułu:

Microsoft Fabric Apps – Narzędzie analityczne i BI firmy Microsoft Microsoft Fabric – Narzędzie analityczne i BI firmy Microsoft Fabric capacity – Pojęcie Fabric tenant settings – Pojęcie

Related articles

Więcej artykułów (temat: Microsoft Fabric):

RSS