Biblioteki klienta

Azure Cache for Redis opiera się na popularnym magazynie danych typu open source w pamięci, usłudze Redis typu open source. Azure Cache for Redis można uzyskać dostęp do wielu różnych klientów usługi Redis w wielu językach programowania. Każda biblioteka klienta ma własny interfejs API, który wykonuje wywołania serwera Redis przy użyciu poleceń Redis, ale biblioteki klienckie są tworzone w celu komunikacji z dowolnym serwerem Redis.

Każdy klient przechowuje własną dokumentację referencyjną dla swojej biblioteki. Klienci udostępniają również linki umożliwiające uzyskanie pomocy technicznej za pośrednictwem społeczności deweloperów biblioteki klienta. Zespół Azure Cache for Redis nie jest właścicielem programowania ani nie obsługuje żadnych bibliotek klienckich.

Mimo że nie jesteśmy właścicielami ani nie obsługujemy żadnych bibliotek klienckich, zalecamy niektóre biblioteki. Rekomendacje są oparte na popularności i czy istnieje aktywna społeczność online do obsługi i odpowiadania na twoje pytania. Zalecamy tylko korzystanie z najnowszej dostępnej wersji i regularne uaktualnianie w miarę udostępniania nowych wersji. Te biblioteki są aktywnie opracowywane i często udostępniają nowe wersje z ulepszeniami niezawodności i wydajności.

Biblioteka kliencka Język RepozytoriumGitHub Dokumentacja
StackExchange.Redis C#/.NET Link Więcej informacji znajduje się tutaj
Lettuce Java Link Więcej informacji znajduje się tutaj
Jedis Java Link
node_redis Node.js Link
Redisson Java Link Więcej informacji znajduje się tutaj
ioredis Node.js Link Więcej informacji znajduje się tutaj

Uwaga

Aplikacja może nawiązać połączenie i używać wystąpienia Azure Cache for Redis z dowolną biblioteką klienta, która może również komunikować się z usługą Redis typu open source.

Wskazówki dotyczące biblioteki klienta

Aby uzyskać informacje na temat najlepszych rozwiązań dotyczących biblioteki klienta, zobacz następujące linki:

Redisson (Java)

Zalecamy użycie narzędzia redisson 3.14.1 lub nowszego. Starsze wersje zawierają znane problemy z wyciekiem połączeń, które powodują problemy po przejściu w tryb failover. Monitoruj dziennik zmian Redisson pod kątem innych znanych problemów, które mogą mieć wpływ na funkcje używane przez aplikację. Aby uzyskać więcej informacji, zobaczCHANGELOG i Redisson FAQ (Często zadawane pytania dotyczące narzędzia Redisson).

Inne uwagi:

  • Redisson domyślnie określa strategię "odczytu z repliki", w przeciwieństwie do innych klientów. Aby to zmienić, zmodyfikuj ustawienie konfiguracji "readMode".
  • Redisson ma strategię buforowania połączeń z konfigurowalnymi ustawieniami minimalnymi i maksymalnymi, a domyślne wartości minimalne są duże. Duże wartości domyślne mogą przyczynić się do agresywnych zachowań ponownego nawiązywania połączenia lub "burzy połączeń". Aby zmniejszyć ryzyko, rozważ użycie mniejszej liczby połączeń, ponieważ można efektywnie potokować polecenia lub partie poleceń za pośrednictwem kilku połączeń.
  • Redisson ma domyślny limit czasu bezczynności połączenia 10 sekund, co prowadzi do większego zamknięcia i ponownego otwarcia połączeń niż idealne.

Poniżej przedstawiono zalecaną konfigurację punktu odniesienia dla trybu klastra, który można zmodyfikować w razie potrzeby:

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

Aby zapoznać się z artykułem pokazującym, jak używać obsługi usługi JCache przez Redissona jako magazynu stanu sesji HTTP w programie IBM Liberty na platformie Azure, zobacz Używanie usługi Java EE JCache z protokołem Open Liberty lub WebSphere Liberty w klastrze Azure Kubernetes Service (AKS).

Jak używać bibliotek klienckich

Oprócz dokumentacji referencyjnej można znaleźć samouczki pokazujące, jak rozpocząć pracę z Azure Cache for Redis przy użyciu różnych języków i klientów pamięci podręcznej.

Aby uzyskać więcej informacji na temat korzystania z niektórych z tych bibliotek klienckich w samouczkach, zobacz następujące artykuły:

Następne kroki