Curso de MariaDB / Instalar no Windows e verificar o servidor e a conexão

No Windows, você pode instalar MariaDB Server com um pacote MSI e executá-lo como serviço. Anote o nome do serviço, a porta e a senha de administração; depois confira a conexão do cliente e uma consulta SQL antes de iniciar os exercícios.

Verificar o computador antes da instalação

Este guia descreve uma instalação local nova para aprendizado no Windows 11 de 64 bits. Instalar o MSI e alterar serviços pode exigir permissões de administrador. Se já houver MariaDB ou MySQL, diferencie atualizar a instância existente de criar outra independente. A introdução ao MariaDB e à diferença entre servidor e cliente ajuda a escolher os componentes.

Consulte primeiro os serviços e as portas em escuta no PowerShell. O nome exibido de um serviço pode ser diferente de sua propriedade Name. Um nome desconhecido não significa que seus dados possam ser descartados.

Get-Service | Where-Object { $_.Name -match 'MariaDB|MySQL' }
Get-NetTCPConnection -State Listen -LocalPort 3306 -ErrorAction SilentlyContinue

Em um computador sem servidor anterior, uma saída vazia é normal. Se encontrar um, entenda sua finalidade antes de pará-lo ou reutilizar o diretório de dados. Uma instância separada precisa de outro nome de serviço e, se a porta estiver ocupada, de outra porta. Adapte todos os comandos à porta realmente escolhida.

Baixar o MSI e escolher os componentes

  1. Na página oficial de downloads do MariaDB, escolha uma versão estável com manutenção e seu pacote Windows x64 MSI. Versões de prévia não são a referência desta instalação para iniciantes.
  2. Execute o MSI, leia a licença e continue para Custom Setup se aceitar as condições. Confirme a seleção do servidor, do cliente e do componente Database instance, que cria a instância.
  3. Anote o caminho de instalação e o diretório de dados. Os exemplos utilizam C:\Program Files\MariaDB 12.3\; substitua pelo caminho real se for diferente. Uma ferramenta gráfica como HeidiSQL é opcional nestes exercícios de linha de comando.

Rótulos e disposição das telas podem mudar entre versões. O guia oficial de instalação MSI no Windows explica as opções da instância. Não escolha atualizar uma instância existente apenas porque o assistente oferece essa alternativa.

Configurar serviço, administrador e conexão

Opção Escolha para uma instância local de aprendizado
Senha de root Escolha uma senha forte e guarde-a com segurança; root é o administrador do banco.
Acesso remoto de root Mantenha desativado neste exercício local.
Conta anônima Mantenha desativada.
Serviço do Windows Instale como serviço e anote o nome real.
Porta TCP Use 3306 se estiver livre ou anote outra porta.
Conjunto de caracteres A opção UTF-8 do instalador não substitui a configuração explícita utf8mb4 dos bancos.

A senha do administrador MariaDB não é a senha de login do Windows. Depois de conferir o servidor, você criará outra conta para praticar SQL. O acesso local por 127.0.0.1 não exige abrir a porta a redes externas. Conclua a instalação e registre qualquer erro em vez de presumir que o servidor iniciou.

Iniciar o serviço e conferir uma conexão administrativa

Se o serviço se chama MariaDB, utilize estes comandos PowerShell. Substitua o nome se escolheu outro. Iniciar um serviço pode exigir PowerShell aberto como administrador.

Get-Service -Name MariaDB
Start-Service -Name MariaDB
Get-Service -Name MariaDB

O estado final deve ser Running, ou em execução. O atalho MariaDB Command Prompt pode incluir o diretório do cliente no caminho de pesquisa. Em um PowerShell comum, o caminho explícito do executável evita essa dependência:

& "C:\Program Files\MariaDB 12.3\bin\mariadb.exe" --protocol=tcp --host=127.0.0.1 --port=3306 --user=root --password --default-character-set=utf8mb4

O operador & do PowerShell chama o executável cujo caminho está entre aspas. Use o caminho e a porta reais. A opção --password sem valor pede a senha interativamente, evitando escrevê-la no comando. Depois de conectar, execute dentro do cliente:

SELECT VERSION() AS server_version;
SELECT 1 + 1 AS result;

O servidor deve retornar a versão e o resultado 2. Conseguir abrir o cliente sem estabelecer conexão não comprova que o servidor funciona. Se houver vários servidores locais, confira a porta da instância antes de interpretar a versão retornada.

Criar uma conta limitada ao banco de práticas

Use root na preparação e depois course_user no aprendizado. Confira primeiro se esse nome já existe:

SELECT User, Host FROM mysql.user WHERE User = 'course_user';

Se encontrar uma conta, examine host e finalidade antes de excluí-la ou recriá-la. Para uma conta nova do curso, substitua o marcador de senha abaixo por uma senha própria forte e execute como administrador:

CREATE USER 'course_user'@'127.0.0.1'
  IDENTIFIED BY 'CHANGE_THIS_TO_YOUR_OWN_PASSWORD';

GRANT ALL PRIVILEGES ON shopcourse.*
  TO 'course_user'@'127.0.0.1';

SHOW GRANTS FOR 'course_user'@'127.0.0.1';

O nome completo da conta inclui usuário e host. Estes exemplos usam deliberadamente TCP com 127.0.0.1 e concedem direitos a essa conta de host. O escopo shopcourse.* permite trabalhar no banco de práticas, inclusive criá-lo, sem privilégios globais ou autorização para conceder direitos a outros usuários. É válido conceder esse escopo antes de o banco existir.

Uma aplicação de produção normalmente precisa de permissões mais restritas conforme sua função. As referências oficiais de CREATE USER e GRANT explicam as regras.

Saia do cliente com \q e conecte novamente a partir do terminal. O comando abaixo pressupõe que mariadb esteja no caminho de pesquisa; caso contrário, use o caminho completo com o operador & como no exemplo anterior.

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
SELECT CURRENT_USER() AS privilege_account;

Execute o último SELECT dentro da nova conexão. A conta de privilégios deve ser course_user@127.0.0.1. A opção --abort-source-on-error prepara o cliente para interromper a execução de um arquivo SOURCE diante de um erro; não altera os direitos da conta. Neste procedimento, CREATE USER e GRANT entram em vigor sem executar manualmente FLUSH PRIVILEGES.

Diagnosticar problemas comuns

  • O serviço não inicia: verifique nome, conflito de porta e registro de erros dessa instância. Preserve o diretório de dados.
  • O comando do cliente não é encontrado: use o caminho completo real ou o MariaDB Command Prompt da instalação.
  • Não é possível conectar: confirme que o serviço esperado está em execução e que host e porta correspondem a ele.
  • Aparece Access denied: confira senha e host da conta MariaDB. Falha de autenticação é diferente de servidor parado.

Antes de editar o my.ini da instância de aprendizado, salve o arquivo original e anote sua localização. Altere uma opção, reinicie essa instância e confira o resultado. Restaure a cópia se a mudança impedir o início. Parar um serviço, desinstalar software e apagar arquivos de banco são ações distintas: excluir dados não é uma correção rotineira para falhas de login.