> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Banco de dados

> Cria os bancos de dados MariaDB/MySQL da sua conta, onde sites como o WordPress guardam posts, páginas, usuários e configurações. Cada banco nasce junto com um usuário de banco,…

**Caminho no painel:** menu da esquerda > **RECURSOS** > **Banco de dados**

## A lista

![Lista de bancos de dados com um banco: o nome com o asterisco e a descrição embaixo, o nome de usuário, o tamanho, o Mostrar dos dados de conexão e os ícones de editar, Interface Web do Banco de Dados e excluir, com a nota do asterisco no pé](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/banco-lista.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=75fbe469487d4b14217ea7c6a7da0b3b)

Acima da lista, a tela diz quanto do seu disco os bancos ocupam (*"Seus bancos de
dados consomem um total de..."*), e **Banco de dados** mostra quantos existem e o
limite da sua conta, como *1 / Ilimitado*. Quem define o limite é a empresa que
administra o servidor.

| Coluna | O que é |
| - | - |
| **NOME DO BANCO DE DADOS** | o nome, com a **Descrição** embaixo |
| **NOME DE USUÁRIO** | o usuário de banco criado junto |
| **TAMANHO DO BANCO DE DADOS** | o espaço que o banco ocupa |
| **DADOS DE CONEXÃO** | o **Mostrar**, com os dados que o site precisa, na seção *Conectar o site ao banco*, abaixo |
| **AÇÕES** | o lápis edita, o ícone de banco de dados abre a **Interface Web do Banco de Dados**, a lixeira exclui |

A busca de **Opções de visualização** procura em **Todos os campos**, ou só em
**Nome do banco de dados**, **Nome de usuário** ou **Descrição**.

### O asterisco ao lado do nome

Um nome com hífen ganha um `*`, e a tela explica no pé da lista: *"\* Se você usar
esse nome em suas consultas SQL, certifique-se de colocá-lo entre o caractere de
crase \`."* Numa consulta, o nome vai entre crases, como em
``USE `sua-conta_loja`;``.

**Medido:** numa conta com hífen no nome, o banco ficou com o hífen, e o asterisco
apareceu.

## Criar um banco de dados

![Formulário Adicionar banco de dados: Nome do banco de dados e Nome de usuário com o prefixo fixo, Descrição, Senha, Confirme a senha e Sugestão de senha com Gerar](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/banco-adicionar.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=f3ab3389ba944743beda2b6b37b93205)

1. Clique em **Adicionar banco de dados**.
2. Em **Nome do banco de dados**, escreva o nome depois da parte fixa.
3. Em **Nome de usuário**, escreva o nome do usuário depois da parte fixa.
4. Em **Descrição**, escreva para que é o banco, como o nome do site. É opcional.
5. Em **Senha** e **Confirme a senha**, digite a senha, ou clique em **Gerar**.
6. Clique em **Salvar**.

A tela responde *"O banco de dados `<banco>` e o usuário `<usuário>` foram criados
com sucesso."*

**Os dois nomes começam com o nome da sua conta e um sublinhado**, uma parte que vem
escrita no campo e não muda. Depois dela cabem até 50 caracteres. Quem decide se a
parte fixa existe é a configuração do servidor: ver
[Servidor do Banco de Dados (área do administrador)](/keyhelp-admin/servidor-do-banco-de-dados).

**O nome do banco e o do usuário são independentes.** Medido: um banco terminado em
`kb` foi criado com um usuário terminado em `lb`. No painel, cada banco tem um
usuário, criado e excluído junto com ele.

**A senha precisa ter pelo menos 12 caracteres, com letra minúscula, letra maiúscula
e número.** É o que a tela exige, e ela recusa a senha que não cumpre, com a lista
das regras.

**O Gerar escreve a senha nos dois campos.** Medido: ele mostra uma senha de 18
caracteres em **Sugestão de senha** e preenche com ela **Senha** e **Confirme a
senha**. Copie a sugestão antes de salvar, porque o site vai precisar dela e o
painel não mostra a senha de nenhum banco depois.

## Conectar o site ao banco

![Janela Dados de conexão: Nome do banco de dados, Nome de usuário, Host localhost e Porta 3306](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/banco-dados-conexao.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=82272a9fea6a0c4ec5875da0f3aa3cfd)

* Na linha do banco, em **DADOS DE CONEXÃO**, clique em **Mostrar**.

| Dado | O que é |
| - | - |
| **Nome do banco de dados** | o nome completo, com a parte fixa |
| **Nome de usuário** | o usuário de banco |
| **Host** | `localhost`, o próprio servidor |
| **Porta** | 3306 |

A senha não aparece aqui: é a que foi definida ao criar o banco. Num WordPress,
esses dados vão no arquivo `wp-config.php`, nas linhas `DB_NAME`, `DB_USER`,
`DB_PASSWORD` e `DB_HOST`.

**O usuário de banco só entra a partir do próprio servidor.** Medido no servidor de
banco: o usuário foi criado só para `localhost`, com todas as permissões sobre o
próprio banco e nenhuma sobre os outros. Neste servidor, a porta 3306 também só
atende o próprio servidor, então um programa instalado no seu computador não
conecta. A entrada de fora depende de quem administra o servidor ligar o acesso
remoto.

## Abrir o banco no navegador

* Na linha do banco, clique no ícone de banco de dados, **Interface Web do Banco de Dados**.

O phpMyAdmin, a ferramenta de ver e mexer no banco pelo navegador, abre **já
conectado, sem pedir senha**. Medido: ele entrou com um usuário temporário criado
pelo painel, e a lista mostrava só aquele banco.

Esse usuário temporário não é o do site, e o painel cria um a cada clique. Como ele
é removido, e o cuidado que isso pede, está em
[Administração do Banco de Dados (área do administrador)](/keyhelp-admin/administracao-do-banco-de-dados).

## Editar

* Na linha do banco, clique no **lápis**.

Dá para trocar a **Descrição** e a **Senha**. **Os nomes do banco e do usuário não
mudam**: os dois campos vêm cinza. Os campos de senha avisam *"Deixe em branco para
manter a senha atual."* A tela responde *"As configurações foram atualizadas."*

O **Gerar** também está na edição, e na criação ele preenche os dois campos de
senha. Se clicou nele sem querer trocar a senha, saia pelo **Voltar a visão geral**,
sem salvar.

## Excluir

![Página Excluir confirmação: o nome do banco, o nome de usuário e a descrição, com a caixa Confirmação](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp/imagens/banco-excluir.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=daa1650202a0cf00858368ac5877080c)

1. Na linha do banco, clique na **lixeira**.
2. Na página **Excluir confirmação**, confira o banco e o usuário.
3. Marque **Confirmação** e clique em **Excluir**.

A tela responde *"Os seguintes itens foram excluídos."*, com o banco e o usuário.

**Medido no servidor de banco:** o banco, o usuário, as permissões dele e a pasta
do banco no disco saíram todos.

> [!WARNING]
>
> **Excluir o banco apaga tudo o que está nele, e a página não avisa**
>
> Não há como desfazer, e um site que usa o banco fica sem os dados dele. Para
> guardar uma cópia antes, faça um backup com **Banco de dados** marcada: ver
> [Criar um backup](/keyhelp/criar-backup).

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| *"A complexidade da senha exigida não foi atendida."* | a senha tem menos de 12 caracteres, ou falta letra minúscula, maiúscula ou número | usar uma senha que cumpra as quatro regras da mensagem, ou o **Gerar** |
| *"Entrada inválida no campo Nome do banco de dados."* (ou **Nome de usuário**) | o nome tem um caractere que não é aceito, como espaço | corrigir o nome |
| **Uma consulta SQL dá erro de sintaxe perto do nome do banco** | o nome tem hífen | escrever o nome entre crases |
| **Um programa no meu computador não conecta no banco** | o usuário de banco só entra a partir do próprio servidor | usar a **Interface Web do Banco de Dados**, ou pedir o acesso remoto à empresa que administra o servidor |
| **Não consigo escolher o nome inteiro** | a parte com o nome da conta é fixa neste servidor | escrever só o que vem depois dela |
| **O site parou de conectar no banco depois de trocar a senha** | o site guarda a senha antiga no arquivo de configuração dele | escrever a senha nova no arquivo de configuração do site, como o `wp-config.php` do WordPress |

## Ver também

* [Painel de Controle](/keyhelp/painel-de-controle), com o espaço que os bancos ocupam e o limite da conta
* [Criar um backup](/keyhelp/criar-backup), para guardar os bancos
* [Gerenciador de Arquivos](/keyhelp/gerenciador-de-arquivos), para chegar ao arquivo de configuração do site
* [Administração do Banco de Dados (área do administrador)](/keyhelp-admin/administracao-do-banco-de-dados), a entrada sem senha e os usuários temporários
* [Servidor do Banco de Dados (área do administrador)](/keyhelp-admin/servidor-do-banco-de-dados), o acesso remoto e a regra dos nomes


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.