Comment installer le système de base de données OLAP ClickHouse sur Ubuntu 22.04

ClickHouse est un système de gestion de base de données orienté colonnes développé par ClickHouse, Inc. et écrit en C++. C’est un système de gestion de base de données OLAP open source qui est rapide, tolérant aux pannes, facile à utiliser et très fiable.

ClickHouse est un système de base de données OLDAP extrêmement rapide pour le traitement analytique en ligne. Il vous permet de générer des rapports analytiques en utilisant des requêtes SQL en temps réel.

Dans ce tutoriel, vous apprendrez comment installer le système de base de données OLAP ClickHouse sur un serveur Ubuntu 22.04. Vous apprendrez également à configurer l’authentification sur ClickHouse et à couvrir son utilisation de base et ses requêtes.

Prérequis

Pour compléter ce tutoriel, vous aurez plusieurs prérequis ci-dessous :

• Un serveur Ubuntu 22.04 - Cet exemple utilise un système Ubuntu avec le nom d’hôte ‘clickhouse-server’ et l’adresse IP ‘192.168.5.100’.
• Un utilisateur non-root avec des privilèges d’administrateur sudo/root.

Configuration du système

Avant de commencer l’installation de ClickHouse, vous devez vous assurer que le CPU actuel prend en charge l’ensemble d’instructions SSE 4.2 et désactiver SWAP sur votre système.

Le paquet binaire précompilé officiel pour ClickHouse est compilé sur l’architecture x86 (64 bits) et le SSE 4.2. Donc, si vous n’avez pas de CPU qui prend en charge SSE 4.2, vous devez construire ClickHouse manuellement à partir de la source.

De plus, lors de l’utilisation de ClickHouse, il est recommandé de désactiver SWAP, surtout dans un environnement de production.

Exécutez la commande ci-dessous pour vérifier que votre CPU prend en charge la fonctionnalité SSE 4.2. Vous devriez recevoir la sortie ‘SSE 4.2 supported’ si votre CPU est pris en charge.

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

Ensuite, exécutez la commande ci-dessous pour désactiver SWAP via le fichier de configuration ‘ /etc/fstab ‘. Cette commande mettra ‘#’ au début de la configuration SWAP et désactivera SWAP dans votre système de manière permanente.

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

Maintenant, exécutez la commande ci-dessous pour désactiver SWAP lors de la session actuelle. Ensuite, vérifiez l’état de SWAP.

sudo swapoff -a  
sudo free -m

Voici la sortie que vous recevrez si SWAP est désactivé - La taille de SWAP dans le champ ‘total’ est 0.

Avec un CPU qui prend en charge SSE 4.2 et SWAP désactivé, vous êtes maintenant prêt à installer le système de base de données OLAP ClickHouse.

Installation du système de base de données OLAP ClickHouse

Le système de base de données OLDAP ClickHouse propose plusieurs méthodes d’installation. Pour les distributions Linux, ClickHouse fournit des dépôts pour les distributions basées sur Debian et RPM. De plus, ClickHouse est disponible avec une installation via Docker ou en utilisant un seul paquet binaire.

Dans cette étape, vous allez installer ClickHouse sur un système Ubuntu 22.04 via le dépôt officiel. Donc, vous allez ajouter le dépôt ClickHouse à votre système, puis installer le paquet ClickHouse via APT.

Pour commencer, exécutez la commande apt ci-dessous pour installer quelques dépendances de base. Lorsque vous y êtes invité, saisissez y et appuyez sur ENTRÉE.

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

Maintenant, exécutez la commande ci-dessous pour ajouter la clé GPG et le dépôt ClickHouse à votre système. Dans cet exemple, vous allez installer ClickHouse à partir de la branche stable du dépôt.

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

Ensuite, mettez à jour et rafraîchissez votre index de paquets via la commande apt ci-dessous.

sudo apt update

Vous recevrez que le dépôt ClickHouse est ajouté.

Maintenant, installez le ‘ clickhouse-server ‘ en tant que système de base de données et le paquet ‘ clickhouse-client ‘ via la commande apt ci-dessous.

sudo apt install clickhouse-server clickhouse-client

Saisissez Y lorsque vous y êtes invité pour la confirmation et appuyez sur ENTRÉE pour continuer.

De plus, pendant l’installation de ClickHouse, vous serez invité à configurer un mot de passe pour l’utilisateur par défaut de ClickHouse. Saisissez un nouveau mot de passe pour ClickHouse et vous recevrez une sortie comme la capture d’écran suivante lorsque l’installation est terminée.

Avec ClickHouse installé, exécutez la commande systemctl ci-dessous pour démarrer et activer le service ClickHouse. Cette commande démarrera ClickHouse et activera le service pour qu’il s’exécute automatiquement au démarrage.

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

Vérifiez le service ClickHouse avec la commande ci-dessous pour vous assurer que le service ClickHouse fonctionne.

sudo systemctl status clickhouse-server

Vous recevrez une sortie comme la suivante - L’état actuel du service ClickHouse est en cours d’exécution et il est activé et sera exécuté automatiquement au démarrage.

Vous avez terminé l’installation du serveur ClickHouse. Dans l’étape suivante, vous apprendrez comment accéder au serveur ClickHouse via l’application cliente et configurer l’authentification par mot de passe pour l’utilisateur administrateur de ClickHouse.

Accéder à ClickHouse via la ligne de commande

Avec le serveur ClickHouse installé, vous pouvez accéder à ClickHouse via le ‘ clickhouse-client ‘ que vous avez également installé.

Le ‘clickhouse-client’ est une interface en ligne de commande pour interagir et gérer le serveur ClickHouse. Il est similaire au client ‘ mysql ‘ pour le serveur MySQL/MariaDB, ‘ psql ‘ pour le serveur PostgreSQL ou ‘ mongod ‘ pour le serveur MongoDB.

Pour accéder au serveur ClickHouse, vous pouvez utiliser la commande ‘ clickhouse-client ‘ ci-dessous.

sudo clickhouse-client --password

Lorsque vous êtes invité à entrer le mot de passe, saisissez le mot de passe que vous avez créé lors de l’installation.

Après vous être connecté, vous devriez voir le shell ClickHouse comme suit.

Ici, vous pouvez voir que vous êtes connecté au serveur ClickHouse v22.11 avec l’utilisateur par défaut de ClickHouse. Le serveur ClickHouse fonctionne par défaut sur localhost avec le port 9000.

À ce stade, vous avez installé le serveur et le client ClickHouse et appris comment vous connecter au serveur ClickHouse via la commande ‘ clickhouse-client ‘. Dans l’étape suivante, vous allez configurer un utilisateur administrateur pour le serveur ClickHouse.

Configuration de l’utilisateur administrateur sur ClickHouse

Dans cette étape, vous allez créer un utilisateur administrateur pour le serveur ClickHouse. Mais avant cela, vous allez activer la ‘Gestion des comptes’ pour l’utilisateur ‘default’ via la configuration ClickHouse.

Pour commencer, ouvrez la configuration ‘/etc/clickhouse-server/users.d/default_password.xml’ en utilisant la commande de l’éditeur nano ci-dessous.

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

Ajoutez la ligne suivante entre la section ‘… ‘. Cela activera la ‘ Gestion des accès ‘ pour l’utilisateur ‘ default ‘.

  
      
          
            ...  
            1  
          
      

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Maintenant, exécutez la commande systemctl ci-dessous pour redémarrer le service ClickHouse et appliquer les modifications.

sudo systemctl restart clickhouse-server

Maintenant que la ‘ gestion des accès ‘ est activée pour l’utilisateur ‘default’, vous allez ensuite créer un nouvel utilisateur administrateur pour ClickHouse. Le nouvel utilisateur pourra accéder à toutes les bases de données avec tous les privilèges sur le serveur ClickHouse.

Exécutez la commande ‘ clickhouse-client ‘ ci-dessous pour vous connecter au serveur ClickHouse via l’utilisateur ‘ default ‘.

sudo clickhouse-client --user default --password

Lorsque vous êtes invité à entrer le mot de passe, saisissez le mot de passe que vous avez configuré. Vous obtiendrez maintenant la console du serveur ClickHouse et vous vous connecterez en tant qu’utilisateur ‘ default ‘ avec ‘ access_management ‘ activé.

Ensuite, exécutez la requête suivante pour créer un nouvel utilisateur ClickHouse. Et assurez-vous de changer le nom d’utilisateur, le mot de passe et l’adresse IP de l’hôte. Cet exemple créera un nouvel utilisateur ‘ halsey ‘ avec le mot de passe ‘password’ et haché avec SHA256. L’option ‘ HOST IP ‘ vous permet de spécifier l’adresse IP qui sera utilisée pour se connecter au serveur ClickHouse. Dans cet exemple, seul localhost ou ‘ 127.0.0.1 ‘ est autorisé.

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

Maintenant, exécutez la requête ci-dessous pour accorder tous les privilèges sur le serveur ClickHouse à l’utilisateur ‘ halsey ‘.

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

Ensuite, vérifiez la liste des utilisateurs sur le serveur ClickHouse via la requête suivante. Vous devriez voir que le nouvel utilisateur ‘halsey’ a été ajouté au ClickHouse.

SHOW USERS;

Maintenant, tapez ‘quit’ sur le client de la console ClickHouse pour quitter.

Avec le nouvel utilisateur administrateur de base de données créé, vous devez ensuite désactiver la ‘ gestion des accès ‘ pour l’utilisateur ‘ default ‘ sur votre serveur ClickHouse.

Ouvrez la configuration ‘ /etc/clickhouse-server/users.d/default_password.xml ‘ en utilisant la commande de l’éditeur nano ci-dessous.

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

Changez l’option ‘ access_management ‘ à ‘ 0 ‘ pour désactiver la ‘ Gestion des accès ‘ pour l’utilisateur ‘ default ‘.

  
      
          
            ...  
            0  
          
      

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Redémarrez le service ClickHouse pour appliquer les modifications via la commande systemctl ci-dessous.

sudo systemctl restart clickhouse-server

Enfin, exécutez la commande suivante pour vous connecter au serveur ClickHouse en tant qu’utilisateur ‘halsey’. Lorsque vous êtes invité à entrer le mot de passe, saisissez votre mot de passe et appuyez sur ENTRÉE pour vous connecter.

sudo clickhouse-client --user halsey --password

Après vous être connecté, vous recevrez une sortie comme la capture d’écran suivante. Le nouvel utilisateur administrateur pour ClickHouse ‘halsey’ est ajouté et la connexion est réussie.

Avec le nouvel utilisateur administrateur du serveur ClickHouse créé, vous allez maintenant apprendre à utiliser ClickHouse pour créer des bases de données et des tables et insérer et récupérer des données via la requête SQL ClickHouse.

Requêtes de base sur le système de base de données ClickHouse

Dans cette étape, vous apprendrez la requête de base du système de base de données ClickHouse, qui est similaire aux requêtes SQL courantes. Vous apprendrez comment créer une base de données et une table, insérer et récupérer des données de la base de données, puis l’utilisation de base de la requête ‘ ALTER ‘ que vous pouvez utiliser pour modifier des données existantes sur le serveur ClickHouse.

Tout d’abord, exécutez la requête suivante pour créer une nouvelle base de données. Dans cet exemple, vous allez créer une nouvelle base de données ‘ testdb ‘.

CREATE DATABASE testdb;

Passez à la ‘ testdb ‘ via la requête suivante ‘ USE dbname’.

USE testdb;

Maintenant, créez une nouvelle table, ‘users,’ avec la requête suivante. La table ‘ users ‘ aura quelques champs ci-dessous :

• id de type ‘UInt64’ pour stocker des valeurs entières.
• name de type ‘String’ pour stocker des chaînes - longueur de caractère.
• last_login de type ‘DateTime’ pour le format de date et heure de chaîne.
• Le moteur ici est ‘MergeTree’, principalement utilisé sur ClickHouse.

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

Ensuite, exécutez la requête suivante pour insérer de nouvelles données dans la table ‘users’. Dans la requête ci-dessous, vous allez insérer trois données différentes dans la table ‘ 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');

Insérez la première donnée.

Insérez la deuxième donnée.

Insérez la troisième donnée.

Exécutez la requête suivante pour récupérer des données de la table ‘ users ‘. Vous devriez voir trois nouveaux champs de données que vous venez d’ajouter.

SELECT * FROM users;

Vous avez appris comment créer la base de données, passer à la base de données, créer la table, insérer des données et récupérer des données sur le système de base de données OLAP ClickHouse. Ensuite, vous apprendrez à modifier des données avec la requête ‘ ALTER ‘.

Exécutez la requête ‘ALTER TABLE’ suivante pour mettre à jour des données existantes dans la table ‘users’. Dans cet exemple, vous allez changer le champ ‘jobs’ pour l’utilisateur ‘ alex ‘ en ‘ administrator ‘.

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

Vérifiez les nouvelles données mises à jour dans la table ‘users’ via la requête suivante. Vous devriez maintenant obtenir les nouvelles données pour l’utilisateur ‘ alex ‘ mises à jour en ‘ Administrator ‘.

SELECT * FROM users;

Maintenant que vous avez appris l’utilisation de base de la requête ClickHouse pour créer et changer des bases de données, créer des tables, insérer des données et récupérer des données. Et aussi, vous avez appris comment utiliser la requête ‘ ALTER ‘ pour changer des données existantes sur la base de données ClickHouse. Vous allez maintenant nettoyer votre installation ClickHouse.

Nettoyage de l’environnement

Avec la nouvelle base de données et la table créées et des données aléatoires insérées, dans cette dernière étape, vous allez nettoyer l’installation du système de base de données ClickHouse en supprimant la base de données et la table que vous venez de créer.

Exécutez la requête suivante, ‘DROP TABLE,’ pour supprimer la table users de la base de données testdb.

DROP TABLE users;

Maintenant, supprimez la base de données ‘testdb’ via la requête ‘ DROP DATABASE ‘ ci-dessous.

DROP DATABASE testdb;

Enfin, vérifiez la liste des bases de données sur le serveur ClickHouse via la requête suivante. Vous devriez voir que la base de données ‘ testdb ‘ a été supprimée du serveur ClickHouse.

SHOW DATABASES;

Maintenant, votre installation ClickHouse est nettoyée avec l’utilisateur administrateur également configuré.

Conclusion

Félicitations ! Vous avez terminé l’installation du système de base de données OLAP ClickHouse et appris comment configurer un utilisateur administrateur sur ClickHouse. Et enfin, vous avez également appris la requête de base pour créer une base de données et une table, insérer et récupérer des données, changer des données existantes et nettoyer la base de données et la table.