Use ferramentas de cliente para gerir dados no Azure Managed Redis

Pode usar as seguintes ferramentas para aceder e gerir dados no Azure Managed Redis como cliente. Use estas ferramentas para interagir diretamente com a sua instância Azure Managed Redis e para depuração e resolução de problemas.

• Redis Insight
• Ferramenta de linha de comandos redis-cli

Redis Insight

O Redis Insight é uma ferramenta gráfica e CLI rica e open-source para emitir comandos Redis e visualizar o conteúdo de uma instância Reddis. Funciona com o Azure Managed Redis e é suportado 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 Managed Redis com o Redis Insight

O Redis Insight pode autenticar para uma instância Azure Managed Redis usando o Microsoft Entra ID ou autenticação por chave de acesso. Recomendamos o uso do Microsoft Entra ID para maior segurança.

A partir da versão 3.2.0, o Redis Insight pode autenticar-se para Azure Redis Gerido com Microsoft Entra ID usando o fluxo PKCE OAuth 2.0, permitindo a descoberta automática de bases de dados através de subscrições e autenticação sem palavra-passe.

Para instruções para configurar o acesso ao Azure Managed Redis com Redis Insight, consulte o Redis Insight GitHub repositório. Esta é uma configuração única por inquilino do Azure.

Ligue-se ao Azure Managed Redis com Redis Insight

Depois de configurar o acesso ao Microsoft Entra ID, ligue-se a uma instância Azure Managed Redis no Redis Insight seguindo estes passos:

1. No Redis Insight, no separador Redis Databases, selecione + Conectar a uma base de dados existente.
2. Na janela Add database, selecione Azure Managed Redis.
3. Siga as instruções para se ligar usando a autenticação Microsoft Entra ID.
4. Na página Subscrição, selecione a subscrição que contém a sua instância Azure Managed Redis e selecione Adicionar base de dados.
5. Selecione a instância Azure Managed Redis (base de dados) à qual pretende ligar-se e depois selecione Adicionar base de dados. Pode selecionar várias bases de dados para se ligar ao mesmo tempo.
6. Repita os passos anteriores para adicionar instâncias de Azure Managed Redis conforme necessário na mesma ou noutra subscrição do Azure.

• Depois de adicionar uma instância Azure Managed Readis, pode selecioná-la da lista de bases de dados Redis no Redis Insight e começar a emitir comandos e visualizar dados.

• Para aceder à CLI incorporada, selecione (>_ CLI) na parte inferior do ecrã para a base de dados selecionada.

Ferramenta de linha de comandos redis-cli

Use a ferramenta de linha de comandos redis-cli para interagir com uma instância Azure Managed Redis como cliente. Use redis_cli como uma forma 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 open source install Redis para a documentação mais detalhada sobre o seu sistema operativo preferido.

Linux

O redis-cli é executado nativamente no Linux, e a maioria das distribuições inclui um pacote Redis que contém a ferramenta redis-cli . No Ubuntu, por exemplo, você instala o pacote Redis com os seguintes comandos:

sudo apt-get update
sudo apt-get install redis

Windows

A melhor forma de usar redis-cli num computador Windows é instalar o Subsistema Windows para Linux (WSL). O subsistema Linux permite executar 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 o redis-cli usando qualquer gerenciamento de pacotes disponível na distro Linux que você escolheu para o WSL.

Reunir informações de acesso ao cache

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

• CLI do Azure a usar az redisenterprise database list-keys
• Azure PowerShell usar Get-AzRedisEnterpriseCacheKey
• Usando o portal Azure

Nesta secção, recupera a informação do portal Azure.

Para ligar o seu servidor Azure Managed Redis, o cliente de cache precisa do endpoint de cache, da porta e de uma chave para a cache. Alguns clientes podem mencionar esses itens com nomes ligeiramente diferentes. Pode obter esta informação no portal Azure.

• Para obter o endpoint e a porta da sua cache, selecione Visão Geral no menu de Recursos . O ponto final é da forma {yourcachename}.{region}.redis.azure.net. A porta é 10000 para todas as instâncias Azure Redis Geridas.

• Para obter as chaves de acesso, selecione Autenticação no menu de Definições . Depois, selecione o separador de Teclas de Acesso . Aqui, pode encontrar as chaves primária e secundária para a cache. Pode usar qualquer uma das teclas para se ligar à sua ferramenta de cliente.

Conecte-se usando redis-cli

Abra um shell ou terminal em um computador com o pacote Redis instalado. Se usares WSL, podes usar o Terminal do Windows para abrir uma linha de comandos Linux. Antes de se conectar com redis-cli, verifique:

1. Se é necessário acesso TLS - Por defeito, as instâncias Azure Managed Redis usam encriptação TLS para ligações. Sempre que o TLS é usado no lado do servidor, o TLS no redis-cli deve ser habilitado usando a --tls opção.
2. A porta usada - todas as instâncias Azure Managed Redis 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 diretiva de cluster OSS - Se você estiver usando a diretiva de cluster OSS, adicione a -copção para garantir que todos os fragmentos possam ser acessados.

Exemplos

1. Ligue-se a uma instância Azure Managed Redis usando a política de cluster Enterprise com TLS:

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

2. Ligue-se a uma instância Azure Managed Redis usando a política de cluster OSS e TLS:

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

Testando a conexão

Uma vez estabelecida a ligação, pode emitir comandos para a sua instância Azure Managed Redis. Uma maneira fácil de testar a conexão é usar o PING comando. Este comando retorna PONG na consola.

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 está ligado à sua instância Azure Managed Redis usando o redis-cli.

Conteúdo relacionado

Comece por criar uma instância nova Azure Managed Redis Instance.