Klientské knihovny

Azure Cache for Redis je založená na oblíbeném opensourcovém úložišti dat v paměti , open source Redis. Azure Cache for Redis má přístup celá řada klientů Redis pro mnoho programovacích jazyků. Každá klientská knihovna má vlastní rozhraní API, které provádí volání serveru Redis pomocí příkazů Redis, ale klientské knihovny jsou vytvořené tak, aby komunikovala s libovolným serverem Redis.

Každý klient má pro svou knihovnu vlastní referenční dokumentaci. Klienti také poskytují odkazy pro získání podpory prostřednictvím komunity vývojářů klientských knihoven. Tým Azure Cache for Redis nevlastní vývoj ani podporu klientských knihoven.

I když nevlastníme ani nepodporujeme žádné klientské knihovny, doporučujeme některé knihovny. Doporučení jsou založená na oblíbenosti a na tom, jestli existuje aktivní online komunita, která podporuje vaše dotazy a odpovídá na ně. Doporučujeme používat pouze nejnovější dostupnou verzi a pravidelně upgradovat, jakmile budou k dispozici nové verze. Tyto knihovny jsou v aktivním vývoji a často vydávají nové verze s vylepšeními spolehlivosti a výkonu.

Klientská knihovna Jazyk Úložiště GitHub Dokumentace
StackExchange.Redis C#/.NET Odkaz Další informace najdete tady.
Lettuce Java Odkaz Další informace najdete tady.
Jedis Java Odkaz
node_redis Node.js Odkaz
Redisson Java Odkaz Další informace najdete tady.
ioredis Node.js Odkaz Další informace najdete tady.

Poznámka

Vaše aplikace se může připojit k instanci Azure Cache for Redis a používat ji s libovolnou klientskou knihovnou, která může také komunikovat s opensourcovým Redisem.

Pokyny pro klientskou knihovnu

Informace o osvědčených postupech pro klientské knihovny najdete na následujících odkazech:

Redisson (Java)

Doporučujeme použít redisson 3.14.1 nebo vyšší. Starší verze obsahují známé problémy s nevrácením připojení, které způsobují problémy po převzetí služeb při selhání. Sledujte redissonův protokol změn a vyhledejte další známé problémy, které můžou mít vliv na funkce používané vaší aplikací. Další informace najdete v článkuCHANGELOG a v nejčastějších dotazech společnosti Redisson.

Další poznámky:

  • Redisson na rozdíl od některých jiných klientů ve výchozím nastavení strategii čtení z repliky. Pokud chcete toto nastavení změnit, upravte nastavení konfigurace readMode.
  • Redisson má strategii sdružování připojení s konfigurovatelným minimálním a maximálním nastavením a výchozí minimální hodnoty jsou velké. Velké výchozí hodnoty můžou přispívat k agresivnímu chování při opětovném připojování nebo k "zahlceným připojením". Pokud chcete toto riziko snížit, zvažte použití menšího počtu připojení, protože můžete efektivně kanálovat příkazy nebo dávky příkazů přes několik připojení.
  • Redisson má výchozí časový limit nečinnosti připojení 10 sekund, což vede k většímu zavírání a opětovnému otevření připojení, než je ideální.

Tady je doporučená základní konfigurace pro režim clusteru, kterou můžete podle potřeby upravit:

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

Článek, který ukazuje, jak používat podporu JCache od společnosti Redisson jako úložiště pro stav relace HTTP v IBM Liberty v Azure, najdete v tématu Použití služby Java EE JCache s platformou Open Liberty nebo WebSphere Liberty v clusteru Azure Kubernetes Service (AKS).

Jak používat klientské knihovny

Kromě referenční dokumentace najdete kurzy, které vám ukážou, jak začít s Azure Cache for Redis používat různé jazyky a klienty mezipaměti.

Další informace o používání některých z těchto klientských knihoven v kurzech najdete v následujících článcích:

Další kroky