Cómo instalar el sistema de base de datos OLAP ClickHouse en Ubuntu 22.04

ClickHouse es un sistema de gestión de bases de datos orientado a columnas desarrollado por ClickHouse, Inc. y escrito en C++. Es un sistema de gestión de bases de datos OLAP de código abierto que es rápido, tolerante a fallos, fácil de usar y altamente confiable.

ClickHouse es un sistema de base de datos OLAP increíblemente rápido para procesamiento analítico en línea. Te permite generar informes analíticos utilizando consultas SQL en tiempo real.

En este tutorial, aprenderás cómo instalar el sistema de base de datos OLAP ClickHouse en un servidor Ubuntu 22.04. También aprenderás cómo configurar la autenticación en ClickHouse y cubrir su uso básico y consultas.

Requisitos previos

Para completar este tutorial, necesitarás varios requisitos previos a continuación:

• Un servidor Ubuntu 22.04 - Este ejemplo utiliza un sistema Ubuntu con el nombre de host ‘clickhouse-server’ y la dirección IP ‘192.168.5.100’.
• Un usuario no root con privilegios de administrador sudo/root.

Configuración del sistema

Antes de comenzar la instalación de ClickHouse, debes asegurarte de que la CPU actual soporte el conjunto de instrucciones SSE 4.2 y desactivar SWAP en tu sistema.

El paquete binario precompilado oficial para ClickHouse está compilado en la arquitectura x86 (64 bits) y el SSE 4.2. Así que, si no tienes una CPU que soporte SSE 4.2, deberías construir ClickHouse manualmente desde la fuente.

Además, al usar ClickHouse, se recomienda desactivar SWAP, especialmente en el entorno de producción.

Ejecuta el siguiente comando para verificar que tu CPU soporte la característica SSE 4.2. Deberías recibir la salida ‘SSE 4.2 supported’ si tu CPU es compatible.

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

A continuación, ejecuta el siguiente comando para desactivar SWAP a través del archivo de configuración ‘ /etc/fstab ‘. Este comando pondrá ‘#’ al principio de la configuración de SWAP y desactivará SWAP en tu sistema de forma permanente.

sudo sed -i '/ swap / s/^\(.*\)$/#
1/g' /etc/fstab

Ahora ejecuta el siguiente comando para apagar SWAP en la sesión actual. Luego verifica el estado de SWAP.

sudo swapoff -a  
sudo free -m

A continuación se muestra la salida que recibirás si SWAP está desactivado - El tamaño de SWAP en el campo ‘total’ es 0.

Con la CPU que soporta SSE 4.2 y SWAP desactivado, ahora estarás listo para instalar el sistema de base de datos OLAP ClickHouse.

Instalando el sistema de base de datos OLAP ClickHouse

El sistema de base de datos OLAP ClickHouse proporciona múltiples métodos de instalación. Para distribuciones de Linux, ClickHouse proporciona repositorios tanto para distribuciones basadas en Debian como en RPM. Además, ClickHouse está disponible con instalación a través de Docker o utilizando un solo paquete binario.

En este paso, instalarás ClickHouse en un sistema Ubuntu 22.04 a través del repositorio oficial. Así que, agregarás el repositorio de ClickHouse a tu sistema y luego instalarás el paquete ClickHouse a través de APT.

Para comenzar, ejecuta el comando apt a continuación para instalar algunas dependencias básicas. Cuando se te pida, ingresa y presiona ENTER.

sudo apt install apt-transport-https ca-certificates dirmngr

Ahora ejecuta el siguiente comando para agregar la clave GPG y el repositorio de ClickHouse a tu sistema. En este ejemplo, instalarás ClickHouse desde la rama estable del repositorio.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754  
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \  
    /etc/apt/sources.list.d/clickhouse.list

A continuación, actualiza y refresca tu índice de paquetes a través del comando apt a continuación.

sudo apt update

Recibirás que el repositorio de ClickHouse ha sido agregado.

Ahora instala el ‘ clickhouse-server ‘ como el sistema de base de datos y el paquete ‘ clickhouse-client ‘ a través del comando apt a continuación.

sudo apt install clickhouse-server clickhouse-client

Ingresa Y cuando se te pida la confirmación y presiona ENTER para continuar.

Además, durante la instalación de ClickHouse, se te pedirá que configures una contraseña para el usuario predeterminado de ClickHouse. Ingresa una nueva contraseña para ClickHouse y recibirás una salida como la siguiente captura de pantalla cuando la instalación haya terminado.

Con ClickHouse instalado, ejecuta el siguiente comando de systemctl para iniciar y habilitar el servicio de ClickHouse. Este comando iniciará ClickHouse y habilitará el servicio para que se ejecute automáticamente al arrancar.

sudo systemctl start clickhouse-server  
sudo systemctl enable clickhouse-server

Verifica el servicio de ClickHouse con el siguiente comando para asegurarte de que el servicio de ClickHouse esté en funcionamiento.

sudo systemctl status clickhouse-server

Recibirás una salida como la siguiente - El estado actual del servicio de ClickHouse está en ejecución y está habilitado y se ejecutará automáticamente al inicio.

Has terminado la instalación del servidor ClickHouse. En el siguiente paso, aprenderás cómo acceder al servidor ClickHouse a través de la aplicación cliente y configurar la autenticación por contraseña para el usuario administrador de ClickHouse.

Accediendo a ClickHouse a través de la línea de comandos

Con el servidor ClickHouse instalado, puedes acceder a ClickHouse a través del ‘ clickhouse-client ‘ que también has instalado.

El ‘clickhouse-client’ es una interfaz de línea de comandos para interactuar y gestionar el servidor ClickHouse. Es similar al cliente ‘ mysql ‘ para el servidor MySQL/MariaDB, ‘ psql ‘ para el servidor PostgreSQL o ‘ mongod ‘ para el servidor MongoDB.

Para acceder al servidor ClickHouse, puedes usar el comando ‘ clickhouse-client ‘ a continuación.

sudo clickhouse-client --password

Cuando se te pida la contraseña, ingresa la contraseña que creaste durante la instalación.

Después de iniciar sesión, deberías ver el shell de ClickHouse como el siguiente.

Desde aquí, puedes ver que te has conectado al servidor ClickHouse v22.11 con el usuario predeterminado de ClickHouse. El servidor ClickHouse se ejecuta por defecto en localhost con el puerto 9000.

En este punto, has instalado el servidor y el cliente ClickHouse y has aprendido cómo conectarte al servidor ClickHouse a través del comando ‘ clickhouse-client ‘. En el siguiente paso, configurarás un usuario administrador para el servidor ClickHouse.

Configurando el usuario administrador en ClickHouse

En este paso, crearás un usuario administrador para el servidor ClickHouse. Pero antes de eso, habilitarás la ‘Gestión de cuentas’ para el usuario ‘predeterminado’ a través de la configuración de ClickHouse.

Para comenzar, abre la configuración ‘/etc/clickhouse-server/users.d/default_password.xml’ usando el siguiente comando del editor nano.

sudo nano /etc/clickhouse-server/users.d/default_password.xml

Agrega la siguiente línea entre la sección ‘… ‘. Esto habilitará la ‘ Gestión de acceso ‘ para el usuario ‘ default ‘.

  
      
          
            ...  
            1  
          
      

Guarda el archivo y sal del editor cuando hayas terminado.

Ahora ejecuta el siguiente comando de systemctl para reiniciar el servicio de ClickHouse y aplicar los cambios.

sudo systemctl restart clickhouse-server

Ahora que la ‘ gestión de acceso ‘ está habilitada para el usuario ‘predeterminado’, crearás un nuevo usuario administrador para ClickHouse. El nuevo usuario podrá acceder a todas las bases de datos con todos los privilegios en el servidor ClickHouse.

Ejecuta el siguiente comando ‘ clickhouse-client ‘ para conectarte al servidor ClickHouse a través del usuario ‘ default ‘.

sudo clickhouse-client --user default --password

Cuando se te pida la contraseña, ingresa la contraseña que has configurado. Ahora obtendrás la consola del servidor ClickHouse y iniciarás sesión como el usuario ‘ default ‘ con ‘ gestión de acceso ‘ habilitada.

A continuación, ejecuta la siguiente consulta para crear un nuevo usuario de ClickHouse. Y asegúrate de cambiar el nombre de usuario, la contraseña y la dirección IP del host. Este ejemplo creará un nuevo usuario ‘ halsey ‘ con la contraseña ‘password’ y hash con SHA256. La opción ‘ HOST IP ‘ te permite especificar la dirección IP que se utilizará para conectarse al servidor ClickHouse. En este ejemplo, solo se permite desde localhost o ‘ 127.0.0.1 ‘.

CREATE USER halsey HOST IP '127.0.0.1' IDENTIFIED WITH sha256_password BY 'password';

Ahora ejecuta la siguiente consulta para otorgar todos los privilegios en el servidor ClickHouse al usuario ‘ halsey ‘.

GRANT ALL ON *.* TO halsey WITH GRANT OPTION;

A continuación, verifica la lista de usuarios en el servidor ClickHouse a través de la siguiente consulta. Deberías ver que el nuevo usuario ‘halsey’ ha sido agregado al ClickHouse.

SHOW USERS;

Ahora escribe ‘quit’ en el cliente de consola de ClickHouse para salir.

Con el nuevo usuario administrador de base de datos creado, deberás desactivar la ‘ gestión de acceso ‘ para el usuario ‘ default ‘ en tu servidor ClickHouse.

Abre la configuración ‘ /etc/clickhouse-server/users.d/default_password.xml ‘ usando el siguiente comando del editor nano.

sudo nano /etc/clickhouse-server/users.d/default_password.xml

Cambia la opción ‘ gestión de acceso ‘ a ‘ 0 ‘ para desactivar la ‘ Gestión de acceso ‘ para el usuario ‘ default ‘.

  
      
          
            ...  
            0  
          
      

Guarda el archivo y sal del editor cuando hayas terminado.

Reinicia el servicio de ClickHouse para aplicar los cambios a través del comando systemctl a continuación.

sudo systemctl restart clickhouse-server

Por último, ejecuta el siguiente comando para iniciar sesión en el servidor ClickHouse como el usuario ‘halsey’. Cuando se te pida la contraseña, ingresa tu contraseña y presiona ENTER para iniciar sesión.

sudo clickhouse-client --user halsey --password

Después de iniciar sesión, recibirás una salida como la siguiente captura de pantalla. El nuevo usuario administrador para ClickHouse ‘halsey’ ha sido agregado y el inicio de sesión es exitoso.

Con el nuevo usuario administrador del servidor ClickHouse creado, a continuación aprenderás cómo usar ClickHouse para crear bases de datos y tablas e insertar y recuperar datos a través de la consulta SQL de ClickHouse.

Consultas básicas en el sistema de base de datos ClickHouse

En este paso, aprenderás la consulta básica del sistema de base de datos ClickHouse, que es similar a las consultas SQL comunes. Aprenderás cómo crear una base de datos y una tabla, insertar y recuperar datos de la base de datos, luego el uso básico de la consulta ‘ ALTER ‘ que puedes usar para cambiar datos existentes en el servidor ClickHouse.

Primero, ejecuta la siguiente consulta para crear una nueva base de datos. En este ejemplo, crearás una nueva base de datos ‘ testdb ‘.

CREATE DATABASE testdb;

Cámbiate a la ‘ testdb ‘ a través de la siguiente consulta ‘ USE dbname’.

USE testdb;

Ahora, crea una nueva tabla, ‘users’, con la siguiente consulta. La tabla ‘ users ‘ tendrá algunos campos a continuación:

• id con tipo ‘UInt64’ para almacenar valores enteros.
• name con tipo ‘String’ para almacenar cadenas - longitud de caracteres.
• last_login con tipo ‘DateTime’ para datos en formato de fecha y hora de cadena.
• El motor aquí es ‘MergeTree’, utilizado principalmente en ClickHouse.

CREATE TABLE users (id UInt64, name String, jobs String, last_login DateTime) ENGINE=MergeTree() PRIMARY KEY id ORDER BY id;

A continuación, ejecuta la siguiente consulta para insertar nuevos datos en la tabla ‘users’. En la consulta a continuación, insertarás tres datos diferentes en la tabla ‘ users ‘.

INSERT INTO users VALUES (1, 'alice', 'DevOps', '2022-10-10 00:10:10');  
INSERT INTO users VALUES (2, 'alex', 'Manager', '2022-09-05 01:19:10');  
INSERT INTO users VALUES (3, 'janet', 'Developer', '2022-05-05 04:29:10');

Inserta el primer dato.

Inserta el segundo dato.

Inserta el tercer dato.

Ejecuta la siguiente consulta para recuperar datos de la tabla ‘ users ‘. Deberías ver tres nuevos campos de datos que acabas de agregar.

SELECT * FROM users;

Has aprendido cómo crear la base de datos, cambiar a la base de datos, crear la tabla, insertar datos y recuperar datos en el sistema de base de datos OLAP ClickHouse. A continuación, aprenderás a cambiar datos con la consulta ‘ ALTER ‘.

Ejecuta la siguiente consulta ‘ALTER TABLE’ para actualizar datos existentes en la tabla ‘users’. En este ejemplo, cambiarás el campo ‘jobs’ para el usuario ‘ alex ‘ a ‘ administrator ‘.

ALTER TABLE users UPDATE jobs = 'Administrator' WHERE name = 'alex';

Verifica los nuevos datos actualizados en la tabla ‘users’ a través de la siguiente consulta. Ahora deberías obtener los nuevos datos para el usuario ‘ alex ‘ actualizados a ‘ Administrator ‘.

SELECT * FROM users;

Ahora que has aprendido el uso básico de la consulta ClickHouse para crear y cambiar bases de datos, crear tablas, insertar datos y recuperar datos. Y también, has aprendido cómo usar la consulta ‘ ALTER ‘ para cambiar datos existentes en la base de datos ClickHouse. A continuación, limpiarás tu instalación de ClickHouse.

Limpiar el entorno

Con la nueva base de datos y tabla creadas y datos aleatorios insertados, en este último paso, limpiarás la instalación del sistema de base de datos ClickHouse eliminando la base de datos y la tabla que acabas de crear.

Ejecuta la siguiente consulta, ‘DROP TABLE,’ para eliminar la tabla de usuarios de la base de datos testdb.

DROP TABLE users;

Ahora elimina la base de datos ‘testdb’ a través de la consulta ‘ DROP DATABASE ‘ a continuación.

DROP DATABASE testdb;

Por último, verifica la lista de bases de datos en el servidor ClickHouse a través de la siguiente consulta. Deberías ver que la base de datos ‘ testdb ‘ ha sido eliminada del servidor ClickHouse.

SHOW DATABASES;

Ahora tu instalación de ClickHouse está limpia con el usuario administrador también configurado.

Conclusión

¡Felicidades! Has terminado la instalación del sistema de base de datos OLAP ClickHouse y has aprendido cómo configurar un usuario administrador en ClickHouse. Y por último, también has aprendido la consulta básica para crear una base de datos y tabla, insertar y recuperar datos, cambiar datos existentes y limpiar la base de datos y la tabla.