Teilen über


Clientbibliotheken

Von Bedeutung

Azure Cache for Redis hat den Auslaufzeitplan für alle SKUs angekündigt. Es wird empfohlen, Ihren vorhandenen Azure-Cache für Redis-Instanzen in Azure Managed Redis zu verschieben, sobald Möglich.

Weitere Informationen zur Einstellung finden Sie unter:

Der Azure-Cache für Redis basiert auf dem Open-Source-Speicher Redis im Arbeitsspeicher. Redis-Clients für viele Programmiersprachen können auf Azure Redis zugreifen. Ihre Anwendung kann eine beliebige Clientbibliothek verwenden, die mit Open-Source-Redis kompatibel ist, um eine Verbindung mit Ihrem Azure Redis-Cache herzustellen.

Jede Clientbibliothek verfügt über eine eigene API, die Redis-Server mithilfe von Redis-Befehlen aufruft. Die Clientbibliotheken sind für die Kommunikation mit jedem Redis-Server erstellt.

Clients verwalten Referenzdokumentationen für ihre eigenen Bibliotheken und stellen Links bereit, um Support über die Entwicklercommunity der Clientbibliothek zu erhalten. Microsoft und das Azure Redis-Team besitzen nicht die Entwicklung oder Unterstützung für Clientbibliotheken.

Microsoft und Azure Redis empfehlen einige Bibliotheken, je nach Beliebtheit und ob es eine aktive Onlinesupportcommunity gibt, um Fragen zu beantworten. Diese Bibliotheken befinden sich in der aktiven Entwicklung und veröffentlichen häufig neue Versionen mit Zuverlässigkeits- und Leistungsverbesserungen. Microsoft empfiehlt, die neueste verfügbare Version zu verwenden und regelmäßig zu aktualisieren, wenn neue Versionen verfügbar sind.

In der folgenden Tabelle sind Links und Dokumentationen für einige empfohlene Clientbibliotheken aufgeführt.

Clientbibliothek Sprache GitHub-Repository Dokumentation
StackExchange.Redis C#/.NET https://github.com/StackExchange/StackExchange.Redis StackExchange.Redis
Jedis Java https://github.com/redis/jedis
Lettuce Java https://github.com/lettuce-io/ Lettuce – Advanced Java Redis Client
Redisson Java https://github.com/redisson/redisson Redisson – Redis Java-Client Real-Time Data Platform
ioredis Node.js https://github.com/luin/ioredis Klassen
node_redis Node.js https://github.com/redis/node-redis

Hinweis

Ihre Anwendung kann eine beliebige Clientbibliothek verwenden, die mit Open Source Redis kompatibel ist, um eine Verbindung mit Ihrer Azure Redis-Instanz herzustellen.

Spezifische Anleitungen für die Clientbibliothek

Informationen zu spezifischen Anleitungen für Clientbibliotheken und bewährten Methoden finden Sie unter den folgenden Links:

Verwenden von Clientbibliotheken

Neben der Referenzdokumentation können Sie die folgenden Lernprogramme verwenden, um mit Azure Redis mit verschiedenen Sprachen und Cacheclients zu beginnen:

Bewährte Methoden für Redisson (Java)

Hier sind einige empfohlene bewährte Methoden für die Redisson-Clientbibliothek :

  • Verwenden Sie Redisson 3.14.1 oder höher. Ältere Versionen enthalten bekannte Probleme mit Verbindungsverlusten, die nach Failovern zu Problemen führen.

  • Überwachen Sie den Redisson-Änderungsprotokoll auf bekannte Probleme, die sich auf Features auswirken können, die Ihre Anwendung verwendet. Weitere Informationen finden Sie in den Redisson Releases History und den Häufig gestellten Fragen zu Redisson.

  • Ändern Sie die readMode Konfigurationseinstellung, wenn Sie die Lese-aus-Replikatstrategie nicht verwenden möchten. Im Gegensatz zu einigen anderen Clients verwendet Redisson Lesen von Replikaten als Standard.

  • Um das Risiko aggressiver Reconnect-Verhaltensweisen oder Verbindungsstürme zu verringern, sollten Sie weniger Mindestverbindungen festlegen.

    Redisson verfügt über eine Strategie zum Bilden von Verbindungspools mit konfigurierbaren Mindest- und Höchsteinstellungen, wobei die Standardmindestwerte groß sind. Die großen Standardwerte können zu aggressivem Wiederherstellungsverhalten von Verbindungen bzw. sogenannten „Verbindungsstürmen“ beitragen. Um dieses Risiko zu verringern, sollten Sie weniger Verbindungen verwenden. Sie können Befehle oder Batches von Befehlen effizient über mehrere Verbindungen weiterleiten.

  • Setzen Sie das Timeout für die Leerlaufverbindung bei Bedarf zurück. Redisson hat ein standardmäßiges 10-Sekunden-Timeout für Leerlaufverbindungen, was dazu führen kann, dass Verbindungen häufiger als ideal geschlossen und wieder geöffnet werden.

  • Informationen zur Verwendung von Redisson mit Java EE JCache zum Speichern des HTTP-Sitzungszustands in einem Azure Kubernetes Service (AKS)-Cluster finden Sie unter Verwenden von Azure Redis als Sitzungscache für WebSphere Liberty oder Open Liberty.

  • Verwenden Sie die folgende empfohlene Basisplankonfiguration für den Clustermodus, und ändern Sie sie nach Bedarf.

    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