Sdílet prostřednictvím


Klientské knihovny

Důležité

Služba Azure Cache for Redis oznámila časovou osu vyřazení všech skladových položek. Doporučujeme přesunout stávající instance Azure Cache for Redis do Azure Managed Redis , jakmile budete moct.

Další podrobnosti o ukončení podpory:

Azure Cache for Redis je založený na opensourcovém úložišti dat v paměti Redis. Klienti Redis pro mnoho programovacích jazyků mají přístup k Azure Redis. Vaše aplikace může použít libovolnou klientskou knihovnu, která je kompatibilní s opensourcovou službou Redis, a připojit se k mezipaměti Azure Redis.

Každá klientská knihovna má vlastní rozhraní API, které volá servery Redis pomocí příkazů Redis. Klientské knihovny jsou vytvořené tak, aby komunikují s jakýmkoli serverem Redis.

Klienti udržují referenční dokumentaci pro své vlastní knihovny a poskytují odkazy pro získání podpory prostřednictvím komunity vývojářů klientské knihovny. Microsoft a tým Azure Redis nevlastní vývoj ani podporu pro žádné klientské knihovny.

Microsoft a Azure Redis doporučují některé knihovny založené na oblíbenosti a na tom, jestli je k dispozici aktivní komunita online podpory, na které můžete odpovědět na otázky. Tyto knihovny se aktivně vyvíjí a často vydávají nové verze s vylepšeními spolehlivosti a výkonu. Společnost Microsoft doporučuje používat nejnovější dostupnou verzi a pravidelně upgradovat, jakmile budou k dispozici nové verze.

Následující tabulka obsahuje odkazy a dokumentaci pro některé doporučené klientské knihovny.

Klientská knihovna Jazyk Úložiště GitHub Dokumentace
StackExchange.Redis C#/.NET https://github.com/StackExchange/StackExchange.Redis StackExchange.Redis
Jedis Java https://github.com/redis/jedis
Salát Java https://github.com/lettuce-io/ Lettuce – Pokročilý Java Redis klient
Redisson Java https://github.com/redisson/redisson Redisson – Klient Redis Java Real-Time Data Platform
ioredis Node.js https://github.com/luin/ioredis Třídy
node_redis Node.js https://github.com/redis/node-redis

Poznámka:

Vaše aplikace může pro připojení k vaší instanci Azure Redis použít libovolnou klientskou knihovnu, která je kompatibilní s open source Redis.

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

Pokyny a osvědčené postupy pro klientskou knihovnu najdete na následujících odkazech:

Jak používat klientské knihovny

Kromě referenční dokumentace můžete pomocí následujících kurzů začít s Azure Redis používat různé jazyky a klienty mezipaměti:

Osvědčené postupy pro Redisson (Java)

Tady je několik doporučených osvědčených postupů pro klientskou knihovnu Redisson :

  • Použijte 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 a sledujte známé problémy, které můžou ovlivnit funkce, které vaše aplikace používá. Další informace najdete v historii vydaných verzí Redisson a v nejčastějších dotazech k Redissonu.

  • readMode Pokud nechcete používat strategii čtení z repliky, upravte nastavení konfigurace. Na rozdíl od některých jiných klientů používá Redisson jako výchozí možnost čtení z repliky.

  • Pokud chcete snížit riziko agresivního chování opětovného připojení nebo výpadků způsobených příliš mnoha připojeními, zvažte nastavení nižšího počtu minimálních připojení.

    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ři připojení. Pokud chcete toto riziko snížit, zvažte použití menšího počtu připojení. Příkazy nebo dávky příkazů můžete efektivně zpracovávat přes několik připojení.

  • V případě potřeby resetujte časový limit nečinných připojení. Redisson má výchozí 10sekundový časový limit nečinného připojení, což může vést k většímu zavření a opětovnému otevření připojení, než je ideální.

  • Informace o použití Redissonu s Java EE JCache k uložení stavu relace HTTP v clusteru Azure Kubernetes Service (AKS) najdete v tématu Použití Azure Redis jako mezipaměti relací pro WebSphere Liberty nebo Open Liberty.

  • Pro režim clusteru použijte následující doporučenou základní konfiguraci a podle potřeby ji upravte.

    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