Corso MariaDB / Connessioni locali e remote e diagnosi degli errori

Per circoscrivere un problema di connessione MariaDB, controllare nell'ordine raggiungibilità, indirizzo e protocollo, corrispondenza dell'account, autenticazione e privilegi sul database. L'accesso remoto richiede anche ascolto, regole di rete, host dell'account e cifratura verificata adeguati: partire da una connessione TCP locale sicuramente corretta.

Separare client, server e percorso di rete

La presenza del client non dimostra che il server sia in esecuzione. Un solo driver ODBC potrebbe non includere né server né client da riga di comando. Controllare pacchetto, servizio e percorso del programma con la guida all'installazione su Windows o la guida all'installazione su Ubuntu. Dopo la connessione verificare le operazioni ammesse con la guida agli account e ai privilegi minimi.

Sintomo Primo controllo Da non confondere con
Comando non trovato Programma client e PATH Password del database errata
Connessione rifiutata o scaduta Server, indirizzo, porta e percorso Problema risolvibile soltanto con GRANT
Access denied Utente, host e autenticazione Sempre e soltanto una password errata
Unknown database Server effettivo e nome del database Problema di una tabella
Verifica TLS fallita Nome host, CA e certificato Motivo per disattivare sempre la verifica

TCP, Transmission Control Protocol, è il protocollo di rete scelto esplicitamente nell'esempio. TLS, Transport Layer Security, protegge la connessione cifrata e richiede anche la verifica dell'identità del server. Il riferimento del client mariadb e la guida MariaDB alle connessioni remote descrivono opzioni e configurazione.

Definire esplicitamente la connessione locale

Il comando seguente presuppone client e server sullo stesso computer, con server avviato e in ascolto sulla porta 3306. Cambiare porta se la configurazione effettiva è diversa e inserire la password soltanto al prompt. Eseguire il comando client nel terminale del sistema operativo.

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 shopcourse
SELECT VERSION(),@@hostname,@@port,DATABASE();
SELECT USER(),CURRENT_USER();
SHOW GRANTS;

Una volta entrati nel client, controllare versione, nome host, porta, database selezionato e CURRENT_USER(). localhost può usare socket, named pipe oppure TCP secondo piattaforma e opzioni. L'esempio sceglie TCP con 127.0.0.1 per eliminare questa ambiguità.

Esaminare SHOW GRANTS localmente, evitando di copiarne informazioni di autenticazione o dati sensibili in documenti pubblici. Accedere con successo al server sbagliato non rende corretta la connessione: verificare l'identità dell'ambiente prima di modificare dati.

Provare l'accesso effettivo al database dopo l'autenticazione

Verificare con SHOW TABLES che products_44_lab non esista. Se esiste, esaminarne prima definizione e dati senza sovrascrivere tabelle applicative. Eseguire la preparazione completa con l'account di studio dotato dei privilegi necessari su shopcourse. Salvare SQL in UTF-8 se si usa un file.

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, '호환 확인');

Il codice conserva i testi coreani della fonte. I prodotti 1–6 sono quaderno, penna, tazza, lampada, cartellina e cavo; le categorie indicano cancelleria, articoli per la casa ed elettronica. Conservare i testi esatti e confrontare gli ID.

SELECT COUNT(*) FROM products_44_lab;

Il conteggio deve essere sei. SELECT 1 può riuscire senza dimostrare l'accesso a tutti i database e alle tabelle richiesti: provare l'operazione effettivamente necessaria. Registrare codice di errore e messaggio ripuliti da segreti.

Autenticazione fallita, database inesistente, tabella inesistente e privilegio negato sono fasi diverse. Aggiungere privilegi non corregge un client introvabile o una porta senza servizio in ascolto. Usare la fase del fallimento per scegliere il controllo successivo.

Limitare ascolto e percorso di rete alle esigenze effettive

Confermare con l'amministratore indirizzo privato reale del server, porta, origini ammesse e regole TLS. Un pacchetto Ubuntu può usare /etc/mysql/mariadb.conf.d/50-server.cnf, ma i percorsi cambiano tra ambienti. Salvare il file e accertarsi che il server avviato lo legga prima di modificare la sezione server.

[mariadbd]
bind-address = 10.0.0.10
port = 3306

10.0.0.10 è un indirizzo privato dimostrativo e non è necessariamente disponibile sul computer. Usare un'interfaccia reale del server e consentire soltanto le origini necessarie tramite regole di rete e definizioni degli account. Pianificare interruzione e ripristino prima del riavvio del servizio.

L'indirizzo di ascolto stabilisce dove il server riceve connessioni; l'host dell'account determina quali origini possono corrispondere all'identità. Raggiungere la porta non dimostra che l'account sia corretto. Anche skip-networking attivo può impedire l'ascolto TCP.

Verificare certificati remoti e corrispondenza dell'account

Il comando seguente presuppone un server realmente risolvibile e un file di autorità di certificazione, o CA, attendibile. Sostituire db.example.internal e il percorso e accertarsi che il nome usato corrisponda al certificato. Una connessione locale riuscita non dimostra che rete e TLS remoti siano corretti.

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

Se la verifica fallisce, controllare nome usato per la connessione, catena dei certificati, file CA e validità temporale pertinente. Disattivare il controllo del certificato non è una correzione ordinaria. Dopo l'accesso verificare comunque CURRENT_USER() per confermare l'account effettivo.

Un tunnel SSH o una VPN approvati possono fornire un percorso diverso; controllare però origine vista dal server e account selezionato. Ascolto su tutte le interfacce, host account con caratteri jolly o verifica certificati disattivata non devono diventare rimedi abituali ai problemi di connessione.

Registrare fase del fallimento e modifiche ripristinabili

Se il server non è raggiungibile, controllare DNS, indirizzo del client, ascolto, porta e firewall. Una volta raggiunto, verificare corrispondenza Host, plugin di autenticazione e credenziali. Database sconosciuto e privilegi di tabella negati appartengono alle fasi successive.

Registrare modifiche, valori iniziali e riavvii, mantenendo una procedura per tornare alle regole precedenti. Dopo aver esaminato le esigenze di conservazione, eliminare soltanto la tabella locale seguente. DROP TABLE elimina struttura e dati e non viene annullato da un normale ROLLBACK.

DROP TABLE shopcourse.products_44_lab;