> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Démarrage rapide de ClickHouse Cloud
> Guide de démarrage rapide pour ClickHouse Cloud
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> Le moyen le plus rapide et le plus simple pour démarrer avec ClickHouse consiste à créer un nouveau
> service dans [ClickHouse Cloud](https://console.clickhouse.cloud). Dans ce guide de prise en main rapide, nous allons vous montrer comment le configurer
> en trois étapes simples.
Pour créer un service ClickHouse gratuit dans [ClickHouse Cloud](https://console.clickhouse.cloud), il vous suffit de vous inscrire en suivant les étapes ci-dessous :
* Créez un compte sur la [page d'inscription](https://console.clickhouse.cloud/signUp)
* Vous pouvez choisir de 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 via 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'onboarding, 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 sur le niveau Scale et créeront 3 répliques, chacune avec 4 vCPU et 16 GiB de RAM. Le [vertical autoscaling](/docs/fr/products/cloud/features/autoscaling/vertical) sera 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 spécifiant une taille minimale et maximale entre lesquelles les répliques pourront évoluer. Lorsque tout est prêt, sélectionnez `Create service`.
Félicitations ! Votre service ClickHouse Cloud est opérationnel et l'onboarding est terminé. Poursuivez votre lecture pour découvrir comment commencer à ingérer et interroger vos données.
Il existe 2 façons de se connecter à ClickHouse :
* Se connecter à l’aide de notre console SQL en ligne
* Se connecter avec votre application
### Se connecter à l’aide de la console SQL
Pour démarrer rapidement, ClickHouse met à votre disposition une console SQL en ligne 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 la connexion fonctionne :
```sql theme={null}
SHOW databases
```
Vous devriez voir 4 bases de données dans la liste, ainsi que toutes celles que vous avez éventuellement ajoutées.
C'est tout : vous êtes prêt à commencer à utiliser votre nouveau service ClickHouse !
### Connectez votre application
Appuyez sur le bouton Connect dans le menu de navigation. Une fenêtre modale s'ouvrira et vous proposera les identifiants de votre service ainsi qu'un ensemble d'instructions expliquant comment vous connecter via votre interface ou vos clients pour différents langages.
Si vous ne voyez pas votre client pour le langage souhaité, vous pouvez consulter notre liste des [Integrations](/docs/fr/integrations/home).
ClickHouse est encore plus puissant avec des données ! Il existe plusieurs façons d'ajouter des données, et la plupart sont disponibles sur la page Sources de données, accessible depuis le menu de navigation.
Vous pouvez téléverser des données à l'aide des méthodes suivantes :
* Configurer un ClickPipe pour commencer à ingérer des données à partir de sources de données comme S3, Postgres, Kafka et GCS
* Utiliser la console SQL
* Utiliser le client ClickHouse
* Téléverser un fichier - les formats acceptés incluent JSON, CSV et TSV
* Téléverser des données depuis l’URL d’un fichier
### ClickPipes
[ClickPipes](http://clickhouse.com/docs/integrations/clickpipes) est une plateforme d'intégration managée qui simplifie l'ingestion de données provenant de sources variées en 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é pour des besoins de streaming à long terme ou pour un chargement de données ponctuel.
### Ajouter des données via la console SQL
Comme la plupart des systèmes de gestion de bases de données, ClickHouse regroupe logiquement les tables en **bases de données**. Utilisez la commande [`CREATE DATABASE`](/docs/fr/reference/statements/create/database) pour créer une nouvelle base de données dans ClickHouse :
```sql theme={null}
CREATE DATABASE IF NOT EXISTS helloworld
```
Exécutez la commande suivante pour créer une table nommée `my_first_table` dans la base de données `helloworld` :
```sql theme={null}
CREATE TABLE helloworld.my_first_table
(
user_id UInt32,
message String,
timestamp DateTime,
metric Float32
)
ENGINE = MergeTree()
PRIMARY KEY (user_id, timestamp)
```
Dans l'exemple ci-dessus, `my_first_table` est une table [`MergeTree`](/docs/fr/reference/engines/table-engines/mergetree-family/mergetree) comportant quatre colonnes :
* `user_id` : un entier non signé de 32 bits ([UInt32](/docs/fr/reference/data-types/int-uint))
* `message` : un type de données [String](/docs/fr/reference/data-types/string), qui remplace des types tels que `VARCHAR`, `BLOB`, `CLOB` et d'autres dans d'autres systèmes de gestion de bases de données
* `timestamp` : une valeur [DateTime](/docs/fr/reference/data-types/datetime), qui représente un instant précis
* `metric` : un nombre à virgule flottante de 32 bits ([Float32](/docs/fr/reference/data-types/float))
**Moteurs de table**
Les 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`](/docs/fr/reference/engines/table-engines/mergetree-family/mergetree) sera probablement le choix le plus adapté.
#### Brève introduction aux clés primaires
Avant d'aller plus loin, il est important de comprendre le fonctionnement des clés primaires dans ClickHouse (leur implémentation
peut sembler inattendue !) :
* dans ClickHouse, les clés primaires ne sont ***pas uniques*** pour chaque ligne d’une table
La clé primaire d'une table ClickHouse détermine la façon dont les données sont triées lors de leur écriture sur le disque. Toutes les 8 192 lignes ou 10 Mo de
données (désignés sous le terme **index granularity**) créent une entrée dans le fichier d'index de clé primaire. Ce concept de granularité
crée un **sparse index** qui tient aisément en mémoire, et les granules représentent une stripe de la plus petite quantité de
données de colonne traitées 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 `PRIMARY KEY`,
la clé devient alors le tuple spécifié dans la clause `ORDER BY`. Si vous spécifiez à la fois un `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 un tuple de `(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 une présentation approfondie des concepts fondamentaux de ClickHouse, consultez ["Core Concepts"](/docs/fr/concepts/core-concepts/index).
#### Insérer des données dans votre table
Vous pouvez utiliser la commande [`INSERT INTO TABLE`](/docs/fr/reference/statements/insert-into) familière avec ClickHouse, mais il est important de comprendre que chaque insertion dans une table [`MergeTree`](/docs/fr/reference/engines/table-engines/mergetree-family/mergetree) entraîne la création d'une **part** dans le stockage.
**Bonne pratique ClickHouse**
Insérez un grand nombre de lignes par lot — des dizaines de milliers, voire des millions de
lignes à la fois. Pas d’inquiétude : ClickHouse peut facilement gérer un tel volume, et cela vous [fera économiser de l’argent](/docs/fr/concepts/best-practices/selecting-an-insert-strategy#batch-inserts-if-synchronous) en envoyant moins de requêtes d’écriture à votre service.
Même pour un exemple simple, insérons plusieurs lignes à la fois :
```sql theme={null}
INSERT INTO helloworld.my_first_table (user_id, message, timestamp, metric) VALUES
(101, 'Hello, ClickHouse!', now(), -1.0 ),
(102, 'Insert a lot of rows per batch', yesterday(), 1.41421 ),
(102, 'Sort your data based on your commonly-used queries', today(), 2.718 ),
(101, 'Granules are the smallest chunks of data read', now() + 5, 3.14159 )
```
Notez que la colonne `timestamp` est alimentée à l’aide de diverses fonctions [**Date**](/docs/fr/reference/data-types/date) et [**DateTime**](/docs/fr/reference/data-types/datetime). ClickHouse propose des centaines de fonctions utiles, que vous pouvez [consulter dans la section **Fonctions**](/docs/fr/reference/functions/index).
Vérifions que cela a fonctionné :
```sql theme={null}
SELECT * FROM helloworld.my_first_table
```
### Ajouter des données avec le client ClickHouse
Vous pouvez également vous connecter à votre service ClickHouse Cloud à l'aide d'un outil en ligne de commande nommé [**clickhouse client**](/docs/fr/concepts/features/interfaces/cli). 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](/docs/fr/concepts/features/interfaces/cli).
2. Exécutez la commande en remplaçant par votre nom d’hôte, votre nom d’utilisateur et votre mot de passe :
```bash theme={null}
./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password
```
Si l'invite avec le smiley s'affiche, vous êtes prêt à exécuter des requêtes !
```response theme={null}
:)
```
3. Pour l’essayer, exécutez la requête suivante :
```sql theme={null}
SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
```
Notez que la réponse est retournée dans un format de tableau clair :
```response theme={null}
┌─user_id─┬─message────────────────────────────────────────────┬───────────timestamp─┬──metric─┐
│ 102 │ Insert a lot of rows per batch │ 2022-03-21 00:00:00 │ 1.41421 │
│ 102 │ Sort your data based on your commonly-used queries │ 2022-03-22 00:00:00 │ 2.718 │
│ 101 │ Hello, ClickHouse! │ 2022-03-22 14:04:09 │ -1 │
│ 101 │ Granules are the smallest chunks of data read │ 2022-03-22 14:04:14 │ 3.14159 │
└─────────┴────────────────────────────────────────────────────┴─────────────────────┴─────────┘
4 rows in set. Elapsed: 0.008 sec.
```
4. Ajoutez une clause [`FORMAT`](/docs/fr/reference/statements/select/format) pour indiquer l’un des [nombreux formats de sortie pris en charge par ClickHouse](/docs/fr/reference/formats/index) :
```sql theme={null}
SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
FORMAT TabSeparated
```
Dans la requête ci-dessus, la sortie est renvoyée sous forme de valeurs séparées par des tabulations :
```response theme={null}
Query id: 3604df1c-acfd-4117-9c56-f86c69721121
102 Insert a lot of rows per batch 2022-03-21 00:00:00 1.41421
102 Sort your data based on your commonly-used queries 2022-03-22 00:00:00 2.718
101 Hello, ClickHouse! 2022-03-22 14:04:09 -1
101 Granules are the smallest chunks of data read 2022-03-22 14:04:14 3.14159
4 rows in set. Elapsed: 0.005 sec.
```
5. Pour quitter le `clickhouse client`, entrez la commande **exit** :
```bash theme={null}
exit
```
### Téléverser un fichier
Une tâche courante lors de la prise en main d'une base de données consiste à insérer des données que vous avez déjà dans des fichiers. Nous proposons des données d'exemple en ligne que vous pouvez insérer, représentant des données de flux de clics — elles comprennent un identifiant utilisateur, une URL visitée et le timestamp de l'événement.
Supposons que nous ayons le texte suivant dans un fichier CSV nommé `data.csv` :
```bash title="data.csv" theme={null}
102,This is data in a file,2022-02-22 10:43:28,123.45
101,It is comma-separated,2022-02-23 00:00:00,456.78
103,Use FORMAT to specify the format,2022-02-21 10:43:30,678.90
```
1. La commande suivante insère les données dans la table `my_first_table` :
```bash theme={null}
./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password \
--query='INSERT INTO helloworld.my_first_table FORMAT CSV' < data.csv
```
2. Notez que les nouvelles lignes apparaissent désormais dans la table si vous effectuez la requête depuis la SQL Console :
**Filtrage par liste d’accès IP**
Avant de poursuivre, nous vous recommandons de configurer le filtrage par liste d’accès IP.
Consultez [« Configurer les filtres IP »](/docs/fr/products/cloud/guides/security/connectivity/setting-ip-filters) pour plus de détails.
## Et ensuite ?
* Le [Tutoriel](/docs/get-started/quickstarts/tutorial) vous explique comment insérer 2 millions de lignes dans une table et écrire quelques requêtes analytiques
* Nous proposons une liste de [jeux de données d’exemple](/docs/fr/get-started/sample-datasets/index) avec des instructions pour les insérer
* Consultez notre vidéo de 12 minutes sur les [premiers pas avec ClickHouse](https://clickhouse.com/company/events/getting-started-with-clickhouse/)
* Si vos données proviennent d’une source externe, consultez notre [collection de guides d’intégration](/docs/fr/integrations/home) pour vous connecter à des files de messages, des bases de données, des pipelines, etc.
* Si vous utilisez un outil de visualisation UI/BI, consultez les [guides utilisateur pour connecter votre UI à ClickHouse](/docs/fr/integrations/connectors/data-visualization/index)
* Le guide utilisateur sur les [clés primaires](/docs/fr/guides/clickhouse/data-modelling/sparse-primary-indexes) contient tout ce qu’il faut savoir sur les clés primaires et sur la manière de les définir