Zdieľať cez

Vytvorenie aplikácie pomocou služieb DevOps a GraphQL API

Vzťahuje sa na:✅databáza SQL v službe Microsoft Fabric

V tejto časti kurzu použijete položky, ktoré ste vytvorili, na vytvorenie webovej aplikácie, ktorá umožňuje používateľovi vybrať oblasť ovplyvnenú výpadkom, a potom sa pozrieť na ďalších dodávateľov v danej oblasti, aby ste upozornili spoločnosť na akékoľvek ďalšie prerušenie dodávateľského reťazca. Vytvoríte koncový bod GraphQL na základe údajov a potom vytvoríte aplikáciu ASP.NET, ktorú môžete nasadiť lokálne alebo k poskytovateľovi cloudu.

Projekty vývoja softvéru zahŕňajú úlohy týkajúce sa developer operations (DevOps), pričom jedným z nich je ovládanie zdrojov. Túto časť začnete umiestnením položiek, ktoré ste vytvorili, do zdrojového ovládania.

Tento článok predstavuje sériu užitočných scenárov na vytvorenie aplikácie založenej na databáze SQL v službe Fabric.

Požiadavky

CI/CD v službe Fabric so službou Azure DevOps

V tejto časti kurzu sa naučíte pracovať s databázou SQL v službe Microsoft Fabric so službou Azure DevOps.

Databáza SQL v službe Microsoft Fabric má integráciu zdrojovej kontroly, čo umožňuje používateľom SQL sledovať definície ich databázových objektov v priebehu času a v rámci tímu:

  • Tím môže potvrdiť databázu do zdrojového ovládacieho prvku, ktorý dynamickú databázu automaticky konvertuje na kód v nakonfigurovanom odkladacom priestore správy zdrojov (Azure DevOps).

  • Tím môže aktualizovať objekty databázy z obsahu ovládacieho prvku zdroja, ktorý pred použitím diferenciálnej zmeny v databáze overí kód v službe Azure DevOps.

    Diagram slučky jednoduchého ovládacieho prvku zdroja.

Ak nepoznáte ovládací prvok zdrojového kódu v službe Microsoft Fabric, odporúča sa tento zdroj:

Začíname pracovať s ovládacím prvkom zdroja

Po splnení týchto predpokladov môžete ponechať pracovný priestor synchronizovaný so službou Azure DevOps. To vám umožňuje potvrdiť všetky zmeny, ktoré vykonáte v pracovnom priestore, do vetvy Azure DevOps a aktualizovať pracovný priestor vždy, keď niekto vytvorí nové záväzky v vetve Azure DevOps.

Teraz upravíte jeden z objektov v databáze pomocou služby Azure DevOps, ktorá aktualizuje odkladací priestor aj objekty databázy. Objekty môžete upravovať aj priamo v odkladacom priestore alebo ich tam "presúvať", ale v tomto prípade môžete vykonať všetky kroky v prostredí Azure DevOps.

  1. V zobrazení Pracovného priestoru kurzu sa uistite, že je váš pracovný priestor nastavený tak, aby bol pod kontrolou zdroja, a aby všetky objekty zobrazovali synchronizované.

  2. V zobrazení Pracovný priestor uvidíte ikonu git, vybratú vetvu a správu o poslednom synchronizovaní pracovného priestoru s ovládacím prvkom zdroja. Vedľa dátumu a času uvidíte prepojenie na identifikátor pre konkrétne umiestnenie v prostredí Azure DevOps. Otvorte prepojenie a pokračujte.

    Snímka obrazovky znázorňujúca prepojenie na umiestnenie prostredia Azure DevOps v pracovnom priestore.

  3. Ak sa o to požiada, prihláste sa do prostredia Azure DevOps.

  4. Keď sa nachádzate v prostredí Azure DevOps, vyberte položku Súbory na table prieskumníka. Zobrazia sa objekty synchronizované s vašou databázou SQL v službe Fabric a odkladacom priestore.

  5. Rozbaľte suppy_chain_analytics_database. SQLDatabase, potom dbo, potom Tables a potom Suppliers.sql objekt.

    Snímka obrazovky znázorňuje objekt databázy Dodávatelia v službe Azure DevOps.

Všimnite si definíciu T-SQL tabuľky v obsahu objektu. V produkčnom prostredí kódovania sa tento objekt zmení pomocou vývojárskych nástrojov, ako je napríklad Visual Studio alebo Visual Studio Code. V každom prípade sa definícia daného objektu databázy replikuje do odkladacieho priestoru, ktorý ste zrkadlili od aktuálneho stavu databázy. Použijeme zdrojový ovládací prvok Azure DevOps na vykonanie zmien objektov databázy v ďalších krokoch kurzu.

  1. Vyhľadajte riadok definície stĺpca [Fax] a vyberte tlačidlo Upraviť . Upravte definíciu stĺpca na .[Fax] NVARCHAR (255) NULL,

  2. Vyberte tlačidlo Potvrdiť.

    Snímka obrazovky znázorňuje úpravu definície stĺpca Fax v tabuľke Dodávatelia v rámci služby Azure DevOps.

  3. Vyplňte zobrazené pole Hlásenia potvrdenia a vyberte tlačidlo Potvrdiť. Skúste popisovať každú zmenu v ovládaní zdroja v prospech vášho aj tímu.

  4. Potvrdenie zapíše zmenu do odkladacieho priestoru.

  5. Vráťte sa naspäť do databázy SQL na portáli služby Fabric a vyberte položku Ovládací prvok zdroja.

  6. Čaká sa na jednu aktualizáciu. V produkčnom prostredí skontrolujete tieto zmeny. Vyberte tlačidlo Aktualizovať všetko. Aktualizácia môže trvať určitý čas.

  7. Vyberte databázu SQL v názve služby Fabric. Otvorte nové okno dotazu v databáze SQL.

  8. Skopírujte a prilepte nasledujúci kód T-SQL, aby sa zobrazili zmeny tabuľky naživo v databáze:

    SELECT * FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 'Suppliers';

  9. Zadajte nasledujúci kód T-SQL, ktorý dotazuje a pridá stĺpec s názvom Notes Suppliers do tabuľky. Zvýraznite iba tú časť kódu a vyberte tlačidlo Spustiť :

    ALTER TABLE Suppliers ADD Notes NVARCHAR(MAX);

  10. Teraz sa vráťte do pracovného priestoru kurzu na portáli služby Fabric.

  11. Vyberte tlačidlo Ovládací prvok zdroja a všimnite si, že systém okrem funkcie Update zobrazí požiadavku na zmenu. Začiarknite políčko vedľa názvu objektu a potom vyberte tlačidlo Potvrdiť .

  12. Systém potvrdí zmeny vykonané v editore dotazov. Môžete sa vrátiť na portál Azure DevOps Portal, prejsť do oblasti Súbory a dbo schémy, potom na tabuľky a Suppliers objekt, aby sa zobrazil nový stĺpec. (Možno bude potrebné obnoviť stranu, aby sa zmena zobrazila.)

    Snímka obrazovky znázorňuje tabuľku Dodávatelia s iným typom údajov na fax.

Teraz ste videli, ako môžete pracovať so schémami objektov databázy SQL z ovládacieho prvku zdroja v službe Azure DevOps. Ďalšie informácie o ovládanie zdrojov v službe Microsoft Fabric nájdete v téme Integrácia ovládacieho prvku zdroja databázy SQL v službe Microsoft Fabric a kurz: Spravovanie životného cyklu v službe Fabric.

Nastavenie a konfigurácia rozhrania API GraphQL

Pripojenie k databázovej aplikácii často zahŕňa inštaláciu množiny knižníc pre vašu aplikáciu, ktoré používajú protokol TDS (Tabular Data Stream), ktorý priamo interaguje s databázou.

Microsoft Fabric obsahuje rozhranie GraphQL na prácu nielen s databázami, ale s viacerými zdrojmi údajov. Môžete tiež kombinovať tieto zdroje pre integrované zobrazenie údajov. GraphQL je jazyk dotazov pre rozhrania API, ktorý umožňuje požadovať presne potrebné údaje, čo uľahčuje vývoj rozhraní API v priebehu času a povolenie výkonných vývojárskych nástrojov. Poskytuje úplný a zrozumiteľný popis údajov vo vašom rozhraní API a dáva klientom možnosť požiadať o presne to, čo potrebujú a nič viac. Vďaka tomu sú aplikácie, ktoré používajú GraphQL, rýchle a stabilné, pretože ovládajú údaje, ktoré získajú, a nie server. Rozhranie GraphQL si môžete predstaviť ako zobrazenie množiny údajov obsiahnutých v zdroji údajov. Údaje môžete dotazovať a meniť údaje pomocou mutácií. Ďalšie informácie o jazyku GraphQL nájdete v tomto odkaze.

Rozhranie GraphQL API môžete začať vytvárať priamo z editora dotazov sql služby Fabric. Fabric vytvorí schému GraphQL automaticky na základe vašich údajov a aplikácie sú pripravené na pripojenie v priebehu niekoľkých minút.

Vytvorenie rozhrania API pre GraphQL

Ak chcete vytvoriť rozhranie API pre GraphQL, ktoré budete používať pre aplikáciu:

  1. Otvorte databázový portál kurzu.

  2. Vyberte tlačidlo Nové a vyberte položku API pre GraphQL.

  3. Zadajte text supplier_impact_gql do poľa Názov položky a vyberte položku Vytvoriť.

  4. Zobrazí sa panel Vybrať údaje . Posúvajte sa, kým nenájdete SupplyChain.vProductsBySuppliers, zobrazenie, ktoré ste vytvorili predtým v tomto kurze. Vyberte ho.

    Snímka obrazovky znázorňujúca ukážku údajov choose of data in the view (Výber ukážky údajov v zobrazení).

  5. Vyberte tlačidlo Načítať.

  6. Na paneli Query1 nahraďte tam zobrazovaný text nasledujúcim reťazcom dotazu GraphQL:

    query { vProductsbySuppliers(filter: { SupplierLocationID: { eq: 7 } }) { items { CompanyName SupplierLocationID ProductCount } } }

  7. Vyberte tlačidlo Spustiť v okne Query1. Výsledky dotazu GraphQL sa vrátia do okna Výsledky vo formáte JSON.

    Snímka obrazovky znázorňujúca dotaz GraphQL a množinu výsledkov pre databázu SQL.

  8. Vyberte tlačidlo Kopírovať koncový bod na páse s nástrojmi.

  9. Keď sa zobrazí panel Kopírovať prepojenie, vyberte tlačidlo Kopírovať. Uložte tento reťazec do poznámkového bloku alebo do iného umiestnenia, ktoré sa má použiť v ukážkovej aplikácii pre tento kurz. Bude to napríklad vyzerať podobne ako: https://api.fabric.microsoft.com/v1/workspaces/<work space id>/graphqlapis/<graph api id>/graphql

Vaše rozhranie API pre GraphQL je teraz pripravené na prijímanie pripojení a požiadaviek. Editor rozhrania API môžete použiť na testovanie a prototyp dotazov GraphQL a prieskumníka schémy na overenie typov údajov a polí zverejnených v rozhraní API. Ďalšie informácie nájdete v téme Vytvorenie rozhrania GraphQL API z databázy SQL na portáli služby Fabric.

Vytvorenie webovej aplikácie na dotazovanie údajov

Doteraz ste v tomto kurze vytvorili databázu, ktorá uchováva predaj a produkty spoločnosti Contoso, a pridali dodávateľov a pripájali sa k entitám pomocou Transact-SQL (T-SQL). Teraz chcete umožniť vývojárom používať údaje bez toho, aby sa museli učiť o T-SQL, a tiež im umožniť dotazovanie viacerých súčastí služby Microsoft Fabric v jednom rozhraní. Túto aplikáciu spustite lokálne v samostatnom hostiteľskom rozhraní .NET REST, ktoré pristupuje ku koncovému bodu GraphQL, ktorý ste vytvorili v tomto kurze. Túto aplikáciu môžete nasadiť aj priamo do služby Microsoft Azure ako webovú aplikáciu alebo na iný webový server podľa vlastného výberu.

Vytvorenie webovej aplikácie pomocou databázy SQL v aplikácii Fabric API pre GraphQL

Boli ste požiadaní, aby ste vytvorili aplikáciu, ktorá bude zobrazovať všetkých ovplyvnených dodávateľov v prípade, že oblasť má prerušenie dodávateľského reťazca v dôsledku živelných pohromy alebo iných prerušení. Tento kód ukazuje, ako vytvoriť aplikáciu ASP.NET, ktorá používa dotaz GraphQL na prístup ku dotazu v koncovom bode SQL In Fabric GraphQL, ktorý ste vytvorili v poslednej časti kurzu.

  1. Nainštalujte príslušnú súpravu .NET SDK pre váš operačný systém.
  2. Otvorte prostriedok v tomto umiestnení a postupujte podľa všetkých krokov, ktoré tam vidíte.

Vzorové snímky obrazovky aplikácie z tohto kurzu:

Snímka obrazovky z webového prehliadača zobrazujúca ukážkovú aplikáciu na webových lokalitách Azure.

Snímka obrazovky z webového prehliadača zobrazujúca ukážku webovej lokality s grafomql, ktorá poskytuje výsledky dotazu, Počet produktov podľa dodávateľov.

Ďalší krok

Vyčistenie zdrojov

  • Last updated on