Como listar bancos de dados usando a ferramenta de linha de comando psql

Introdução

Versão curta: use \l ou \list para listar todos os bancos de dados no psql. No entanto, isso mostra apenas as informações mais básicas sobre cada banco. Se você precisa de mais detalhes sobre cada banco de dados, continue lendo.

Passo 1: Garanta que você tem acesso ao ‘psql’

Primeiro, garanta que você tem acesso ao utilitário de linha de comando do PostgreSQL, o psql. Para iniciar o psql, abra o terminal e digite:

psql -U username -d dbname

Substitua username pelo nome de usuário da sua role do PostgreSQL e dbname por qualquer banco de dados ao qual o usuário tenha acesso. Se você estiver acessando o banco padrão do PostgreSQL para a configuração inicial, pode usar postgres como dbname.

Passo 2: Listando bancos de dados

Dentro da interface do psql, listar todos os bancos de dados é simples. Use o seguinte comando:

\l

ou

\list

Esses comandos exibem uma lista de todos os bancos de dados com seus donos, encoding, configurações de collation e privilégios de acesso. Veja um exemplo de como a saída pode ficar:

                                 List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges   
-----------+----------+----------+-------------+-------------+-----------------------
 postgres  | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 template0 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
 template1 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
           |          |          |             |             | postgres=CTc/postgres
 mydb      | dbuser   | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 

Entendendo a saída

• Name: o nome do banco de dados.
• Owner: a role dona do banco de dados.
• Encoding: esquema de codificação de caracteres usado pelo banco de dados.
• Collate: ordem de collation (ou seja, como as strings são ordenadas).
• Ctype: classificação de caracteres (por exemplo, letra, dígito).
• Access privileges: privilégios de acesso personalizados, se houver.

Adicione um ‘+’ para obter mais informações

O psql usa + junto com outros comandos para exibir a saída do comando de forma expandida. Isso é especialmente útil quando você quer informações mais detalhadas ou quando a saída padrão é compacta demais ou fica cortada.

Para listar, execute \l+ e veja informações extras sobre cada banco de dados

Esse comando exibe detalhes adicionais sobre cada banco de dados, como:

• Size: o espaço físico em disco usado pelo banco de dados.
• Description: quaisquer comentários adicionados ao banco de dados.

Listando roles e permissões com ‘\du’

O comando \du exibe a lista de roles do banco de dados PostgreSQL com seus privilégios associados.

A saída inclui colunas como:

• Role name
• Attributes: lista atributos globais, como permissões de login, status de superusuário, herança de roles etc.
• Member of: outras roles das quais essa role faz parte.

Listando informações de tablespaces com ‘\db’

O comando \db fornece informações sobre tablespaces, que são os locais de armazenamento onde os bancos de dados PostgreSQL guardam seus arquivos.

Ele exibe detalhes sobre cada tablespace, incluindo:

• Name: o nome do tablespace.
• Owner: a role do PostgreSQL dona do tablespace.
• Location: o caminho do diretório do tablespace no disco.
• Size: o tamanho do tablespace.

Obtendo informações detalhadas dos bancos de dados em ‘pg_catalog.pg_database’

O PostgreSQL armazena metadados sobre todos os bancos de dados no catálogo do sistema pg_catalog.pg_database. Consultar esse catálogo pode trazer detalhes completos sobre os bancos de dados.

Exemplo de consulta SQL

Para obter informações detalhadas sobre os bancos de dados:

SELECT datname AS database_name, 
       pg_size_pretty(pg_database_size(datname)) AS size,
       datallowconn AS allow_connections,
       datconnlimit AS connection_limit,
       encoding, 
       datcollate, 
       datctype 
FROM pg_catalog.pg_database;

Entendendo a saída

• database_name: nome do banco de dados.
• size: tamanho do banco de dados em formato legível.
• allow_connections: indica se o banco de dados permite conexões (true ou false).
• connection_limit: o número máximo de conexões simultâneas permitidas (-1 significa sem limite).
• encoding: ID numérico do encoding do banco de dados.
• datcollate: configuração de collation do banco de dados.
• datctype: configuração de tipo de caractere do banco de dados.

Essa consulta oferece uma visão das configurações do banco de dados.

Só apontar e clicar com o Beekeeper Studio

O Beekeeper Studio lista todos os bancos de dados em um menu suspenso no topo da interface, e você pode alternar entre eles a qualquer momento.

Baixar o Beekeeper Studio

Resumo

Resumindo: liste todos os bancos de dados no psql usando \l. Para obter informações mais detalhadas, use os outros comandos apresentados neste tutorial.