# Aceder à Sua Base de Dados Com o phpMyAdmin

Source: https://support.kapsulehost.com/pt-pt/sites-phpmyadmin

Todos os sites da KapsuleHost com base de dados têm acesso à base de dados através do navegador com o phpMyAdmin, aberto com início de sessão único, pelo que não há uma segunda palavra-passe para guardar. Este guia aborda como abri-lo, ler os seus dados de ligação, as operações que vale a pena fazer aí, e as duas tarefas de base de dados que nunca deve fazer no phpMyAdmin num site WordPress.

## A Abrir o phpMyAdmin

1. Inicie sessão no [KPanel](https://kpanel.kapsulehost.com) e clique em **Websites** na barra lateral esquerda.
2. Clique no seu site.
3. No menu do próprio site, abra **Base de dados**.
4. Clique em **Abrir phpMyAdmin**.

O phpMyAdmin abre-se num novo separador, já com sessão iniciada e apontado para a base de dados do seu site. Não há formulário de início de sessão nem uma credencial separada para guardar.

![O separador Database num site no KPanel com o botão Abrir phpMyAdmin](https://support.kapsulehost.com/help/screenshots/sites-phpmyadmin.84df4ba6.webp)

> **Note:** Se a página indicar que não há base de dados provisionada para este tipo de site, isso é esperado. Os sites estáticos em HTML e alguns tipos de aplicação são criados sem uma. Os tipos de site que utilizam uma base de dados, incluindo WordPress e WooCommerce, têm-na sempre.

## Os Seus Dados de Ligação

O mesmo ecrã mostra as credenciais que a sua aplicação utiliza, cada uma com um botão de cópia e a palavra-passe escondida atrás de um controlo de revelação:

| Campo | Valor |
|---|---|
| Servidor | `127.0.0.1` |
| Porta | `3306` |
| Base de dados | O nome da sua base de dados |
| Utilizador | O seu utilizador da base de dados |
| Palavra-passe | Oculta até clicar em revelar |

Estes são os valores que pertencem a `wp-config.php`, a um ficheiro `.env`, ou à configuração de base de dados de qualquer framework.

> **Warning:** `127.0.0.1` significa "este servidor". Não é possível aceder a partir do seu portátil, e nenhuma configuração de firewall irá alterar isso: a base de dados simplesmente não escuta num endereço público, por conceção. Para ligar um cliente de ambiente de trabalho como o TablePlus ou o Sequel Ace, utilize um túnel via SSH. Consulte [Ligar à Sua Base de Dados Através de um Túnel SSH](https://support.kapsulehost.com/pt-pt/database-ssh-tunnel).

## Para Que Utilizar

O phpMyAdmin justifica o seu lugar para um conjunto específico de tarefas:

- **Ler dados.** Confirmar o que um plugin realmente guardou, verificar se uma linha existe, contar registos.
- **Importar uma base de dados** durante uma migração ou uma restauração.
- **Exportar uma base de dados**, quer como cópia de segurança extra, quer para entregar a um programador.
- **Reparar um único valor danificado**, como um `siteurl` que foi escrito incorretamente e agora o bloqueia fora do wp-admin.
- **Diagnosticar o tamanho.** Ordenar tabelas por tamanho mostra-lhe de imediato quando uma tabela de registos ou de dados temporários cresceu descontroladamente.

## A Importar uma Base de Dados

1. Abra o phpMyAdmin a partir do separador Database.
2. Clique no nome da sua base de dados no painel esquerdo.
3. Clique em **Import** no topo.
4. Escolha o ficheiro `.sql` e clique em **Go**.

Uma importação substitui as tabelas correspondentes. Não as combina.

> **Important:** Importar sobre uma base de dados em produção é destrutivo e imediato. Todas as linhas de uma tabela correspondente são substituídas pelo que estiver no ficheiro, e não há desfazer dentro do phpMyAdmin. Faça primeiro uma cópia de segurança a partir da página **Cópias de segurança** do site: [Fazer uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/taking-a-backup).

Para um ficheiro grande, comprima-o primeiro para `.sql.gz`, que o phpMyAdmin aceita e que normalmente reduz o ficheiro para abaixo do limite de carregamento. Se ainda assim for demasiado grande, divida-o em vários ficheiros por tabela, ou abra um ticket e nós importamo-lo do lado do servidor por si.

## A Exportar uma Base de Dados

1. Clique no nome da sua base de dados no painel esquerdo.
2. Clique em **Export**.
3. **Quick** com formato SQL é adequado para uma cópia direta. Escolha **Custom** se precisar de tabelas específicas, ou quiser o resultado comprimido com gzip.
4. Clique em **Go**.

Uma exportação do phpMyAdmin é uma cópia extra útil, não uma estratégia de cópia de segurança. Captura apenas a base de dados, não os seus ficheiros, e fica onde quer que a tenha guardado. O seu site é copiado automaticamente todos os dias com ambos em conjunto, e pode fazer uma cópia manual a qualquer momento: [Fazer uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/taking-a-backup).

## Duas Coisas a Não Fazer Aqui

### Não execute uma pesquisa e substituição com SQL

O WordPress guarda as definições de plugins e temas como strings serializadas em PHP, que registam o comprimento de cada valor dentro delas. Uma consulta `REPLACE()` altera o texto sem alterar o comprimento registado, pelo que o PHP deixa de conseguir ler a opção e esta reverte silenciosamente para vazio. As definições do tema desaparecem, os sliders ficam vazios, as licenças são desativadas.

Utilize o cartão **Pesquisar e Substituir** no separador **WordPress** do site, que trata corretamente a serialização e faz primeiro uma cópia de segurança. Explicação completa: [Executar uma Pesquisa e Substituição](https://support.kapsulehost.com/pt-pt/wordpress-search-replace).

### Não reponha uma palavra-passe editando a wp_users

Guias mais antigos indicam para definir `user_pass` utilizando a função `MD5` a partir do menu suspenso do phpMyAdmin. O WordPress moderno não utiliza hashes MD5, e fazer isto incorretamente bloqueia a conta em vez de a repor.

O KPanel tem ferramentas próprias para isto no separador **WordPress** do site, depois **Users**: inicie sessão diretamente com **Login as**, envie um e-mail de reposição, ou copie uma ligação de reposição para enviar a si próprio. Consulte [Repor uma Palavra-passe de Administrador do WordPress Perdida](https://support.kapsulehost.com/pt-pt/wordpress-reset-password).

## Ferramentas de Base de Dados WordPress no KPanel

Para trabalho de rotina na base de dados do WordPress, o separador **WordPress**, depois a secção **Base de dados**, é mais seguro e mais rápido do que o phpMyAdmin. Dá-lhe os tamanhos das tabelas de relance, otimização e reparação com uma cópia de segurança automática feita primeiro, conversão de tabelas antigas para um motor de armazenamento moderno, e limpeza com um clique de revisões de artigos, rascunhos automáticos, dados temporários expirados e artigos no lixo. A pesquisa e substituição encontra-se numa secção ao lado, em **Ações Rápidas**.

Recorra ao phpMyAdmin quando precisar de ver linhas em bruto. Recorra à secção Database quando precisar de alterar algo.

## Resolução de Problemas

**O phpMyAdmin não abre.** O botão precisa de acesso de escrita ao site. Se a função da sua conta KapsuleHost for apenas de leitura, peça a um proprietário da conta. Se tiver acesso de escrita e continuar a falhar, o site pode ainda estar a ser provisionado: verifique o indicador de estado no topo do site.

**Não consigo ligar a partir do meu portátil com os dados no separador Database.** Correto, e deliberado. A base de dados não está exposta publicamente. Utilize um túnel SSH: [Ligar à Sua Base de Dados Através de um Túnel SSH](https://support.kapsulehost.com/pt-pt/database-ssh-tunnel).

**A importação para sem erro.** Quase sempre é o tamanho do ficheiro. Comprima-o com gzip ou divida-o.

**Alterei um valor e o site avariou.** Restaure a partir da cópia de segurança mais recente: [Restaurar a Partir de uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/restoring-from-backup). É por isso que a cópia de segurança vem primeiro.

**As tabelas cresceram de forma descontrolada.** Ordene por tamanho no phpMyAdmin para encontrar o culpado, depois limpe-o a partir do separador **WordPress**, secção **Base de dados**, em vez de eliminar linhas manualmente.