Integrieren von Azure Cache for Redis in Service Connector

Diese Seite zeigt unterstützte Authentifizierungsmethoden und -clients und zeigt Beispielcode, den Sie verwenden können, um Azure Cache für Redis mit anderen Clouddiensten mithilfe von Service Verbinden or zu verbinden. Möglicherweise können Sie auch in anderen Programmiersprachen eine Verbindung zu Azure Cache for Redis herstellen, ohne Service Connector zu verwenden. Auf dieser Seite werden auch die Namen und Werte der Standardumgebungsvariablen (oder die Spring Boot-Konfiguration) angezeigt, die Sie erhalten, wenn Sie die Dienstverbindung erstellen.

Unterstützte Computedienste

Der Dienst Verbinden or kann verwendet werden, um die folgenden Computedienste mit Azure Cache für Redis zu verbinden:

• Azure App Service
• Azure-Funktionen
• Azure Container Apps
• Azure Spring Apps

Unterstützte Authentifizierungstypen und Client-Typen

Die folgende Tabelle zeigt, welche Kombinationen von Authentifizierungsmethoden und Clients unterstützt werden, um Ihren Computedienst mit Azure Cache für Redis mithilfe von Service Verbinden or zu verbinden. Ein "Ja" gibt an, dass die Kombination unterstützt wird, während ein "Nein" angibt, dass sie nicht unterstützt wird.

Clienttyp	Systemseitig zugewiesene verwaltete Identität	Benutzerseitig zugewiesene verwaltete Identität	Geheimnis/Verbindungszeichenfolge	Dienstprinzipal
.NET	Nein	Nein	Ja	Nein
Go	Nein	Nein	Ja	Nein
Java	Nein	Nein	Ja	Nein
Java - Spring Boot	Nein	Nein	Ja	Nein
Node.js	Nein	Nein	Ja	Nein
Python	Nein	Nein	Ja	Nein
Keine	Nein	Nein	Ja	Nein

Diese Tabelle gibt an, dass die einzige unterstützte Authentifizierungsmethode für alle Clienttypen in der Tabelle die Methode "Geheim/Verbindungszeichenfolge" ist. Andere Authentifizierungsmethoden werden für einen der Clienttypen nicht unterstützt, um mithilfe von Service Verbinden or eine Verbindung mit dem Azure-Cache für Redis herzustellen.

Standardumgebungsvariablennamen oder Anwendungseigenschaften und Beispielcode

Verwenden Sie die unten aufgeführten Namen und Anwendungseigenschaften der Umgebungsvariablen, um Computedienste mit Redis Server zu verbinden. Ersetzen Sie den Platzhaltertext <redis-server-name> und <redis-key> in allen Beispielen unten durch Ihren eigenen Redis-Servernamen und Schlüssel. Weitere Informationen zu Benennungskonventionen finden Sie im Artikel "Service Verbinden or internals".

Verbindungszeichenfolge

.NET

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Redis-Verbindungszeichenfolge	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	Jedis-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Anwendungseigenschaften	Beschreibung	Beispielswert
spring.redis.host	Redis-Host	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Redis-Port	6380
spring.redis.database	Redis-Datenbank	0
spring.redis.password	Redis-Schlüssel	<redis-key>
spring.redis.ssl	SSL-Einstellungen	true

Python

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	redis-py-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	redis-py-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	node-redis-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Andere

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_HOST	Redis-Host	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Redis-Port	6380
AZURE_REDIS_DATABASE	Redis-Datenbank	0
AZURE_REDIS_PASSWORD	Redis-Schlüssel	<redis-key>
AZURE_REDIS_SSL	SSL-Einstellungen	true

Beispielcode

Lesen Sie die schritte und den folgenden Code, um mithilfe eines Verbindungszeichenfolge eine Verbindung mit Azure Cache für Redis herzustellen.

.NET

1. Installieren Sie Abhängigkeiten.

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Rufen Sie die Redis-Verbindungszeichenfolge aus der Umgebungsvariable ab, die von Service Verbinden or hinzugefügt wurde.

   using StackExchange.Redis;
   var connectionString = Environment.GetEnvironmentVariable("AZURE_REDIS_CONNECTIONSTRING");
   var _redisConnection = await RedisConnection.InitializeAsync(connectionString: connectionString);
   

Java

1. Fügen Sie die folgende Abhängigkeit in Ihrer pom.xml-Datei hinzu:

   <dependency>
     <groupId>redis.clients</groupId>
     <artifactId>jedis</artifactId>
     <version>4.1.0</version>
     <type>jar</type>
     <scope>compile</scope>
   </dependency>
   

2. Rufen Sie die Redis-Verbindungszeichenfolge aus der Umgebungsvariable ab, die von Service Verbinden or hinzugefügt wurde.

   import redis.clients.jedis.DefaultJedisClientConfig;
   import redis.clients.jedis.Jedis;
   import redis.clients.jedis.JedisShardInfo;
   import java.net.URI;
   
   String connectionString = System.getenv("AZURE_REDIS_CONNECTIONSTRING");
   URI uri = new URI(connectionString);
   JedisShardInfo shardInfo = new JedisShardInfo(uri);
   shardInfo.setSsl(true);
   Jedis jedis = new Jedis(shardInfo);
   

SpringBoot

Weitere Informationen finden Sie unter Verwenden des Azure Redis-Caches im Frühjahr , um Ihre Spring-Anwendung einzurichten. Die Konfigurationseigenschaften werden spring Apps by Service Verbinden or hinzugefügt.

Python

1. Installieren Sie Abhängigkeiten.

   pip install redis
   

2. Rufen Sie die Redis-Verbindungszeichenfolge aus der Umgebungsvariable ab, die von Service Verbinden or hinzugefügt wurde.

   import os
   import redis
   
   url = os.getenv('AZURE_REDIS_CONNECTIONSTRING')
   url_connection = redis.from_url(url)
   url_connection.ping()
   

Go

1. Installieren Sie Abhängigkeiten.

   go get github.com/redis/go-redis/v9
   

2. Rufen Sie die Redis-Verbindungszeichenfolge aus der Umgebungsvariable ab, die von Service Verbinden or hinzugefügt wurde.

   import (
       "context"
       "fmt"
   
       "github.com/redis/go-redis/v9"
   )
   
   connectionString := os.Getenv("AZURE_REDIS_CONNECTIONSTRING")
   opt, err := redis.ParseURL(connectionString)
   if err != nil {
   	panic(err)
   }
   
   client := redis.NewClient(opt)
   

NodeJS

1. Installieren Sie Abhängigkeiten.

   npm install redis
   

2. Rufen Sie die Redis-Verbindungszeichenfolge aus der Umgebungsvariable ab, die von Service Verbinden or hinzugefügt wurde.

   const redis = require("redis");
   
   const connectionString = process.env.AZURE_REDIS_CONNECTIONSTRING;
   const cacheConnection = redis.createClient({
       url: connectionString,
   });
   await cacheConnection.connect();
   

Andere

Für andere Sprachen können Sie die Verbindungsinformationen verwenden, die Service Verbinden or auf die Umgebungsvariablen festlegt, um eine Verbindung mit Azure Cache für Redis herzustellen. Details zu Umgebungsvariablen finden Sie unter Integration Azure-App Configuration with Service Verbinden or.For environment variable details, see Integrate Azure-App Configuration with Service Verbinden or.

Nächste Schritte

Befolgen Sie die unten aufgeführten Tutorials, um mehr über Service Connector zu erfahren.

Informationen zu Service Connector-Konzepten