Sdílet prostřednictvím

Přehled funkcí Azure pro Azure Redis

  • Článek

Tento článek popisuje, jak používat Azure Managed Redis nebo Azure Cache for Redis s Azure Functions k vytváření optimalizovaných bezserverových architektur a architektur řízených událostmi.

Azure Functions poskytuje programovací model řízený událostmi, kde triggery a vazby jsou klíčové funkce. Pomocí Azure Functions můžete snadno vytvářet bezserverové aplikace řízené událostmi. Služby Azure Redis (Azure Managed Redis a Azure Cache for Redis) poskytují sadu stavebních bloků a osvědčených postupů pro vytváření distribuovaných aplikací, včetně mikroslužeb, správy stavu, pub/sub messaging a dalších.

Azure Redis se dá použít jako trigger pro Azure Functions, který umožňuje zahájit bezserverový pracovní postup. Tato funkce může být vysoce užitečná v architekturách dat, jako je mezipaměť za zápisem nebo jakákoli architektura založená na událostech.

Azure Redis a Azure Functions můžete integrovat a vytvářet funkce, které reagují na události z Azure Redis nebo externích systémů.

Akce Směr
Aktivace v dílčích zprávách redis pub Trigger
Aktivace v seznamech Redis Trigger
Aktivace streamů Redis Trigger
Čtení hodnoty uložené v mezipaměti Vstup
Zápis hodnot do mezipaměti Výstup

Rozsah dostupnosti pro triggery a vazby funkcí

Úroveň Azure Cache for Redis (Basic, Standard, Premium, Enterprise, Enterprise Flash) Azure Managed Redis (Optimalizováno pro paměť, Basic, Optimalizováno pro výpočty, Optimalizováno pro Flash)
Pub/Sub Ano Yes
Seznamy Ano Yes
Streamy Ano Yes
Vazby Ano Yes

Důležité

Triggery Redis se v současné době podporují jenom pro funkce spuštěné v plánu Elastic Premium nebo vyhrazeném plánu služby App Service.

Instalace rozšíření

Funkce běží v izolovaném pracovním procesu C#. Další informace najdete v průvodci spuštěním služby Azure Functions v jazyce C# v izolovaném pracovním procesu.

Přidejte rozšíření do projektu instalací tohoto balíčku NuGet.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Redis

Instalace sady

  1. Vytvořte projekt funkce Java. Můžete použít Maven: mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8

  2. Přidejte sadu rozšíření přidáním nebo nahrazením následujícího kódu v souboru host.json :

    {
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.11.*, 5.0.0)"
  }
}

    Upozorňující

    Rozšíření Redis je aktuálně dostupné jenom ve verzi Preview.

  3. Přidejte do pom.xml souboru vazby Java pro Redis:

    <dependency>
  <groupId>com.microsoft.azure.functions</groupId>
  <artifactId>azure-functions-java-library-redis</artifactId>
  <version>${azure.functions.java.library.redis.version}</version>
</dependency>

Přidejte sadu rozšíření přidáním nebo nahrazením následujícího kódu v souboru host.json :

  {
    "version": "2.0",
    "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
      "version": "[4.11.*, 5.0.0)"
  }
}

Upozorňující

Rozšíření Redis je aktuálně dostupné jenom ve verzi Preview.

Připojovací řetězec Redis

Triggery a vazby Azure Redis mají požadovanou vlastnost, která označuje nastavení aplikace nebo název kolekce obsahující informace o připojení k mezipaměti. Připojovací řetězec najdete v nabídce Přístupové klíče na portálu Azure Managed Redis nebo Azure Cache for Redis. Trigger nebo vazba Redis hledá proměnnou prostředí, která obsahuje připojovací řetězec s názvem předaným parametruConnection.

V místním vývoji je možné ho Connectiondefinovat pomocí souboru local.settings.json . Při nasazení do Azure je možné použít nastavení aplikace.

Při připojování k instanci mezipaměti pomocí funkce Azure můžete ve svých nasazeních použít tři typy připojení: připojovací řetězec, spravovanou identitu přiřazenou systémem a spravovanou identitu přiřazenou uživatelem.

Pro místní vývoj můžete také použít tajné kódy instančního objektu.

Důležité

Pro zajištění optimálního zabezpečení by vaše aplikace funkcí měla používat ID Microsoft Entra se spravovanými identitami k autorizaci požadavků v mezipaměti, pokud je to možné. Autorizace pomocí Microsoft Entra ID a spravovaných identit poskytuje vynikající zabezpečení a snadné použití prostřednictvím autorizace sdíleného přístupového klíče. Další informace o používání spravovaných identit s mezipamětí naleznete v tématu Použití MICROSOFT Entra ID pro ověřování mezipaměti.

appsettings Použijte ke konfiguraci každého z následujících typů ověřování klientů za předpokladuConnection, že byla nastavena Redis na funkci.

Connection string

"Redis": "<cacheName>.<region>.redis.azure.net:10000,password=..."

Spravovaná identita přiřazená systémem

"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
"Redis__principalId": "<principalId>"

Spravovaná identita přiřazená uživatelem

"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
"Redis__principalId": "<principalId>",
"Redis__clientId": "<clientId>"

Tajný klíč instančního objektu

Připojení využívající tajné kódy instančního objektu jsou k dispozici pouze během místního vývoje.

"Redis__redisHostName": "<cacheName>.<region>.redis.azure.net",
"Redis__principalId": "<principalId>",
"Redis__clientId": "<clientId>"
"Redis__tenantId": "<tenantId>"
"Redis__clientSecret": "<clientSecret>"

Související obsah