Клиентские библиотеки

  • Статья

Кэш Azure для Redis основан на популярном продукте с открытым кодом — выполняющемся в памяти хранилище данных, Redis с открытым кодом. Доступ к кэшу Azure для Redis можно получить с помощью широкого спектра клиентов Redis для многих языков программирования. Каждая клиентская библиотека имеет собственный API, который вызывает сервер Redis с помощью команд Redis, но клиентские библиотеки создаются для взаимодействия с любым сервером Redis.

У каждого клиента собственная справочная документация для его библиотеки. Клиенты также предоставляют ссылки для получения поддержки через сообщество разработчиков клиентской библиотеки. Команда Кэш Azure для Redis не владеет разработкой и не осуществляет поддержку каких-либо клиентских библиотек.

Несмотря на то, что мы не имеем и не поддерживаем какие-либо клиентские библиотеки, мы рекомендуем некоторые из них. Рекомендации основаны на популярности и наличии активного онлайн-сообщества для поддержки и ответа на ваши вопросы. Мы рекомендуем использовать последнюю доступную версию и регулярно проводить обновления по мере того, как новые версии становятся доступными. Эти библиотеки находятся в активной разработке, и часто выпускаются новые версии с улучшениями в области надежности и производительности.

Клиентская библиотека Язык РепозиторийGitHub Документация
StackExchange.Redis C#/.NET Ссылка См. подробнее здесь
Lettuce Java Ссылка См. подробнее здесь
Jedis Java Ссылка
node_redis Node.js Ссылка
Redisson Java Ссылка См. подробнее здесь
ioredis. Node.js Ссылка См. подробнее здесь

Примечание

Приложение может подключаться к и использовать экземпляр Кэш Azure для Redis с любой клиентской библиотекой, которая также может взаимодействовать с Redis с открытым кодом.

Особые рекомендации для клиентских библиотек

Дополнительные сведения о рекомендациях для конкретной клиентской библиотеки см. по следующим ссылкам:

Redisson (Java)

Рекомендуется использовать redisson 3.14.1 или более поздней версии. В более старых версиях содержатся известные проблемы с утечкой подключений, которые вызывают проблемы после отработки отказа. Отслеживайте журнал изменений Redisson на наличие других известных проблем, которые могут повлиять на функции, используемые приложением. Дополнительные сведения смCHANGELOG . в разделах и часто задаваемых вопросов о Redisson.

Другие примечания:

  • Redisson по умолчанию использует стратегию "чтение из реплики", в отличие от некоторых других клиентов. Чтобы изменить это значение, измените параметр конфигурации readMode.
  • Redisson имеет стратегию создания пулов подключений с настраиваемыми минимальными и максимальными параметрами, а минимальные значения по умолчанию являются большими. Большие значения по умолчанию могут способствовать агрессивному поведению повторного подключения или "бурям подключений". Чтобы снизить риск, рассмотрите возможность использования меньшего количества подключений, так как вы можете эффективно конвейерировать команды или пакеты команд для нескольких подключений.
  • По умолчанию в Redisson время ожидания простоя подключения равно 10 секундам, что приводит к большему закрытию и повторному открытию подключений, чем в идеале.

Ниже приведена рекомендуемая базовая конфигурация для режима кластера, которую можно изменить при необходимости:

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

Статью, демонстрирующую, как использовать поддержку Redisson для JCache в качестве хранилища для состояния сеанса HTTP в IBM Liberty в Azure, см. в статье Использование Java EE JCache с Open Liberty или WebSphere Liberty в кластере Служба Azure Kubernetes (AKS).

Использование клиентских библиотек

Помимо справочной документации можно найти учебники, показывающие, как приступить к работе с Кэшем Azure для Redis, используя разные языки и клиенты кэша.

Дополнительные сведения учебных пособий об использовании некоторых из этих клиентских библиотек см. в следующих статьях:

Дальнейшие действия