Corso MariaDB / Collegarsi dal terminale ed eseguire file SQL con SOURCE
Avviare il collegamento MariaDB dal terminale, poi immettere SQL nel client collegato. Per eseguire un file SQL salvato in UTF-8, usare il comando SOURCE con un percorso sul computer che esegue il client: non è un percorso nel filesystem del server di database.
Preparare server, account e file
Completare la configurazione MariaDB su Windows oppure la configurazione MariaDB su Ubuntu e verificare che il server sia in esecuzione. Gli esempi comuni usano l'account di studio e i parametri seguenti. Sostituire la porta se ne è stata scelta un'altra. SQL viene inviato al server descritto nell'introduzione ai ruoli di server e client MariaDB; dopo il collegamento, USE permette di selezionare il database predefinito.
| Elemento | Valore o controllo |
|---|---|
| Protocollo e host | TCP verso 127.0.0.1 |
| Porta | 3306, salvo una scelta diversa per l'istanza |
| Account | course_user con la password scelta |
| Set di caratteri della connessione | utf8mb4 |
| File SQL | Testo UTF-8 con estensione .sql, non .sql.txt |
La shell avvia il programma client; il client collegato inoltra SQL al server. SOURCE viene interpretato dal client, che legge il file locale e invia le istruzioni. Confondere questi livelli porta facilmente a immettere un comando corretto nel posto sbagliato.
Collegarsi dal terminale e verificare la connessione
Eseguire il comando nel terminale, fuori da qualsiasi collegamento MariaDB già aperto:
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
| Opzione | Scopo |
|---|---|
| --protocol=tcp | Usare esplicitamente TCP invece del socket locale |
| --host e --port | Scegliere indirizzo e porta del server |
| --user | Scegliere il nome utente MariaDB |
| --password | Richiedere la password invece di inserirla nel comando |
| --default-character-set=utf8mb4 | Impostare il set di caratteri della connessione client |
| --abort-source-on-error | Interrompere il resto dell'input SOURCE in caso di errore |
Su Windows, se mariadb non è nel percorso di ricerca, usare MariaDB Command Prompt dell'installazione oppure il percorso completo indicato nella guida Windows. Un prompt come MariaDB [(none)]> indica che non è stato selezionato un database predefinito; da solo non segnala un errore di accesso.
All'interno del client eseguire:
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;
Il server restituisce versione, informazioni sull'account, un totale di 5 e il saluto Hello, café. Il carattere accentato offre anche un semplice controllo della codifica. USER() descrive l'identità della connessione, mentre CURRENT_USER() identifica l'account usato per verificare i privilegi. Il riferimento ufficiale del client MariaDB da riga di comando definisce opzioni e comandi.
Completare, annullare o cambiare visualizzazione di un'istruzione
SQL può occupare più righe. Il client attende che l'istruzione sia completa, normalmente fino al punto e virgola:
SELECT
10 + 20 AS total;
Il risultato è 30. Se si sta ancora scrivendo un'istruzione incompleta e si desidera scartarla, immettere questo comando del client:
\c
Per mostrare un risultato in verticale, usare il terminatore del client \G al posto del punto e virgola:
SELECT VERSION() AS server_version\G
\c e \G sono convenzioni del client, non sintassi SQL generale accettata da qualsiasi strumento. Digitare quit per terminare il collegamento. Disconnettersi non arresta MariaDB Server e non elimina i dati.
Salvare un file SQL UTF-8 completo
Creare un file di testo semplice chiamato lesson04-check.sql con l'intero esempio:
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;
Selezionare la codifica UTF-8 nell'editor e controllare l'estensione effettiva. Windows può nascondere le estensioni e lasciare un file chiamato lesson04-check.sql.txt. Scegliere una directory sotto il proprio controllo, come C:\mariadb-course\ su Windows oppure /home/yourname/mariadb-course/ su Ubuntu. Sostituire yourname con il componente reale del percorso.
Il file conserva istruzioni, non una copia di backup del database. Salvarlo non esegue alcun comando. Il suo percorso è una posizione nel filesystem del computer client, mentre 127.0.0.1:3306 identifica un punto di collegamento al server.
Eseguire il file con SOURCE e controllare i risultati
Dopo il collegamento, usare il percorso Windows con barre in avanti:
SOURCE C:/mariadb-course/lesson04-check.sql;
Oppure usare il percorso Ubuntu effettivo:
SOURCE /home/yourname/mariadb-course/lesson04-check.sql;
I due comandi sono alternative, non passaggi da eseguire uno dopo l'altro. Il client deve mostrare gli stessi tre risultati, compresi totale 5 e saluto integro. Questo file legge soltanto valori: ripeterlo non aggiunge né elimina righe di tabelle. Non si può estendere automaticamente questa proprietà a file che contengono CREATE TABLE, INSERT, UPDATE o DELETE.
Se client e server sono su computer diversi, SOURCE continua a leggere il file sul computer client. Con --abort-source-on-error, un errore interrompe l'input rimanente del file. L'opzione non annulla le istruzioni già riuscite e non rende la creazione di tabelle annullabile tramite ROLLBACK.
Risolvere errori di file, codifica e SQL
- File non trovato: verificare percorso completo, nome, permessi di lettura ed estensione .sql effettiva.
- Testo illeggibile: controllare codifica UTF-8 del file, set di caratteri della connessione e codifica di visualizzazione del terminale.
- Access denied: esaminare account e privilegi; è un problema diverso da un file mancante.
- Errore a metà del file: controllare che cosa è già riuscito prima di ripetere un file che modifica dati.
Su Windows, se il problema riguarda la codifica di visualizzazione del terminale, uscire dal client MariaDB, eseguire il comando seguente nel terminale e ricollegarsi con l'opzione UTF-8:
chcp 65001
All'interno del client, quando necessario, controllare le variabili del set di caratteri:
SHOW VARIABLES LIKE 'character_set_%';
Cambiare un'impostazione della connessione non ripara automaticamente testo già memorizzato in modo errato. Individuare l'origine del problema prima di modificare i dati. Mantenere distinti i contesti di esecuzione di comandi della shell, comandi del client e SQL.





