8.5 KiB
| machine_translated | machine_translated_rev | toc_priority | toc_title |
|---|---|---|---|
| true | f865c9653f |
11 | Installation |
Installation
Configuration Système Requise
ClickHouse peut fonctionner sur N'importe quel Linux, FreeBSD ou Mac OS X avec une architecture CPU x86_64, AArch64 ou PowerPC64LE.
Les binaires pré-construits officiels sont généralement compilés pour le jeu d'instructions x86_64 et leverage SSE 4.2, donc sauf indication contraire, l'utilisation du processeur qui le prend en charge devient une exigence système supplémentaire. Voici la commande pour vérifier si le processeur actuel prend en charge SSE 4.2:
$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
Pour exécuter ClickHouse sur des processeurs qui ne prennent pas en charge SSE 4.2 ou qui ont une architecture AArch64 ou PowerPC64LE, vous devez construire ClickHouse à partir de sources avec des ajustements de configuration appropriés.
Options D'Installation Disponibles
À partir de paquets DEB
Il est recommandé d'utiliser officiel pré-compilé deb Paquets Pour Debian ou Ubuntu.
Pour installer les paquets officiels ajoutez le référentiel Yandex dans /etc/apt/sources.list ou dans un autre /etc/apt/sources.list.d/clickhouse.list fichier:
deb http://repo.clickhouse.tech/deb/stable/ main/
Si vous souhaitez utiliser la version la plus récente, remplacer stable avec testing (ceci est recommandé pour vos environnements de test).
Exécutez ensuite ces commandes pour installer les paquets:
sudo apt-get install dirmngr # optional
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4 # optional
sudo apt-get update
sudo apt-get install clickhouse-client clickhouse-server
Vous pouvez également télécharger et installer des paquets manuellement à partir d'ici: https://repo.yandex.ru/clickhouse/deb/stable/main/.
Paquet
clickhouse-common-static— Installs ClickHouse compiled binary files.clickhouse-server— Creates a symbolic link forclickhouse-serveret installe la configuration du serveur par défaut.clickhouse-client— Creates a symbolic link forclickhouse-clientet d'autres outils. et installe les fichiers de configuration du client.clickhouse-common-static-dbg— Installs ClickHouse compiled binary files with debug info.
À partir de paquets RPM
Il est recommandé d'utiliser officiel pré-compilé rpm packages pour CentOS, RedHat et toutes les autres distributions Linux basées sur rpm.
Tout d'abord, vous devez ajouter le dépôt officiel:
sudo yum install yum-utils
sudo rpm --import https://repo.clickhouse.tech/CLICKHOUSE-KEY.GPG
sudo yum-config-manager --add-repo https://repo.clickhouse.tech/rpm/stable/x86_64
Si vous souhaitez utiliser la version la plus récente, remplacer stable avec testing (ceci est recommandé pour vos environnements de test). Le prestable la balise est parfois trop.
Exécutez ensuite ces commandes pour installer les paquets:
sudo yum install clickhouse-server clickhouse-client
Vous pouvez également télécharger et installer des paquets manuellement à partir d'ici: https://repo.clickhouse.tech / rpm / stable / x86_64.
À partir d'archives tgz
Il est recommandé d'utiliser officiel pré-compilé tgz archives pour toutes les distributions Linux, où l'installation de deb ou rpm les emballages n'est pas possible.
La version requise peut être téléchargée avec curl ou wget depuis le référentiel https://repo.yandex.ru/clickhouse/tgz/.
Après cela, les archives téléchargées doivent être décompressées et installées avec des scripts d'installation. Exemple pour la dernière version:
export LATEST_VERSION=`curl https://api.github.com/repos/ClickHouse/ClickHouse/tags 2>/dev/null | grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | head -n 1`
curl -O https://repo.clickhouse.tech/tgz/clickhouse-common-static-$LATEST_VERSION.tgz
curl -O https://repo.clickhouse.tech/tgz/clickhouse-common-static-dbg-$LATEST_VERSION.tgz
curl -O https://repo.clickhouse.tech/tgz/clickhouse-server-$LATEST_VERSION.tgz
curl -O https://repo.clickhouse.tech/tgz/clickhouse-client-$LATEST_VERSION.tgz
tar -xzvf clickhouse-common-static-$LATEST_VERSION.tgz
sudo clickhouse-common-static-$LATEST_VERSION/install/doinst.sh
tar -xzvf clickhouse-common-static-dbg-$LATEST_VERSION.tgz
sudo clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh
tar -xzvf clickhouse-server-$LATEST_VERSION.tgz
sudo clickhouse-server-$LATEST_VERSION/install/doinst.sh
sudo /etc/init.d/clickhouse-server start
tar -xzvf clickhouse-client-$LATEST_VERSION.tgz
sudo clickhouse-client-$LATEST_VERSION/install/doinst.sh
Pour les environnements de production, il est recommandé d'utiliser la dernière stable-version. Vous pouvez trouver son numéro sur la page GitHub https://github.com/ClickHouse/ClickHouse/tags avec postfix -stable.
À Partir De L'Image Docker
Pour exécuter Clickhouse à L'intérieur Docker suivez le guide sur Hub Docker. Ces images utilisent officiel deb les paquets à l'intérieur.
À Partir De Sources
Pour compiler manuellement ClickHouse, suivez les instructions pour Linux ou Mac OS X.
Vous pouvez compiler des paquets et les installer ou utiliser des programmes sans installer de paquets. En outre, en construisant manuellement, vous pouvez désactiver L'exigence SSE 4.2 ou construire pour les processeurs AArch64.
Client: programs/clickhouse-client
Server: programs/clickhouse-server
Vous devrez créer un dossier de données et de métadonnées et chown pour l'utilisateur souhaité. Leurs chemins peuvent être modifiés dans la configuration du serveur (src / programs / server / config.xml), par défaut, ils sont:
/opt/clickhouse/data/default/
/opt/clickhouse/metadata/default/
Sur Gentoo, vous pouvez simplement utiliser emerge clickhouse pour installer ClickHouse à partir de sources.
Lancer
Pour démarrer le serveur en tant que démon, exécutez:
$ sudo service clickhouse-server start
Si vous n'avez pas service commande, exécuter comme
$ sudo /etc/init.d/clickhouse-server start
Voir les journaux dans le /var/log/clickhouse-server/ répertoire.
Si le serveur ne démarre pas, vérifiez les configurations dans le fichier /etc/clickhouse-server/config.xml.
Vous pouvez également lancer manuellement le serveur à partir de la console:
$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml
Dans ce cas, le journal sera imprimé sur la console, ce qui est pratique lors du développement.
Si le fichier de configuration se trouve dans le répertoire courant, vous n'avez pas besoin --config-file paramètre. Par défaut, il utilise ./config.xml.
ClickHouse prend en charge les paramètres de restriction d'accès. Ils sont situés dans la users.xml fichier (à côté de config.xml).
Par défaut, l'accès est autorisé depuis n'importe où pour default l'utilisateur, sans un mot de passe. Voir user/default/networks.
Pour plus d'informations, consultez la section “Configuration Files”.
Après le lancement du serveur, vous pouvez utiliser le client de ligne de commande pour vous y connecter:
$ clickhouse-client
Par défaut, il se connecte à localhost:9000 au nom de l'utilisateur default sans un mot de passe. Il peut également être utilisé pour se connecter à un serveur distant en utilisant --host argument.
Le terminal doit utiliser L'encodage UTF-8. Pour plus d'informations, consultez la section “Command-line client”.
Exemple:
$ ./clickhouse-client
ClickHouse client version 0.0.18749.
Connecting to localhost:9000.
Connected to ClickHouse server version 0.0.18749.
:) SELECT 1
SELECT 1
┌─1─┐
│ 1 │
└───┘
1 rows in set. Elapsed: 0.003 sec.
:)
Félicitations, le système fonctionne!
Pour continuer à expérimenter, vous pouvez télécharger l'un des jeux de données de test ou passer par tutoriel.