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

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

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

受支持的计算服务

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

• Azure 应用服务
• Azure Functions
• Azure 容器应用
• Azure Spring Apps

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

下表显示了使用服务连接or将计算服务连接到 Azure Redis 缓存的身份验证方法和客户端的组合。 “是”表示支持组合，而“否”则表示不支持该组合。

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

此表指示表中所有客户端类型唯一支持的身份验证方法是 Secret/连接字符串 方法。 任何客户端类型都不支持使用服务连接or 连接到 Azure Redis 缓存的其他身份验证方法。

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

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

连接字符串

.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_DATABA标准版	Redis 数据库	0
AZURE_REDIS_PASSWORD	Redis 密钥	<redis-key>
AZURE_REDIS_SSL	SSL 设置	true

示例代码

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

.NET

1. 安装依赖项。

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. 从 Service 连接or 添加的环境变量中获取 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. 从 Service 连接or 添加的环境变量中获取 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 中使用 Azure Redis 缓存设置 Spring 应用程序。 配置属性按 Service 连接or 添加到 Spring Apps。

Python

1. 安装依赖项。

   pip install redis
   

2. 从 Service 连接or 添加的环境变量中获取 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. 从 Service 连接or 添加的环境变量中获取 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. 从 Service 连接or 添加的环境变量中获取 Redis 连接字符串。

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

其他

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

后续步骤

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

了解服务连接器的概念