Tair (Redis® OSS-Compatible):Use o redis-cli para se conectar a uma instância

Pré-requisitos

Antes de começar, certifique-se de ter:

• Definido a senha da conta da instância. Use a senha da conta padrão ou crie uma conta standard com sua própria senha. Para alterar ou redefinir uma senha, consulte Alterar ou redefinir a senha.

• Adicionado o endereço IP do seu dispositivo à lista de permissões de IP da instância. Consulte Definir listas de permissões de IP.

• Obtido o endpoint da instância. Consulte Visualizar endpoints.

Qual endpoint e endereço IP usar:

Por padrão, as instâncias possuem apenas um endpoint VPC. Para se conectar pela internet, solicite um endpoint público primeiro.

Instale o redis-cli

O redis-cli é instalado como parte do pacote Redis. A versão do redis-cli não precisa corresponder à versão da sua instância.

Conectar-se a uma instância

1. Acesse o diretório onde o redis-cli está instalado.

   Linux

   Acesse o diretório src dentro da pasta de origem do Redis. Por exemplo, execute cd /home/redis-7.2.0/src.

   macOS

   Acesse o diretório bin do Homebrew. Por exemplo, execute cd /opt/homebrew/bin.

   Windows

   Abra a janela de linha de comando e acesse o diretório onde o redis-cli está localizado.

2. Escolha o comando de conexão

   Antes de executar o comando, confirme dois pontos:

   • Arquitetura da instância: standard ou cluster. Verifique a página de detalhes da instância no console.

   • Tipo de conexão: endpoint VPC ou endpoint público. Isso determina qual hostname usar.

   Selecione o comando correspondente à sua configuração:

   Cenário	Comando
   Arquitetura standard ou arquitetura cluster via endpoint de proxy	./redis-cli -h <hostname> -p <port>
   Arquitetura cluster via endereço de conexão direta	./redis-cli -h <hostname> -p <port> -c

   No Windows PowerShell, substitua ./redis-cli por .\redis-cli .

   Parâmetros:

   Parâmetro	Descrição	Como obter
   <hostname>	Endpoint da instância	Obtenha o endpoint VPC ou endpoint público no console. Consulte Visualizar endpoints.
   <port>	Porta da instância	O padrão é 6379. Para uma porta personalizada, consulte Alterar o endpoint ou a porta.
   -c	Ativar modo cluster	Necessário apenas para instâncias com arquitetura cluster que utilizam um endereço de conexão direta.

   Exemplo:

   ./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379

3. Autentique-se

   Execute o comando AUTH após a conexão:

   AUTH <password>

   O formato da senha depende do tipo de conta:

   Tipo de conta	Formato da senha	Exemplo
   Conta padrão (chamada default ou ID da instância)	Apenas senha	AUTH Rp829dlwa
   Conta standard	user:password	AUTH testaccount:Rp829dlwa

   Se o acesso sem senha via VPC estiver ativado, pule a autenticação e execute os comandos diretamente.

4. Verifique a conexão

   Uma resposta OK do comando AUTH confirma que você está conectado. Execute um teste rápido para verificar o acesso de leitura e escrita:

   set testkey "hello"    # Write a test value
   OK
   get testkey            # Read it back
   "hello"
   set tempkey "bye" EX 5 # Write with a 5-second expiration
   get tempkey
   "bye"
                          # Wait 5 seconds
   get tempkey
   (nil)                  # Key has expired

   Para obter uma lista de comandos compatíveis, consulte Visão geral de comandos.

Solução de problemas

Se a versão secundária da sua instância estiver desatualizada, as mensagens de erro poderão diferir das apresentadas abaixo. Atualize a versão secundária para obter as mensagens de erro mais recentes.

Ao usar ferramentas de terceiros, como RDM, insira a senha no formato user:password no campo de senha.

Tópicos relacionados

• Visão geral de comandos — navegue pelos comandos Redis compatíveis.

• Criar e gerenciar contas — gerencie contas e permissões da instância.