# Editar um registro no phpMyAdmin sem quebrar o site

Exportar só aquela tabela antes de tocar nela, ler o WHERE pela chave primária no Visualizar SQL, usar a aba SQL sem UPDATE solto e restaurar uma única linha a partir do .sql quando o UPDATE pegar linha demais.

> antes de Executar, confirme banco e prefixo no wp-config.php e exporte só aquela tabela em Exportar > Personalizado com DROP TABLE desmarcado. Depois: achar a linha pela aba Pesquisar, editar pelo lápis e ler no Visualizar SQL se o WHERE aponta para a chave primária de uma linha só. Nunca rode UPDATE sem WHERE.

João Rizzon · 2026-11-01 · Painéis

---

Editar uma linha do banco pelo phpMyAdmin é uma operação de dois minutos que pode custar um dia de site fora do ar. Não porque o phpMyAdmin seja perigoso, mas porque quase todo tutorial começa no passo 3: abre a tabela, manda o `UPDATE`, pronto. Fica de fora o que acontece quando o `UPDATE` pega 40 mil linhas em vez de uma, e o que fazer depois.

O que segue é a sequência inteira, na ordem em que ela protege você. Nada aqui é medição de laboratório: é procedimento apoiado na [documentação oficial do phpMyAdmin no cPanel](https://docs.cpanel.net/cpanel/databases/phpmyadmin/) e no comportamento padrão da ferramenta. Os dados de exemplo (nomes de tabela, IDs) são fictícios e estão identificados como exemplo.

## Onde fica o phpMyAdmin e como descobrir qual banco é o do seu site

No cPanel, o phpMyAdmin está na seção **Bancos de Dados** (Databases). A documentação do cPanel descreve a interface como o lugar para administrar os bancos MySQL da conta: criar tabelas, rodar consultas, importar e exportar.

Antes de abrir, descubra qual banco é o do site. Se for WordPress, a resposta está no `wp-config.php`, na raiz do site, acessível pelo Gerenciador de Arquivos:

```php
define( 'DB_NAME', 'usuario_wp123' );
define( 'DB_USER', 'usuario_wpuser' );
```

O valor de `DB_NAME` é o banco que você vai abrir na coluna da esquerda do phpMyAdmin. Conta com vários sites tem vários bancos parecidos, e abrir o banco do site de teste achando que é o de produção é um jeito silencioso de "consertar" a coisa errada.

Outra linha do `wp-config.php` importa: `$table_prefix`. Se for `wp_`, as tabelas se chamam `wp_options`, `wp_posts`, `wp_users`. Se alguém trocou o prefixo por segurança, pode ser `xk3_options`. Use o nome que aparece na lista, não o do tutorial.

Esse é o passo 1 da sequência. Ele não mexe em nada e evita a categoria de erro mais difícil de rastrear: a edição perfeita feita no banco errado.

## Exportar só aquela tabela antes de tocar nela

Backup do banco inteiro é bom e você deve ter um. Mas para uma edição pontual, o que salva a sua tarde é um arquivo pequeno, gerado minuto antes, com a tabela que você vai mexer. Ele abre no editor de texto e você acha a linha original em segundos.

### Como exportar só aquela tabela, do clique ao .sql

- Na coluna da esquerda, clique no banco e depois no nome da tabela (exemplo: `wp_options`).
- No menu do topo, clique na aba **Exportar**.
- Em Método de exportação, escolha **Personalizado**. O método Rápido não mostra as opções que interessam.
- Confirme que só a sua tabela está selecionada na lista de tabelas.
- Ajuste as opções da tabela abaixo.
- Formato **SQL**, e clique em **Executar** (Go). O navegador baixa um `.sql`.

### As opções do Exportar > Personalizado que mudam o resultado

| Opção no Exportar > Personalizado | Como deixar | Por quê |
|---|---|---||
| Adicionar instrução DROP TABLE / VIEW | **desmarcada** | Se um dia você importar esse arquivo sem querer, ele não apaga a tabela atual antes de recriar |
| Adicionar instrução CREATE TABLE | marcada | Guarda a estrutura da tabela junto com os dados |
| Sintaxe a usar ao inserir dados | INSERT | É o que você vai reaproveitar para restaurar uma linha |
| Inserções estendidas (extended inserts) | **desmarcada**, se a versão oferecer | Gera um INSERT por linha, o que torna possível achar e copiar uma linha só |
| Comentários no cabeçalho | marcada | O arquivo sai com data e hora, e você distingue o export de hoje do de semana passada |

O detalhe do DROP TABLE tem uma contrapartida honesta: com DROP desmarcado e CREATE TABLE marcado, esse arquivo **não** serve para restaurar a tabela inteira por importação direta. A importação para logo no começo, na criação da tabela: o `CREATE TABLE` do arquivo encontra uma tabela de mesmo nome e o MySQL responde `#1050 - Table already exists`. Se a sua versão do phpMyAdmin tiver gerado `CREATE TABLE IF NOT EXISTS`, a criação é ignorada e o erro só muda de lugar, indo parar nos `INSERT`, que colidem com as linhas existentes e param com chave duplicada. O objetivo do export aqui é outro: ter o texto da linha original à mão. Para restauração completa da tabela, você gera outro export com DROP marcado, ciente de que ele apaga e recria.

Guarde o arquivo em uma pasta que você ache depois. `wp_options-2026-09-25-antes-da-url.sql` é melhor nome que `localhost.sql`.

## Achar a linha certa pela aba Pesquisar

Rolar a tabela procurando a linha é onde a maioria dos erros começa, porque a paginação embaralha a noção de onde você está. Use a busca.

- Com a tabela aberta, clique na aba **Pesquisar** (Search).
- A tela lista as colunas da tabela. Escolha a coluna onde está o valor conhecido. Em `wp_options`, geralmente `option_name`.
- No campo Operador, escolha `=` quando você sabe o valor exato (exemplo: `siteurl`) ou `LIKE` com `%` quando sabe só um pedaço (exemplo: `%_transient_%`).
- Digite o valor e clique em **Executar**.

O resultado vem com a contagem de linhas encontradas. Essa contagem é informação, não decoração: se você esperava uma linha e vieram 37, pare e refine a busca antes de editar qualquer coisa.

Mesma coisa pela aba **SQL**, que é mais rápida quando você já sabe o que quer (exemplo fictício de valor):

```sql
SELECT option_id, option_name, LEFT(option_value, 80) AS inicio_do_valor
FROM wp_options
WHERE option_name = 'siteurl';
```

O `LEFT(..., 80)` mostra só os primeiros 80 caracteres do valor, o que evita a tela travar quando a linha guarda um bloco enorme de dados.

## Editar pelo lápis e conferir o SQL antes de Executar

Na linha do resultado, clique no ícone de lápis, **Editar**. O phpMyAdmin abre um formulário com um campo por coluna.

Três coisas para observar nessa tela:

- **A chave primária não se mexe.** Em `wp_options`, é `option_id`. Alterar esse número é o mesmo que trocar a identidade da linha.
- **O tipo de campo importa.** Campo `text` vem em caixa grande; campo `varchar` vem em linha única. Se você colar um valor com quebra de linha em um campo que não deveria tê-la, o problema só aparece depois.
- **Espaço no começo ou no fim do valor é invisível e é erro.** `https://seusite.com.br ` com espaço final quebra a URL do site do mesmo jeito que um endereço errado.

Antes de salvar, procure o botão **Visualizar SQL** (Preview SQL) no rodapé do formulário. Versões atuais do phpMyAdmin mostram, sem executar, a consulta que seria enviada. Ela tem a forma:

```sql
UPDATE `wp_options` SET `option_value` = 'https://seusite.com.br' WHERE `wp_options`.`option_id` = 1;
```

Leia o `WHERE`. Se ele aponta para a chave primária de uma linha só, pode seguir. Se a tabela não tem chave primária, o phpMyAdmin monta o `WHERE` com o conteúdo de várias colunas, e aí o risco de pegar linha parecida existe. Se a sua versão não tem o botão Visualizar SQL, salve e confira a mensagem de retorno: o phpMyAdmin imprime a consulta executada e o número de linhas afetadas logo acima do resultado.

**1 linha afetada** é o que você quer ver. "0 linhas afetadas" costuma significar que o valor novo era igual ao antigo. Qualquer número maior que 1 significa que você editou mais do que pretendia, e é hora de abrir o `.sql` exportado.

## UPDATE sem WHERE reescreve a tabela inteira

Quando a correção é em massa (trocar um domínio antigo por um novo em vários registros, por exemplo), o caminho é a aba **SQL**. E aqui mora a armadilha.

```sql
-- Reescreve TODAS as linhas da tabela. Não rode isto.
UPDATE wp_options SET option_value = 'https://seusite.com.br';
```

Sem `WHERE`, o MySQL não pergunta nada e não faz distinção: ele aplica o valor em todas as linhas da tabela. Em `wp_options`, isso significa que cada opção do site, do nome do blog às configurações de todos os plugins, passa a valer a mesma string. O site não volta com F5. Volta com restauração de backup.

A versão com filtro:

```sql
UPDATE wp_options
SET option_value = 'https://seusite.com.br'
WHERE option_name IN ('siteurl', 'home');
```

### O SELECT antes do UPDATE e o ensaio com ROLLBACK

Escreva primeiro o `SELECT` com o mesmo `WHERE`, rode, confira a contagem, e só então troque o começo da consulta.

```sql
-- 1. Rode isto primeiro e olhe quantas linhas voltaram
SELECT option_id, option_name, option_value
FROM wp_options
WHERE option_name IN ('siteurl', 'home');

-- 2. Se voltaram exatamente as linhas esperadas, rode o UPDATE com o MESMO WHERE
```

Se a sua versão do phpMyAdmin mostrar o link **Simular consulta** (Simulate query) ao lado do botão Executar para consultas de escrita, use: ele informa quantas linhas seriam atingidas sem gravar nada. Quando não houver, o `SELECT` antes faz o mesmo trabalho.

Em tabelas InnoDB existe ainda a transação, com uma ressalva que costuma passar batida: a transação não sobrevive entre execuções da aba SQL. Se você enviar `START TRANSACTION` em uma execução, olhar o resultado, e mandar `COMMIT` na execução seguinte, o phpMyAdmin pode ter usado outra conexão, e aí não há o que confirmar nem o que desfazer. Para valer, os comandos vão juntos, no mesmo envio, com a conferência dentro do lote:

```sql
START TRANSACTION;
UPDATE wp_options
SET option_value = 'https://seusite.com.br'
WHERE option_name IN ('siteurl', 'home');
SELECT option_name, option_value FROM wp_options
WHERE option_name IN ('siteurl', 'home');
ROLLBACK;
```

Esse lote é o ensaio: o `SELECT` do meio mostra como os dados ficariam e o `ROLLBACK` no fim devolve tudo ao estado anterior. Conferiu e gostou do resultado, rode o mesmo lote trocando `ROLLBACK` por `COMMIT`. Só funciona em tabela InnoDB, que é o padrão do WordPress atual.

## Os dois casos que quebram o site mesmo com a edição "certa"

### Campo serializado no wp_options quebra se editado na mão

Muita opção do WordPress não guarda texto simples, guarda um array serializado do PHP. O valor tem esta cara (exemplo):

```
a:2:{s:5:"color";s:4:"blue";s:4:"size";s:5:"large";}
```

Os números não são enfeite. `s:4:"blue"` quer dizer "string de 4 caracteres". Se você trocar `blue` por `red` na mão e deixar o `s:4`, o PHP tenta ler 4 caracteres onde existem 3, a desserialização falha e a opção passa a valer `false`. O sintoma costuma ser um plugin que "perdeu as configurações", um tema que volta ao padrão, ou a tela branca.

Regra prática: **não edite valor serializado direto no phpMyAdmin**. Se o valor começa com `a:`, `s:` ou `O:` seguido de dois-pontos e número, saia da tela de edição. Troque pelo caminho certo:

- Na tela do próprio plugin ou tema, que regrava a opção com o tamanho correto.
- Com um plugin de busca e substituição que trate serialização, do tipo Better Search Replace, que desserializa, troca e serializa de novo.
- Por linha de comando, com `wp search-replace` do WP-CLI, se a hospedagem der acesso a SSH.

Por isso a troca de domínio do WordPress não se faz com `UPDATE` na mão em `wp_postmeta` e `wp_options`: as URLs também vivem dentro de campos serializados, e o `UPDATE` cru quebra o tamanho declarado.

### Apagar a linha errada, e como recuperar o acesso pelo wp-config.php

O ícone de lixeira fica ao lado do lápis, e os dois têm mais ou menos o mesmo tamanho. Apagar `siteurl` ou `home` de `wp_options` deixa o site sem endereço e o painel inacessível. Apagar uma linha de `wp_users` desconecta o usuário e deixa os posts dele sem autor.

Dois cuidados: apague sempre a partir de um resultado de busca, não da listagem geral paginada, e confirme a caixa "Mostrar confirmação ao enviar DELETE" nas preferências, que faz o phpMyAdmin perguntar antes.

Se apagar `siteurl` e perder o acesso ao `/wp-admin`, existe um socorro fora do banco: adicione ao `wp-config.php`, acima da linha `/* That's all, stop editing! */`:

```php
define( 'WP_HOME', 'https://seusite.com.br' );
define( 'WP_SITEURL', 'https://seusite.com.br' );
```

Isso força a URL pelo arquivo e devolve o acesso ao painel, ganhando tempo para restaurar a linha com calma. Depois de restaurada, remova as duas linhas.

## Restaurar só aquela linha a partir do .sql exportado

Com o export feito no começo, a volta é cirúrgica. Não precisa importar o arquivo inteiro, e não deve: a importação direta esbarra na tabela que já existe.

- Abra o `.sql` em um editor de texto (Bloco de Notas funciona, mas VS Code, Notepad++ ou Sublime lidam melhor com arquivo grande).
- Busque no arquivo pelo valor que identifica a linha, por exemplo `siteurl`.
- Você vai encontrar uma linha começando com `INSERT INTO \`wp_options\``. Copie ela inteira, até o ponto e vírgula.
- No phpMyAdmin, com o banco certo aberto, vá na aba **SQL** e cole.

Se a linha foi **apagada**, o `INSERT` original resolve. Cole e execute. Retorno esperado: 1 linha inserida.

Se a linha ainda existe, porém com valor errado, o `INSERT` vai falhar com erro de chave duplicada. Aí você tem duas saídas:

```sql
-- Opção A: trocar INSERT por REPLACE no comando copiado.
-- REPLACE apaga a linha de mesma chave e grava a do arquivo.
REPLACE INTO `wp_options` (`option_id`, `option_name`, `option_value`, `autoload`)
VALUES (1, 'siteurl', 'https://seusite.com.br', 'yes');

-- Opção B: montar um UPDATE com o valor original que você leu no arquivo.
UPDATE wp_options
SET option_value = 'https://seusite.com.br'
WHERE option_id = 1;
```

O `REPLACE` é mais fiel, porque recoloca todas as colunas como estavam. Ele também apaga e reinsere, então só use quando a linha do arquivo traz a chave primária explícita, como no exemplo acima.

Depois de restaurar, limpe o cache: cache de página do plugin, cache de objeto se houver, e o cache do navegador. Valor certo no banco com página antiga em cache parece restauração que não funcionou.

## O que significam #1050, #1062 e os outros erros que aparecem na tela

| Mensagem | Significado provável | O que fazer |
|---|---|---||
| `#1050 - Table already exists` | Importação de um `.sql` com CREATE TABLE sem DROP, com a tabela já presente no banco | Não importe o arquivo inteiro: abra no editor e copie só a linha que interessa |
| `#1062 - Duplicate entry` | Já existe linha com a mesma chave única | Use REPLACE ou UPDATE em vez de INSERT |
| `#1054 - Unknown column` | Nome de coluna errado ou prefixo de tabela diferente | Confira o nome exato na aba Estrutura |
| `#1146 - Table doesn't exist` | Banco errado aberto ou prefixo diferente de `wp_` | Confira `DB_NAME` e `$table_prefix` no wp-config.php |
| `#1044 - Access denied` | Usuário do banco sem privilégio na operação | Revise os privilégios do usuário em Bancos de Dados MySQL no cPanel |
| `0 linhas afetadas` | O WHERE não bateu em nada, ou o valor novo já era igual | Rode o SELECT com o mesmo WHERE e confira |
| Tela em branco no site após salvar | Valor serializado quebrado | Restaure a linha pelo `.sql` e refaça pelo painel do plugin |

Uma observação sobre tempo: consulta pesada em tabela grande pode estourar o tempo limite de execução do PHP e voltar com erro genérico, sem dizer se gravou ou não. Se acontecer, não repita a consulta no impulso. Rode antes um `SELECT` para verificar o estado atual dos dados, e só então decida.

## A sequência curta, para colar ao lado do monitor

- Confirme o banco e o prefixo pelo `wp-config.php`.
- Abra a tabela, aba **Exportar**, método **Personalizado**, DROP TABLE desmarcado, inserções estendidas desmarcadas. Baixe o `.sql`.
- Aba **Pesquisar** para localizar a linha. Confira a contagem de resultados.
- Lápis para editar. **Visualizar SQL** e leia o `WHERE` antes de salvar.
- Em massa, escreva o `SELECT` com o `WHERE` primeiro, confira, depois transforme em `UPDATE`.
- Valor que começa com `a:`, `s:` ou `O:` não se edita na mão.
- Deu errado: abra o `.sql`, copie o `INSERT` da linha, cole na aba SQL, ajuste para `REPLACE` se a linha ainda existir.

O passo 2, o export da tabela, é o único que parece supérfluo e é o único que você vai agradecer. Ele custa quinze segundos e transforma um acidente irreversível em um copiar e colar.

