Поделиться через

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

  • Статья

Кэш 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 Ссылка См. подробнее здесь

Примечание.

Приложение может использовать любую клиентную библиотеку, совместимую с Redis с открытым кодом, для подключения к Кэш Azure для 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, используя разные языки и клиенты кэша.

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

Следующие шаги