Skip to main content
Le moyen le plus rapide et le plus simple de démarrer avec ClickHouse consiste à créer un nouveau service dans ClickHouse Cloud. Dans ce guide de démarrage rapide, nous vous aiderons à configurer votre environnement en trois étapes simples.
1

Créer un service ClickHouse

Pour créer un service ClickHouse gratuit dans ClickHouse Cloud, il vous suffit de suivre les étapes ci-dessous :
  • Créez un compte sur la page d’inscription
  • Vous pouvez vous inscrire avec votre adresse e-mail, ou via Google SSO, Microsoft SSO, AWS Marketplace, Google Cloud ou Microsoft Azure
  • Si vous vous inscrivez avec une adresse e-mail et un mot de passe, pensez à vérifier votre adresse e-mail dans les 24 heures en cliquant sur le lien reçu par e-mail
  • Connectez-vous avec le nom d’utilisateur et le mot de passe que vous venez de créer

Une fois connecté, ClickHouse Cloud lance l’assistant d’intégration, qui vous guide dans la création d’un nouveau service ClickHouse. Sélectionnez la région dans laquelle déployer le service, puis donnez un nom à votre nouveau service :
Par défaut, les nouvelles organisations sont placées dans le niveau Scale et créent 3 répliques, chacune disposant de 4 vCPU et de 16 GiB de RAM. Le dimensionnement automatique vertical est activé par défaut dans le niveau Scale. Vous pourrez modifier ultérieurement le niveau de votre organisation sur la page ‘Plans’.Personnalisez les ressources du service si nécessaire en définissant les tailles minimale et maximale entre lesquelles les répliques peuvent évoluer. Lorsque vous êtes prêt, sélectionnez Create service.
Félicitations ! Votre service ClickHouse Cloud est opérationnel et l’intégration est terminée. Poursuivez votre lecture pour savoir comment commencer à ingérer et à interroger vos données.
2

Se connecter à ClickHouse

Il existe deux façons de vous connecter à ClickHouse :
  • Utiliser notre console SQL web
  • Vous connecter avec votre application

Utiliser la console SQL

Pour démarrer rapidement, ClickHouse propose une console SQL web vers laquelle vous serez redirigé une fois l’onboarding terminé.Créez un onglet de requête et saisissez une requête simple pour vérifier que votre connexion fonctionne :
Vous devriez voir 4 bases de données dans la liste, en plus de celles que vous avez éventuellement ajoutées.
C’est tout : vous pouvez commencer à utiliser votre nouveau service ClickHouse !

Connectez votre application

Cliquez sur le bouton Connect dans le menu de navigation. Une fenêtre modale s’ouvrira, affichant les identifiants de votre service et des instructions pour vous connecter à l’aide de votre interface ou de vos clients de langage.
Si votre client de langage n’est pas répertorié, consultez notre liste d’intégrations.
3

Ajouter des données

ClickHouse est bien meilleur avec des données ! Il existe plusieurs façons d’ajouter des données, et la plupart sont accessibles depuis la page Data Sources, disponible dans le menu de navigation.
Vous pouvez procéder au téléversement des données selon les méthodes suivantes :
  • Configurez un ClickPipe pour commencer à ingérer des données depuis des sources telles que S3, Postgres, Kafka ou GCS
  • Utilisez la console SQL
  • Utilisez le client ClickHouse
  • Téléversez un fichier - les formats acceptés incluent JSON, CSV et TSV
  • Téléversez des données à partir de l’URL d’un fichier

ClickPipes

ClickPipes est une plateforme d’intégration gérée qui rend l’ingestion de données depuis un large éventail de sources aussi simple que quelques clics. Conçue pour les charges de travail les plus exigeantes, l’architecture robuste et évolutive de ClickPipes garantit des performances et une fiabilité constantes. ClickPipes peut être utilisé aussi bien pour des besoins de streaming à long terme que pour un chargement de données ponctuel.

Ajouter des données depuis la SQL Console

Comme la plupart des systèmes de gestion de bases de données, ClickHouse regroupe logiquement les tables au sein de bases de données. Utilisez la commande CREATE DATABASE pour créer une nouvelle base de données dans ClickHouse :
Exécutez la commande suivante pour créer une table nommée my_first_table dans la base de données helloworld :
Dans l’exemple ci‑dessus, my_first_table est une table MergeTree comportant quatre colonnes :
  • user_id : un entier non signé de 32 bits (UInt32)
  • message : un type de données String, qui remplace des types tels que VARCHAR, BLOB, CLOB et d’autres utilisés dans d’autres systèmes de bases de données
  • timestamp : une valeur DateTime représentant un instant donné
  • metric : un nombre à virgule flottante de 32 bits (Float32)
Moteurs de tableLes moteurs de table déterminent :
  • Comment et où les données sont stockées
  • Quelles requêtes sont prises en charge
  • Si les données sont répliquées ou non

Il existe de nombreux moteurs de table, mais pour une table simple sur un serveur ClickHouse à nœud unique, MergeTree est probablement le meilleur choix.

Brève introduction aux clés primaires

Avant d’aller plus loin, il est important de comprendre comment fonctionnent les clés primaires dans ClickHouse (leur mise en œuvre peut sembler surprenante !) :
  • les clés primaires dans ClickHouse ne sont pas uniques pour chaque ligne d’une table
La clé primaire d’une table ClickHouse détermine la manière dont les données sont triées lorsqu’elles sont écrites sur le disque. Toutes les 8 192 lignes ou 10 Mo de données (appelées index granularity) créent une entrée dans le fichier d’index de la clé primaire. Ce concept de granularité crée un index sparse qui peut facilement tenir en mémoire, et les granules représentent une bande correspondant à la plus petite quantité de données de colonne traitée lors des requêtes SELECT.La clé primaire peut être définie à l’aide du paramètre PRIMARY KEY. Si vous définissez une table sans spécifier de PRIMARY KEY, la clé devient alors le tuple indiqué dans la clause ORDER BY. Si vous spécifiez à la fois une PRIMARY KEY et un ORDER BY, la clé primaire doit être un sous-ensemble de l’ordre de tri.La clé primaire est également la clé de tri, qui est le tuple (user_id, timestamp). Par conséquent, les données stockées dans chaque fichier de colonne seront triées par user_id, puis par timestamp.Pour un approfondissement des concepts fondamentaux de ClickHouse, consultez “Concepts fondamentaux”.

Insérer des données dans votre table

Avec ClickHouse, vous pouvez utiliser la commande familière INSERT INTO TABLE, mais il est important de comprendre que chaque insertion dans une table MergeTree provoque la création d’une part dans le stockage.
Bonne pratique ClickHouseInsérez un grand nombre de lignes par lot — des dizaines de milliers, voire des millions de lignes à la fois. ClickHouse peut facilement gérer ce type de volume et vous permettra de faire des économies en envoyant moins de requêtes d’écriture à votre service.

Même pour un exemple simple, insérons plusieurs lignes à la fois :
Notez que la colonne timestamp est renseignée à l’aide de diverses fonctions Date et DateTime. ClickHouse propose des centaines de fonctions utiles, que vous pouvez consulter dans la section Functions.
Vérifions que cela a bien fonctionné :

Ajouter des données à l’aide du ClickHouse Client

Vous pouvez également vous connecter à votre service ClickHouse Cloud à l’aide de l’outil en ligne de commande clickhouse client. Cliquez sur « Connect » dans le menu de gauche pour accéder à ces informations. Dans la boîte de dialogue, sélectionnez « Native » dans la liste déroulante :
  1. Installez ClickHouse.
  2. Exécutez la commande en remplaçant le hostname, le username et le password par les vôtres :
Si le prompt en forme de smiley s’affiche, vous pouvez commencer à exécuter des requêtes !
  1. Essayez d’exécuter la requête suivante :

Remarquez que la réponse est renvoyée sous la forme d’un tableau :
  1. Ajoutez une clause FORMAT pour spécifier l’un des nombreux formats de sortie pris en charge par ClickHouse :

Dans la requête ci-dessus, la sortie est renvoyée avec des champs séparés par des tabulations :
  1. Pour quitter le clickhouse client, exécutez la commande exit :

Téléverser un fichier

Une tâche courante lorsque l’on commence avec une base de données consiste à insérer des données que vous possédez déjà dans des fichiers. Nous disposons de données d’exemple en ligne que vous pouvez insérer et qui représentent des données de clickstream : elles comprennent un identifiant utilisateur, une URL visitée et l’horodatage de l’événement.Supposons que nous ayons le texte suivant dans un fichier CSV nommé data.csv :
data.csv
  1. La commande suivante insère les données dans my_first_table :

  1. Observez les nouvelles lignes qui apparaissent désormais dans la table lorsque vous exécutez une requête depuis la console SQL :


Filtrage par liste d’accès IPAvant de poursuivre, nous vous recommandons de configurer le filtrage par liste d’accès IP. Pour plus de détails, consultez “Configuration des filtres IP”.

Quelle est la prochaine étape ?

Dernière modification le 2 septembre 2026