Cheatsheet

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

Published on March 23, 2020
Default avatar

By Mark Drake

Manager, Developer Education

Português
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:

  1. sudo nano /etc/redis/redis.conf

Atenção: O comando config set é considerado perigoso. Ao alterar seu arquivo de configuração do Redis, é possível que seu servidor Redis se comporte de maneiras inesperadas ou indesejáveis. Recomendamos que você execute o comando config set apenas se estiver testando seu comportamento ou se tiver certeza absoluta de que deseja fazer alterações na configuração do Redis.

Pode ser do seu interesse renomear este comando (veja o Passo 5) para algo com menor probabilidade de ser executado acidentalmente.

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:

  1. 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:

  1. 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.

Nota: Nem todos os parâmetros no arquivo redis.conf podem ser alterados com uma operação config set. Por exemplo, você não pode alterar a senha de autenticação definida pelo parâmetro requirepass.

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:

  1. 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:

  1. 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.

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about us


About the authors
Default avatar

Manager, Developer Education

Technical Writer @ DigitalOcean



Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
Leave a comment


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more
DigitalOcean Cloud Control Panel