用戶端程式庫

  • 發行項

Azure Cache for Redis 依據熱門的開放原始碼記憶體內部資料存放區的開放原始碼 Redis 為基礎。 Azure Cache for Redis 可由各種不同的 Redis 用戶端來存取，並適用於許多程式設計語言。 每個用戶端程式庫都有自己的 API，可使用 Redis 命令來呼叫 Redis 伺服器，但會建置用戶端程式庫來與任何 Redis 伺服器通訊。

每個用戶端針對其程式庫都會維護本身的參考文件。 用戶端也會提供連結，以透過用戶端程式庫開發人員社群獲得支援。 Azure Cache for Redis 小組不會擁有開發，或支援任何用戶端程式庫。

雖然我們並非擁有或支援任何用戶端程式庫，但還是建議您使用某些程式庫。 建議是依據熱門程度為基礎，以及是否包括有效的線上社群可支援以及回答您的問題。 僅建議您使用最新可用的版本，並在新版本可供使用時定期升級。 這些程式庫在作用中開發中，而且通常會發行具備可靠性和效能改善的新發行版本。

用戶端程式庫 語言 GitHubrepo 文件集
StackExchange.Redis C#/.NET 連結 詳細資訊如此處所述
Lettuce Java 連結 詳細資訊如此處所述
Jedis Java 連結
node_redis Node.js 連結
Redisson Java 連結 詳細資訊如此處所述
ioredis Node.js 連結 詳細資訊如此處所述

注意

您的應用程式可以連線並使用您的 Azure Cache for Redis 執行個體與任何能與開放原始碼 Redis 通訊的用戶端程式庫。

用戶端程式庫特定的指引

如需用戶端程式庫特定指引最佳做法的資訊，請參閱下列連結：

Redisson (Java)

建議您使用 Redisson 3.14.1 或更高版本。 舊版包含已知的連線遺漏問題，其會在容錯移轉之後發生問題。 監視 Redisson 變更記錄，以了解其他已知問題可能會影響您應用程式所使用的功能。 如需詳細資訊，請參閱 CHANGELOG 和 Redisson 常見問題集 \(英文\)。

其他注意事項：

  • 不同於其他用戶端，Redisson 會預設為「從複本讀取」策略。 若要變更此設定，請修改 'readMode' 組態設定。
  • Redisson 有一個連線集區策略，其中具有可設定的最小值和最大值設定，且預設的最小值很大。 較大的預設值可能導致主動重新連線行為或「連線風暴」。 若要降低風險，請考慮使用較少的連線，因為您可以透過數個連線有效率地透過管線傳送命令或命令批次。
  • Redisson 的預設閒置連線逾時為 10 秒，這導致連線關閉和重新開啟的次數比理想的數目還要多。

以下是您可以視需要修改之叢集模式的建議基準設定：

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

如需示範如何使用 Re Azure Kubernetes Service (AKS) 叢集上的 JCache 作為 IBM Free 中 HTTP 會話狀態存放區的文章，請參閱在 Azure Kubernetes Service (AKS) 叢集上使用 JAVA EE JCache 與 Open Free 或 WebSphereBert。

用戶端程式庫的使用方式

除了參考文件以外，許多教學課程亦會示範如何以不同的語言和快取用戶端開始使用 Azure Cache for Redis。

如需在教學課程中運用其中一些用戶端程式庫的詳細資訊，請參閱下列文章：

下一步