> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-67bc7bf8.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Insérer des données dans ClickHouse Cloud avec clickhouse-client

> Découvrez comment utiliser clickhouse-client pour insérer dans un service ClickHouse Cloud des données provenant de fichiers CSV et Parquet locaux, depuis la ligne de commande.

<a href="/fr/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">Tous les guides de démarrage rapide</Badge></a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">Analytics en temps réel</Badge>
  <Badge size="lg" color="blue">Entreposage de données</Badge>
  <Badge size="lg" color="blue">Observabilité</Badge>
  <Badge size="lg" color="blue">IA/ML</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## Prérequis
</div>

Vous devez également avoir terminé les guides de démarrage rapide suivants :

* [Créez votre premier service Cloud](/fr/get-started/quickstarts/create-your-first-service-on-cloud) - vous aurez besoin d'un service ClickHouse Cloud en cours d'exécution pour y insérer des données
* [Obtenez les informations de connexion à votre service Cloud](/fr/get-started/quickstarts/obtain-your-cloud-connection-details) - vous aurez besoin du nom d'hôte, du nom d'utilisateur et du mot de passe pour vous connecter

<div id="what-youll-build">
  ## Ce que vous allez créer
</div>

Dans ce guide de démarrage rapide, vous utiliserez **clickhouse-client** - le client CLI officiel de ClickHouse - pour insérer des données d’un fichier CSV file local dans un service ClickHouse Cloud.
Vous installerez clickhouse-client, préparerez un jeu de données d’exemple, vous vous connecterez à votre service Cloud, créerez une table et y insérerez des données depuis votre machine locale.
À la fin, vous saurez utiliser clickhouse-client pour charger des fichiers locaux dans ClickHouse Cloud, dans un flux de travail compatible avec les formats CSV, Parquet, JSON et bien d’autres.

<Steps titleSize="h3">
  <Step>
    ### Installer clickhouse-client

    `clickhouse-client` est l’interface en ligne de commande officielle pour se connecter à ClickHouse. Il est inclus dans le binaire ClickHouse.

    Installez-le à l’aide de l’installateur universel :

    ```bash theme={null}
    curl https://clickhouse.com/ | sh
    ```

    Cette commande télécharge le dernier binaire `clickhouse` dans votre répertoire courant. Vérifiez l’installation :

    ```bash theme={null}
    ./clickhouse client --version
    ```

    Vous devriez voir un résultat indiquant le numéro de version de ClickHouse, ce qui confirme que `clickhouse-client` est prêt à être utilisé.
  </Step>

  <Step>
    ### Préparez un fichier CSV d’exemple

    Créez un petit fichier CSV d’exemple pour que ce guide de prise en main soit autonome. Exécutez ce qui suit dans votre terminal :

    ```bash theme={null}
    cat <<'EOF' > sample_data.csv
    timestamp,event_type,user_id,duration_ms,status
    2024-01-15 10:30:00,page_view,1001,120,success
    2024-01-15 10:31:15,click,1002,45,success
    2024-01-15 10:32:00,page_view,1003,200,success
    2024-01-15 10:33:30,purchase,1001,1500,success
    2024-01-15 10:34:00,click,1004,60,error
    2024-01-15 10:35:45,page_view,1002,95,success
    2024-01-15 10:36:10,purchase,1005,2200,success
    2024-01-15 10:37:00,click,1003,30,success
    2024-01-15 10:38:20,page_view,1004,150,error
    2024-01-15 10:39:00,purchase,1002,1800,success
    EOF
    ```
  </Step>

  <Step>
    ### Connectez-vous à votre service Cloud

    Les commandes ci-dessous supposent que vous avez exporté `CLICKHOUSE_HOST`, `CLICKHOUSE_USER` et `CLICKHOUSE_PASSWORD` comme variables d’environnement, comme indiqué dans le quickstart [Obtain your Cloud connection details](/fr/get-started/quickstarts/obtain-your-cloud-connection-details). Si ce n’est pas le cas, vous pouvez les remplacer directement par vos propres valeurs.

    Testez la connexion en exécutant une requête simple sur votre service Cloud :

    ```bash theme={null}
    ./clickhouse client \
      --host $CLICKHOUSE_HOST \
      --port 9440 \
      --user $CLICKHOUSE_USER \
      --password $CLICKHOUSE_PASSWORD \
      --secure \
      -q "SELECT 1"
    ```

    Si la connexion réussit, vous verrez `1` s’afficher dans le terminal. Si vous obtenez une erreur de connexion, vérifiez que votre service est bien en cours d’exécution dans la console Cloud et que votre nom d’hôte et votre mot de passe sont corrects.

    <Note>
      Le port `9440` est le port sécurisé du protocole natif pour ClickHouse Cloud. L’option `--secure` active le chiffrement TLS. Ils sont requis pour toutes les connexions Cloud.
    </Note>
  </Step>

  <Step>
    ### Créer une table cible et insérer des données

    Tout d’abord, créez une table sur votre service Cloud pour recevoir les données :

    ```bash theme={null}
    ./clickhouse client \
      --host $CLICKHOUSE_HOST \
      --port 9440 \
      --user $CLICKHOUSE_USER \
      --password $CLICKHOUSE_PASSWORD \
      --secure \
      -q "
        CREATE TABLE IF NOT EXISTS events (
          timestamp DateTime,
          event_type LowCardinality(String),
          user_id UInt32,
          duration_ms UInt32,
          status LowCardinality(String)
        )
        ENGINE = MergeTree
        ORDER BY (event_type, timestamp)
      "
    ```

    Insérez maintenant les données de votre fichier CSV local. C’est l’étape clé : `clickhouse-client` lit le fichier depuis stdin et l’achemine en continu vers le service distant :

    ```bash theme={null}
    ./clickhouse client \
      --host $CLICKHOUSE_HOST \
      --port 9440 \
      --user $CLICKHOUSE_USER \
      --password $CLICKHOUSE_PASSWORD \
      --secure \
      -q "INSERT INTO events FORMAT CSVWithNames" < sample_data.csv
    ```

    `clickhouse-client` envoie directement le contenu du fichier CSV à votre service Cloud. Le format `CSVWithNames` indique à ClickHouse que la première ligne contient les noms des colonnes.
  </Step>

  <Step>
    ### Vérifiez que les données ont bien été insérées

    Interrogez votre service Cloud pour vérifier que les lignes ont bien été insérées :

    ```bash theme={null}
    ./clickhouse client \
      --host $CLICKHOUSE_HOST \
      --port 9440 \
      --user $CLICKHOUSE_USER \
      --password $CLICKHOUSE_PASSWORD \
      --secure \
      -q "SELECT count() FROM events"
    ```

    Vous devriez voir `10`, le nombre de lignes du fichier CSV d’exemple.

    Prévisualisez les données :

    ```bash theme={null}
    ./clickhouse client \
      --host $CLICKHOUSE_HOST \
      --port 9440 \
      --user $CLICKHOUSE_USER \
      --password $CLICKHOUSE_PASSWORD \
      --secure \
      -q "SELECT * FROM events ORDER BY timestamp LIMIT 5"
    ```

    Ce même workflow fonctionne avec Parquet, TSV, JSON, Avro, ORC et bien d’autres [formats pris en charge](/fr/reference/formats/index) ; il suffit de modifier la clause `FORMAT` et de fournir le fichier approprié en entrée.
  </Step>
</Steps>

## Étapes suivantes

Dans ce guide de démarrage rapide, vous avez installé `clickhouse-client`, l’avez connecté à un service ClickHouse Cloud, puis l’avez utilisé pour ingérer des données depuis un fichier CSV local vers le Cloud. Cette même approche fonctionne avec Parquet, JSON et des dizaines d’autres formats.

Découvrez ensuite les guides de démarrage rapide suivants :

* [Créer votre première table MergeTree](/fr/get-started/quickstarts/create-your-first-mergetree-table)

Ou approfondissez avec la documentation de référence :

* [Référence de clickhouse-client](/fr/concepts/features/interfaces/cli)
* [Formats d’entrée/sortie pris en charge](/fr/reference/formats/index)

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/IZH2CZJY-CKRYgTZ/images/academy.png?fit=max&auto=format&n=IZH2CZJY-CKRYgTZ&q=85&s=2e94c6b2f4f2db55ba45ea55a13f7b1b" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.png" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/fr/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">Tous les guides de démarrage rapide</Badge></a>
</div>