Integrare Cache di Azure per Redis con Service Connector

Questa pagina mostra i client e i metodi di autenticazione supportati, e mostra un codice di esempio che è possibile usare per connettere Cache di Azure per Redis ad altri servizi cloud tramite Service Connector. È comunque possibile connettersi a Cache di Azure per Redis in altri linguaggi di programmazione senza usare Service Connector. Questa pagina mostra anche i nomi e i valori predefiniti delle variabili di ambiente (o configurazione spring boot) che si ottengono quando si crea la connessione al servizio.

Servizi di calcolo supportati

Service Connector può essere usato per connettere i servizi di calcolo seguenti a Cache di Azure per Redis:

• Servizio app di Azure
• App contenitore di Azure
• Funzioni di Azure
• Servizio Azure Kubernetes (AKS)
• Azure Spring Apps

Tipi di client e tipi di autenticazione supportati

La tabella seguente illustra le combinazioni di client e metodi di autenticazione supportati per la connessione del servizio di calcolo a Cache di Azure per Redis tramite Service Connector. Un valore "Sì" indica che la combinazione è supportata, mentre "No" indica che non è supportata.

Tipo client	Identità gestita assegnata dal sistema	Identità gestita assegnata dall'utente	Stringa di segreto/connessione	Entità servizio
.NET	No	No	Sì	No
Go	No	No	Sì	No
Java	No	No	Sì	No
Java - Spring Boot	No	No	Sì	No
Node.js	No	No	Sì	No
Python	No	No	Sì	No
None	No	No	Sì	No

Questa tabella indica che l'unico metodo di autenticazione per tutti i tipi di client nella tabella è il metodo segreto / stringa di connessione. Altri metodi di autenticazione non sono supportati per nessuno dei tipi di client per connettersi a Cache di Azure per Redis tramite Service Connector.

Nomi di variabili di ambiente predefiniti o proprietà dell'applicazione e codice di esempio

Usare i nomi delle variabili di ambiente e le proprietà dell'applicazione elencati di seguito per connettere i servizi di calcolo al server Redis. Per ogni esempio seguente, sostituire i testi segnaposto <redis-server-name> e <redis-key> con il nome del server e la chiave di Redis. Per altre informazioni sulle convenzioni di denominazione, vedere l'articolo Elementi interni di Service Connector.

Stringa di connessione

Avviso

Microsoft consiglia di usare il flusso di autenticazione più sicuro disponibile. Il flusso di autenticazione descritto in questa procedura richiede un livello di attendibilità molto elevato nell'applicazione e comporta rischi che non sono presenti in altri flussi. Si consiglia di usare questo flusso solo quando altri flussi più sicuri, come le identità gestite, non sono validi.

.NET

Nome variabile di ambiente predefinito	Descrizione	Valore di esempio
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Stringa di connessione di Redis	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

Nome variabile di ambiente predefinito	Descrizione	Valore di esempio
AZURE_REDIS_CONNECTIONSTRING	Stringa di connessione di Redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Proprietà dell'applicazione	Descrizione	Valore di esempio
spring.redis.host	Host di Redis	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Porta di Redis	6380
spring.redis.database	Database di Redis	0
spring.redis.password	Chiave di Redis	<redis-key>
spring.redis.ssl	Impostazione SSL	true

Python

Nome variabile di ambiente predefinito	Descrizione	Valore di esempio
AZURE_REDIS_CONNECTIONSTRING	Stringa di connessione redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

Nome variabile di ambiente predefinito	Descrizione	Valore di esempio
AZURE_REDIS_CONNECTIONSTRING	Stringa di connessione redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

Nome variabile di ambiente predefinito	Descrizione	Valore di esempio
AZURE_REDIS_CONNECTIONSTRING	Stringa di connessione node-redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Altro

Nome variabile di ambiente predefinito	Descrizione	Valore di esempio
AZURE_REDIS_HOST	Host di Redis	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Porta di Redis	6380
AZURE_REDIS_DATABASE	Database di Redis	0
AZURE_REDIS_PASSWORD	Chiave di Redis	<redis-key>
AZURE_REDIS_SSL	Impostazione SSL	true

Codice di esempio

Vedere i passaggi e il codice seguenti per connettersi a Cache di Azure per Redis tramite una stringa di connessione.

.NET

1. Installare le dipendenze.

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Ottenere la stringa di connessione di Redis dalla variabile di ambiente aggiunta da Service Connector.

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

Java

1. Aggiungere la dipendenza seguente nel file pom.xml:

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

2. Ottenere la stringa di connessione di Redis dalla variabile di ambiente aggiunta da Service Connector.

   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

Vedere Usare Cache di Azure per Redis in Spring per configurare l'applicazione Spring. Le proprietà di configurazione sono aggiunte a Spring App da Service Connector.

Python

1. Installare le dipendenze.

   pip install redis
   

2. Ottenere la stringa di connessione di Redis dalla variabile di ambiente aggiunta da Service Connector.

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

Go

1. Installare le dipendenze.

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

2. Ottenere la stringa di connessione di Redis dalla variabile di ambiente aggiunta da Service Connector.

   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. Installare le dipendenze.

   npm install redis
   

2. Ottenere la stringa di connessione di Redis dalla variabile di ambiente aggiunta da Service Connector.

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

Altro

Per altri linguaggi, è possibile usare le informazioni di connessione impostate da Service Connector sulle variabili di ambiente per connettersi a Cache di Azure per Redis. Per i dettagli sulle variabili di ambiente, vedere Integrare Configurazione app di Azure con Service Connector.

Passaggi successivi

Per altre informazioni sul connettore di servizi seguire le esercitazioni riportate di seguito.

Informazioni sui concetti del connettore di servizi