Udostępnij za pośrednictwem


Tworzenie interfejsu API dla języka GraphQL w sieci szkieletowej i dodawanie danych

Uwaga

Interfejs API usługi Microsoft Fabric dla języka GraphQL jest w wersji zapoznawczej.

Rozpocznij pracę z interfejsem API sieci szkieletowej dla języka GraphQL, tworząc interfejs API, a następnie łącząc źródło danych, aby uwidocznić dane wybrane za pośrednictwem interfejsu API. Sieć szkieletowa tworzy schemat GraphQL automatycznie na podstawie danych, a aplikacje są gotowe do nawiązania połączenia w ciągu kilku minut.

Wymagania wstępne

Tworzenie interfejsu API dla języka GraphQL

Aby utworzyć interfejs API dla języka GraphQL:

  1. W portalu sieci szkieletowej wybierz pozycję inżynierowie danych z przełącznika obciążenia w dolnej części paska nawigacyjnego. Jeśli jesteś w domu sieć szkieletowa, możesz również wybrać kartę inżynierowie danych ing.

    Zrzut ekranu przedstawiający opcję inżynierowie danych w przełączniku obciążenia.

  2. Wybierz pozycję INTERFEJS API dla programu GraphQL (wersja zapoznawcza).

    Zrzut ekranu przedstawiający kafelek interfejsu API, który wybierzesz, aby utworzyć nowy element interfejsu API.

    Alternatywnie wybierz pozycję Nowy>interfejs API dla programu GraphQL (wersja zapoznawcza) z dowolnego obszaru roboczego w inżynierowie danych.

    Zrzut ekranu przedstawiający pasek narzędzi obszaru roboczego pokazujący, gdzie wybrać opcję Nowy.

  3. Wprowadź nazwę elementu i wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający okno dialogowe New API for GraphQL (Nowy interfejs API dla języka GraphQL), w którym należy wprowadzić nazwę i wybrać pozycję Utwórz.

Masz teraz w pełni funkcjonalny interfejs API umożliwiający dostęp do danych w usłudze Fabric.

Połączenie do źródła danych i skompiluj schemat

Na tym etapie interfejs API jest gotowy, ale nie udostępnia żadnych danych. Interfejsy API dla języka GraphQL są definiowane w schemacie zorganizowanym pod względem typów i pól w silnie typizowanym systemie. Sieć szkieletowa automatycznie generuje wymagany schemat GraphQL na podstawie danych, które mają być widoczne dla klientów GraphQL.

  1. W nowym interfejsie API wybierz źródło danych do udostępnienia, wybierając pozycję Wybierz źródło danych.

    Zrzut ekranu przedstawiający opcję Wybierz źródło danych.

  2. Zostanie wyświetlone centrum danych OneLake; wybierz źródło danych, z którym chcesz nawiązać połączenie. W poniższym przykładzie wybieramy punkt końcowy analizy SQL AdventureWorks połączony z dublowaną bazą danych. Wybierz pozycję Filtr , aby wyświetlić tylko określone typy źródeł danych sieci szkieletowej lub wyszukaj według określonego słowa kluczowego. Gdy wszystko będzie gotowe, wybierz pozycję Połączenie.

    Zrzut ekranu przedstawiający centrum danych OneLake z dostępnymi opcjami źródła danych dla obszaru roboczego.

  3. Zostanie wyświetlony ekran Pobieranie danych , na którym można wybrać obiekty, które mają być uwidocznione w schemacie GraphQL.

    Zrzut ekranu Pobieranie danych przedstawiający listę Wybierz dane.

  4. Zaznacz pola wyboru obok poszczególnych tabel lub procedur składowanych, które chcesz uwidocznić w interfejsie API. Aby zaznaczyć wszystkie obiekty w folderze, zaznacz pole wyboru z nazwą źródła danych u góry.

    Zrzut ekranu przedstawiający listę Wybierz dane z wybranym folderem, który automatycznie wybiera wszystkie elementy w tym folderze.

  5. Wybierz pozycję Załaduj , aby rozpocząć proces generowania schematu GraphQL.

  6. Schemat jest generowany i można rozpocząć tworzenie prototypów zapytań GraphQL (odczyt, lista) lub mutacje (tworzenie, aktualizowanie, usuwanie) w celu interakcji z danymi.

    Zrzut ekranu przedstawiający ekran Eksplorator schematu.

Interfejs API dla języka GraphQL jest teraz gotowy do akceptowania połączeń i żądań. Edytor interfejsu API umożliwia testowanie i prototypowanie zapytań GraphQL oraz Eksplorator schematu w celu zweryfikowania typów danych i pól uwidocznionych w interfejsie API.