Gerenciar PostgreSQL

O PostgreSQL é um sistema de gerenciamento de banco de dados objeto-relacional de código aberto. É conhecido por sua confiabilidade, escalabilidade e ampla funcionalidade, incluindo suporte a JSON, busca em texto completo, procedimentos armazenados, extensões e muito mais.

Com os bancos de dados PostgreSQL gerenciados da Hostman, você obtém um cluster PostgreSQL totalmente gerenciado, sem configuração manual — tudo é provisionado automaticamente.

Ao criar um cluster, você pode selecionar a versão do PostgreSQL: 14, 15, 16, 17, 18.

Criação de bancos de dados

Ao criar um novo cluster, um banco de dados chamado default_db é adicionado automaticamente.

Você pode adicionar bancos de dados adicionais:

1. Acesse a seção Bancos de dados no painel de controle da Hostman.
2. Clique no cluster.
3. Na aba Bancos de dados, clique em Adicionar.
4. Informe o nome do banco de dados: 3–64 caracteres. Letras, números e caracteres especiais são permitidos.
5. (Opcional) Adicione uma descrição.
6. Clique em Criar.

Importar banco de dados

Para importar um banco de dados:

1. Acesse a seção Bancos de dados no painel de controle da Hostman.
2. Clique no cluster.
3. Na aba Bancos de dados, clique em Importar.
4. Informe os dados de conexão do banco de dados que deseja importar.
5. Clique em Iniciar importação.

Requisitos e limitações

• Acesso de rede: o banco de dados de origem deve estar acessível pela internet a partir de qualquer endereço IP. Caso contrário, a importação não será iniciada.
• Nome exclusivo: o cluster de destino não pode conter um banco de dados com o mesmo nome.
• Compatibilidade de versões: a importação permite transferir dados entre diferentes versões do PostgreSQL (por exemplo, da 17 para a 18). No entanto, algumas extensões e parâmetros podem ser incompatíveis ou variar entre versões.

O que será transferido:

• Estruturas de tabelas
• Índices
• Dados das tabelas

O que não será transferido:

• Usuários e funções (roles)
• Extensões

Você precisará criar os usuários e instalar as extensões necessárias manualmente no novo banco de dados.

Usuários e privilégios

No painel de controle, você pode gerenciar usuários PostgreSQL e seus privilégios.

Criar usuários

1. Acesse a seção Bancos de dados e clique no cluster.
2. Abra a aba Usuários e clique em Adicionar.
3. Defina o nome de usuário e a senha:
   • Nome de usuário: 3–64 caracteres. Letras, números e caracteres especiais são permitidos.
   • Senha: 8–30 caracteres. Letras, números e caracteres especiais são permitidos.
4. (Opcional) Configure os privilégios do usuário. Você também pode manter os valores padrão e alterá-los depois.
5. Clique em Criar.

Modificar privilégios

Para atualizar os privilégios de um usuário existente:

1. Acesse Bancos de dados e clique no cluster.
2. Abra a aba Usuários.
3. Clique nos três pontos ao lado do usuário.
4. Selecione Privilégios.
5. Escolha os privilégios necessários. Você pode conceder acesso a um banco específico ou aplicar os mesmos privilégios a todos os bancos ativando Idêntico para todos os bancos de dados.

Privilégios disponíveis

Alterar senha

Você pode alterar a senha do usuário:

1. Acesse Bancos de dados e clique no cluster.
2. Vá para a aba Usuários.
3. Clique nos três pontos ao lado do usuário.
4. Selecione Alterar senha.
5. Informe a nova senha e salve as alterações.

Extensões

As extensões do PostgreSQL permitem ampliar a funcionalidade do banco de dados adicionando recursos extras para tarefas específicas. Para mais informações, consulte a documentação oficial do PostgreSQL.

Ativar extensões

Para ativar ou desativar extensões:

1. Acesse Bancos de dados e clique no cluster.
2. Abra a aba Configuração.
3. Clique em Modificar ao lado de Extensões.
4. Selecione o banco de dados e as extensões necessárias. Para aplicar as mesmas extensões a todos os bancos do cluster, ative Usar as mesmas extensões para todos os bancos de dados.

Lista de extensões

Parâmetros do banco de dados

Você pode alterar as configurações do banco de dados para otimizar o desempenho.

Por padrão, o banco é criado com parâmetros adequados para a maioria dos cenários e compatíveis com a configuração selecionada. No entanto, se o seu projeto exigir ajustes específicos, você pode modificá-los conforme necessário.

Altere os parâmetros com cuidado. Configurações incorretas podem afetar negativamente a estabilidade e o desempenho do banco de dados.

Alterar parâmetros

1. Acesse a seção Bancos de dados e clique no cluster.
2. Abra a aba Configuração.
3. Clique em Modificar parâmetros ao lado de Parâmetros do banco de dados.
4. Ajuste os parâmetros. Para saber mais sobre cada um, clique em Abrir descrição ao lado dele.
5. Clique em Aplicar na parte inferior da página.

Lista de parâmetros

Restaurando os parâmetros padrão

Você pode restaurar facilmente as configurações padrão:

1. Acesse Bancos de dados e clique no cluster.
2. Abra a aba Configuração.
3. Clique em Modificar parâmetros ao lado de Parâmetros do banco de dados.
4. Role até o final da página e clique em Restaurar configurações padrão.

Atenção: os parâmetros serão redefinidos imediatamente, sem confirmação adicional.

Conectar ao banco de dados

Você pode se conectar usando o Adminer ou via terminal. O acesso pelo Adminer está disponível apenas se o cluster tiver um IP público.

Adminer

1. Acesse Bancos de dados e clique no cluster.
2. Clique em Interface Web e selecione Adminer.

Terminal

Instale o cliente PostgreSQL:

• Ubuntu/Debian

sudo apt install postgresql-client

• Arch

sudo pacman -S postgresql-libs

• Fedora

sudo dnf install postgresql

Você pode se conectar:

• via IP público
• via IP privado

O comando de conexão pode ser copiado:

• na aba Painel

• ou na aba Conexão

Gerenciar funções (roles)

Um usuário com o privilégio CREATE ROLE pode:

• criar usuários (CREATE USER)
• criar funções (CREATE ROLE)
• gerenciar associações de funções (GRANT ... TO ...)

Criar um usuário

Um usuário é uma função (role) que tem permissão para se conectar ao banco de dados. Essa função pode acessar o banco usando um nome de usuário e senha.

Para criar um usuário com senha, execute:

CREATE USER someuser WITH PASSWORD 'password';

Aqui, someuser é o nome do usuário e password é a senha.

O novo usuário aparecerá na aba Usuários logo após a criação.

Criar uma função e atribuir a um usuário

Em vez de conceder permissões diretamente a cada usuário, é recomendado criar funções com os privilégios necessários e depois atribuir os usuários a essas funções.

Vamos criar duas funções: uma com acesso somente leitura e outra com acesso de leitura e escrita.

Função somente leitura:

CREATE ROLE app_reader;

Função leitura/escrita:

CREATE ROLE app_writer;

Atribuindo uma função a um usuário:

GRANT app_writer TO someuser;

Configurar esquemas

Por padrão, todas as tabelas PostgreSQL são criadas no esquema public. Para conceder permissões, crie um novo esquema:

CREATE SCHEMA app_data;

Criando tabelas no novo esquema:

CREATE TABLE app_data.users (
  id SERIAL PRIMARY KEY,
  username VARCHAR(50) NOT NULL,
  email VARCHAR(100) UNIQUE NOT NULL
);

CREATE TABLE app_data.orders (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES app_data.users(id),
  order_date TIMESTAMP DEFAULT now()
);

Concedendo acesso ao esquema para as funções criadas anteriormente:

GRANT USAGE ON SCHEMA app_data TO app_reader;
GRANT USAGE ON SCHEMA app_data TO app_writer;

Concedendo permissão para criar objetos no esquema:

GRANT CREATE ON SCHEMA app_data TO app_writer;

Permissões de tabelas

Concedendo acesso de leitura a todas as tabelas existentes no esquema:

GRANT SELECT ON ALL TABLES IN SCHEMA app_data TO app_reader;

Concedendo acesso de leitura e escrita:

GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA app_data TO app_writer;

Definindo permissões padrão para novas tabelas:

ALTER DEFAULT PRIVILEGES IN SCHEMA app_data
GRANT SELECT ON TABLES TO app_reader;

ALTER DEFAULT PRIVILEGES IN SCHEMA app_data
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_writer;

E permissões padrão para novas sequências:

ALTER DEFAULT PRIVILEGES IN SCHEMA app_data
GRANT USAGE, SELECT ON SEQUENCES TO app_writer;

Criar um dump

Para criar um dump, execute:

pg_dump -x 'postgresql://<user>:<password>@<host>:5432/<db>' | gzip > default_db.sql.gz

A opção -x (--no-privileges) exclui os comandos GRANT e REVOKE do dump, pois o gerenciamento de permissões é feito pelo painel de controle.

Sem essa opção, podem ocorrer erros ao carregar o dump, mas eles não afetam a restauração dos dados.

Carregar um dump

Para carregar um dump, execute:

zcat default_db.sql.gz | psql 'postgresql://<user>:<password>@<host>:5432/<db>'

Esse comando descompacta o dump e o envia ao cliente PostgreSQL para execução.

Limitações do plano básico

O plano básico de banco de dados (1 CPU / 1 GB de RAM / 20 GB NVMe) possui as seguintes limitações técnicas:

• Não é possível adicionar bancos de dados adicionais
• Não é possível adicionar usuários adicionais
• Não é possível configurar os seguintes parâmetros:
  • shared_buffers
  • effective_cache_size
  • maintenance_work_mem
  • max_connections