Azure Cosmos DB által aktivált függvény létrehozása

Megtudhatja, hogyan hozhat létre olyan függvényt az Azure Portalon, amely akkor aktiválódik, amikor adatokat adnak hozzá vagy módosítanak az Azure Cosmos DB-ben. További információ az Azure Cosmos DB-ről: Azure Cosmos DB: Kiszolgáló nélküli adatbázis-használat az Azure Functions szolgáltatással.

Feljegyzés

A portálon belüli szerkesztés csak JavaScript-, PowerShell- és C#-szkriptfüggvényekhez támogatott. A Python portálon belüli szerkesztése csak akkor támogatott, ha a Használat csomagban fut. Ha lehetséges, helyileg kell fejlesztenie a függvényeket.

Ha többet szeretne megtudni a függvénykód Azure Portalon történő szerkesztésének korlátozásairól, tekintse meg az Azure Portal fejlesztési korlátait.

Előfeltételek

Az oktatóanyag elvégzéséhez:

• Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Feljegyzés

Az Azure Cosmos DB-kötések csak az Azure Cosmos DB for NoSQL-hez használhatók. Az Azure Cosmos DB for Table támogatása a Table Storage-kötések használatával érhető el, kezdve az 5.x kiterjesztéssel. Az összes többi Azure Cosmos DB API esetében a függvényből kell elérnie az adatbázist az API statikus ügyfélalkalmazásával, beleértve a MongoDB-hez készült Azure Cosmos DB-t, a Cassandra-hoz készült Azure Cosmos DB-t és az Apache Gremlinhez készült Azure Cosmos DB-t.

Bejelentkezés az Azure-ba

Jelentkezzen be az Azure Portalra az Azure-fiókjával.

Azure Cosmos DB-fiók létrehozása

A trigger létrehozásához rendelkeznie kell egy SQL API-t használó Azure Cosmos DB-fiókkal.

1. Az Azure Portal menüjében vagy a Kezdőlapon válassza az Erőforrás létrehozása elemet.

2. Keresse meg az Azure Cosmos DB-t. Válassza az Azure Cosmos DB létrehozása lehetőséget.>

3. Az Azure Cosmos DB-fiók létrehozása lapon válassza a Létrehozás lehetőséget az Azure Cosmos DB for NoSQL szakaszban.

   Az Azure Cosmos DB számos API-t biztosít:

   • NoSQL, dokumentumadatokhoz
   • PostgreSQL
   • MongoDB, dokumentumadatokhoz
   • Apache Cassandra
   • Tábla
   • Apache Gremlin, gráfadatokhoz

   A NoSQL API-val kapcsolatos további információkért lásd : Üdvözli az Azure Cosmos DB.

4. Az Azure Cosmos DB-fiók létrehozása lapon adja meg az új Azure Cosmos DB-fiók alapbeállításait.

   Beállítás	Érték	Leírás
   Előfizetés	Előfizetés neve	Válassza ki az Azure Cosmos DB-fiókhoz használni kívánt Azure-előfizetést.
   Erőforráscsoport	Erőforráscsoport neve	Válasszon ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, majd adja meg az új erőforráscsoport egyedi nevét.
   Fiók neve	Egyedi név	Adjon meg egy nevet az Azure Cosmos DB-fiók azonosításához. A rendszer a documents.azure.com utótaggal egészíti ki a megadott nevet az URI létrehozásához, ezért válasszon egyedi nevet. A név csak kisbetűket, számokat és kötőjelet (-) tartalmazhat. 3–44 karakter hosszúságúnak kell lennie.
   Hely	A felhasználókhoz legközelebb eső régió	Válassza ki az Azure Cosmos DB-fiókot üzemeltetéséhez használni kívánt földrajzi helyet. Használja a felhasználókhoz legközelebb lévő helyet, hogy a lehető leggyorsabb hozzáférést biztosítsa az adatokhoz.
   Kapacitásmód	Kiosztott átviteli sebesség vagy kiszolgáló nélküli	A kiosztott átviteli sebesség kiválasztásával hozzon létre egy fiókot kiosztott átviteli módban. A Kiszolgáló nélküli lehetőséget választva kiszolgáló nélküli módban hozhat létre fiókot.
   Ingyenes Azure Cosmos DB-kedvezmény alkalmazása	Alkalmazás vagy nem alkalmazható	Az Ingyenes Azure Cosmos DB-szinttel az első 1000 RU/s és 25 GB tárterület ingyenesen elérhető egy fiókban. További információk az ingyenes szintről.
   A fiók teljes átviteli sebességének korlátozása	Kijelölve vagy nem	Korlátozza az ezen a fiókon kiosztható átviteli sebesség teljes mennyiségét. Ez a korlát megakadályozza a kiosztott átviteli sebességhez kapcsolódó váratlan díjakat. A fiók létrehozása után frissítheti vagy eltávolíthatja ezt a korlátot.

   Azure-előfizetésenként legfeljebb egy ingyenes szintű Azure Cosmos DB-fiókkal rendelkezhet, és a fiók létrehozásakor be kell jelentkeznie. Ha nem látja az ingyenes szint kedvezményének alkalmazását, az előfizetés egy másik fiókja már engedélyezve van az ingyenes szinttel.

   

   Feljegyzés

   A következő beállítások nem érhetők el, ha a Kiszolgáló nélküli lehetőséget választja kapacitás módként:

   • Ingyenes szintű kedvezmény alkalmazása
   • A fiók teljes átviteli sebességének korlátozása

5. A Globális terjesztés lapon konfigurálja az alábbi adatokat. A rövid útmutató alapértelmezett értékeit a következő módon hagyhatja meg:

   Beállítás	Érték	Leírás
   Georedundancia	Letiltás	Engedélyezze vagy tiltsa le a globális terjesztést a fiókjában, ha párosítja a régiót egy párrégióval. Később további régiókat is hozzáadhat a fiókjához.
   Többrégiós írások	Letiltás	A többrégiós írási képesség lehetővé teszi, hogy kihasználja az adatbázisok és tárolók kiosztott átviteli sebességét világszerte.
   Rendelkezésre állási zónák	Letiltás	A rendelkezésre állási zónák segítségével tovább javíthatja az alkalmazás rendelkezésre állását és rugalmasságát.

   Feljegyzés

   Az alábbi beállítások nem érhetők el, ha a Kiszolgáló nélküli lehetőséget választja kapacitás módként az előző Alapszintű beállítások lapon:

   • Georedundancia
   • Többrégiós írások

6. Igény szerint további részleteket is konfigurálhat az alábbi lapokban:

   • Hálózatkezelés. Virtuális hálózatról való hozzáférés konfigurálása.
   • Biztonsági mentési szabályzat. Konfiguráljon rendszeres vagy folyamatos biztonsági mentési szabályzatot.
   • Titkosítás. Használjon szolgáltatás által felügyelt vagy ügyfél által felügyelt kulcsot.
   • Címkék. A címkék olyan név/érték párok, amelyek segítségével kategóriákba sorolhatja az erőforrásokat, és ha ugyanazt a címkét több erőforrásra és erőforráscsoportra is alkalmazza, ezzel együtt jelenítheti meg és kezelheti azok összesített számlázási adatait.

7. Válassza az Áttekintés + létrehozás lehetőséget.

8. Ellenőrizze a fiók beállításait, majd válassza a Létrehozás lehetőséget. A fiók létrehozása néhány percet vesz igénybe. Várja meg, hogy a portálon megjelenjen Az üzembe helyezés befejeződött üzenet.

   

9. Válassza az Ugrás az erőforrásra lehetőséget, és lépjen az Azure Cosmos DB-fiók oldalára.

   

Függvényalkalmazás létrehozása az Azure-ban

1. Az Azure Portal menüjében vagy a Kezdőlapon válassza az Erőforrás létrehozása elemet.

2. Az Új lapon válassza a Számítási>függvényalkalmazás lehetőséget.

3. A Tárhely kiválasztása lehetőségnél válassza a Consumption Select (Felhasználás>kiválasztása) lehetőséget az alkalmazás alapértelmezett használatalapú csomagban való létrehozásához. Ebben a kiszolgáló nélküli üzemeltetési beállításban csak a függvények futtatásának idejéért kell fizetnie. A Prémium csomag dinamikus skálázást is kínál. Ha App Service-csomagot használ, foglalkoznia kell a függvényalkalmazás méretezésével.

4. Az Alapok lapon használja a függvényalkalmazás beállításait az alábbi táblázatban megadott módon:

   Beállítás	Ajánlott érték	Leírás
   Előfizetés	Az Ön előfizetése	Az előfizetés, amely alatt létrehozza az új függvényalkalmazást.
   Erőforráscsoport	myResourceGroup	Annak az új erőforráscsoportnak a neve, amelyben a függvényalkalmazást létrehozza. Létre kell hoznia egy új erőforráscsoportot, mert ismert korlátozások vonatkoznak az új függvényalkalmazások meglévő erőforráscsoportban való létrehozásakor.
   Függvényalkalmazás neve	Globálisan egyedi név	Az új függvényalkalmazást azonosító név. Az érvényes karakterek az a-z (kis- és nagybetűk megkülönböztetése nélkül) 0-9és az -.
   Futtatókörnyezeti verem	Elsődleges nyelv	Válasszon egy olyan futtatókörnyezetet, amely támogatja a kedvenc függvényprogramozási nyelvét. A portálon belüli szerkesztés csak JavaScript, PowerShell, Python, TypeScript és C# szkriptekhez érhető el. A C#-osztálytárat és a Java-függvényeket helyileg kell fejleszteni.
   Verzió	Verziószám	Válassza ki a telepített futtatókörnyezet verzióját.
   Régió	Előnyben részesített régió	Válasszon ki egy önhöz közeli régiót vagy a függvényei által elérhető egyéb szolgáltatásokat.
   Operációs rendszer	Windows	Az operációs rendszer előre ki van jelölve a futtatókörnyezeti verem kiválasztása alapján, de szükség esetén módosíthatja a beállítást. A portálon belüli szerkesztés csak Windows rendszeren támogatott.

5. Fogadja el az alapértelmezett beállításokat a többi lapon, beleértve az új tárfiók létrehozásának alapértelmezett viselkedését a Storage lapon, valamint egy új Application Insights-példányt a Figyelés lapon. Meglévő tárfiókot vagy alkalmazáspéldányt is használhat Elemzések.

6. Válassza a Véleményezés + létrehozás lehetőséget a választott alkalmazáskonfiguráció áttekintéséhez, majd válassza a Létrehozás lehetőséget a függvényalkalmazás kiépítéséhez és üzembe helyezéséhez.

7. Válassza az Értesítések ikont a portál jobb felső sarkában, és figyelje meg az üzembe helyezés sikeres üzenetét.

8. Az új függvényalkalmazás megtekintéséhez válassza az Erőforrás megnyitása lehetőséget. A Rögzítés az irányítópulton lehetőséget is választhatja. A rögzítés megkönnyíti a függvényalkalmazás-erőforráshoz való visszatérést az irányítópultról.

   

Ezután létrehozhat egy függvényt az új függvényalkalmazásban.

Azure Cosmos DB-eseményindító létrehozása

1. A függvényalkalmazásban válassza az Áttekintés, majd a +Létrehozás a Függvények területen lehetőséget.

2. A Sablon kiválasztása területen görgessen le, és válassza ki az Azure Cosmos DB-eseményindító sablont.

3. A Sablon részletei területen konfigurálja az új eseményindítót a táblázatban megadott beállításokkal, majd válassza a Létrehozás:

   Beállítás	Ajánlott érték	Leírás
   Új függvény	Fogadja el az alapértelmezett nevet	A függvény neve.
   Azure Cosmos DB-fiók kapcsolata	Az alapértelmezett új név elfogadása	Válassza az Új lehetőséget, a korábban létrehozott adatbázisfiókot , majd az OK gombot. Ez a művelet létrehoz egy alkalmazásbeállítást a fiókkapcsolathoz. Ezt a beállítást használja a kötés, hogy kapcsolódjon az adatbázishoz.
   Adatbázis neve	Tevékenységek	A figyelendő gyűjteményt tartalmazó adatbázis neve.
   Gyűjtemény neve	Elemek	A monitorozni kívánt gyűjtemény neve.
   Bérletek gyűjteményneve	leases	A bérletek tárolására használt gyűjtemény neve.
   Bérletgyűjtemény létrehozása, ha nem létezik	Igen	Ellenőrzi a bérletgyűjtemény meglétét, és automatikusan létrehozza azt.

   Az Azure a megadott értékek alapján hozza létre az Azure Cosmos DB által aktivált függvényt.

4. A sablonalapú függvénykód megjelenítéséhez válassza a Kód + Teszt lehetőséget.

   

   Ez a függvénysablon a naplókba írja a dokumentumok számát és az első dokumentumazonosítót.

Ezután csatlakozik az Azure Cosmos DB-fiókjához, és létrehozza a tárolót Items az Tasks adatbázisban.

Az Elemek tároló létrehozása

1. Nyissa meg az Azure Portal egy újabb példányát egy új böngészőlapon.

2. A portál bal oldali menüjében bontsa ki az ikonsort, gépelje be a cosmos szöveget a keresőmezőbe, és válassza az Azure Cosmos DB lehetőséget.

   

3. Válassza ki Azure Cosmos DB-fiókját, majd válassza azAdatkezelő lehetőséget.

4. Az SQL API-ben válassza a Feladatok adatbázist, és válassza az Új tároló lehetőséget.

   

5. A Tároló hozzáadása területen használja a rendszerkép alatti táblázatban látható beállításokat.

   

   Beállítás	Ajánlott érték	Leírás
   Adatbázis-azonosító	Tevékenységek	Az új adatbázis neve. A névnek meg kell egyeznie a függvénykötésben meghatározott névvel.
   Tároló azonosítója	Elemek	Az új tároló neve. A névnek meg kell egyeznie a függvénykötésben meghatározott névvel.
   Partíciókulcs	/kategória	Az egyes partíciók között az adatokat egyenletesen elosztó partíciókulcs. A megfelelő partíciókulcs kiválasztása fontos egy performansz tároló létrehozásához.
   Átviteli sebesség	400 kérelemegység	Használja az alapértelmezett értéket. Később lehetősége lesz növelni az átviteli sebességet a késés csökkentése érdekében.

6. Kattintson az OK gombra az Elemek tároló létrehozásához. A tároló létrehozása eltarthat egy rövid ideig.

Miután a függvénykötésben megadott tároló már létezik, tesztelheti a függvényt, ha elemeket ad hozzá ehhez az új tárolóhoz.

A függvény tesztelése

1. Bontsa ki az új Elemek tárolót az Adatkezelőben, válassza az Elemek lehetőséget, majd válassza az Új elem lehetőséget.

   

2. Cserélje le az új elem tartalmát a következő tartalomra, majd válassza a Mentés lehetőséget.

   {
       "id": "task1",
       "category": "general",
       "description": "some task"
   }
   

3. Váltson a böngészőben az első lapra, amely tartalmazza a függvényt a portálon. Bontsa ki a függvénynaplókat, és ellenőrizze, hogy az új dokumentum aktiválta-e a függvényt. Meggyőződhet arról, hogy a task1 dokumentumazonosító értéke a naplókba lett írva.

   

4. (Nem kötelező) Térjen vissza a dokumentumhoz, hajtson végre egy módosítást, majd kattintson a Frissítés elemre. Térjen vissza a függvénynaplókhoz és ellenőrizze, hogy a frissítés is aktiválta-e a függvényt.

Az erőforrások eltávolítása

Az ebben a gyűjteményben lévő többi rövid útmutató erre a rövid útmutatóra épül. Ha további rövid útmutatókkal, oktatóanyagokkal vagy az ebben a rövid útmutatóban létrehozott szolgáltatásokkal szeretne dolgozni, ne törölje az erőforrásokat.

Az erőforrások kifejezés az Azure-ban például függvényalkalmazásokra, függvényekre vagy tárfiókokra utal. Ezek erőforráscsoportokba vannak csoportosítva, és a csoport törlésével törölheti a csoport összes elemét.

A rövid útmutatók elvégzéséhez erőforrásokat hozott létre. Előfordulhat, hogy ezekért az erőforrásokért a fiók állapotától és a szolgáltatás díjszabásától függően kell fizetnie. Ha már nincs szüksége ezekre az erőforrásokra, a következőképpen törölheti őket:

1. Az Azure Portalon nyissa meg az Erőforráscsoport oldalt.

   Ha a függvényalkalmazás oldaláról szeretné elérni ezt a lapot, válassza az Áttekintés lapot, majd válassza az Erőforráscsoport alatti hivatkozást.

   

   Ha az irányítópultról szeretné elérni ezt a lapot, válassza az Erőforráscsoportok lehetőséget, majd válassza ki a cikkhez használt erőforráscsoportot.

2. Az Erőforráscsoport lapon tekintse át a belefoglalt erőforrások listáját, és ellenőrizze, hogy ezek-e törölni kívánt erőforrások.

3. Válassza az Erőforráscsoport törlése lehetőséget , és kövesse az utasításokat.

   A törlés eltarthat néhány percig. Amint a művelet befejeződött, néhány másodpercre egy értesítés jelenik meg. Az értesítést úgy is megtekintheti, ha kiválasztja a harang ikont az oldal tetején.

Következő lépések

Létrehozott egy függvényt, amely akkor fut, amikor dokumentum hozzáadása vagy módosítása történik az Azure Cosmos DB-ben. További információ az Azure Cosmos DB-eseményindítókról: Azure Cosmos DB – Azure Functions kötések.

Most, hogy létrehozta az első függvényt, adjunk hozzá egy kimeneti kötést ahhoz a függvényhez, amely üzenetet ír egy Storage-üzenetsorba.

Üzenetek hozzáadása az Azure Storage üzenetsorába függvények használatával