Service Connector を使用して Azure Cache for Redis を統合する
[アーティクル] 02/06/2024
3 人の共同作成者
フィードバック
この記事の内容
このページでは、サポートされている認証方法とクライアントを示し、Service Connector を使用して Azure Cache for Redis を他のクラウド サービスに接続するために使用できるサンプル コードを示します。 Service Connector を使用しなくても、他のプログラミング言語で Azure Cache for Redis に接続できる場合があります。 このページには、サービス接続を作成するときに取得する既定の環境変数の名前と値 (つまり、Spring Boot 構成) も示されています。
サポートされているコンピューティング サービス
Service Connector を使用して、次のコンピューティング サービスを Azure Cache for Redis に接続できます。
Azure App Service
Azure Functions
Azure Container Apps
Azure Spring Apps
サポートされている認証の種類とクライアントの種類
次の表は、Service Connector を使用してコンピューティング サービスを Azure Cache for Redis に接続するためにサポートされている認証方法とクライアントの組み合わせを示しています。 "はい" は組み合わせがサポートされていることを示し、"いいえ" はサポートされていないことを示します。
クライアント タイプ
システム割り当てマネージド ID
ユーザー割り当てマネージド ID
シークレット/接続文字列
サービス プリンシパル
.NET
いいえ
番号
イエス
いいえ
Go
いいえ
番号
イエス
いいえ
Java
いいえ
番号
イエス
いいえ
Java - Spring Boot
いいえ
番号
イエス
いいえ
Node.js
いいえ
番号
イエス
いいえ
Python
いいえ
番号
イエス
いいえ
なし
いいえ
番号
イエス
いいえ
このテーブルは、テーブル内のすべてのクライアントの種類でサポートされている認証方法が Secret/接続文字列 メソッドのみであることを示します。 Service Connector を使用して Azure Cache for Redis に接続するクライアントの種類では、その他の認証方法はサポートされていません。
既定の環境変数名またはアプリケーション プロパティとサンプル コード
次に示す環境変数名とアプリケーション プロパティを使用して、コンピューティング サービスを Redis Server に接続します。 下の各例では、プレースホルダー テキスト <redis-server-name>
、<redis-key>
を自分の Redis サーバー名およびキーに置き換えます。 名前付け規則の詳細については、Service Connector の内部 の記事を参照してください。
Connection String
既定の環境変数名
説明
例値
AZURE_REDIS_CONNECTIONSTRING
StackExchange. Redis 接続文字列
<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0
既定の環境変数名
説明
例値
AZURE_REDIS_CONNECTIONSTRING
Jedis 接続文字列
rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0
Application properties
説明
例値
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
既定の環境変数名
説明
例値
AZURE_REDIS_CONNECTIONSTRING
redis-py 接続文字列
rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0
既定の環境変数名
説明
例値
AZURE_REDIS_CONNECTIONSTRING
redis-py 接続文字列
rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0
既定の環境変数名
説明
例値
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_DATABAStandard Edition
Redis データベース
0
AZURE_REDIS_PASSWORD
Redis キー
<redis-key>
AZURE_REDIS_SSL
SSL 設定
true
サンプル コード
接続文字列を使用して Azure Cache for Redis に接続するには、以下の手順とコードを参照してください。
依存関係をインストールします。
dotnet add package StackExchange.Redis --version 2.6.122
Service Connector によって追加された環境変数から Redis 接続文字列を取得します。
using StackExchange.Redis;
var connectionString = Environment.GetEnvironmentVariable("AZURE_REDIS_CONNECTIONSTRING");
var _redisConnection = await RedisConnection.InitializeAsync(connectionString: connectionString);
pom.xml ファイルに次の依存関係を 追加します。<dependency>
<groupId>redis.clients</groupId>
<artifactId>jedis</artifactId>
<version>4.1.0</version>
<type>jar</type>
<scope>compile</scope>
</dependency>
Service Connector によって追加された環境変数から 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);
Spring アプリケーションを設定するには、「 Spring で Azure Redis Cache を使用する」を参照してください。 構成プロパティは、Spring Apps by Service Connector に追加されます。
依存関係をインストールします。
pip install redis
Service Connector によって追加された環境変数から Redis 接続文字列を取得します。
import os
import redis
url = os.getenv('AZURE_REDIS_CONNECTIONSTRING')
url_connection = redis.from_url(url)
url_connection.ping()
依存関係をインストールします。
go get github.com/redis/go-redis/v9
Service Connector によって追加された環境変数から 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)
依存関係をインストールします。
npm install redis
Service Connector によって追加された環境変数から Redis 接続文字列を取得します。
const redis = require("redis");
const connectionString = process.env.AZURE_REDIS_CONNECTIONSTRING;
const cacheConnection = redis.createClient({
url: connectionString,
});
await cacheConnection.connect();
次のステップ
Service Connector の詳細については、以下のチュートリアルに従ってください。