ClickHouse - Comment se connecter à un cluster ClickHouse

Objectif

ClickHouse est un système de base de données analytique en colonnes et open source, conçu pour le traitement en temps réel de volumes de données massifs, offrant des performances élevées, une grande scalabilité et une faible latence.

Ce guide explique comment se connecter à un cluster ClickHouse à l'aide de la CLI native, HTTPS et des protocoles MySQL.

Prérequis

• Un projet Public Cloud dans votre compte OVHcloud.
• Un cluster ClickHouse en cours d'exécution sur OVHcloud Public Cloud et acceptant les connexions entrantes.

Accès à l'espace client OVHcloud

• Lien direct : Tous mes projets Public Cloud
• Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Analytics

En pratique

Télécharger les certificats serveur et utilisateur

Pour vous connecter au service ClickHouse, vous avez besoin de certificats serveur et utilisateur.

• Certificat serveur : le certificat de l'autorité de certification (CA) du serveur peut être téléchargé depuis l'onglet Dashboard.
• Certificat utilisateur et clé d'accès : le certificat utilisateur et la clé d'accès utilisateur peuvent être téléchargés depuis l'onglet Utilisateurs.

Méthodes de connexion

Vous pouvez vous connecter à un cluster ClickHouse en utilisant différents protocoles et ports :

Se connecter avec le protocole natif ClickHouse (port 20184)

Connectez-vous à l'aide de la CLI officielle clickhouse-client. Pour les détails d'installation, consultez la documentation officielle du client ClickHouse.

clickhouse-client --user avnadmin \
                  --password <password> \
                  --host clickhouse-01234567-89abcdef.database.cloud.ovh.net \
                  --port 20184 \
                  --secure

Remplacez <password> par votre mot de passe réel et le nom d'hôte par celui de votre tableau de bord de cluster.

Fichier de configuration du client ClickHouse

Vous pouvez configurer le client ClickHouse à l'aide d'un fichier XML ou YAML pour simplifier la connexion. Le client recherche les fichiers de configuration dans l'ordre suivant :

1. Un fichier spécifié avec -c / --config / --config-file.
2. ./clickhouse-client.[xml|yaml|yml].
3. $XDG_CONFIG_HOME/clickhouse/config.[xml|yaml|yml] (ou ~/.config/clickhouse/config.[xml|yaml|yml] si XDG_CONFIG_HOME n'est pas défini).
4. ~/.clickhouse-client/config.[xml|yaml|yml].
5. /etc/clickhouse-client/config.[xml|yaml|yml].

`<config>`
    `<user>avnadmin</user>`
    `<password>your_password</password>`
    `<secure>true</secure>`

    `<openSSL>`
        `<client>`
            `<caConfig>/home/user/clickhouse/ca.pem</caConfig>`
        </client>
    </openSSL>

    `<connections_credentials>`
        `<connection>`
            `<name>default</name>`
            `<hostname>clickhouse-01234567-89abcdef.database.cloud.ovh.net</hostname>`
            `<port>20184</port>`
        </connection>
    </connections_credentials>
</config>

user: avnadmin
password: 'your_password'
secure: true
openSSL:
  client:
    caConfig: '/home/user/clickhouse/ca.pem'

Modifiez ces valeurs selon la configuration de votre propre cluster.

Insérer des données dans ClickHouse avec la CLI native ClickHouse

Pour ce premier exemple, insérons une ligne de test dans la table my_table de la base test_db.

clickhouse-client --query "INSERT INTO test_db.my_table (id, message) VALUES (1, 'test-message-content')"

Interroger des données depuis ClickHouse avec la CLI native ClickHouse

Récupérez toutes les données de la table my_table dans la base test_db :

clickhouse-client --query "SELECT * FROM test_db.my_table"

Se connecter avec HTTPS (port 20185)

Connectez-vous à l'aide de curl ou de tout client HTTP via HTTPS :

curl https://clickhouse-01234567-89abcdef.database.cloud.ovh.net:20185 \
  --user avnadmin:`<password>` \
  -d "SELECT 1"

Remplacez <password> par votre mot de passe réel et le nom d'hôte par celui de votre tableau de bord de cluster.

Se connecter avec le protocole MySQL (port 20186)

Connectez-vous à l'aide du client standard mysql via l'interface compatible MySQL :

mysql --host=clickhouse-01234567-89abcdef.database.cloud.ovh.net \
      --port=20186 \
      --user=avnadmin \
      --password=<password> \
      --ssl-mode=REQUIRED

Remplacez <password> par votre mot de passe réel et le nom d'hôte par celui de votre tableau de bord de cluster.

Aller plus loin

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service Analytics !

Rejoignez notre communauté d'utilisateurs.