Sdílet prostřednictvím

Klientské knihovny

  • Článek

Služba Azure Cache for Redis je založená na oblíbeném opensourcovém úložišti dat v paměti, opensourcovém úložišti Redis. Klienti Redis pro mnoho programovacích jazyků mají přístup ke službě Azure Managed Redis. Každá klientská knihovna má vlastní rozhraní API, které volá server Redis pomocí příkazů Redis, ale klientské knihovny jsou vytvořené tak, aby komunikily s libovolným serverem Redis.

Každý klient udržuje vlastní referenční dokumentaci ke své knihovně. Klienti také poskytují odkazy na získání podpory prostřednictvím komunity vývojářů klientské knihovny. Tým Azure Cache for Redis nevlastní vývoj ani podporu žádné klientské knihovny.

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

Klientská knihovna Jazyk Úložiště GitHubu 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 může pro připojení k instanci Azure Cache for Redis použít libovolnou klientskou knihovnu, která je kompatibilní s open source Redis.

Doprovodné materiály ke konkrétním klientským knihovnám

Informace o osvědčených postupech specifických pro klientskou knihovnu najdete na následujících odkazech:

Redisson (Java)

Doporučujeme použít verzi 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 protokol změn Redisson, kde se mohou objevit další známé problémy, které mohou ovlivnit funkce používané vaší aplikací. Další informace naleznete v tématu CHANGELOG a častých otázkách k Redisson.

Další poznámky:

  • Redisson ve výchozím nastavení na rozdíl od jiných klientů nastaví strategii čtení z repliky. Chcete-li toto výchozí 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ět k agresivnímu chování opětovného připojení nebo "bouře připojení". Pokud chcete riziko snížit, zvažte použití méně připojení, protože můžete efektivně provádět příkazy kanálu nebo dávky příkazů přes několik připojení.
  • Redisson má výchozí dobu nečinnosti připojení z 10 sekund, což vede k většímu zavření 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 o podpoře JCache pro JCache jako úložišti stavu relace HTTP v IBM Liberty v Azure najdete v tématu Použití Java EE JCache s Open Liberty nebo WebSphere Liberty v clusteru Azure Kubernetes Service (AKS).

Jak používat klientské knihovny

Kromě referenční dokumentace najdete kurzy, které ukazují, jak začít se službou 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 najdete v následujících článcích:

Další kroky