Curso de MariaDB / Diagnosticar conexões locais, remotas e seus erros

Para diagnosticar uma conexão com o MariaDB, verifique nesta ordem o acesso ao servidor, o endereço e o protocolo, a conta selecionada, a autenticação e as permissões do banco. O acesso remoto exige também uma interface de escuta adequada, regras de rede, uma origem compatível com a conta e criptografia verificada; comece estabelecendo uma conexão TCP local conhecida.

Separar cliente, servidor e caminho de rede

Ter um cliente instalado não demonstra que o servidor esteja em execução. Um driver ODBC, interface usada por aplicações para acessar bancos de dados, também não significa que o servidor ou o cliente de linha de comando esteja instalado. Confira os pacotes, o serviço e o caminho do executável com a instalação no Windows ou a instalação no Ubuntu.

Depois de conectar, confira separadamente quais operações a conta pode executar na prática de usuários e permissões limitadas. Instalar o software, permitir tráfego na rede e autorizar uma consulta são verificações diferentes.

Sintoma O que verificar primeiro Não confundir com
Comando não encontrado Executável do cliente e PATH, a lista de diretórios de comandos Falha de senha
Conexão recusada ou tempo esgotado Servidor, endereço, porta e caminho de rede Algo resolvido apenas com GRANT
Access denied Usuário, origem e método de autenticação Senha incorreta em todos os casos
Unknown database Servidor acessado e nome do banco Problema de tabela
Erro de verificação TLS Nome do servidor, autoridade certificadora e certificado Motivo para desativar a verificação por rotina

Definir explicitamente a conexão TCP local

O comando pressupõe que cliente e servidor estejam no mesmo computador e que o servidor escute na porta 3306. Altere a porta se a configuração real usar outra. Execute no terminal do sistema operacional e informe a senha quando solicitada, sem escrevê-la no argumento do comando. TCP é o protocolo de rede escolhido explicitamente neste exemplo.

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 shopcourse

Depois de entrar no cliente, execute:

SELECT VERSION(),@@hostname,@@port,DATABASE();
SELECT USER(),CURRENT_USER();
SHOW GRANTS;

Confira a versão, o nome do servidor, a porta, o banco selecionado e CURRENT_USER(), que identifica a conta usada para verificar permissões. USER() mostra o usuário e a origem da conexão e nem sempre coincide com essa conta. Examine SHOW GRANTS em particular: o resultado pode conter informações de autenticação que não devem ser publicadas.

Conforme a plataforma e as opções, localhost pode usar um socket local, um pipe nomeado ou TCP. O comando escolhe TCP e 127.0.0.1 para eliminar essa ambiguidade. A referência oficial do cliente mariadb explica as opções de conexão.

Testar acesso real aos dados depois da autenticação

Confira SELECT VERSION(), DATABASE(); e SHOW TABLES; e confirme que products_44_lab não esteja em uso. Se já existir, examine os dados e a definição antes de decidir se a tabela é descartável. Com uma conta de estudos que tenha as permissões necessárias, crie o exemplo independente abaixo; não substitua uma tabela da aplicação.

USE shopcourse;
CREATE TABLE products_44_lab (
  product_id INT NOT NULL AUTO_INCREMENT,
  product_name VARCHAR(100) NOT NULL,
  category VARCHAR(30) NOT NULL,
  price DECIMAL(10,2) NOT NULL,
  stock INT NOT NULL DEFAULT 0,
  note VARCHAR(100) NULL DEFAULT NULL,
  PRIMARY KEY (product_id),
  CONSTRAINT ck_p44_price CHECK (price >= 0),
  CONSTRAINT ck_p44_stock CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_44_lab (product_id,product_name,category,price,stock,note) VALUES (1, '노트', '문구', 3500.00, 20, NULL),
  (2, '볼펜', '문구', 1500.00, 0, ''),
  (3, '머그컵', '생활', 8000.00, 12, '선물 포장'),
  (4, '스탠드', '생활', 25000.00, 5, NULL),
  (5, '파일', '문구', 1500.00, 50, ''),
  (6, '케이블', '전자', 8000.00, 0, '호환 확인');

Os textos originais em coreano foram mantidos para exercitar UTF-8, a codificação usada para esses caracteres. Os IDs 1–6 representam caderno, caneta, caneca, luminária, pasta e cabo. As categorias significam papelaria, casa e eletrônicos. Digite os valores de texto como aparecem, compare resultados pelos IDs e salve o arquivo como UTF-8 caso use SOURCE.

SELECT COUNT(*) FROM products_44_lab;

A contagem esperada é seis. SELECT 1 pode funcionar sem demonstrar acesso à tabela necessária à aplicação; teste as operações realmente exigidas. Guarde os códigos de erro e mensagens sem dados sensíveis, evitando expor credenciais em registros ou capturas de tela.

Restringir a escuta remota ao caminho necessário

Confirme com a administração o endereço privado real do servidor, a porta, a origem permitida do cliente e a política TLS, protocolo de segurança da camada de transporte. Pacotes do Ubuntu podem usar /etc/mysql/mariadb.conf.d/50-server.cnf, mas os caminhos variam. Faça uma cópia do arquivo e verifique se o servidor em execução o lê antes de alterar a seção de configuração.

[mariadbd]
bind-address = 10.0.0.10
port = 3306

10.0.0.10 é um exemplo de endereço privado, não um endereço que necessariamente existe no computador. Use uma interface real do servidor e limite as origens do cliente tanto nas regras de rede quanto na definição da conta. Planeje a interrupção causada pela reinicialização e como restaurar os valores anteriores. Aceitar pacotes não demonstra que a origem corresponda ao Host da conta.

O guia oficial de acesso remoto ao MariaDB explica a escuta, as contas e as regras de rede. Se skip-networking estiver habilitado, o servidor não aceitará conexões TCP. Não transforme uma escuta ampla ou um Host curinga na correção padrão para qualquer falha de conexão.

Verificar o certificado e a conta da conexão remota

O comando seguinte exige um servidor real com nome resolvível e um arquivo de uma autoridade certificadora confiável. Substitua db.example.internal e o caminho do arquivo; o nome do servidor precisa corresponder ao certificado. Execute no terminal, fora do cliente SQL.

mariadb --protocol=tcp --host=db.example.internal --port=3306 --user=app_user --password --ssl --ssl-verify-server-cert --ssl-ca=C:/mariadb-lab/ca.pem

As opções solicitam criptografia e verificação do certificado do servidor com a autoridade indicada. Se houver falha, confira o nome, a cadeia de confiança, o caminho do arquivo e a compatibilidade das versões; não desative a verificação para ocultar o problema. Uma conexão local bem-sucedida não comprova o funcionamento da rede remota nem do TLS.

Um túnel SSH, que encaminha conexões por um canal seguro, ou uma VPN aprovada, que oferece uma rede privada virtual, pode fornecer outro caminho. Ainda assim, confira qual origem o servidor enxerga e qual conta é selecionada. Esses caminhos exigem compreender as permissões e a identidade do destino.

Registrar a etapa da falha e as mudanças reversíveis

Se o servidor não estiver acessível, confira a resolução do nome, o endereço do cliente, a interface de escuta, a porta e o firewall. Quando o servidor estiver acessível, investigue a correspondência de Host, o método de autenticação e as credenciais. Banco desconhecido e falta de permissão sobre uma tabela são etapas posteriores.

Registre as configurações alteradas, os valores originais e as reinicializações realizadas, mantendo um caminho de retorno à política anterior. Confira o conteúdo da tabela local e remova-a somente se continuar sendo um objeto descartável de estudos. DROP TABLE apaga a estrutura e os dados e não pode ser desfeito com um ROLLBACK comum.

DROP TABLE shopcourse.products_44_lab;