Kluczowe pojęcia i funkcje

Zestaw narzędzi do rozszerzania przedstawia zestaw funkcji zaprojektowanych w celu jak najprostszego przenoszenia aplikacji danych do sieci szkieletowej. Te funkcje umożliwiają deweloperom tworzenie zaawansowanych, zintegrowanych środowisk przy minimalnym nakładzie pracy. Dzięki narzędziu Extensibility Toolkit można łatwo uzyskiwać dostęp do interfejsów API Fabric bezpośrednio z frontendu, utrwalać definicję elementu (stan) w ramach Fabric, korzystać ze standardowego przepływu tworzenia elementów oraz czerpać korzyści z ulepszonych zabezpieczeń i interoperacyjności za pomocą rozluźnienia ograniczeń iFrame i obsługi publicznego interfejsu API. Ponadto usprawnia cykl życia oprogramowania dzięki wbudowanej obsłudze CI/CD, co ułatwia automatyzację wdrażania i testowania. Poniższe sekcje zawierają omówienie głównych funkcji i wskazówek dotyczących sposobu dołączania ich do obciążeń.

Standardowe środowisko tworzenia elementów

Tworzenie elementu jest ustandaryzowane za pomocą dedykowanej kontrolki Fabric, która prowadzi użytkowników przez proces. Ta kontrolka umożliwia użytkownikom wybieranie obszaru roboczego, w którym jest tworzony element, przypisywanie etykiet poufności i konfigurowanie innych odpowiednich ustawień. Korzystając z tego ustandaryzowanego środowiska, nie musisz już obsługiwać złożoności tworzenia elementów samodzielnie ani martwić się o przyszłe zmiany w procesie. Ponadto takie podejście umożliwia tworzenie elementów bezpośrednio na stronie roboczej, zapewniając bezproblemowe i zintegrowane doświadczenie użytkownika.

Skorzystaj z przewodnika How to create an Item (Jak utworzyć element ), aby dowiedzieć się, jak można go zaimplementować.

Wsparcie dla frontendowego interfejsu API

Za pomocą zestawu narzędzi rozszerzalności można uzyskać token Microsoft Entra On-Behalf-Of (OBO) bezpośrednio w aplikacji frontendowej, umożliwiając bezpieczny dostęp do dowolnego chronionego interfejsu API Entra. Ta funkcja umożliwia głęboką integrację z usługami Microsoft Fabric — na przykład możesz odczytywać i przechowywać dane w usłudze OneLake, tworzyć i wchodzić w interakcje z innymi elementami sieci szkieletowej lub używać platformy Spark jako aparatu przetwarzania za pośrednictwem interfejsów API livey. Aby uzyskać więcej informacji, zobacz dokumentację usługi Microsoft Entra, dokumentację usługi OneLake, interfejsy API REST usługi Fabric i platformę Spark w usłudze Fabric.

Skorzystaj z przewodnika Jak uzyskać token entra firmy Microsoft, aby dowiedzieć się, jak można go zaimplementować. Skorzystaj również z przewodnika How to access Fabric APIs (Jak uzyskać dostęp do interfejsów API sieci szkieletowej), aby dowiedzieć się, jak można wchodzić w interakcje z siecią szkieletową.

Przechowywanie definicji elementu w Fabric

Ta funkcja umożliwia przechowywanie metadanych elementu — takich jak konfiguracja elementu i inne istotne informacje — bezpośrednio w usłudze OneLake w ukrytym folderze, który nie jest widoczny dla użytkowników końcowych. Dane są przechowywane przy użyciu tego samego formatu stosowanego przez publiczne API i procesy CI/CD, co zapewnia spójność i interoperacyjność w różnych punktach integracji. Szczegółowe informacje o formacie i jego użyciu z publicznymi interfejsami API i ciągłą integrację/ciągłe wdrażanie omówiono w poniższych sekcjach.

Użyj definicji jak przechowywać element, aby dowiedzieć się, jak można ją zaimplementować.

Co należy przechowywać w definicji

Pomyśl o stanie jako coś, co zawiera wszystkie informacje potrzebne do przywrócenia elementu, jeśli zostanie on usunięty lub skopiowany gdzie indziej. Nie obejmuje to danych przechowywanych w usłudze OneLake (zobacz Przechowywanie danych elementów w usłudze OneLake).

Oto kilka praktycznych przykładów:

• Element notatnika: stan zapisuje kod notatnika, kolejność komórek i metadane, takie jak silnik wykonawczy (np. Spark, SQL). Rzeczywiste dane przetwarzane przez notatnik nie są przechowywane w stanie.
• Element edytora plików: stan nie przechowuje samej zawartości pliku, ale zamiast tego przechowuje konfigurację edytora — na przykład schemat kolorów, ustawienia automatycznego uzupełniania, rozmiar czcionki i inne preferencje użytkownika.
• Instalator lub element orkiestratora: jeśli element instaluje lub dostarcza inne składniki (takie jak bazy danych lub zasoby komputerowe), stan powinien zawierać odwołania (ID, URI) do utworzonych elementów. To umożliwia Twojemu zadaniu sprawdzanie ich stanu lub zarządzanie nimi później.

Koncentrując się na konfiguracji, metadanych i odwołaniach, upewnij się, że stan elementu jest przenośny, lekki i łatwy do przywrócenia lub migracji.

Przechowywanie danych elementów w usłudze OneLake

Każdy element jest dostarczany z własnym folderem elementów Onelake, w którym deweloperzy mogą przechowywać dane ustrukturyzowane, a także dane bez struktury. Podobnie jak w przypadku usługi Lakehouse element ma folder Table, w którym można przechowywać dane w formacie Delta lub Iceberg oraz folder Files, w którym można przechowywać dane bez struktury.

Aby dowiedzieć się, jak można zaimplementować dane w elemencie, skorzystaj z tematu Jak przechowywać dane w elemencie .

Dane skrótów

Ponieważ każdy element ma własny folder Onelake, mogą one również pracować ze skrótami. W obciążeniach publicznego interfejsu Shortcut API deweloperzy mogą tworzyć różne typy skrótów z ich elementów lub do ich elementów, aby uczestniczyć w zapewnieniu pojedynczej kopii przez OneLake.

Użyj metody tworzenia skrótów, aby dowiedzieć się, jak można ją zaimplementować.

Obsługa interfejsu API elementów CRUD

Użytkownicy mogą tworzyć, aktualizować i usuwać elementy z zawartością przy użyciu standardowych Fabric Item REST API. To automatyczne włączanie znacznie ułatwia integrację z elementami obciążenia roboczego w taki sam sposób jak z podstawowymi elementami Fabric, usprawniając współdziałanie i zmniejszając nakład pracy wymagany do tworzenia niezawodnych integracji.

Obsługa CI/CD

Uwaga / Notatka

Obecnie trwają prace nad obsługą CI/CD dla zestawu narzędzi Extensibility Toolkit. Opisane poniżej funkcje są planowane i mogą ulec zmianie przed wydaniem.

Obsługa CI/CD dla wszystkich elementów jest jedną z najwyższych wymagań klientów. Dzięki tej funkcji wszystkie elementy mogą uczestniczyć w CI/CD natychmiast, bez potrzeby implementowania jakiejkolwiek konkretnej logiki lub operacji. Oznacza to, że można zautomatyzować wdrażanie, testowanie i aktualizacje obciążeń przy użyciu standardowych usług Azure Pipelines i narzędzi. Format elementu oraz interfejsy API zostały zaprojektowane tak, aby były w pełni zgodne z procesami ciągłej integracji/ciągłego wdrażania, zapewniając spójne i niezawodne doświadczenie w różnych środowiskach. Aby uzyskać więcej informacji na temat integracji z CI/CD, zobacz dokumentację Fabric CICD.

API powiadomień CRUD elementów

Uwaga / Notatka

Obsługa interfejsu API powiadomień CRUD dla zestawu narzędzi Extensibility Toolkit jest obecnie opracowywana. Opisane poniżej funkcje są planowane i mogą ulec zmianie przed wydaniem.

Istnieją przypadki, w których obciążenie robocze musi uczestniczyć w operacjach CRUD na elementach. Ponieważ elementy są tworzone na platformie bezpośrednio za pomocą środowiska użytkownika, Publicznego API lub w ramach obciążeń CI/CD, właściciele tych obciążeń nie mają kontroli nad utworzeniem nowego elementu przez te punkty wejścia. Domyślnie elementy przechowują swój stan w usłudze Fabric i nie muszą otrzymywać informacji o zmianie elementu. Niemniej jednak istnieją pewne przypadki, w których obciążenia muszą uczestniczyć w przepływie CRUD. Dotyczy to głównie sytuacji, w których należy aprowizować lub skonfigurować infrastrukturę elementów (na przykład Bazy danych). W przypadku tych scenariuszy umożliwiamy partnerom zaimplementowanie interfejsu API powiadomień CRUD, który Fabric wywołuje na każde zdarzenie. W tym scenariuszu deweloper aplikacji musi upewnić się, że jego interfejs API jest osiągalny, ponieważ w przeciwnym razie operacje Fabric kończą się niepowodzeniem.

Harmonogram sieci szkieletowej

Uwaga / Notatka

Obsługa harmonogramu fabryki dla zestawu narzędzi Extensibility Toolkit jest obecnie opracowywana. Opisane poniżej funkcje są planowane i mogą ulec zmianie przed wydaniem.

Fabric obsługuje planowanie zadań dla obciążeń. Ta funkcja umożliwia deweloperom tworzenie obciążeń, które są powiadamiane, nawet jeśli użytkownik nie jest przed interfejsem użytkownika i wykonują zadanie, które należy wykonać (na przykład skopiować dane w Onelake). Partnerzy muszą zaimplementować interfejs API i skonfigurować swoje obciążenie, aby uczestniczyć w tej funkcji.

Relaksacja iFrame

Deweloperzy mogą zażądać większej liczby atrybutów elementu iFrame, aby umożliwić zaawansowane scenariusze, takie jak pobieranie plików lub otwieranie zewnętrznych witryn internetowych. Ta funkcja umożliwia obciążeniu monitowanie użytkowników o jawną zgodę przed wykonaniem akcji wymagających szerszych możliwości przeglądarki, takich jak inicjowanie pobierania lub łączenie użytkowników z zewnętrznymi interfejsami API przy użyciu ich bieżących poświadczeń sieci szkieletowej. Określając te wymagania w konfiguracji obciążenia, upewnij się, że użytkownicy są informowani i mogą udzielać niezbędnych uprawnień, umożliwiając bezproblemową integrację z systemami zewnętrznymi przy zachowaniu bezpieczeństwa i zaufania użytkowników.

Aby zrozumieć, jak można zrelaksować element iFrame, skorzystaj z Jak zrelaksować iFrame.

Uwaga / Notatka

Włączenie tej funkcji wymaga od użytkowników udzielenia dodatkowej zgody Microsoft Entra na rozszerzony zakres, poza standardowym zakresem Fabric wymaganym dla podstawowej funkcjonalności obciążeń.

Ograniczenia funkcji

Łącze prywatne

Wszystkie obciążenia są blokowane do użycia i programowania, jeśli usługa Private Link jest włączona na poziomie dzierżawy lub obszaru roboczego.