Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda> Distributed Cache Service> Guia de usuário> Acessando uma instância do DCS Redis> Acesso em diferentes idiomas> redis-cli

Atualizado em 2022-11-08 GMT+08:00

Ver PDF

redis-cli

Esta seção descreve como usar o redis-cli em um ECS na mesma VPC que uma instância do DCS Redis para se conectar à instância. Para obter detalhes sobre mais clientes, consulte o site oficial do Redis.

Para obter mais informações sobre como acessar uma instância do DCS Redis em redes públicas, consulte Passo 3: Acessar uma instância do DCS Redis no Windows.

O Redis 3.0 não suporta personalização de portas e permite apenas a porta 6379. Para Redis 4.0 e 5.0, você pode especificar uma porta ou usar a porta padrão 6379. O seguinte usa a porta padrão 6379. Se você especificou uma porta, substitua 6379 pela porta real.
When connecting to a Redis Cluster instance, ensure that -c is added to the command. Caso contrário, a conexão falhará.
- Execute o seguinte comando para conectar-se a uma instância do Cluster do Redis:
  ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} -c
- Execute o seguinte comando para se conectar a uma instância de cluster de proxy, principal/em espera ou de nó único:
  ./redis-cli -h {dcs_instance_address} -p 6379 -a {password}
Para mais detalhes, consulte 3.

Pré-requisitos

Uma instância do DCS Redis foi criada e está no estado Running.
Foi criado um ECS. Para obter detalhes sobre como criar um ECS, consulte Comprando um ECS .
Se o ECS executar o SO de Linux, verifique se o ambiente de compilação GCC foi instalado no ECS.

Procedimento (Linux)

Visualize o endereço IP/nome do domínio e o número da porta da instância do DCS Redis a ser acessada.
Para mais detalhes, consulte Exibindo Detalhes da Instância.
Para obter detalhes sobre como instalar o cliente redis-cli, consulte as instruções oficiais do Redis.
As etapas a seguir pressupõem que seu cliente esteja instalado no SO de Linux.
1. Acesse o ECS.
2. Execute o seguinte comando para baixar o pacote de código-fonte do seu cliente Redis do http://download.redis.io/releases/redis-5.0.8.tar.gz:
  wget http://download.redis.io/releases/redis-5.0.8.tar.gz
3. Execute o seguinte comando para descompactar o pacote de código-fonte do seu cliente Redis:
  tar -xzf redis-5.0.8.tar.gz
4. Execute os seguintes comandos para ir para o diretório do Redis e compilar o código-fonte do seu cliente Redis:
  cd redis-5.0.8
  
  make
  
  cd src
Acesse a instância do DCS Redis.
- Acessar uma instância de DCS de um tipo diferente do Cluster do Redis.
  Execute o procedimento a seguir para acessar uma instância do DCS Redis 3.0 ou uma instância do DCS Redis 4.0 ou 5.0 de cluster de nó único, principal/em espera ou proxy.
  1. Execute o seguinte comando para acessar a instância do DCS Redis escolhida:
    ./redis-cli -h {dcs_instance_address} -p 6379
    
    {dcs_instance_address} indica o endereço IP/nome de domínio da instância DCS e 6379 é a porta usada para acessar a instância. O endereço IP/nome do domínio e o número da porta são obtidos em 1.
    Para uma instância do Cluster de Proxy DCS Redis, você pode usar Connection Address ou IP Address para {dcs_instance_address}. Os endereços podem ser obtidos na página de informações básicas da instância no console, conforme mostrado na Figura 1.
    
    Connection Address e IP Address são os endereços LB. As solicitações são distribuídas pelos nós proxy.
    
    Você pode usar Backend Addresses para se conectar diretamente ao nó proxy especificado de uma instância do DCS Redis 3.0 de cluster de proxy.
    Figura 1 Obtendo os endereços para conexão a instâncias de DCS do Cluster de Proxy
    
    O exemplo a seguir usa o endereço de nome de domínio de uma instância do DCS Redis. Altere o nome de domínio e a porta conforme necessário.
```
[root@ecs-redis redis-5.0.8]# cd src
[root@ecs-redis src]# ./redis-cli -h redis-069949a-dcs-lxy.dcs.huaweicloud.com -p 6379
redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> 
```
  2. Se você definiu uma senha para a instância do DCS, digite a senha nesta etapa. Você pode ler e gravar dados em cache somente depois que a senha for verificada.
    auth {password}
    
    {password} indica a senha usada para efetuar login na instância do DCS Redis escolhida. Essa senha é definida durante a criação da instância do DCS Redis.
    
    A saída do comando é a seguinte:
```
redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> auth *******
OK
redis-069949a-dcs-lxy.dcs.huaweicloud.com:6379> 
```
- Acesse uma instância de DCS do tipo Cluster do Redis.
  Execute o procedimento a seguir para acessar uma instância do DCS Redis 4.0 ou 5.0 no tipo de cluster do Redis.
  1. Execute o seguinte comando para acessar a instância do DCS Redis escolhida:
    ./redis-cli -h {dcs_instance_address} -p 6379 -a {password} -c
    
    {dcs_instance_address} indica o endereço IP/nome de domínio da instância do DCS Redis, 6379 é a porta usada para acessar a instância, {password} é a senha da instância, e -c é usado para acessar nós do Cluster do Redis. O endereço IP/nome do domínio e o número da porta são obtidos em 1.
    Você pode definir {dcs_instance_address} como Connection Address ou IP Address na seção Connection ou IP Address na seção Instance Topology. Os endereços podem ser obtidos na página de informações básicas da instância no console, conforme mostrado na Figura 2.
    
    O campo IP Address fornece dois endereços IP. Você pode usar qualquer um deles para se conectar à instância. O algoritmo CRC16 (chave) mod 16384 é usado para calcular o que é o slot de hash de uma determinada chave.
    
    Usando o IP Address na seção Instance Topology, você pode se conectar ao estilhaço especificado.
    Figura 2 Obtendo os endereços para conexão com uma instância de DCS do Cluster do Redis
    - O exemplo a seguir usa o endereço IP de uma instância do DCS Redis. Altere o endereço IP e a porta conforme necessário.
```
root@ecs-redis:~/redis-5.0.8/src# ./redis-cli -h 192.168.0.85 -p 6379 -a ****** -c
192.168.0.85:6379> 
```
    - O exemplo a seguir usa o nome de domínio de uma instância do DCS Redis. Altere o nome de domínio e a porta conforme necessário.
```
root@ecs-redis:~/redis-5.0.8/src# ./redis-cli -h redis-51e463c-dcs-lxy.dcs.huaweicloud.com -p 6379 -a ****** -c
redis-51e463c-dcs-lxy.dcs.huaweicloud.com:6379> 
```
  2. Execute o seguinte comando para exibir as informações de nó do Cluster do Redis:
    cluster nodes
    
    Cada estilhaço em um cluster do Redis tem um principal e uma réplica por padrão. O comando procedente fornece todas as informações dos nós do cluster.
```
192.168.0.85:6379> cluster nodes
0988ae8fd3686074c9afdcce73d7878c81a33ddc 192.168.0.231:6379@16379 slave f0141816260ca5029c56333095f015c7a058f113 0 1568084030
000 3 connected
1a32d809c0b743bd83b5e1c277d5d201d0140b75 192.168.0.85:6379@16379 myself,master - 0 1568084030000 2 connected 5461-10922
c8ad7af9a12cce3c8e416fb67bd6ec9207f0082d 192.168.0.130:6379@16379 slave 1a32d809c0b743bd83b5e1c277d5d201d0140b75 0 1568084031
000 2 connected
7ca218299c254b5da939f8e60a940ac8171adc27 192.168.0.22:6379@16379 master - 0 1568084030000 1 connected 0-5460
f0141816260ca5029c56333095f015c7a058f113 192.168.0.170:6379@16379 master - 0 1568084031992 3 connected 10923-16383
19b1a400815396c6223963b013ec934a657bdc52 192.168.0.161:6379@16379 slave 7ca218299c254b5da939f8e60a940ac8171adc27 0 1568084031
000 1 connected
```
    As operações de gravação só podem ser executadas em nós principais. O algoritmo CRC16 (chave) mod 16384 é usado para calcular qual é o slot de hash de uma determinada chave.
    
    Conforme mostrado a seguir, o valor do CRC16 (KEY) mode 16384 determina o hash slot em que uma determinada chave está localizada e redireciona o cliente para o nó em que o hash slot está localizado.
```
192.168.0.170:6379> set hello world
-> Redirected to slot [866] located at 192.168.0.22:6379
OK
192.168.0.22:6379> set happy day
OK
192.168.0.22:6379> set abc 123
-> Redirected to slot [7638] located at 192.168.0.85:6379
OK
192.168.0.85:6379> get hello
-> Redirected to slot [866] located at 192.168.0.22:6379
"world"
192.168.0.22:6379> get abc
-> Redirected to slot [7638] located at 192.168.0.85:6379
"123"
192.168.0.85:6379> 
```

Procedimento (Windows)

Download o pacote de instalação do cliente Windows Redis. Descompacte o pacote, abra a ferramenta CLI cmd.exe e vá para o diretório onde o pacote de instalação do cliente Redis descompactado foi salvo. Em seguida, execute o seguinte comando para acessar a instância do DCS Redis:

redis-cli -h XXX -p 6379

XXX indica o endereço IP/nome de domínio da instância DCS e 6379 é um número de porta de exemplo usado para acessar a instância DCS. Para obter detalhes sobre como obter o endereço IP/nome do domínio e a porta, consulte Exibindo Detalhes da Instância. Altere o endereço IP/nome do domínio e a porta conforme necessário.

Tópico principal: Acesso em diferentes idiomas

Tópico anterior: Acesso em diferentes idiomas

Próximo tópico: Java