No psql, \l lista os bancos de dados, \c dbname conecta a um deles e \dt lista as tabelas do banco atual. Em SQL ou em qualquer outro cliente, consulte os catálogos: pg_database para os bancos e information_schema.tables para as tabelas.
O resultado traz as duas tabelas como BASE TABLE e a view como VIEW, todas no schema public. O filtro WHERE esconde os catálogos do sistema, que adicionariam centenas de linhas. Acrescente AND table_type = 'BASE TABLE' para deixar as views de fora.
Comandos do psql para bancos e tabelas
São metacomandos do psql. O psql transforma cada um numa consulta aos catálogos, então eles não funcionam em outros clientes nem no código da aplicação.
| Comando | Mostra |
|---|---|
\l | Os bancos de dados (\l+ adiciona os tamanhos) |
\c shop | Conecta ao banco shop |
\conninfo | O banco, o usuário e o host em que você está |
\dn | Os schemas |
\dt | As tabelas dos schemas no seu search_path |
\dt sales.* | As tabelas do schema sales |
\dt *.* | As tabelas de todos os schemas, inclusive os do sistema |
\dt+ | As tabelas com tamanho e descrição |
\dv, \di, \ds | Views, índices, sequences |
\d orders | Colunas, índices e restrições de orders |
\d+ orders | O mesmo, mais armazenamento e comentários |
\du | Os roles |
No terminal, psql -l imprime a lista de bancos e sai, e -c executa um único comando:
psql -l
psql -d shop -c '\dt'
Inicie o psql com -E para ver o SQL por trás de cada metacomando. É um jeito rápido de aprender as tabelas do catálogo.
Listar bancos de dados com SQL
Cada banco do servidor é uma linha em pg_database. template0 e template1 são os modelos que o CREATE DATABASE copia, então filtre os dois:
Nesta página, cada execução recebe um banco novo cujo nome começa com lesson_. O resultado mostra esse banco e o postgres, o banco padrão que todo servidor cria. SELECT current_database() retorna o banco em que você está conectado.
Descrever as colunas de uma tabela
No psql, \d orders descreve a tabela. Em SQL, information_schema.columns tem uma linha por coluna:
id mostra NO em is_nullable porque uma chave primária é sempre NOT NULL. O column_default dela fica vazio: uma coluna identity recebe valores de uma sequence, não de um valor padrão.
Consultar o pg_catalog diretamente
information_schema é a visão do padrão SQL e só mostra objetos sobre os quais você tem algum privilégio. Os catálogos próprios do PostgreSQL em pg_catalog guardam mais coisas, como a definição dos índices:
Aparecem três índices: orders_email_key, do UNIQUE, orders_pkey, da chave primária, e o índice parcial que você criou. Cada um vem com o comando CREATE INDEX que o recriaria. pg_tables lista só tabelas; pg_views e pg_matviews cobrem views e views materializadas.
Contar as linhas de todas as tabelas
Os catálogos não guardam a contagem exata de linhas. pg_class.reltuples tem a estimativa do planejador, que o VACUUM e o ANALYZE atualizam. Ela basta para achar as tabelas grandes, e -1 significa que a tabela nunca foi analisada:
SELECT relname, reltuples::bigint AS estimated_rows
FROM pg_class
WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
ORDER BY reltuples DESC;
Para um número exato, rode SELECT count(*) FROM orders, que lê a tabela inteira. As tabelas do catálogo estão documentadas em System Catalogs, no manual do PostgreSQL.
Perguntas frequentes
O PostgreSQL tem SHOW TABLES ou SHOW DATABASES?
Não, esses são comandos do MySQL. No PostgreSQL, SHOW lê uma configuração do servidor, então SHOW TABLES falha com "unrecognized configuration parameter". Use \dt e \l no psql, ou consulte information_schema.tables e pg_database.
Por que o \dt diz "Did not find any relations"?
Ou você está conectado a um banco diferente daquele que tem as tabelas, ou as tabelas estão num schema que não está no seu search_path. Confira com \conninfo e tente \dt *.* ou \dt schema_name.*.
Como trocar de banco de dados no PostgreSQL?
Uma conexão pertence a um único banco, e o SQL não tem o comando USE. No psql, rode \c other_db, que abre uma nova conexão; pelo terminal, inicie psql -d other_db.
Como ver o tamanho das tabelas no PostgreSQL?
No psql, \dt+ adiciona uma coluna de tamanho. Em SQL, pg_size_pretty(pg_total_relation_size('orders')) mostra o tamanho de uma tabela incluindo os índices e os dados TOAST.