Fabric Apps — często zadawane pytania

Ten artykuł zawiera odpowiedzi na często zadawane pytania dotyczące aplikacji Microsoft Fabric.

General

Co to jest Fabric Apps?

Fabric Apps to platforma zaplecza, która ułatwia deweloperom języka TypeScript szybsze tworzenie i wdrażanie aplikacji opartych na danych. Modele danych są definiowane przy użyciu dekoratorów języka TypeScript, a aplikacje Fabric automatycznie generują interfejsy API GraphQL, schematy bazy danych i bezpieczne typy klientów.

Kto powinien używać aplikacji Fabric?

Fabric Apps to idealne rozwiązanie dla deweloperów tworzących:

  • Narzędzia wewnętrzne i pulpity nawigacyjne
  • Aplikacje do eksploracji i wizualizacji danych
  • Szybkie prototypy
  • Sztuczna inteligencja i aplikacje agentów, które wymagają stanu trwałego

Jakie bazy danych są obsługiwane?

Usługa Fabric Apps obsługuje SQL Server — ustawienie domyślne dla wdrożeń Fabric.

Czy mogę używać usługi Fabric Apps z istniejącymi bazami danych?

Nie. Fabric Apps zarządza schematem bazy danych na podstawie modeli danych TypeScript. Nie można wskazać istniejącej bazy danych z predefiniowanym schematem.

Rozwój

Jak zainstalować CLI?

Możesz zainstalować Rayfin CLI za pomocą npm. Ponieważ jest to pakiet npm, można go zaktualizować poleceniem npm update.

npm i @microsoft/rayfin-cli

Czy mogę używać aplikacji Fabric bez języka TypeScript?

Nie. Modele danych muszą być zdefiniowane przy użyciu dekoratorów języka TypeScript. Aplikacja frontonu może używać języka JavaScript, ale zaplecze wymaga języka TypeScript dla definicji modelu.

Jakie struktury frontonu są obsługiwane?

Fabric Apps współpracuje z dowolną strukturą frontonu, która może wysyłać żądania HTTP:

  • React
  • Vue
  • Angular
  • Svelte
  • Vanilla JavaScript/TypeScript

SDK klienta udostępnia interfejsy API bezpieczne pod względem typów dla wszystkich frameworków.

Authentication

Jakie metody uwierzytelniania są obsługiwane?

Środowisko Obsługiwane metody
Rozwój lokalny Microsoft Entra logowanie jednokrotne i adres e-mail/hasło
Wdrożone w Fabric Tylko SSO Microsoft Entra

Uwaga / Notatka

Uwierzytelnianie za pomocą poczty e-mail i hasła nie działa po wdrożeniu w Fabric. Nie można wdrożyć aplikacji w Fabric, chyba że włączono uwierzytelnianie.

Czy mogę używać niestandardowych dostawców uwierzytelniania?

Nie. aplikacja Fabric Apps obsługuje tylko logowanie jednokrotne Microsoft Entra i adres e-mail/hasło. Nie można zintegrować innych dostawców.

Deployment

Czy mogę wdrożyć aplikację bez włączonego uwierzytelniania?

Nie. Usługa Fabric wymaga włączenia uwierzytelniania usługi Fabric przed wdrożeniem aplikacji Fabric.

Czy mogę wdrożyć w wielu środowiskach (deweloperskich, przejściowych, produkcyjnych)?

Możesz ręcznie zarządzać oddzielnymi obszarami roboczymi Fabric i wdrażać je w różnych elementach.

Jak długo trwa wdrażanie?

Początkowe wdrożenie zwykle trwa od 2 do 5 minut. Kolejne wdrożenia z npx rayfin up staticapp deploy (tylko zawartość statyczna) zajmują od 30 do 60 sekund.

Czy mogę wycofać wdrożenie?

Ponownie wdróż poprzednią wersję, sprawdzając poprzednie zatwierdzenie git i uruchamiając polecenie npx rayfin up.

Jak debugować błędy wdrażania?

  • Błędy kompilacji — uruchom npm run build przed wdrożeniem. Najczęstszą przyczyną niepowodzenia wdrożenia jest brak buildu produkcyjnego. Po pomyślnym zakończeniu kompilacji uruchom polecenie npx rayfin up.
  • Błędy pojemności lub uprawnień — Sprawdź, czy do obszaru roboczego przypisano pojemność Fabric i czy masz uprawnienia do tworzenia lub modyfikowania elementów w obszarze roboczym.
  • Błędy schematu bazy danych — jeśli podczas stosowania schematu bazy danych wystąpi błąd, przejrzyj zmiany schematu wprowadzone od ostatniego pomyślnego wdrożenia i rozwiąż wszelkie konflikty.

Modele danych

Czy mogę używać złożonych kluczy podstawowych?

Nie. Każda jednostka musi używać jednego pola UUID o nazwie id jako klucza podstawowego.

Czy relacje wiele-do-wielu są obsługiwane?

Nie. Zamiast tego należy użyć jawnej encji łączącej z dwoma dekoratorami nawigacji @one().

Czy można pisać niestandardowe zapytania SQL?

Nie istnieje bezpośrednia obsługa zapytań SQL. Cały dostęp do danych przechodzi przez wygenerowane interfejsy API graphQL.

Wydajność i skalowalność

Jakie są limity wydajności?

Wydajność zależy od pojemności Fabric. Skontaktuj się z administratorem Fabric w celu uzyskania limitów specyficznych dla pojemności.

Czy mogę buforować wyniki zapytań?

Yes. Zaimplementuj buforowanie po stronie klienta w aplikacji frontendowej. Backend nie oferuje wbudowanego buforowania.

Jak zoptymalizować wydajność zapytań?

  • Wybieranie tylko potrzebnych pól
  • Używanie stronicowania dla dużych zestawów wyników
  • Uwzględnianie pól powiązanych jednostek w jednym zapytaniu zamiast wysyłania wielu żądań

Zabezpieczenia

Jak są zabezpieczone dane?

  • Uwierzytelnianie jest wymagane domyślnie (konfigurowalne dla jednostki)
  • Zasady zabezpieczeń na poziomie wiersza filtrują dane na podstawie oświadczeń JWT
  • Cała komunikacja korzysta z protokołu HTTPS we wdrożeniach Fabric

Ograniczenia

Jakie są bieżące ograniczenia?

  • count() nie jest dostępna w kliencie fluent GraphQL
  • Relacje wiele-do-wielu nie są obsługiwane
  • Złożone klucze podstawowe nie są obsługiwane
  • Niestandardowi dostawcy uwierzytelniania nie są obsługiwani
  • Zarządzanie wieloma środowiskami nie jest dostępne domyślnie

Aby uzyskać obejścia, zobacz Troubleshoot Fabric Apps.

Czy mogę wyeksportować moje dane?

Yes. Możesz również połączyć się bezpośrednio z bazą danych SQL, jeśli masz parametry połączenia.

Treści powiązane

  • Last updated on