Compartilhar via


Bibliotecas do Cliente Redis Gerenciado do Azure

Este artigo ajuda você a escolher e usar as melhores bibliotecas de cliente para Redis Gerenciados do Azure. Você aprende quais bibliotecas usar para sua linguagem de programação, como lidar com políticas de clustering e evitar problemas comuns de conexão.

O Redis Gerenciado do Azure é baseado no popular repositório de dados na memória, o Redis. Os clientes Redis para muitas linguagens de programação podem acessar o Redis Gerenciado do Azure. Cada biblioteca de clientes tem sua própria API, que faz chamadas para o servidor Redis usando os comandos os Redis, mas as bibliotecas de clientes são criadas para se comunicar com qualquer servidor Redis.

Cada biblioteca de clientes mantém a própria documentação de referência. As biblioteca também fornecem links para obter suporte por meio da comunidade de desenvolvedores da biblioteca de clientes. A equipe do Azure Managed Redis não desenvolve nem oferece suporte direto para nenhuma biblioteca de clientes.

As seguintes recomendações são baseadas na popularidade e se há uma comunidade online ativa para dar suporte e responder às suas perguntas. Só recomendamos usar a versão mais recente disponível e atualizar regularmente, à medida que novas versões forem disponibilizadas. Essas bibliotecas estão em desenvolvimento ativo e geralmente lançam novas versões com melhorias de confiabilidade e desempenho.

Biblioteca do cliente Linguagem RepositórioGitHub Documentação
StackExchange.Redis C# / .NET StackExchange.Redis GitHub Documentos do StackExchange.Redis
Lettuce Java Lettuce GitHub Documentação Lettuce
Jedis Java Jedis GitHub Documentação dos Jedis
node_redis Node.js node_redis GitHub documentação do node_redis
ioredis Node.js ioredis GitHub Referência da API ioredis

Observação

Seu aplicativo pode usar qualquer biblioteca de cliente compatível com o Redis de software livre para se conectar à instância do Redis Gerenciado do Azure.

Como escolher a biblioteca de clientes correta com base na política de clustering

O Azure Managed Redis oferece suporte à política de clustering Enterprise e à política de clustering de OSS (software de código aberto). Veja mais informações aqui (adicionar o link às informações da política de clustering).

Todas as bibliotecas de cliente operam com sua instância Redis com a política de clustering Enterprise. No entanto, se você estiver usando a política de clustering do OSS, verifique se a biblioteca de clientes selecionada dá suporte à conexão com instâncias do Redis clusterizadas.

Comandos bloqueados

A Microsoft gerencia a configuração e o gerenciamento de instâncias dos Redis Gerenciado pelo Azure, o que desabilita os comandos a seguir por padrão. Para mais informações sobre comandos bloqueados, confira o artigo Compatibilidade de comandos de gerenciamento de cluster

Comandos de várias chaves

Como as camadas do ARM usam uma configuração clusterizada, você pode conferir exceções CROSSSLOT em comandos que operam em várias chaves. O comportamento varia dependendo da política de clustering usada. Se você usar a política de clustering do OSS, os comandos de várias chaves exigirão que todas as chaves sejam mapeadas para o mesmo slot de hash.

Você também pode ver CROSSSLOT erros com a política de clustering Enterprise. Somente os seguintes comandos de várias chaves são permitidos entre slots com clustering Enterprise: DEL, MSET, MGET, EXISTS, UNLINK e TOUCH.

Em bancos de dados Active-Active, os comandos de gravação de várias chaves (DEL, MSET, UNLINK) só podem ser executados em chaves que estão no mesmo slot. No entanto, os seguintes comandos multichave são permitidos entre slots em bancos de dados Active-Active: MGET, EXISTS e TOUCH. Para obter mais informações, consulte clustering banco de dados.

Comandos bloqueados para a política de clustering Enterprise

  • INFORMAÇÕES DO CLUSTER
  • CLUSTER HELP
  • CLUSTER KEYSLOT
  • CLUSTER NODES
  • CLUSTER SLOTS

Comandos bloqueados para replicação geográfica ativa

  • FLUSHALL
  • FLUSHDB

Diretrizes específicas para a biblioteca de clientes

Escolha sua linguagem de programação para obter práticas recomendadas detalhadas e diretrizes de conexão:

Como usar as bibliotecas de clientes

Além da documentação de referência, você pode encontrar tutoriais que mostram como começar a usar o Azure Managed Redis por meio de diferentes linguagens e clientes de cache.

Para obter mais informações sobre como usar algumas dessas bibliotecas de clientes em tutoriais, confira os seguintes artigos:

Próximas etapas