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.
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-előfizetést szeretne hozzáadni egy Azure-függvény használatával, 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 az Event Hubs 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.
Következő lépések
A támogatott eseménykezelők listáját az Eseménykezelők című cikkben találja.