Přehled funkcí Azure pro Azure Cache for Redis

Tento článek popisuje, jak používat Azure Cache for Redis se službou 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. Azure Cache for Redis poskytuje 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 Cache for 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 Cache for Redis a Azure Functions můžete integrovat a vytvářet funkce, které reagují na události z Azure Cache for Redis nebo externích systémů.

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

Rozsah dostupnosti pro triggery a vazby funkcí

Úroveň Basic Standard, Premium Enterprise, Enterprise Flash
Pub/Sub Ano Ano Yes
Seznamy Ano Ano Yes
Streamy Ano Ano Yes
Vazby Ano 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 --prerelease

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 Cache for Redis mají požadovanou vlastnost pro připojovací řetězec mezipaměti. Připojovací řetězec najdete v nabídce Přístupové klíče na portálu 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 Connection definovat 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.

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>.redis.cache.windows.net:6380,password=..."

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

"Redis:redisHostName": "<cacheName>.redis.cache.windows.net",
"Redis:principalId": "<principalId>"

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

"Redis:redisHostName": "<cacheName>.redis.cache.windows.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>.redis.cache.windows.net",
"Redis:principalId": "<principalId>",
"Redis:clientId": "<clientId>"
"Redis:tenantId": "<tenantId>"
"Redis:clientSecret": "<clientSecret>"