Service Connector を使用して Azure Cache for Redis を統合する

このページでは、サポートされている認証方法とクライアントを示し、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

.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

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

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_DATABAStandard Edition	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. Service Connector によって追加された環境変数から 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 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);
   

SpringBoot

Spring アプリケーションを設定するには、「 Spring で Azure Redis Cache を使用する」を参照してください。 構成プロパティは、Spring Apps by Service Connector に追加されます。

Python

1. 依存関係をインストールします。

   pip install redis
   

2. Service Connector によって追加された環境変数から 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 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)
   

NodeJS

1. 依存関係をインストールします。

   npm install redis
   

2. 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 が環境変数に設定する接続情報を使用して、Azure Cache for Redis に接続できます。 環境変数の詳細については、「Service Connector を使用して Azure App Configuration を統合する」を参照してください。

次のステップ

Service Connector の詳細については、以下のチュートリアルに従ってください。

Service Connector の概念について学習する