Alkalmazás létrehozása a DevOps és a GraphQL API használatával

Cikk
11/19/2024

A következőre vonatkozik:✅ SQL-adatbázis a Microsoft Fabricben

Az oktatóanyag ezen szakaszában a létrehozott eszközökkel fog létrehozni egy webalkalmazást, amely lehetővé teszi a felhasználó számára, hogy válasszon ki egy kimaradás által érintett régiót, majd tekintse meg a régió többi szállítóját, hogy figyelmeztetse a vállalatot az ellátási lánc esetleges további zavaraira. Létrehoz egy GraphQL-végpontot az adatokon keresztül, majd létrehoz egy ASP.NET alkalmazást, amely helyileg vagy felhőszolgáltatón telepíthető.

A szoftverfejlesztési projektek fejlesztői üzemeltetési (DevOps) feladatokat is magukban foglalnak, amelyek egyike a forrásvezérlés. Ezt a szakaszt úgy fogja kezdeni, hogy a létrehozott elemeket a forráskövetés alá helyezi.

Ez a cikk hasznos forgatókönyvek sorozatát mutatja be egy sql-adatbázison alapuló alkalmazás létrehozásához a Fabricben.

Előfeltételek

Végezze el az oktatóanyag összes korábbi lépését.
Engedélyezze a Git-integrációs bérlő beállításait.
Engedélyezze a GraphQL-hez készült API bérlői rendszergazdai beállítását .
Szervezet és projekt létrehozása a Microsoft Azure DevOpsban.

CI/CD a Fabricben az Azure DevOpsszal

Az oktatóanyag jelen részében megtudhatja, hogyan használhatja az SQL-adatbázist a Microsoft Fabricben az Azure DevOpsszal.

A Microsoft Fabric sql-adatbázisainak forrásvezérlési integrációja lehetővé teszi, hogy az SQL-felhasználók nyomon kövessék az adatbázis-objektumaik definícióit egy csapaton belül:

A csapat véglegesítheti az adatbázist a forrásvezérlőre, amely automatikusan kódmá alakítja az élő adatbázist a konfigurált forrásvezérlő adattárban (Azure DevOps).
A csapat frissítheti az adatbázis-objektumokat a forrásvezérlő tartalmából, amely ellenőrzi a kódot az Azure DevOpsban, mielőtt különbségi módosítást alkalmaz az adatbázisra.

Ha nem ismeri a Microsoft Fabric forráskód-vezérlését, az alábbi ajánlott erőforrást ajánljuk:

Oktatóanyag: Életciklus-kezelés a Fabricben

A forrásvezérlés használatának első lépései

Miután teljesítette ezeket az előfeltételeket, szinkronizálhatja a munkaterületet az Azure DevOpsszal. Ez lehetővé teszi, hogy a munkaterületen végrehajtott módosításokat véglegesítse az Azure DevOps-ágban, és frissítse a munkaterületet, amikor valaki új véglegesítéseket hoz létre az Azure DevOps-ágban.

Most az adatbázis egyik objektumát fogja szerkeszteni az Azure DevOps használatával, amely frissíti az adattárat és az adatbázis-objektumokat is. Az objektumokat közvetlenül az adattárban is szerkesztheti, vagy ott "leküldheti" őket, de ebben az esetben minden lépést végrehajthat az Azure DevOps-környezetben.

Az oktatóanyag Munkaterület nézetében győződjön meg arról, hogy a munkaterület forrásvezérlés alatt van, és az összes objektum szinkronizálva van.
A Munkaterület nézetben megjelenik a git ikon, a kijelölt ág, valamint egy üzenet arról, hogy a munkaterületet utoljára szinkronizálták a forrásvezérlővel. A dátum és az idő mellett megjelenik egy azonosító hivatkozás az Azure DevOps-környezet adott helyéhez. A folytatáshoz nyissa meg ezt a hivatkozást.
Ha szükséges, jelentkezzen be az Azure DevOps-környezetbe.
Az Azure DevOps-környezeten belül válassza ki a Fájlok elemet az Explorer panelen. Megjelennek az SQL-adatbázissal szinkronizált objektumok a Fabricben és az adattárban.
Bontsa ki a suppy_chain_analytics_database. SQLDatabase, majd dbo, táblák, majd Suppliers.sql objektum.

Figyelje meg a tábla T-SQL-definícióját az objektum tartalmában. Éles kódolási környezetben ez az objektum olyan fejlesztői eszközökkel módosulna, mint a Visual Studio vagy a Visual Studio Code. Az adatbázis-objektum definícióját mindenesetre a rendszer replikálja az adattárba, amelyet az adatbázis aktuális állapotából tükrözött. Az Azure DevOps-forrásvezérlővel végezze el az adatbázis-objektumok néhány módosítását a következő oktatóanyag lépéseiben.

Keresse meg az [Fax] oszlopdefiníciós sort, és válassza a Szerkesztés gombot. Módosítsa az oszlopdefiníciót a következőre [Fax] NVARCHAR (255) NULL,: .
Válassza a Véglegesítés gombot.
Töltse ki a megjelenő Véglegesítés üzenetmezőt, és válassza a Véglegesítés gombot. Próbáljon meg leíró lenni a forráskövetés minden változásáról, az Ön és a csapata javára.
A véglegesítés megírja a módosítást az adattárba.
Váltson vissza az SQL-adatbázisra a Fabric Portalon, majd válassza a Forrásvezérlő lehetőséget.
Egy frissítés van függőben. Éles környezetben ezeket a módosításokat fogja áttekinteni. Válassza az Összes frissítése gombot. A frissítés eltarthat egy ideig.
Válassza ki az SQL-adatbázist a Fabric névben. Nyisson meg egy új lekérdezési ablakot az SQL-adatbázisban.
Másolja és illessze be a következő T-SQL-kódot a tábla módosításainak élő megjelenítéséhez az adatbázisban:
```
SELECT * FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 'Suppliers';
```
Adja meg a következő T-SQL-kódot, amelyet a lekérdezés a táblához elnevezett Notes oszlop hozzáadásához Suppliers kérdez le. Jelölje ki a kódnak azt a szakaszát, és válassza a Futtatás gombot:
```
ALTER TABLE Suppliers ADD Notes NVARCHAR(MAX);
```
Most térjen vissza az oktatóanyag munkaterületére a Háló portálon.
Válassza a Forrásvezérlő gombot, és figyelje meg, hogy frissítés helyett a rendszer változáskérést jelenít meg. Jelölje be az objektum neve melletti jelölőnégyzetet, majd válassza a Véglegesítés gombot.
A rendszer véglegesíti a lekérdezésszerkesztőben végrehajtott módosításokat, ön pedig visszatérhet az Azure DevOps Portálra, és a Fájlok területre, a dbo Sémára, majd a Táblák és Suppliers objektumok területre lépve megtekintheti az új oszlopot. (Előfordulhat, hogy frissítenie kell a lapot a módosítás megtekintéséhez.)

Most már láthatta, hogyan használhatja az SQL-adatbázis objektumsémáit az Azure DevOps forrásvezérlőjéből. A Microsoft Fabric forrásvezérlésével kapcsolatos további információkért lásd az SQL-adatbázis forrásvezérlési integrációját a Microsoft Fabricben , és oktatóanyag: Életciklus-kezelés a Fabricben.

A GraphQL API beállítása és konfigurálása

Az adatbázis-alkalmazáshoz való csatlakozás gyakran magában foglalja az alkalmazás kódtárainak olyan készletét, amely az adatbázissal közvetlenül kommunikáló Táblázatos adatfolyam (TDS) protokollt használja.

A Microsoft Fabric tartalmaz egy GraphQL-felületet, amellyel nem csak adatbázisokkal, hanem több adatforrással is dolgozhat. Ezeket a forrásokat egy integrált adatnézethez is kombinálhatja. A GraphQL az API-k lekérdezési nyelve, amely lehetővé teszi, hogy pontosan a szükséges adatokat kérje le, így egyszerűbbé válik az API-k fejlesztése az idő függvényében, és hatékony fejlesztői eszközöket tesz lehetővé. Teljes körű és érthető leírást nyújt az API-ban lévő adatokról, így az ügyfelek pontosan azt kérdezhetik meg, amire szükségük van, és semmi többre. Ez a GraphQL-t használó alkalmazásokat gyorssá és stabilsá teszi, mivel a lekért adatokat nem a kiszolgálót, hanem azokat vezérli. A GraphQL-felület úgy képzelhető el, mintha egy adatforrásban lévő adatkészletet látnánk. Az adatokat lekérdezheti, és mutációk használatával módosíthatja az adatokat. A GraphQL-ről ebben a hivatkozásban talál további információt.

A GraphQL API-k létrehozását közvetlenül a Fabric SQL lekérdezésszerkesztőből kezdheti el. A Fabric az adatok alapján automatikusan létrehozza a GraphQL-sémát, és az alkalmazások percek alatt készen állnak a csatlakozásra.

API létrehozása a GraphQL-hez

Az alkalmazáshoz használni kívánt GraphQL API létrehozásához:

Nyissa meg az oktatóanyag adatbázis-portálját.
Válassza az Új gombot, és válassza a GraphQL API-t.
Írja be az elem nevének supplier_impact_gql szövegét, és válassza a Létrehozás lehetőséget.
Ekkor megjelenik az Adatok kiválasztása panel. Görgessen addig, amíg meg nem találja SupplyChain.vProductsBySuppliersaz oktatóanyag korábbi részében létrehozott nézetet. Válassza ki.
Válassza a Betöltés gombot.

A Lekérdezés1 panelen cserélje le az ott látható szöveget a következő GraphQL lekérdezési sztringre:

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

Válassza a Futtatás gombot a Lekérdezés1 ablakban. A GraphQL-lekérdezés eredményei JSON formátumban jelennek meg az Eredmények ablakban.
Válassza a Végpont másolása gombot a menüszalagon.
Válassza a Másolás gombot a Hivatkozás másolása panel megjelenésekor. Tárolja ezt a sztringet egy jegyzettömbben vagy más helyen, amelyet az oktatóanyaghoz használt mintaalkalmazásban kell használni. Például a következőképpen fog kinézni: https://api.fabric.microsoft.com/v1/workspaces/<work space id>/graphqlapis/<graph api id>/graphql

A GraphQL-hez készült API készen áll a kapcsolatok és kérések elfogadására. Az API-szerkesztővel graphQL-lekérdezéseket tesztelhet és prototípusokat készíthet, valamint a Sémakezelővel ellenőrizheti az API-ban közzétett adattípusokat és mezőket. További információ: GraphQL API létrehozása az SQL-adatbázisból a Fabric portálon.

Webalkalmazás létrehozása adatok lekérdezéséhez

Ebben az oktatóanyagban olyan adatbázist hozott létre, amely tárolja a Contoso értékesítéseit és termékeit, valamint beszállítókat adott hozzá és csatlakozott az entitásokhoz a Transact-SQL (T-SQL) használatával. Most azt szeretné, hogy a fejlesztők a T-SQL elsajátítása nélkül használhassák az adatokat, és lehetővé tegyék, hogy egyetlen felületen több Microsoft Fabric-összetevőt is lekérdezhessenek. Futtassa az alkalmazást helyileg egy saját üzemeltetésű .NET REST-felületen, amely hozzáfér az oktatóanyagban létrehozott GraphQL-végponthoz. Ezt az alkalmazást közvetlenül a Microsoft Azure-ban is üzembe helyezheti webalkalmazásként vagy egy másik, ön által választott webkiszolgálón.

Webalkalmazás létrehozása a GraphQL-hez készült Fabric API SQL-adatbázisával

Arra kérték, hogy hozzon létre egy alkalmazást, amely megjeleníti az összes érintett szállítót, ha egy hely ellátási lánc megszakad természeti katasztrófák vagy egyéb megszakítások miatt. Ez a kód bemutatja, hogyan hozhat létre egy ASP.NET alkalmazást, amely GraphQL-lekérdezéssel fér hozzá egy lekérdezéshez az oktatóanyag utolsó szakaszában létrehozott SQL In Fabric GraphQL-végponton.