Freigeben über


Übersicht über Azure-Funktionen für Azure Redis

In diesem Artikel wird beschrieben, wie Sie entweder Azure Managed Redis oder Azure Cache for Redis mit Azure Functions verwenden, um optimierte serverlose und ereignisgesteuerte Architekturen zu erstellen.

Azure Functions bietet ein ereignisgesteuertes Programmiermodell, bei dem Trigger und Bindungen wichtige Features sind. Mit Azure Functions können Sie problemlos ereignisgesteuerte serverlose Anwendungen erstellen. Azure Redis-Dienste (Azure Managed Redis und Azure Cache for Redis) bieten eine Reihe von Bausteinen und bewährten Methoden zum Erstellen verteilter Anwendungen, einschließlich Mikroservices, Zustandsverwaltung, Pub/Sub Messaging und mehr.

Azure Redis kann als Trigger für Azure Functions verwendet werden, sodass Sie einen serverlosen Workflow initiieren können. Diese Funktionalität kann in Datenarchitekturen wie einem Write-Behind-Cache oder allen ereignisbasierten Architekturen sehr nützlich sein.

Sie können Azure Redis und Azure Functions integrieren, um Funktionen zu erstellen, die auf Ereignisse von Azure Redis oder externen Systemen reagieren.

Aktion Direction
Trigger für Redis Pub-Unternachrichten Trigger
Trigger für Redis-Listen Trigger
Trigger für Redis-Datenströme Trigger
Lesen eines zwischengespeicherten Werts Eingabe
Schreiben von Werten zum Zwischenspeichern Output

Verfügbarkeitsbereich für Funktionentrigger und Bindungen

Tarif Azure-Cache für Redis (Basic, Standard, Premium, Enterprise, Enterprise Flash) Azure Managed Redis (Speicher optimiert, Einfach, Compute optimiert, Flash optimiert)
Pub/Sub Ja Ja
Listen Ja Ja
Datenströme Ja Ja
Bindungen Ja Ja

Wichtig

Redis-Trigger werden derzeit nur für Funktionen unterstützt, die in einem Elastic Premium-Plan oder einem dedizierten App Service-Plan ausgeführt werden.

Installieren der Erweiterung

Funktionen werden in einem isolierten C#-Workerprozess ausgeführt. Weitere Informationen finden Sie im Leitfaden zum Ausführen von Azure Functions (C#) in einem isolierten Workerprozess.

Fügen Sie ihrem Projekt die Erweiterung hinzu, indem Sie dieses NuGet-Paket installieren.

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

Installieren des Pakets

  1. Erstellen eines Java-Funktionsprojekts Sie könnten Maven verwenden: mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8

  2. Fügen Sie das Erweiterungspaket hinzu, indem Sie den folgenden Code in Ihrer Datei host.json hinzufügen oder ersetzen:

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

    Warnung

    Die Redis-Erweiterung ist derzeit nur in einem Vorschaupaketrelease verfügbar.

  3. Fügen Sie der Datei pom.xml die Java-Bibliothek für Redis-Bindungen hinzu:

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

Fügen Sie das Erweiterungspaket hinzu, indem Sie den folgenden Code in Ihrer Datei host.json hinzufügen oder ersetzen:

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

Warnung

Die Redis-Erweiterung ist derzeit nur in einem Vorschaupaketrelease verfügbar.

Redis-Verbindungszeichenfolge

Azure Redis triggers and bindings have a required property that indicates the application setting or collection name that contains cache connection information. Die Verbindungszeichenfolge finden Sie im Menü "Zugriffstasten" im Azure Managed Redis- oder Azure Cache for Redis-Portal. Der Trigger oder die Bindung von Redis sucht nach einer Umgebungsvariablen, die die Verbindungszeichenfolge mit dem Namen enthält, der an den Parameter Connection übergebenen wird.

In der lokalen Entwicklung kann Connection mithilfe der Datei local.settings.json definiert werden. Bei der Bereitstellung in Azure können Anwendungseinstellungen verwendet werden.

Wenn Sie eine Verbindung mit einer Cacheinstanz mit einer Azure-Funktion herstellen, können Sie drei Arten von Verbindungen in Ihren Bereitstellungen verwenden: Verbindungszeichenfolge, vom System zugewiesene verwaltete Identität und vom Benutzer zugewiesene verwaltete Identität.

Für die lokale Entwicklung können Sie auch Dienstprinzipalschlüssel verwenden.

Wichtig

Um optimale Sicherheit zu gewährleisten, sollte Ihre Funktions-App Microsoft Entra-ID mit verwalteten Identitäten verwenden, um Anforderungen für Ihren Cache zu autorisieren, falls möglich. Die Autorisierung mit Microsoft Entra ID und verwalteten Identitäten bietet eine höhere Sicherheit und Benutzerfreundlichkeit als die Autorisierung mit gemeinsam verwendetem Schlüssel. Weitere Informationen zum Verwenden verwalteter Identitäten mit Ihren Caches finden Sie unter Verwenden von Microsoft Entra ID für die Cacheauthentifizierung.

Verwenden Sie die appsettings Folgenden Typen der Clientauthentifizierung, wobei davon ausgegangen wird, dass sie Connection in der Funktion festgelegt Redis wurde.

Connection string

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

Systemseitig zugewiesene verwaltete Identität

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

Benutzerseitig zugewiesene verwaltete Identität

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

Geheimnis des Dienstprinzipals

Verbindungen mit Dienstprinzipalschlüsseln sind nur während der lokalen Entwicklung verfügbar.

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