Interfejs API sieci szkieletowej dla języka GraphQL — często zadawane pytania

Znajdź odpowiedzi na często zadawane pytania dotyczące interfejsu API sieci szkieletowej dla języka GraphQL.

Co to jest GraphQL?

GraphQL to język zapytań typu open source dla interfejsów API i środowisko uruchomieniowe do wypełniania tych zapytań przy użyciu istniejących danych. Narzędzie GraphQL udostępnia pełny i zrozumiały opis danych w interfejsie API z silnie typizowanym systemem, daje klientom możliwość zapytań o dokładnie to, czego potrzebują, i nic więcej, ułatwia rozwijanie interfejsów API w czasie i umożliwia zaawansowane narzędzia deweloperskie.

Co to jest interfejs API usługi Microsoft Fabric dla programu GraphQL?

Interfejs API usługi Microsoft Fabric dla języka GraphQL to usługa zarządzana, która umożliwia tworzenie interfejsu API GraphQL w ciągu kilku sekund w celu uzyskania dostępu do danych ze źródeł danych, takich jak magazyny danych usługi Microsoft Fabric, usługi Microsoft Fabric Lakehouses, dublowane bazy danych Microsoft Fabric, bazy danych Microsoft Fabric SQL Database i bazy danych Azure SQL Database. Zapewnia ujednoliconą warstwę interfejsu API do wykonywania zapytań i wyciszania danych z tych obsługiwanych źródeł danych. Interfejs API sieci szkieletowej dla języka GraphQL jest obecnie w wersji zapoznawczej.

Jakie operacje graphQL są obsługiwane w interfejsie API sieci szkieletowej dla języka GraphQL?

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ć narzędzia rozpoznawania nazw w interfejsie API sieci szkieletowej dla języka 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. 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. Obecnie nie można dostosować funkcji rozpoznawania nazw. 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 w celu wykonywania zapytań lub mutacji?

Interfejs API dla języka GraphQL wymaga, aby aplikacje używały usługi Microsoft Entra do uwierzytelniania. Aplikacja kliencka musi być zarejestrowana i skonfigurowana odpowiednio do wykonywania wywołań interfejsu API w usłudze Fabric. Aplikacja zarejestrowana w usłudze Microsoft Entra wymaga uprawnień Item.Execute.All dla usługa Power BI. Aby uzyskać więcej informacji, zobacz Tworzenie aplikacji Microsoft Entra na platformie Azure. Oprócz firmy Microsoft Entra, jeśli interfejs API jest skonfigurowany do korzystania z logowania jednokrotnego, uwierzytelniony użytkownik lub jednostka usługi w aplikacji wywołującej interfejs API GraphQL wymaga dostępu zarówno do interfejsu API GraphQL, jak i źródła danych. W szczególności uprawnienia Do uruchamiania zapytań i mutacji w interfejsie API GraphQL oraz dostęp do odczytu lub zapisu wymagany w wybranym źródle danych. Inną opcją jest posiadanie użytkownika lub jednostki usługi jako członka obszaru roboczego z rolą współautora, w której znajdują się zarówno elementy interfejsu API, jak i źródła danych, co zapewni wymagany dostęp do obu elementów z jednego miejsca. Aby uzyskać więcej informacji, zobacz Przyznawanie użytkownikom dostępu do obszarów roboczych. Alternatywnie, 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 uruchom zapytania i mutacje opcji podczas dodawania uprawnień dostępu bezpośredniego do interfejsu API). 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ę otworzyć bilet pomocy technicznej dla interfejsu API dla języka GraphQL?

Aby uzyskać pomoc od pomoc techniczna firmy Microsoft w przypadku dowolnego problemu związanego z interfejsem API sieci szkieletowej dla języka GraphQL, odwiedź witrynę pomocy technicznej sieci szkieletowej i wybierz opcję inżynierowie danych.

Które regiony nie są jeszcze obsługiwane przez interfejs API dla języka GraphQL?

Interfejs API dla języka GraphQL nie jest obecnie obsługiwany w regionie Zachodnie stany USA 3.