A estrutura da base de dados do WordPress

By , Founder · Updated

Uma instalação WordPress de site único padrão armazena o seu conteúdo e definições em 12 tabelas de base de dados do núcleo, todas partilhando um prefixo comum (wp_ por predefinição). O WordPress e quase todos os Plugins guardam as suas definições dentro dessa base de dados, organizados nestas tabelas. Este guia explica cada tabela predefinida da base de dados WordPress: o que armazena, o que depende dela e o que parte quando falta ou está corrompida.

Resumo: O WordPress armazena a maior parte dos dados do site numa base de dados MySQL ou MariaDB. Uma instalação WordPress de site único padrão usa atualmente 12 tabelas predefinidas com um prefixo configurável, normalmente wp_. Estas tabelas armazenam publicações, páginas, utilizadores, definições, comentários, termos de taxonomia e metadados, enquanto Plugins, Themes, WooCommerce e instalações Multisite podem adicionar mais tabelas.

Nota: Para inspecionar a tua base de dados WordPress em segurança, faz Backup do teu site ou cria um ambiente de Staging com o WP STAGING. Depois usa uma ferramenta de gestão de base de dados, como o phpMyAdmin ou o Adminer, para aceder e modificar a base de dados sem impacto no site em produção.

Tabelas da base de dados WordPress em síntese

Uma instalação WordPress de site único padrão usa atualmente 12 tabelas predefinidas. A tabela abaixo resume o que cada tabela armazena, onde o WordPress a usa e o que pode partir se a tabela faltar ou estiver corrompida.

Tabela Armazena Usada para O que parte se faltar ou estiver corrompida
wp_options URL do site, Plugins ativos, definições de Theme, transients, regras de rewrite, dados de cron Bootstrap do WordPress, definições de Plugins, configuração do site Redirecionamentos para URL errado, definições em falta, falhas de Plugins, cron partido, options autoload lentos
wp_posts Publicações, páginas, anexos, revisões, menus, tipos de conteúdo personalizados Conteúdo, biblioteca de media, menus de navegação, muitos tipos de dados de Plugins Páginas/publicações/media em falta, menus partidos, entradas de tipos de conteúdo personalizados em falta
wp_postmeta Metadados de publicações, páginas, anexos, produtos, page builders, Plugins SEO Imagens destacadas, dados de produto, campos SEO, layouts de builders Imagens em falta, layouts partidos, dados de produto em falta, metadados SEO incompletos
wp_users Contas de utilizador, logins, hashes de palavra-passe, emails, nomes de exibição Autenticação e autoria Utilizadores não conseguem iniciar sessão, autores desaparecem
wp_usermeta Funções de utilizador, capabilities, campos de perfil, definições de utilizador de Plugins Permissões e definições por utilizador Administrador perde permissões, funções desaparecem, definições de utilizador partem
wp_comments Comentários, pingbacks, trackbacks, avaliações Sistemas de comentários e avaliações Comentários ou avaliações desaparecem
wp_commentmeta Metadados de comentários e avaliações Estado de spam, ratings, dados de Plugins em comentários Metadados de avaliações, dados de spam ou de Plugins em comentários perdem-se
wp_terms Nomes e slugs de termos Categorias, etiquetas, categorias de links, termos de taxonomia personalizada Nomes de categorias e etiquetas desaparecem
wp_termmeta Metadados para termos de taxonomia Imagens de termos, metadados SEO, campos personalizados de termos Metadados de categorias/etiquetas desaparecem
wp_term_taxonomy Tipo de taxonomia, relação parental, contagens de termos Distingue categoria vs etiqueta vs taxonomia personalizada Categorias/etiquetas ficam mal mapeadas ou perdem a hierarquia
wp_term_relationships Relações entre conteúdo e termos de taxonomia Atribui publicações/produtos/páginas a categorias e etiquetas Publicações perdem categorias/etiquetas, menus e relações de taxonomia partem
wp_links Dados legados do blogroll/gestor de links Funcionalidade Links Manager deprecada e Plugins antigos Normalmente nada em sites modernos, a menos que um Plugin antigo ainda use

Como são as tabelas da base de dados?

Imagina uma folha do Excel com uma linha de cabeçalho e valores na linha abaixo.

Por exemplo, podes ver uma pequena secção da tabela aqui. wp_options:

WordPress Database Header of the table wp_options

Vamos olhar para estas tabelas mais de perto para perceber porque importa qual a tabela que guarda qual parte de um site WordPress.

Compreender a estrutura das tabelas vai ajudar-te a saber qual a tabela que precisas de incluir ou excluir se planeias sincronizar ou mover dados de um site de Staging para o site em produção, ou vice-versa, com o WP STAGING. Também é útil se planeias atualizar o site de Staging.

Isto torna-se ainda mais importante com a tabela wp_collaboration planeada para o WordPress 7.0, que armazena dados de colaboração do editor em tempo real que são temporários e específicos do ambiente. Ao enviar um site de Staging para um site em produção, evita sobrescrever o estado de colaboração ativo do site em produção, a menos que pretendas intencionalmente substituir toda a base de dados.

Lista de tabelas do núcleo do WordPress

A tabela acima dá uma visão geral rápida. A secção seguinte explica as tabelas do núcleo do WordPress em mais detalhe para programadores, proprietários de sites e qualquer pessoa a diagnosticar migrações, Backups ou problemas de base de dados.

O WordPress pode adicionar novas tabelas ao núcleo em lançamentos importantes. Por exemplo, o WordPress 7.0 está planeado para introduzir wp_collaboration para dados de colaboração em tempo real no editor.

Outras tabelas na tua base de dados são criadas por Plugins ou Themes e nem sempre são necessárias para o site funcionar.

wp_options

A tabela wp_options é uma das tabelas da base de dados WordPress mais essenciais e armazena todas as definições de um site WordPress, como o URL, o título, Plugins instalados, etc! A maioria dos Plugins também armazena definições nesta tabela.

Todas as definições no painel do WordPress são armazenadas nesta tabela.

wp_users, wp_usermeta

wp_users armazena todos os utilizadores registados num site WordPress. Contém informação básica sobre um utilizador, como nome de utilizador e palavra-passe encriptada, email, hora de registo, nome de exibição, estado e mais alguns campos.

wp_usermeta armazena os metadados (‘dados adicionais‘) dos utilizadores. Estende a tabela wp_users com mais dados. Por exemplo, o primeiro nome de um utilizador é armazenado na tabela wp_usermeta em vez de na tabela wp_users.

Há dois campos necessários nesta tabela. Os Plugins podem armazenar dados personalizados em wp_usermeta apenas adicionando um novo valor no campo meta_key.

wp_posts, wp_postmeta

A tabela wp_posts armazena todos os dados de conteúdo de um site WordPress. Todas as publicações, páginas e respetivas revisões estão disponíveis na tabela wp_posts. Pode não ser claro, mas o WordPress armazena muito mais nessa tabela.

Esta tabela também contém itens de menu de navegação, ficheiros de media e anexos como imagens e dados de conteúdo usados por Plugins.

Em wp_posts existe uma coluna post_type que segmenta esses tipos diferentes de dados para que uma query à base de dados possa pedir tipos específicos. post_type é a coluna mais crítica desta tabela.

Nas imagens abaixo, podes ver dois valores de post_type diferentes, revision e attachment, ambos guardados na mesma tabela wp_posts:

Table wp_posts column attachment post_type
Table wp_posts column revision post_type

A tabela wp_postmeta, tal como wp_usermeta, estende a tabela wp_posts com mais dados, que também podem ser usados por outros Plugins.

Por exemplo, o popular Plugin Yoast SEO guarda tags Open Graph personalizadas, publicações e dados de URL nesta tabela.

wp_terms, wp_term_relationships, wp_term_taxonomy, wp_termmeta

A tabela wp_terms armazena categorias e etiquetas para publicações, páginas e links.

Uma das colunas desta tabela é ‘slug’. Um slug é um termo que reflete uma etiqueta de uma publicação em particular. No WordPress, podes usar etiquetas para ligar publicações, páginas e links.

wp_term_relationships é a conjunção e liga essas etiquetas a publicações, páginas e links. É como um mapa entre os objetos de conteúdo e os termos.

wp_term_taxonomy estende a tabela wp_terms com mais dados. É como metadados para a tabela wp_terms, com a diferença de que os Plugins não podem adicionar dados personalizados aqui. Esta tabela também contém uma relação entre menus e itens de menu.

A tabela wp_termmeta armazena metadados para termos de taxonomia. Funciona de forma semelhante a wp_postmeta, wp_usermeta e wp_commentmeta, mas para categorias, etiquetas e termos de taxonomia personalizada.

Plugins e Themes podem usar esta tabela para armazenar dados adicionais sobre termos, como imagens de categoria, metadados SEO, cores personalizadas, definições de apresentação ou outros campos específicos de taxonomia.

Se esta tabela faltar ou estiver incompleta após uma migração, as categorias e etiquetas podem ainda existir, mas os seus metadados adicionais podem perder-se.

wp_comments, wp_commentmeta

wp_comments armazena comentários em publicações e páginas. Esta tabela também contém comentários não aprovados e informação de autor, juntamente com a hierarquia de comentários. A tabela wp_commentmeta contém metadados adicionais sobre os comentários.

Esta tabela contém informação sobre links personalizados adicionados ao teu site. Foi deprecada e já não é usada. Há alguns Plugins mais antigos que ainda a usam, mas normalmente é uma tabela vazia.

Tabela planeada: wp_collaboration (WordPress 7.0)

wp_collaboration é uma nova tabela do núcleo da base de dados planeada para o WordPress 7.0. Faz parte da funcionalidade de colaboração em tempo real do editor de blocos, que permite a vários utilizadores editar a mesma publicação ou página ao mesmo tempo.

A tabela separa os dados de colaboração de alta frequência, como identificadores de sessão, informação de sala e timestamps de limpeza, das tabelas regulares de conteúdo wp_posts e wp_postmeta. A atividade do editor em tempo real escreve com muita frequência, e mantê-la fora das tabelas de conteúdo evita agitar os caches de objetos relacionados com publicações durante uma sessão de edição.

Esta tabela não substitui wp_posts, wp_postmeta nem o sistema de revisões do WordPress. Publicações, páginas, anexos, tipos de conteúdo personalizados e revisões continuam a ser armazenados em wp_posts, e os metadados específicos de publicações permanecem em wp_postmeta.

Para Backups e migrações, trata a wp_collaboration como dados de curta duração. Um Backup completo da base de dados deve incluí-la, mas ao enviar um site de Staging para produção normalmente não precisa de sobrescrever o site em produção, porque o WordPress consegue recriar o estado de colaboração à medida que os utilizadores editam. O schema ainda pode mudar antes do lançamento do WordPress 7.0, por isso confirma a lista final de colunas antes de depender dela.

Estrutura gráfica da base de dados WordPress

Este diagrama mostra como as tabelas do WordPress estão ligadas:

WordPress Database Structure and tables - SVG

Abre a imagem em resolução total: botão direito -> abrir imagem em novo separador

Problemas comuns da base de dados WordPress e as tabelas por trás deles

Problema Tabela(s) mais relevante(s) O que verificar
O site redireciona para o domínio errado após migração wp_options Verifica siteurl, home e options de Plugins serializadas
O utilizador admin existe mas não tem permissões de administrador wp_usermeta Verifica a chave capabilities, especialmente após mudança de prefixo de tabela
As publicações existem mas as categorias ou etiquetas estão em falta wp_terms, wp_term_taxonomy, wp_term_relationships Verifica se todas as tabelas de taxonomia foram migradas em conjunto
Entradas na biblioteca de media existem mas as imagens estão partidas wp_posts, wp_postmeta, pasta uploads Os anexos estão em wp_posts; caminhos de ficheiro frequentemente em _wp_attached_file em wp_postmeta
Os menus desaparecem após migração wp_posts, wp_terms, wp_term_relationships, wp_postmeta Os menus de navegação estão distribuídos por várias tabelas
Definições de Plugins desaparecem wp_options, por vezes tabelas específicas de Plugins Verifica se o Plugin guarda definições em wp_options ou em tabelas personalizadas
O site fica lento após migração wp_options, wp_postmeta Verifica options autoload e tabelas grandes de metadados
Comentários ou avaliações desaparecem wp_comments, wp_commentmeta Migra ambas as tabelas em conjunto
O WordPress diz que uma tabela não existe wp-config.php, todas as tabelas com prefixo Verifica $table_prefix e se todas as tabelas usam o mesmo prefixo

Artigos relacionados

Updated on September 2, 2026

Rene Hermenau

Autor: Rene Hermenau

Sobre o autor: René Hermenau é o fundador do WP STAGING. Ele trabalha com backups do WordPress, ambientes de staging, migrações, gestão de bases de dados e fluxos de implantação seguros.