Függvény használata eseménykezelőként az Event Grid-eseményekhez
Az eseménykezelő az a hely, ahol az esemény el lesz küldve. A kezelő végrehajt egy műveletet az esemény feldolgozásához. Számos Azure-szolgáltatás automatikusan konfigurálva van az események kezelésére, és az Azure Functions is ezek közé tartozik. Az Azure Event Grid például az Azure Functionst korrupciógátló rétegként használhatja az események átalakítására vagy ellenőrzésére, mielőtt továbbítsa őket az alárendelt rendszerekbe.
Ha egy függvényt az Azure-ban szeretne eseménykezelőként használni, kövesse az alábbi módszerek egyikét:
- Event Grid-eseményindító használata. Adja meg az Azure-függvényt végponttípusként. Ezután adja meg a függvényalkalmazást és az eseményeket kezelő függvényt.
- HTTP-eseményindító használata. Adja meg a Web Hookot végponttípusként. Ezután adja meg az eseményeket kezelő függvény URL-címét.
Javasoljuk, hogy az első megközelítést (Event Grid-eseményindítót) használja, mivel a második megközelítéssel szemben az alábbi előnyökkel jár:
- Az Event Grid automatikusan ellenőrzi az Event Grid-eseményindítókat. Általános HTTP-eseményindítók esetén saját maga kell implementálnia az érvényesítési választ .
- Az Event Grid automatikusan módosítja az eseményeknek egy Event Grid-esemény által aktivált függvényhez való kézbesítésének sebességét az észlelt sebesség alapján, amelyen a függvény feldolgozhatja az eseményeket. Ez a sebességegyeztetési funkció elhárítja azokat a kézbesítési hibákat, amelyek abból erednek, hogy egy függvény nem tudja feldolgozni az eseményeket, mivel a függvény eseményfeldolgozási sebessége idővel változhat. A magas átviteli sebesség hatékonyságának javítása érdekében engedélyezze a kötegelést az esemény-előfizetésen. További információ: Kötegelés engedélyezése.
Feljegyzés
- Amikor egy Event Grid-esemény-esemény-esemény-előfizetést egy Azure-függvény használatával ad hozzá, az Event Grid lekéri a célfüggvény hozzáférési kulcsát az Event Grid szolgáltatásnév hitelesítő adataival. Az engedélyek akkor kapják meg az Event Gridet, ha regisztrálja az Event Grid-erőforrás-szolgáltatót az Azure-előfizetésében.
- Ha egy Microsoft Entra ID-alkalmazással védi az Azure-függvényt, a HTTP-eseményindítóval kell használnia az általános webhook-megközelítést. Az előfizetés hozzáadásakor használja az Azure-függvényvégpontot webhook URL-címként.
Oktatóanyagok
Cím | Leírás |
---|---|
Rövid útmutató: Események kezelése függvényekkel | Egyéni eseményt küld egy függvénynek feldolgozás céljából. |
Oktatóanyag: big data streamelése adattárházba | Amikor egy eseményközpont létrehoz egy Capture-fájlt, az Event Grid egy eseményt küld egy függvényalkalmazásnak. Az alkalmazás lekéri a Capture fájlt, és adatokat migrál egy adattárházba. |
Oktatóanyag: Azure Service Bus–Azure Event Grid-integrációs példák | Az Event Grid üzeneteket küld a Service Bus-témakörből egy függvényalkalmazásnak és egy logikai alkalmazásnak. |
REST-példa (PUT esetén)
{
"properties":
{
"destination":
{
"endpointType": "AzureFunction",
"properties":
{
"resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.Web/sites/<FUNCTION APP NAME>/functions/<FUNCTION NAME>",
"maxEventsPerBatch": 10,
"preferredBatchSizeInKilobytes": 64
}
},
"eventDeliverySchema": "EventGridSchema"
}
}
Kötegelés engedélyezése
A nagyobb átviteli sebesség érdekében engedélyezze a kötegelést az előfizetésen. Ha az Azure Portalt használja, az előfizetés létrehozásakor vagy a létrehozás után megadhatja a kötegenkénti maximális eseményeket és az előnyben részesített kötegméretet kilobájtban.
A kötegbeállításokat az Azure Portal, a PowerShell, a parancssori felület vagy a Resource Manager sablon használatával konfigurálhatja.
Azure Portal
Amikor előfizetést hoz létre a felhasználói felületen, az Esemény-előfizetés létrehozása lapon váltson a Speciális szolgáltatások lapra, és állítsa be a kötegenkénti max. események és az előnyben részesített kötegméret értékeit kilobájtban.
Ezeket az értékeket frissítheti egy meglévő előfizetéshez az Event Grid-témakör lap Szolgáltatások lapján.
Azure Resource Manager-sablon
Egy Azure Resource Manager-sablonban beállíthatja a maxEventsPerBatch és a preferredBatchSizeInKilobytes értéket. További információ: Microsoft.EventGrid eventSubscriptions template reference.
Azure CLI
A parancs használatával konfigurálhatja a az eventgrid event-subscription create
köteghez kapcsolódó beállításokat a következő paraméterekkel: --max-events-per-batch
vagy --preferred-batch-size-in-kilobytes
.
Azure PowerShell
A New-AzEventGridSubscription vagy az Update-AzEventGridSubscription parancsmaggal konfigurálhatja a köteghez kapcsolódó beállításokat a következő paraméterekkel: -MaxEventsPerBatch
vagy-PreferredBatchSizeInKiloBytes
.
Feljegyzés
Az Event Grid-eseményindító használatakor az Event Grid szolgáltatás lekéri a cél Azure-függvény ügyféltitkát, és arra használja, hogy eseményeket kézbesítsen az Azure-függvénynek. Ha egy Microsoft Entra-alkalmazással védi az Azure-függvényt, az általános webes kampó megközelítést kell alkalmaznia, és a HTTP-eseményindítót kell használnia.
Kapcsolódó tartalom
A támogatott eseménykezelők listáját az Eseménykezelők című cikkben találja.