Digite para filtrar os verbetes do Glossário.

    Banco de dados · Vibe Coding: Do Zero ao MVP

    O que é catálogo do sistema?

    O catálogo do sistema guarda a descrição dos objetos do banco. No PostgreSQL, você pode consultá-lo para conferir tabelas e colunas existentes.

    Também chamado de: system catalog

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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 attname
    FROM pg_catalog.pg_attribute
    WHERE attrelid = 'public.clientes'::regclass
    AND attnum > 0
    AND NOT attisdropped
    ORDER 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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano