Gerenciar PostgreSQL no Railway com CLI e Scoop

Publicado em por

Neste tutorial, veja como gerenciar o banco de dados PostgreSQL no Railway usando o Railway CLI e o Scoop no Windows. Passo a passo para instalar, conectar e executar comandos SQL.

1. Instalando o Scoop no Windows

Para facilitar a instalação de ferramentas no Windows, usamos o Scoop, um gerenciador de pacotes leve e eficiente.

No PowerShell (versão 5.1 ou superior), execute:

powershellCopySet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Isso configura o Scoop no seu sistema, permitindo instalar programas via linha de comando.

2. Instalando o Railway CLI com Scoop

Com o Scoop instalado, basta rodar:

powershellCopyscoop install railway

O Railway CLI é a ferramenta oficial para interagir com seus projetos Railway diretamente pelo terminal, facilitando deploys, gerenciamento e acesso a serviços.

3. Instalando o Cliente PostgreSQL (psql)

Para usar o Railway CLI para conectar ao banco PostgreSQL, é necessário ter o cliente psql instalado localmente.

Baixamos o PostgreSQL completo para Windows no site oficial da EnterpriseDB:

https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

Durante a instalação, certifique-se de marcar a opção Command Line Tools, que inclui o psql.

Após a instalação, adicione o caminho da pasta bin do PostgreSQL (exemplo: C:\Program Files\PostgreSQL\<versão>\bin) à variável de ambiente PATH do Windows para poder usar o comando psql de qualquer lugar.

4. Autenticando no Railway CLI

Após a instalação, faça login na sua conta Railway:

powershellCopyrailway login

Esse comando abrirá o navegador para autenticação segura.

5. Conectando ao Banco PostgreSQL

Para acessar o banco PostgreSQL do seu projeto Railway, use:

powershellCopyrailway connect Postgres

Esse comando abre um prompt interativo do PostgreSQL (psql), onde você pode executar comandos SQL diretamente no banco.

6. Manipulando o Banco de Dados

No prompt do psql aberto pelo Railway CLI, você pode executar comandos SQL, como:

  • Apagar tabelas antigas:
sqlCopyDROPTABLE IF EXISTS counter;
  • Consultar tabelas existentes:
sqlCopy\dt
  • Sair do prompt:
\q

7. Benefícios do Uso do Railway CLI

  • Facilita o gerenciamento remoto do banco e serviços.
  • Permite executar comandos SQL diretamente no ambiente de produção ou desenvolvimento.
  • Integração com deploys e logs via terminal.
  • Segurança e controle via autenticação.

Conclusão

Com o Railway CLI, Scoop e o cliente PostgreSQL instalado, conseguimos uma forma simples, segura e eficiente de manipular nosso banco PostgreSQL no Railway, desde a instalação até a execução de comandos SQL essenciais para manutenção e desenvolvimento.

Se você está começando com Railway e PostgreSQL, essa é uma ótima forma de ganhar produtividade e controle total do seu ambiente.

Para saber mais sobre como hospedar seus projetos de forma fácil e rápida, confira nosso post:
Hospedagem de projetos com Railway: fácil, rápida e eficiente