Corso MariaDB / Installare su Windows e verificare server e collegamenti
Su Windows è possibile installare MariaDB Server con un pacchetto MSI ed eseguirlo come servizio Windows. Annotare nome del servizio, porta e password amministrativa, quindi verificare un collegamento del client e una query SQL prima di iniziare le esercitazioni.
Controllare il computer prima dell'installazione
Questa guida riguarda una nuova installazione locale per lo studio su Windows 11 a 64 bit. L'installazione MSI e la gestione dei servizi possono richiedere privilegi amministrativi. Se MariaDB o MySQL è già presente, distinguere l'aggiornamento dell'istanza esistente dalla creazione di un'istanza di prova separata. La spiegazione della differenza tra server e client MariaDB aiuta a scegliere i componenti necessari.
Leggere prima in PowerShell i servizi e le porte in ascolto. Il nome visualizzato di un servizio può essere diverso dal suo valore Name. Un nome sconosciuto non significa che i suoi dati siano eliminabili.
Get-Service | Where-Object { $_.Name -match 'MariaDB|MySQL' }
Get-NetTCPConnection -State Listen -LocalPort 3306 -ErrorAction SilentlyContinue
Se non è presente un server, un risultato vuoto è normale. Se viene trovato un server, verificarne lo scopo prima di arrestarlo o riutilizzarne la directory dei dati. Un'istanza separata richiede un nome di servizio diverso e, se la porta è occupata, una porta diversa. Adeguare tutti i comandi di collegamento alla porta effettivamente scelta.
Scaricare il pacchetto MSI e scegliere i componenti
- Aprire la pagina ufficiale dei download MariaDB e scegliere una versione stabile di MariaDB Server ancora supportata, nel formato Windows x64 MSI. Le versioni di anteprima non sono il riferimento per questa installazione introduttiva.
- Avviare l'MSI, leggere le condizioni di licenza e proseguire con Custom Setup. Assicurarsi che siano selezionati server, client e istanza del database.
- Annotare percorso di installazione e directory dei dati. Gli esempi usano
C:\Program Files\MariaDB 12.3\: sostituirlo con il percorso reale, se diverso. Uno strumento grafico come HeidiSQL è facoltativo per queste esercitazioni da terminale.
Etichette e disposizione delle schermate possono cambiare tra versioni. La guida ufficiale all'installazione MSI su Windows spiega le opzioni dell'istanza. Non scegliere l'aggiornamento di un'istanza esistente soltanto perché la procedura guidata propone tale opzione.
Impostare servizio, amministratore e collegamenti
| Impostazione | Scelta per un'istanza locale di studio |
|---|---|
| Password root | Scegliere una password robusta e conservarla in modo sicuro; root è l'amministratore del database |
| Accesso remoto root | Lasciarlo disabilitato per questa esercitazione locale |
| Account anonimo | Lasciarlo disabilitato |
| Servizio Windows | Installare come servizio e annotarne il nome effettivo |
| Porta TCP | Usare 3306 se libera oppure annotare una porta distinta |
| Set di caratteri | L'opzione UTF-8 dell'installer non sostituisce la scelta esplicita di utf8mb4 nel database |
La password amministrativa MariaDB non è la password di accesso a Windows. Dopo il controllo del server verrà creato un account separato per le esercitazioni SQL. L'accesso locale tramite 127.0.0.1 non richiede di aprire la porta del server alle reti esterne. Completare l'installazione e annotare eventuali errori, senza presumere che il server si sia avviato correttamente.
Avviare il servizio e verificare il collegamento amministrativo
Se il servizio si chiama MariaDB, usare questi comandi PowerShell. Sostituire il nome se ne è stato scelto un altro. L'avvio del servizio può richiedere una finestra PowerShell con privilegi amministrativi.
Get-Service -Name MariaDB
Start-Service -Name MariaDB
Get-Service -Name MariaDB
Lo stato finale deve essere Running. Il MariaDB Command Prompt fornito dall'installazione può già includere la directory del client nel percorso di ricerca. In PowerShell ordinario, il percorso completo dell'eseguibile evita tale dipendenza:
& "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
L'operatore & di PowerShell esegue il programma indicato dal percorso tra virgolette. Usare percorso e porta reali. L'opzione --password senza valore richiede la password interattivamente, evitando di scriverla nel comando. Una volta collegati, eseguire:
SELECT VERSION() AS server_version;
SELECT 1 + 1 AS result;
Il server deve restituire la propria versione e il risultato 2. Un client che si apre senza collegarsi non è una prova sufficiente del funzionamento del server.
Creare un account limitato al database delle esercitazioni
Usare root per la configurazione, poi passare a course_user per lo studio. Verificare prima se il nome è già presente:
SELECT User, Host FROM mysql.user WHERE User = 'course_user';
Se esiste già un account, controllarne host e scopo invece di eliminarlo o ricrearlo senza verifica. Per un nuovo account di studio, sostituire il segnaposto della password con una password robusta personale ed eseguire il blocco come amministratore:
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';
L'identità di un account comprende nome utente e host. Gli esempi si collegano intenzionalmente via TCP a 127.0.0.1 e concedono i privilegi all'account con quell'host. L'ambito è shopcourse.*: permette di lavorare nel database di studio, anche creandolo, senza privilegi globali o facoltà di concedere privilegi ad altri. È possibile assegnare questo ambito prima che il database esista.
Un'applicazione di produzione dovrebbe normalmente avere autorizzazioni più ristrette in base al proprio lavoro. Le regole sono descritte nei riferimenti ufficiali di CREATE USER e GRANT.
Chiudere il collegamento con quit, poi ricollegarsi dal terminale:
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
Se il comando mariadb non viene trovato, usare il percorso completo come per il collegamento amministrativo oppure aprire MariaDB Command Prompt. Nel client collegato come account di studio, eseguire:
SELECT CURRENT_USER() AS privilege_account;
L'account usato per il controllo dei privilegi deve essere course_user@127.0.0.1. CREATE USER e GRANT hanno effetto senza un FLUSH PRIVILEGES manuale in questa procedura.
Diagnosticare gli errori di installazione e collegamento
- Il servizio non si avvia: verificare il nome, un eventuale conflitto di porta e il log degli errori dell'istanza. Conservare la directory dei dati.
- Il comando del client non viene trovato: usare il percorso completo reale oppure MariaDB Command Prompt dell'installazione.
- Il collegamento non riesce: controllare che il servizio previsto sia in esecuzione e che host e porta del comando corrispondano all'istanza.
- Access denied: verificare password e host dell'account MariaDB. Un errore di autenticazione è diverso da un server arrestato.
Prima di modificare my.ini dell'istanza di studio, salvarne una copia e annotarne la posizione. Cambiare una sola impostazione, riavviare quell'istanza e verificare il risultato. Ripristinare il file salvato se la modifica impedisce l'avvio. Arrestare un servizio, disinstallare il software ed eliminare i file del database sono azioni distinte; cancellare i dati non è una normale soluzione a un problema di accesso.




