Instalación 

Requisitos del sistema 

ClickHouse puede ejecutarse en cualquier Linux, FreeBSD o Mac OS X con arquitectura de CPU x86_64, AArch64 o PowerPC64LE.

Los binarios oficiales preconstruidos generalmente se compilan para x86_64 y aprovechan el conjunto de instrucciones SSE 4.2, por lo que, a menos que se indique lo contrario, el uso de la CPU que lo admite se convierte en un requisito adicional del sistema. Aquí está el comando para verificar si la CPU actual tiene soporte para SSE 4.2:

$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"

Para ejecutar ClickHouse en procesadores que no admiten SSE 4.2 o tienen arquitectura AArch64 o PowerPC64LE, debe construir ClickHouse a partir de fuentes con los ajustes de configuración adecuados.

Opciones de instalación disponibles 

De paquetes DEB 

Se recomienda utilizar pre-compilado oficial deb Paquetes para Debian o Ubuntu. Ejecute estos comandos para instalar paquetes:

sudo apt-get install apt-transport-https ca-certificates dirmngr
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4

echo "deb https://repo.clickhouse.tech/deb/stable/ main/" | sudo tee \
    /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update

sudo apt-get install -y clickhouse-server clickhouse-client

sudo service clickhouse-server start
clickhouse-client

Si desea utilizar la versión más reciente, reemplace stable con testing (esto se recomienda para sus entornos de prueba).

También puede descargar e instalar paquetes manualmente desde aqui.

Paquete 

  • clickhouse-common-static — Installs ClickHouse compiled binary files.
  • clickhouse-server — Creates a symbolic link for clickhouse-server e instala la configuración predeterminada del servidor.
  • clickhouse-client — Creates a symbolic link for clickhouse-client y otras herramientas relacionadas con el cliente. e instala los archivos de configuración del cliente.
  • clickhouse-common-static-dbg — Installs ClickHouse compiled binary files with debug info.

De paquetes RPM 

Se recomienda utilizar pre-compilado oficial rpm También puede utilizar los paquetes para CentOS, RedHat y todas las demás distribuciones de Linux basadas en rpm.

Primero, necesitas agregar el repositorio oficial:

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 desea utilizar la versión más reciente, reemplace stable con testing (esto se recomienda para sus entornos de prueba). El prestable etiqueta a veces está disponible también.

A continuación, ejecute estos comandos para instalar paquetes:

sudo yum install clickhouse-server clickhouse-client

También puede descargar e instalar paquetes manualmente desde aqui.

De archivos Tgz 

Se recomienda utilizar pre-compilado oficial tgz para todas las distribuciones de Linux, donde la instalación de deb o rpm paquetes no es posible.

La versión requerida se puede descargar con curl o wget desde el repositorio https://repo.clickhouse.tech/tgz/.
Después de eso, los archivos descargados deben desempaquetarse e instalarse con scripts de instalación. Ejemplo para la última versión:

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

Para los entornos de producción, se recomienda utilizar las últimas stable-versión. Puede encontrar su número en la página de GitHub https://github.com/ClickHouse/ClickHouse/tags con postfix -stable.

Desde Docker Image 

Para ejecutar ClickHouse dentro de Docker, siga la guía en Eje de acoplador. Esas imágenes usan oficial deb paquetes dentro.

De fuentes 

Para compilar manualmente ClickHouse, siga las instrucciones para Linux o Mac OS X.

Puede compilar paquetes e instalarlos o usar programas sin instalar paquetes. Además, al construir manualmente, puede deshabilitar el requisito de SSE 4.2 o compilar para CPU AArch64.

  Client: programs/clickhouse-client
  Server: programs/clickhouse-server

Tendrá que crear carpetas de datos y metadatos y chown para el usuario deseado. Sus rutas se pueden cambiar en la configuración del servidor (src/programs/server/config.xml), por defecto son:

  /opt/clickhouse/data/default/
  /opt/clickhouse/metadata/default/

En Gentoo, puedes usar emerge clickhouse para instalar ClickHouse desde fuentes.

Lanzar 

Para iniciar el servidor como demonio, ejecute:

$ sudo service clickhouse-server start

Si no tienes service comando ejecutar como

$ sudo /etc/init.d/clickhouse-server start

Vea los registros en el /var/log/clickhouse-server/ directorio.

Si el servidor no se inicia, compruebe las configuraciones en el archivo /etc/clickhouse-server/config.xml.

También puede iniciar manualmente el servidor desde la consola:

$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml

En este caso, el registro se imprimirá en la consola, lo cual es conveniente durante el desarrollo.
Si el archivo de configuración está en el directorio actual, no es necesario --config-file parámetro. De forma predeterminada, utiliza ./config.xml.

ClickHouse admite la configuración de restricción de acceso. Están ubicados en el users.xml archivo (junto a config.xml).
De forma predeterminada, se permite el acceso desde cualquier lugar default usuario, sin una contraseña. Ver user/default/networks.
Para obtener más información, consulte la sección “Configuration Files”.

Después de iniciar el servidor, puede usar el cliente de línea de comandos para conectarse a él:

$ clickhouse-client

Por defecto, se conecta a localhost:9000 en nombre del usuario default sin una contraseña. También se puede usar para conectarse a un servidor remoto usando --host argumento.

El terminal debe usar codificación UTF-8.
Para obtener más información, consulte la sección “Command-line client”.

Ejemplo:

$ ./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.

:)

Felicidades, el sistema funciona!

Para continuar experimentando, puede descargar uno de los conjuntos de datos de prueba o pasar por tutorial.

Clasificación: 4.5 - 23 voto

¿Este contenido fue útil?
★★★★★