Come installare il sistema di database OLAP ClickHouse su Ubuntu 22.04

ClickHouse è un sistema di gestione di database orientato alle colonne sviluppato da ClickHouse, Inc. e scritto in C++. È un sistema di gestione di database OLAP Open Source che è veloce, tollerante ai guasti, facile da usare e altamente affidabile.

ClickHouse è un sistema di database OLDAP incredibilmente veloce per l’elaborazione analitica online. Ti consente di generare report analitici utilizzando query SQL in tempo reale.

In questo tutorial, imparerai come installare il sistema di database OLAP ClickHouse su un server Ubuntu 22.04. Imparerai anche come impostare l’autenticazione su ClickHouse e coprire il suo utilizzo di base e le query.

Prerequisiti

Per completare questo tutorial, avrai diversi prerequisiti qui sotto:

• Un server Ubuntu 22.04 - Questo esempio utilizza un sistema Ubuntu con il nome host ‘clickhouse-server’ e l’indirizzo IP ‘192.168.5.100’.
• Un utente non root con privilegi di amministratore sudo/root.

Configurazione del sistema

Prima di iniziare l’installazione di ClickHouse, dovrai assicurarti che la CPU attuale supporti il set di istruzioni SSE 4.2 e disabilitare SWAP sul tuo sistema.

Il pacchetto binario precompilato ufficiale per ClickHouse è compilato sull’architettura x86 (64-bit) e il SSE 4.2. Quindi, se non hai una CPU che supporta SSE 4.2, dovresti costruire ClickHouse manualmente dal sorgente.

Inoltre, quando utilizzi ClickHouse, è consigliato disabilitare SWAP, specialmente nell’ambiente di produzione.

Esegui il comando qui sotto per controllare che la tua CPU supporti la funzionalità SSE 4.2. Dovresti ricevere l’output ‘SSE 4.2 supported’ se la tua CPU è supportata.

grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"

Successivamente, esegui il comando qui sotto per disabilitare SWAP tramite il file di configurazione ‘ /etc/fstab ‘. Questo comando metterà ‘#’ all’inizio della configurazione SWAP e disabiliterà SWAP nel tuo sistema in modo permanente.

sudo sed -i '/ swap / s/^\(.*\)$/#\\1/g' /etc/fstab

Ora esegui il comando qui sotto per disattivare SWAP nella sessione attuale. Quindi verifica lo stato di SWAP.

sudo swapoff -a  
sudo free -m

Di seguito è riportato l’output che riceverai se SWAP è disabilitato - La dimensione di SWAP nel campo ‘total’ è 0.

Con la CPU che supporta SSE 4.2 e WAP disabilitato, sei ora pronto per installare il sistema di database OLAP ClickHouse.

Installazione del sistema di database OLAP ClickHouse

Il sistema di database ClickHouse OLDAP fornisce più metodi di installazione. Per le distribuzioni Linux, ClickHouse fornisce repository sia per distribuzioni basate su Debian che su RPM. Inoltre, ClickHouse è disponibile con installazione tramite Docker o utilizzando un singolo pacchetto binario.

In questo passaggio, installerai ClickHouse su un sistema Ubuntu 22.04 tramite il repository ufficiale. Quindi, aggiungerai il repository ClickHouse al tuo sistema, quindi installerai il pacchetto ClickHouse tramite APT.

Per iniziare, esegui il comando apt qui sotto per installare alcune dipendenze di base. Quando richiesto, inserisci y e premi INVIO.

sudo apt install apt-transport-https ca-certificates dirmngr

Ora esegui il comando qui sotto per aggiungere la chiave GPG e il repository ClickHouse al tuo sistema. In questo esempio, installerai ClickHouse dal ramo stabile del repository.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754  
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \  
    /etc/apt/sources.list.d/clickhouse.list

Successivamente, aggiorna e aggiorna l’indice dei pacchetti tramite il comando apt qui sotto.

sudo apt update

Riceverai che il repository ClickHouse è stato aggiunto.

Ora installa il ‘ clickhouse-server ‘ come sistema di database e il pacchetto ‘ clickhouse-client ‘ tramite il comando apt qui sotto.

sudo apt install clickhouse-server clickhouse-client

Inserisci Y quando richiesto per la conferma e premi INVIO per procedere.

Inoltre, durante l’installazione di ClickHouse, ti verrà chiesto di impostare una password per l’utente predefinito di ClickHouse. Inserisci una nuova password per ClickHouse e riceverai un output simile allo screenshot seguente quando l’installazione è completata.

Con ClickHouse installato, esegui il comando utility systemctl qui sotto per avviare e abilitare il servizio ClickHouse. Questo comando avvierà ClickHouse e abiliterà il servizio a essere eseguito automaticamente all’avvio.

sudo systemctl start clickhouse-server  
sudo systemctl enable clickhouse-server

Verifica il servizio ClickHouse con il comando qui sotto per assicurarti che il servizio ClickHouse sia in esecuzione.

sudo systemctl status clickhouse-server

Riceverai un output simile al seguente - Lo stato attuale del servizio ClickHouse è in esecuzione ed è abilitato e verrà eseguito automaticamente all’avvio.

Hai completato l’installazione del server ClickHouse. Nel passaggio successivo, imparerai come accedere al server ClickHouse tramite l’applicazione client e impostare l’autenticazione con password per l’utente amministratore di ClickHouse.

Accesso a ClickHouse tramite riga di comando

Con il server ClickHouse installato, puoi accedere a ClickHouse tramite il ‘ clickhouse-client ‘ che hai anche installato.

Il ‘clickhouse-client’ è un’interfaccia a riga di comando per interagire e gestire il server ClickHouse. È simile al client ‘ mysql ‘ per il server MySQL/MariaDB, ‘ psql ‘ per il server PostgreSQL o ‘ mongod ‘ per il server MongoDB.

Per accedere al server ClickHouse, puoi utilizzare il comando ‘ clickhouse-client ‘ qui sotto.

sudo clickhouse-client --password

Quando ti viene richiesta la password, inserisci la password che hai creato durante l’installazione.

Dopo aver effettuato l’accesso, dovresti vedere la shell di ClickHouse come segue.

Da qui, puoi vedere che ti sei connesso al server ClickHouse v22.11 con l’utente predefinito di ClickHouse. Il server ClickHouse è in esecuzione per impostazione predefinita su localhost con la porta 9000.

A questo punto, hai installato il server e il client ClickHouse e hai imparato come connetterti al server ClickHouse tramite il comando ‘ clickhouse-client ‘. Nel passaggio successivo, imposterai un utente amministratore per il server ClickHouse.

Configurazione dell’utente amministratore su ClickHouse

In questo passaggio, creerai un utente amministratore per il server ClickHouse. Ma prima di ciò, abiliterai la ‘Gestione degli account’ per l’utente ‘default’ tramite la configurazione di ClickHouse.

Per iniziare, apri la configurazione ‘/etc/clickhouse-server/users.d/default_password.xml’ utilizzando il comando dell’editor nano qui sotto.

sudo nano /etc/clickhouse-server/users.d/default_password.xml

Aggiungi la seguente riga tra la sezione ‘… ‘. Questo abiliterà la ‘ Gestione degli accessi ‘ per l’utente ‘ default ‘.

  
      
          
            ...  
            1  
          
      

Salva il file ed esci dall’editor quando hai finito.

Ora esegui il comando utility systemctl qui sotto per riavviare il servizio ClickHouse e applicare le modifiche.

sudo systemctl restart clickhouse-server

Ora che la ‘ gestione degli accessi ‘ è abilitata per l’utente ‘default’, creerai quindi un nuovo utente amministratore per ClickHouse. Il nuovo utente sarà in grado di accedere a tutti i database con tutti i privilegi sul server ClickHouse.

Esegui il comando ‘ clickhouse-client ‘ qui sotto per connetterti al server ClickHouse tramite l’utente ‘ default ‘.

sudo clickhouse-client --user default --password

Quando ti viene richiesta la password, inserisci la password che hai configurato. Ora otterrai la console del server ClickHouse e accedi come utente ‘ default ‘ con ‘ access_management ‘ abilitato.

Successivamente, esegui la seguente query per creare un nuovo utente ClickHouse. E assicurati di cambiare il nome utente, la password e l’indirizzo IP dell’host. Questo esempio creerà un nuovo utente ‘ halsey ‘ con la password ‘password’ e hashato con SHA256. L’opzione ‘ HOST IP ‘ ti consente di specificare l’indirizzo IP che verrà utilizzato per connettersi al server ClickHouse. In questo esempio, è consentito solo da localhost o ‘ 127.0.0.1 ‘.

CREATE USER halsey HOST IP '127.0.0.1' IDENTIFIED WITH sha256_password BY 'password';

Ora esegui la seguente query per concedere tutti i privilegi sul server ClickHouse all’utente ‘ halsey ‘.

GRANT ALL ON *.* TO halsey WITH GRANT OPTION;

Successivamente, verifica l’elenco degli utenti sul server ClickHouse tramite la seguente query. Dovresti vedere che il nuovo utente ‘halsey’ è stato aggiunto a ClickHouse.

SHOW USERS;

Ora digita ‘quit’ sulla console client di ClickHouse per uscire.

Con il nuovo utente amministratore del database creato, dovrai quindi disabilitare la ‘ gestione degli accessi ‘ per l’utente ‘ default ‘ sul tuo server ClickHouse.

Apri la configurazione ‘ /etc/clickhouse-server/users.d/default_password.xml ‘ utilizzando il comando dell’editor nano qui sotto.

sudo nano /etc/clickhouse-server/users.d/default_password.xml

Cambia l’opzione ‘ access_management ‘ in ‘ 0 ‘ per disabilitare la ‘ Gestione degli accessi ‘ per l’utente ‘ default ‘.

  
      
          
            ...  
            0  
          
      

Salva il file ed esci dall’editor quando hai finito.

Riavvia il servizio ClickHouse per applicare le modifiche tramite il comando utility systemctl qui sotto.

sudo systemctl restart clickhouse-server

Infine, esegui il seguente comando per accedere al server ClickHouse come utente ‘halsey’. Quando ti viene richiesta la password, inserisci la tua password e premi INVIO per accedere.

sudo clickhouse-client --user halsey --password

Dopo aver effettuato l’accesso, riceverai un output simile allo screenshot seguente. Il nuovo utente amministratore per ClickHouse ‘halsey’ è stato aggiunto e l’accesso è stato effettuato con successo.

Con il nuovo utente amministratore del server ClickHouse creato, imparerai ora come utilizzare ClickHouse per creare database e tabelle e inserire e recuperare dati tramite la query SQL di ClickHouse.

Query di base sul sistema di database ClickHouse

In questo passaggio, imparerai la query di base del sistema di database ClickHouse, che è simile alle comuni query SQL. Imparerai come creare un database e una tabella, inserire e recuperare dati dal database, quindi l’uso di base della query ‘ ALTER ‘ che puoi utilizzare per modificare i dati esistenti sul server ClickHouse.

Per prima cosa, esegui la seguente query per creare un nuovo database. In questo esempio, creerai un nuovo database ‘ testdb ‘.

CREATE DATABASE testdb;

Passa al ‘ testdb ‘ tramite la seguente query ‘ USE dbname’.

USE testdb;

Ora, crea una nuova tabella, ‘users,’ con la seguente query. La tabella ‘ users ‘ avrà alcuni campi qui sotto:

• id con tipo ‘UInt64’ per memorizzare valori interi.
• name con tipo ‘String’  per memorizzare stringhe - lunghezza del carattere.
• last_login con tipo ‘DateTime’ per dati in formato data e ora stringa.
• Il motore qui è ‘MergeTree’, utilizzato principalmente su ClickHouse.

CREATE TABLE users (id UInt64, name String, jobs String, last_login DateTime) ENGINE=MergeTree() PRIMARY KEY id ORDER BY id;

Successivamente, esegui la seguente query per inserire nuovi dati nella tabella ‘users’. Nella query qui sotto, inserirai tre dati diversi nella tabella ‘ users ‘.

INSERT INTO users VALUES (1, 'alice', 'DevOps', '2022-10-10 00:10:10');  
INSERT INTO users VALUES (2, 'alex', 'Manager', '2022-09-05 01:19:10');  
INSERT INTO users VALUES (3, 'janet', 'Developer', '2022-05-05 04:29:10');

Inserisci il primo dato.

Inserisci il secondo dato.

Inserisci il terzo dato.

Esegui la seguente query per recuperare i dati dalla tabella ‘ users ‘. Dovresti vedere tre nuovi campi di dati che hai appena aggiunto.

SELECT * FROM users;

Hai imparato come creare il database, passare al database, creare la tabella, inserire dati e recuperare dati sul sistema di database OLAP ClickHouse. Successivamente, imparerai a modificare i dati con la query ‘ ALTER ‘.

Esegui la seguente query ‘ALTER TABLE’ per aggiornare i dati esistenti sulla tabella ‘users’. In questo esempio, cambierai il campo ‘jobs’ per l’utente ‘ alex ‘ in ‘ administrator ‘.

ALTER TABLE users UPDATE jobs = 'Administrator' WHERE name = 'alex';

Verifica i dati appena aggiornati sulla tabella ‘users’ tramite la seguente query. Dovresti ora ottenere i nuovi dati per l’utente ‘ alex ‘ aggiornati a ‘ Administrator ‘.

SELECT * FROM users;

Ora che hai imparato l’uso di base della query ClickHouse per creare e passare ai database, creare tabelle, inserire dati e recuperare dati. E inoltre, hai imparato come utilizzare la query ‘ ALTER ‘ per modificare i dati esistenti sul database ClickHouse. Ora pulirai la tua installazione di ClickHouse.

Pulizia dell’ambiente

Con il nuovo database e la tabella creati e dati casuali inseriti, in questo ultimo passaggio, pulirai l’installazione del sistema di database ClickHouse eliminando il database e la tabella che hai appena creato.

Esegui la seguente query, ‘DROP TABLE,’ per rimuovere la tabella users dal database testdb.

DROP TABLE users;

Ora rimuovi il database ‘testdb’ tramite la query ‘ DROP DATABASE ‘ qui sotto.

DROP DATABASE testdb;

Infine, verifica l’elenco dei database sul server ClickHouse tramite la seguente query. Dovresti vedere che il database ‘ testdb ‘ è stato eliminato dal server ClickHouse.

SHOW DATABASES;

Ora la tua installazione di ClickHouse è pulita con l’utente amministratore configurato.

Conclusione

Congratulazioni! Hai completato l’installazione del sistema di database OLAP ClickHouse e hai imparato come impostare un utente amministratore su ClickHouse. E infine, hai anche imparato la query di base per creare un database e una tabella, inserire e recuperare dati, modificare dati esistenti e pulire il database e la tabella.