Metadados no PostgreSQL
O catálogo do sistema é o conjunto de registros que descreve a estrutura e as informações internas de um banco. No PostgreSQL, esses registros ficam em tabelas consultáveis por SQL. Uma delas, pg_attribute, descreve as colunas dos objetos do banco.
O servidor mantém essa descrição ao criar ou alterar os objetos. Você pode consultá-la para conferir o esquema instalado, por exemplo, durante a investigação de uma migração que deveria ter acrescentado uma coluna.
Consultar as colunas de uma tabela
Neste exemplo didático, a tabela public.clientes já existe. A consulta lê os nomes das suas colunas no catálogo:
SELECT attnameFROM pg_catalog.pg_attributeWHERE attrelid = 'public.clientes'::regclass AND attnum > 0 AND NOT attisdroppedORDER BY attnum;A conversão para regclass identifica a tabela pelo nome. O filtro attnum > 0 exclui as colunas internas do sistema e NOT attisdropped retira as colunas removidas. O resultado contém um nome por linha, na ordem das colunas. Se a migração deveria criar telefone, você procura esse nome no resultado para conferir a estrutura. A consulta falha se a tabela informada não existir.
Alterações diretas nos catálogos podem comprometer o banco. Para criar uma coluna, use o comando de alteração da tabela, que também atualiza seus metadados. A estrutura dos catálogos deve ser consultada na documentação da versão utilizada.
Dúvidas frequentes
Perguntas frequentes sobre catálogo do sistema
- O catálogo guarda o conteúdo das tabelas da aplicação?
- Ele guarda metadados, como a definição de uma coluna. Os valores cadastrados pela aplicação ficam nas tabelas que essa definição descreve.
- Como uma alteração de esquema atualiza o catálogo?
- Comandos como CREATE TABLE registram os metadados necessários durante a criação do objeto. A administração normal usa esses comandos para manter as estruturas coerentes.
- Os catálogos têm a mesma estrutura em todos os bancos?
- Cada sistema define seus próprios catálogos. Uma consulta aos registros internos do PostgreSQL precisa seguir a documentação da versão instalada.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: metadados e catálogos internos
Explica o papel dos metadados e por que as alterações devem usar os comandos SQL de administração.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação ao vivo para investigar diferenças entre o esquema esperado pela aplicação e as tabelas existentes no banco.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você pode conferir no catálogo se as colunas previstas por uma migração já existem no banco utilizado pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.