Como Alterar a Configuração do Redis pela Linha de Comando

Introdução

O Redis é um datastore ou armazenamento de dados open-source de chave-valor na memória. O Redis possui vários comandos que lhe permitem fazer rapidamente alterações nas definições de configuração do servidor Redis. Este tutorial abordará alguns desses comandos e também explicará como tornar permanentes essas alterações de configuração.

Como Utilizar Este Guia

Este guia está no formato de referência rápida com trechos de linha de comando independentes. Recomendamos que você pule para qualquer seção que seja relevante para a tarefa que você está tentando concluir.

Os comandos mostrados neste guia foram testados em um servidor Ubuntu 18.04 executando a versão 4.0.9 do Redis. Para configurar um ambiente semelhante, você pode seguir o Passo 1 do nosso guia Como Instalar e Proteger o Redis no Ubuntu 18.04. Vamos demonstrar como esses comandos se comportam executando-os com redis-cli, a interface de linha de comando do Redis. Observe que se você estiver usando uma interface Redis diferente — Redli, por exemplo — a saída exata de certos comandos pode ser diferente.

Esteja ciente de que os bancos de dados Redis gerenciados normalmente não permitem que os usuários alterem o arquivo de configuração. Se você estiver trabalhando com um banco de dados gerenciado da DigitalOcean, os comandos descritos neste guia resultarão em erros.

Alterando a Configuração do Redis

Os comandos descritos nesta seção alterarão o comportamento do servidor Redis apenas durante a sessão atual ou até você executar o comando config rewrite, o que os tornará permanentes. Você pode alterar o arquivo de configuração Redis diretamente, abrindo e editando-o com o seu editor de texto preferido. Por exemplo, você pode usar o nano para fazer isso:

sudo nano /etc/redis/redis.conf

O config set permite que você reconfigure o Redis em tempo de execução sem precisar reiniciar o serviço. Ele usa a seguinte sintaxe:

config set parâmetro valor

Por exemplo, se você quisesse alterar o nome do arquivo de dump de banco de dados que o Redis produzirá depois de executar um comando save, você poderia executar um comando como o seguinte:

config set "dbfilename" "novo_arquivo.rdb"

Se a alteração na configuração for válida, o comando retornará OK. Caso contrário, ele retornará um erro.

Tornando Permanentes as Alterações de Configuração

O config set não altera permanentemente o arquivo de configuração da instância do Redis; apenas altera o comportamento do Redis em tempo de execução. Para editar o redis.conf após executar o comando config set e tornar permanente a configuração da sessão atual, execute config rewrite:

config rewrite

Este comando faz o possível para preservar os comentários e a estrutura geral do arquivo redis.conf original, com apenas alterações mínimas para corresponder às configurações usadas atualmente pelo servidor.

Assim como o config set, se a reescrita for bem-sucedida, o config rewrite retornará OK.

Verificando a Configuração do Redis

Para ler os parâmetros de configuração atuais de um servidor Redis, execute o comando config get. O config get utiliza um único argumento, que pode ser uma correspondência exata de um parâmetro usado no redis.conf ou um glob pattern. Por exemplo:

config get repl*

Dependendo da sua configuração do Redis, este comando pode retornar:

Output
 1) "repl-ping-slave-period"
 2) "10"
 3) "repl-timeout"
 4) "60"
 5) "repl-backlog-size"
 6) "1048576"
 7) "repl-backlog-ttl"
 8) "3600"
 9) "repl-diskless-sync-delay"
10) "5"
11) "repl-disable-tcp-nodelay"
12) "no"
13) "repl-diskless-sync"
14) "no"

Você também pode retornar todos os parâmetros de configuração suportados pelo config set executando config get *.

Conclusão

Este guia detalha os comandos redis-cli usados para fazer alterações no arquivo de configuração de um servidor Redis em tempo real. Se houver outros comandos, argumentos ou procedimentos relacionados que você queira ver neste guia, peça ou faça sugestões nos comentários abaixo.

Para obter mais informações sobre comandos Redis, consulte nossa série de tutoriais Como Gerenciar um Banco de Dados Redis.