Függvény használata eseménykezelőként az Event Grid-eseményekhez

Cikk
10/18/2023

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.

Megjegyzé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: Feltöltött képek átméretezésének automatizálása az Event Grid használatával	A felhasználók képeket töltenek fel webalkalmazáson keresztül a tárfiókba. Egy tárolóblob létrehozásakor az Event Grid egy eseményt küld a függvényalkalmazásnak, amely átméretezi a feltöltött képet.
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.

Enable batching at the time of creating a subscription

Ezeket az értékeket frissítheti egy meglévő előfizetéshez az Event Grid-témakör lap Szolgáltatások lapján.

Enable batching after creation

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.