次の方法で共有

クライアント ライブラリ

  • 適用対象: ✅ Azure Cache for Redis

Azure Cache for Redis は、Redis オープン ソースのメモリ内データ ストアに基づいています。 多くのプログラミング言語の Redis クライアントは、Azure Redis にアクセスできます。 アプリケーションでは、オープンソースの Redis と互換性のある任意のクライアント ライブラリを使用して、Azure Redis キャッシュに接続できます。

各クライアント ライブラリには、Redis コマンドを使用して Redis サーバーを呼び出す独自の API があります。 クライアント ライブラリは、任意の Redis サーバーと通信するように構築されています。

クライアントは、独自のライブラリの参照ドキュメントを保持し、クライアント ライブラリ開発者コミュニティを通じてサポートを受けるリンクを提供します。 Microsoft と Azure Redis チームは、クライアント ライブラリの開発やサポートを所有していません。

Microsoft と Azure Redis では、人気と、質問に答えるアクティブなオンライン サポート コミュニティがあるかどうかに基づいて、一部のライブラリをお勧めします。 これらのライブラリは現在開発中であり、多くの場合、信頼性とパフォーマンスが向上した新しいバージョンをリリースします。 Microsoft では、利用可能な最新バージョンを使用し、新しいバージョンが利用可能になったときに定期的にアップグレードすることをお勧めします。

次の表に、推奨されるクライアント ライブラリのリンクとドキュメントを示します。

クライアント ライブラリ 言語 GitHub リポジトリ を する ドキュメント
StackExchange.Redis C#/.NET https://github.com/StackExchange/StackExchange.Redis StackExchange.Redis です。
ジェダイズ ジャワ https://github.com/redis/jedis
レタス ジャワ https://github.com/lettuce-io/ Lettuce - 高度な Java Redis クライアント
Redisson ジャワ https://github.com/redisson/redisson Redisson - Redis Java クライアント Real-Time データ プラットフォーム
ioredis Node.js https://github.com/luin/ioredis クラス
node_redis Node.js https://github.com/redis/node-redis

注

アプリケーションでは、オープンソースの Redis と互換性のある任意のクライアント ライブラリを使用して、Azure Redis インスタンスに接続できます。

クライアント ライブラリ固有のガイダンス

クライアント ライブラリ固有のガイダンスとベスト プラクティスについては、次のリンクを参照してください。

クライアント ライブラリの使用方法

リファレンス ドキュメントに加えて、次のチュートリアルを使用して、さまざまな言語とキャッシュ クライアントを使用して Azure Redis の使用を開始できます。

Redisson のベスト プラクティス (Java)

Redisson クライアント ライブラリの推奨されるベスト プラクティスを次に示します。

  • Redisson 3.14.1 以降を使用します。 以前のバージョンには、フェールオーバー後の問題につながる接続リークの問題が確認されています。

  • Redisson の変更ログで、アプリケーションで使用される機能に影響する可能性がある既知の問題を監視します。 詳細については、 Redisson リリース履歴と Redisson に関する FAQ を参照してください。

  • readModeり戦略を使用しない場合は、構成設定を変更します。 他の一部のクライアントとは異なり、Redisson では レプリカからの読み取り が既定として使用されます。

  • アグレッシブな再接続動作や 接続ストームのリスクを軽減するには、最小接続数の設定を減らすことを検討してください。

    Redisson の接続プール方式には、構成可能な最小と最大の設定があり、既定の最小値が大きすぎます。 大きな既定値は、アグレッシブな再接続動作や接続ストームに寄与する可能性があります。 このリスクを軽減するには、使用する接続の数を減らすことを検討してください。 いくつかの接続を介して、コマンドまたはコマンドのバッチを効率的にパイプライン化できます。

  • 必要に応じて、アイドル接続タイムアウトをリセットします。 Redisson にはデフォルトで10秒間のアイドル接続タイムアウトがありますが、これにより、理想的な状況よりも頻繁に接続を閉じて再開することになります。

  • Redisson と Java EE JCache を使用して Azure Kubernetes Service (AKS) クラスターに HTTP セッション状態を格納する方法については、「 WebSphere Liberty または Open Liberty のセッション キャッシュとして Azure Redis を使用する」を参照してください。

  • クラスター モードには、次の推奨されるベースライン構成を使用し、必要に応じて変更します。

    clusterServersConfig:
  idleConnectionTimeout: 30000
  connectTimeout: 15000
  timeout: 5000
  retryAttempts: 3
  retryInterval: 3000
  checkLockSyncedSlaves: false
  failedSlaveReconnectionInterval: 15000
  failedSlaveCheckInterval: 60000
  subscriptionsPerConnection: 5
  clientName: "redisson"
  loadBalancer: !<org.redisson.connection.balancer.RoundRobinLoadBalancer> {}
  subscriptionConnectionMinimumIdleSize: 1
  subscriptionConnectionPoolSize: 50
  slaveConnectionMinimumIdleSize: 2
  slaveConnectionPoolSize: 24
  masterConnectionMinimumIdleSize: 2
  masterConnectionPoolSize: 24
  readMode: "MASTER"
  subscriptionMode: "MASTER"
  nodeAddresses:
  - "redis://mycacheaddress:6380"
  scanInterval: 1000
  pingConnectionInterval: 60000
  keepAlive: false
  tcpNoDelay: true

関連コンテンツ