你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用服务连接器集成 Azure Cache for Redis

此页面显示了支持的身份验证方法和客户端，并演示了使用服务连接器将 Azure Cache for Redis 连接到其他云服务时可以使用的示例代码。 即使不使用服务连接器，你可能仍然可以使用其他编程语言连接到 Azure Cache for Redis。 此页面还显示了你在创建服务连接时获得的默认环境变量名称和值（或 Spring Boot 配置）。

受支持的计算服务

服务连接器可用于将以下计算服务连接到 Azure Cache for Redis：

• Azure 应用程序服务
• Azure Container Apps
• Azure Functions
• Azure Kubernetes 服务 (AKS)
• Azure Spring Apps

支持的身份验证类型和客户端类型

下表显示了使用服务连接器将计算服务连接到 Azure Cache for Redis 时所支持的身份验证方法与客户端的组合。 “是”表示支持该组合，“否”表示不支持该组合。

客户端类型	系统分配的托管标识	用户分配的托管标识	机密/连接字符串	服务主体
.NET	否	No	是	否
Go	否	No	是	否
Java	否	No	是	否
Java - Spring Boot	否	No	是	否
Node.js	否	No	是	否
Python	否	No	是	否
无	否	No	是	否

此表指示表中所有客户端类型唯一支持的身份验证方法是机密/连接字符串方法。 使用服务连接器连接到 Azure Cache for Redis 时，任何客户端类型均不支持使用其他身份验证方法。

默认环境变量名称或应用程序属性和示例代码

使用下面列出的环境变量名称和应用程序属性将计算服务连接到 Redis 服务器。 对于以下每个示例，将占位符文本 <redis-server-name> 和 <redis-key> 替换为自己的 Redis 服务器名称和密钥。 有关命名约定的详细信息，请参阅服务连接器内部一文。

连接字符串

警告

Microsoft 建议使用最安全的可用身份验证流。 本过程中介绍的身份验证流程需要非常高的信任度，并携带其他流中不存在的风险。 请仅在无法使用其他更安全的流（例如托管标识）时才使用此流。

.NET

默认环境变量名称	说明	示例值
AZURE_REDIS_CONNECTIONSTRING	StackExchange。 Redis 连接字符串	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

默认环境变量名称	说明	示例值
AZURE_REDIS_CONNECTIONSTRING	Jedis 连接字符串	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

应用程序属性	说明	示例值
spring.redis.host	Redis 主机	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Redis 端口	6380
spring.redis.database	Redis 数据库	0
spring.redis.password	Redis 密钥	<redis-key>
spring.redis.ssl	SSL 设置	true

Python

默认环境变量名称	说明	示例值
AZURE_REDIS_CONNECTIONSTRING	redis-py 连接字符串	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

默认环境变量名称	说明	示例值
AZURE_REDIS_CONNECTIONSTRING	redis-py 连接字符串	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

默认环境变量名称	说明	示例值
AZURE_REDIS_CONNECTIONSTRING	node-redis 连接字符串	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

其他

默认环境变量名称	说明	示例值
AZURE_REDIS_HOST	Redis 主机	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Redis 端口	6380
AZURE_REDIS_DATABASE	Redis 数据库	0
AZURE_REDIS_PASSWORD	Redis 密钥	<redis-key>
AZURE_REDIS_SSL	SSL 设置	true

代码示例

请参阅下面的步骤和代码，以使用连接字符串连接到 Azure Cache for Redis。

.NET

1. 安装依赖项。

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. 从服务连接器添加的环境变量中获取 Redis 连接字符串。

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

Java

1. 将以下依赖项添加到 pom.xml 文件：

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

2. 从服务连接器添加的环境变量中获取 Redis 连接字符串。

   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

要设置 Spring 应用程序，请参阅在 Spring 中使用 Azure Redis 缓存。 配置属性通过服务连接器添加到 Spring Apps。

Python

1. 安装依赖项。

   pip install redis
   

2. 从服务连接器添加的环境变量中获取 Redis 连接字符串。

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

Go

1. 安装依赖项。

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

2. 从服务连接器添加的环境变量中获取 Redis 连接字符串。

   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. 安装依赖项。

   npm install redis
   

2. 从服务连接器添加的环境变量中获取 Redis 连接字符串。

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

其他

对于其他语言，可以使用服务连接器设置为环境变量的连接信息来连接到 Azure Cache for Redis。 有关环境变量的详细信息，请参阅将 Azure 应用程序配置与服务连接器集成。

后续步骤

参考下面列出的教程来详细了解服务连接器。

了解服务连接器的概念