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

Il terminale avvia il client mariadb, SOURCE legge il file SQL sul computer client, il server esegue SQL e il client mostra i risultati

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.