Usar ferramentas de cliente para gerenciar dados no Azure Redis Gerenciado

Você pode usar as ferramentas a seguir para acessar e gerenciar dados no Azure Redis Gerenciado como um cliente. Use essas ferramentas para interagir diretamente com sua instância Azure Redis Gerenciada e para depuração e solução de problemas.

• Redis Insight
• ferramenta de linha de comando redis-cli

Insight do Redis

O Redis Insight é uma ferramenta gráfica e de CLI de software livre avançada para emitir comandos Redis e exibir o conteúdo de uma instância do Redis. Funciona com o Azure Redis Gerenciado e com suporte em Linux, Windows e macOS.

Instalar o Redis Insight

Para instalar o Redis Insight, siga as instruções na documentação do Redis Insight.

Configurar o acesso ao Azure Redis Gerenciado com o Redis Insight

O Redis Insight pode autenticar em uma instância gerenciada do Redis do Azure usando Microsoft Entra ID ou autenticação por chave de acesso. É recomendável usar Microsoft Entra ID para melhorar a segurança.

A partir da versão 3.2.0, o Redis Insight pode autenticar no Azure Managed Redis com Microsoft Entra ID usando o fluxo PKCE OAuth 2.0, permitindo a descoberta automática de bancos de dados entre assinaturas e autenticação sem uso de senha.

Para obter instruções sobre como configurar o acesso ao Azure Redis Gerenciado com o Redis Insight, consulte o repositório Redis Insight GitHub. Essa é uma configuração única por locatário Azure.

Conectar-se ao Azure Redis Gerenciado com o Redis Insight

Depois que o acesso Microsoft Entra ID for configurado, conecte-se a uma instância gerenciada Azure Redis no Redis Insight seguindo estas etapas:

1. No Redis Insight, na guia Bancos de Dados Redis , selecione + Conectar banco de dados existente.
2. Na janela Add database, selecione Azure Managed Redis.
3. Siga as instruções para se conectar usando a autenticação do Microsoft Entra ID.
4. Na página Subscription, selecione a assinatura que contém sua instância Azure Redis Gerenciada e selecione Add database.
5. Selecione a instância Azure Redis Gerenciada (banco de dados) à qual você deseja se conectar e selecione Add database. Você pode selecionar vários bancos de dados para se conectar ao mesmo tempo.
6. Repita as etapas anteriores para adicionar instâncias Redis gerenciadas do Azure conforme necessário na mesma assinatura ou em outra.

• Depois de adicionar uma instância Azure Redis Gerenciada, você pode selecioná-la na lista de bancos de dados Redis no Redis Insight e começar a emitir comandos e exibir dados.

• Para acessar a CLI interna, selecione (>_ CLI) na parte inferior da tela do banco de dados selecionado.

ferramenta de linha de comando redis-cli

Use a ferramenta de linha de comando redis-cli para interagir com uma instância do Redis gerenciada Azure como cliente. Use redis_cli como uma maneira leve de emitir comandos e para testes repetíveis em scripts.

Instalar redis-cli

A ferramenta redis-cli é instalada automaticamente com o pacote Redis, que está disponível para vários sistemas operacionais. Consulte o guia código aberto instalar o Redis para obter a documentação mais detalhada sobre seu sistema operacional preferencial.

Linux

redis-cli é executada nativamente no Linux e a maioria das distribuições incluem um pacote Redis que contém a ferramenta redis-cli. No Ubuntu, por exemplo, instale o pacote Redis com os seguintes comandos:

sudo apt-get update
sudo apt-get install redis

Windows

A melhor maneira de usar redis-cli em um computador Windows é instalar o Subsistema do Windows para Linux (WSL). O subsistema linux permite que você execute ferramentas linux diretamente no Windows. Para instalar o WSL, siga as instruções de instalação do WSL.

Depois que o WSL estiver instalado, você poderá instalar redis-cli usando qualquer gerenciamento de pacote disponível na distribuição do Linux que você escolheu para o WSL.

Coletar informações de acesso do cache

Você pode coletar as informações necessárias para acessar o cache usando esses métodos:

• Usando CLI do Azure com o comando az redisenterprise database list-keys
• Azure PowerShell usando Get-AzRedisEnterpriseCacheKey
• Usando o portal Azure

Nesta seção, você recuperará as informações do portal do Azure.

Para conectar seu servidor Redis gerenciado pelo Azure, o cliente de cache precisa do ponto de extremidade de cache, da porta e da chave de acesso ao cache. Alguns clientes podem se referir a esses itens por nomes um pouco diferentes. Você pode obter essas informações no Azure portal.

• Para obter o ponto de extremidade e a porta do cache, selecione Visão geral no menu Recurso . O ponto de extremidade é do formato {yourcachename}.{region}.redis.azure.net. A porta é 10000 para todas as instâncias de Redis Gerenciado do Azure.

• Para obter as chaves de acesso, selecione Autenticação no menu Configurações . Em seguida, selecione a guia Chaves de Acesso . Aqui, você pode encontrar as chaves primária e secundária para o cache. Você pode usar qualquer chave para se conectar à ferramenta cliente.

Conectar-se usando redis-cli

Abra um shell ou terminal em um computador com o pacote Redis instalado. Se estiver usando o WSL, você poderá use o Terminal do Windows para abrir uma linha de comando do Linux. Antes de se conectar a redis-cli, verifique:

1. Se o acesso TLS é necessário – por padrão, Azure instâncias gerenciadas do Redis usam criptografia TLS para conexões. Sempre que o TLS é usado no lado do servidor, o TLS na redis-cli deve ser habilitado usando a opção --tls.
2. A porta usada – todas as instâncias Azure Redis Gerenciadas usam a porta 10000. Observe que isso é diferente do padrão para a edição da comunidade Redis, que é 6379.
3. Se a instância de cache usa a política de cluster do OSS – caso esteja usando a política de cluster do OSS, adicione a opção-c para garantir que todos os fragmentos possam ser acessados.

Exemplos

1. Conecte-se a uma instância do Redis gerenciada pela Azure usando a política de cluster de empresa com TLS:

   redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls
   

2. Conecte-se a uma instância do Redis gerenciada do Azure, usando a política de cluster do OSS e o TLS.

   redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c
   

Testar a conexão

Depois que a conexão for estabelecida, você poderá emitir comandos para sua instância Azure Redis Gerenciada. Uma maneira fácil de testar a conexão é usar o comando PING. Esse comando retorna PONG no console.

yourcachename.region.redis.azure.net:10000> PING
PONG

Você também pode executar comandos como SET e GET:

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

Agora você está conectado à instância do Azure Managed Redis usando a redis-cli.

Conteúdo relacionado

Comece criando uma instância new Azure Managed Redis Instance.