Znajdź odpowiedzi na często zadawane pytania dotyczące Fabric API dla GraphQL.
Co to jest GraphQL?
GraphQL to język zapytań dla interfejsów API, który umożliwia aplikacjom żądanie dokładnie potrzebnych danych. Najważniejsze korzyści to:
- System silnego typu — jasno opisuje dostępne dane
- Dokładne pobieranie danych — zmniejsza nadmierne pobieranie, zezwalając na określone żądania
- Zgodność z poprzednimi wersjami — ułatwia aktualizowanie interfejsu API bez przerywania istniejącego kodu
- Rich tooling — umożliwia korzystanie z szerokiego zestawu narzędzi deweloperskich
Jest to bardziej wydajny sposób na komunikację aplikacji z serwerami i bazami danych.
Co to jest interfejs API Microsoft Fabric dla języka GraphQL?
Microsoft Fabric API for GraphQL to usługa zarządzana, która umożliwia tworzenie interfejsu API GraphQL w ciągu kilku sekund.
Obsługiwane źródła danych:
- magazyny danych Microsoft Fabric
- Microsoft Fabric Lakehouses
- Odzrciedlone bazy danych Microsoft Fabric
- Microsoft Fabric bazy danych SQL
- bazy danych Azure SQL
Zapewnia ujednoliconą warstwę interfejsu API do wykonywania zapytań i modyfikacji danych z tych obsługiwanych źródeł danych.
Jakie operacje GraphQL są obsługiwane w Fabric API?
Obecnie obsługiwane są tylko zapytania GraphQL (odczyt) i mutacje (zapis). Źródła danych uwidocznione za pośrednictwem punktów końcowych usługi SQL Analytics są tylko do odczytu, dlatego obsługują tylko zapytania. W przypadku magazynów danych należy zdefiniować klucz podstawowy, aby mutacje zostały wygenerowane automatycznie.
Jak wyświetlać i edytować resolverów w Fabric API dla GraphQL?
Narzędzia rozpoznawania to składniki GraphQL, które zapewniają logikę biznesową w celu rozpoznawania pól w interfejsie API i wykonywania operacji na danych znajdujących się w źródłach danych.
Automatyczne generowanie: Sieć szkieletowa automatycznie generuje narzędzia rozpoznawania po dołączeniu nowego źródła danych lub wybraniu nowych obiektów, które mają być uwidocznione z istniejącego źródła danych.
Dostosowywanie: Obecnie nie można bezpośrednio dostosowywać resolverów. W przypadku niestandardowej logiki biznesowej w interfejsie API dla języka GraphQL można utworzyć procedurę składowaną w źródle danych i uwidocznić ją w interfejsie API GraphQL.
Czy interfejs API dla aplikacji klienckiej GraphQL wymaga dostępu do źródła danych, aby wykonywać zapytania lub mutacje?
Microsoft Entra ID authentication: API for GraphQL wymaga, aby aplikacje używały Microsoft Entra ID do uwierzytelniania. Aplikacja kliencka musi być zarejestrowana i skonfigurowana do wykonywania wywołań interfejsu API względem sieci Szkieletowej.
Wymagane uprawnienia:
- Aplikacja zarejestrowana w witrynie Microsoft Entra wymaga posiadania uprawnień GraphQLApi.Execute.All dla usługi Power BI. Aby uzyskać więcej informacji, zobacz Tworzenie aplikacji Microsoft Entra w Azure.
Konfigurowanie logowania jednokrotnego (SSO): Jeśli interfejs API jest skonfigurowany do korzystania z logowania jednokrotnego, uwierzytelniony użytkownik lub jednostka usługi wymaga dostępu do obu:
- Interfejs GraphQL API (uprawnienie Uruchamianie zapytań oraz mutacji)
- Źródło danych (dostęp do odczytu lub zapisu zgodnie z potrzebami)
Opcja dostępu na poziomie obszaru roboczego: Alternatywnie, przypisz użytkownika lub jednostkę usługi jako członka obszaru roboczego z rolą kontrybutora, gdzie znajdują się zarówno elementy interfejsu API, jak i źródła danych. To zapewnia wymagany dostęp do obu elementów z jednego miejsca. Aby uzyskać więcej informacji, zobacz Udostępnianie użytkownikom dostępu do obszarów roboczych.
Saved credentials configuration: Jeśli interfejs API jest skonfigurowany do używania zapisanych poświadczeń, uwierzytelniony użytkownik lub jednostka usługi musi mieć tylko dostęp do interfejsu API (wybierz opcję Uruchamianie zapytań i mutacji podczas dodawania bezpośrednich uprawnień dostępu do interfejsu API).
Przykłady: Przykład kompleksowego kodu można znaleźć w przykładzie zawierającym zarówno jednostki użytkownika, jak i jednostki usługi , na stronie Łączenie aplikacji.
Jak mogę założyć zgłoszenie do wsparcia technicznego dla API GraphQL?
Aby uzyskać pomoc od Microsoft Support w przypadku dowolnego problemu dotyczącego Fabric API for GraphQL, odwiedź naszą witrynę pomocy technicznej Fabric i wybierz opcję Data Engineering.
Czy interfejs API dla języka GraphQL obsługuje Private Link?
Interfejs API dla GraphQL obsługuje w tej chwili tylko Tenant Level Private Link.
Dlaczego moje żądanie działa źle za pierwszym razem, a następnie działa dobrze przy kolejnych żądaniach?
Istnieją dwa główne przyczyny tego zachowania "zimnego startu":
Rozgrzewka źródła danych:
- Pierwsze żądanie może potrwać dłużej, jeśli źródło danych musi zostać rozgrzane z zimnego stanu
- Nawet jeśli źródło danych nie jest zimne, pobieranie danych może nie być tak wydajne, gdy po raz pierwszy narzędzie GraphQL wystawia zapytanie, jeśli źródło danych nie ma niezbędnych danych załadowanych do pamięci
Inicjowanie punktu końcowego interfejsu API:
- Pierwsze żądanie do interfejsu API dla endpointu GraphQL może zająć więcej czasu, ponieważ system musi załadować twój schemat i konfigurację.
- Kolejne żądania są szybsze, ponieważ system jest już rozgrzany i gotowy do obsługi żądań
Więcej informacji można znaleźć w najlepszych rozwiązaniach dotyczących wydajności.
Jak mogę przekazać opinię lub sugestie dotyczące interfejsu API dla języka GraphQL?
Z zadowoleniem przyjmujemy Twoją opinię i sugestie! Możesz przekazać opinię za pośrednictwem Fabric Ideas. Nasz zespół aktywnie monitoruje opinie i sugestie przesłane za pośrednictwem tej platformy. Możesz również skontaktować się z nami za pośrednictwem Pomocy technicznej Microsoft Fabric w razie jakichkolwiek konkretnych zapytań lub problemów.