Saltar al contenido principal
La forma más rápida y sencilla de empezar a usar ClickHouse es crear un nuevo servicio en ClickHouse Cloud. En esta guía de inicio rápido, lo configurarás en tres sencillos pasos.
1

​
Crear un servicio de ClickHouse

Para crear un servicio gratuito de ClickHouse en ClickHouse Cloud, solo tienes que registrarte siguiendo estos pasos:
  • Crea una cuenta en la página de registro
  • Puedes registrarte con tu correo electrónico o mediante Google SSO, Microsoft SSO, AWS Marketplace, Google Cloud o Microsoft Azure
  • Si te registras con correo electrónico y contraseña, recuerda verificar tu dirección de correo en las siguientes 24 h mediante el enlace que recibirás por correo
  • Inicia sesión con el nombre de usuario y la contraseña que acabas de crear

Una vez que hayas iniciado sesión, ClickHouse Cloud inicia el asistente de configuración inicial, que te guía para crear un nuevo servicio de ClickHouse. Selecciona la región en la que quieres desplegar el servicio y asígnale un nombre a tu nuevo servicio:
De forma predeterminada, las nuevas organizaciones se crean en el nivel Scale y tendrán 3 réplicas, cada una con 4 vCPU y 16 GiB de RAM. Vertical autoscaling estará habilitado de forma predeterminada en el nivel Scale. Puedes cambiar el nivel de la organización más adelante en la página ‘Planes’.Si es necesario, personaliza los recursos del servicio especificando un tamaño mínimo y máximo entre los que podrán escalar las réplicas. Cuando esté todo listo, selecciona Create service.
¡Enhorabuena! Tu servicio de ClickHouse Cloud ya está en funcionamiento y la configuración inicial se ha completado. Sigue leyendo para conocer cómo empezar a ingestar y consultar tus datos.
2

​
Conéctate a ClickHouse

Hay 2 formas de conectarte a ClickHouse:
  • Conéctate usando nuestra consola SQL basada en web
  • Conéctate con tu aplicación

​
Conéctate usando la consola SQL

Para empezar rápidamente, ClickHouse ofrece una consola SQL basada en web a la que se te redirigirá al completar el onboarding.Crea una pestaña de consulta e introduce una consulta sencilla para verificar que la conexión funciona:
SHOW databases
Deberías ver 4 bases de datos en la lista, además de las que hayas añadido.
Eso es todo: ¡ya puedes empezar a usar tu nuevo servicio de ClickHouse!

​
Conéctate con tu aplicación

Haz clic en el botón Connect del menú de navegación. Se abrirá una ventana modal con las credenciales de tu servicio y una serie de instrucciones sobre cómo conectarte mediante tu interfaz o los clients de tu lenguaje.
Si no encuentras el client para tu lenguaje, quizá quieras consultar nuestra lista de Integrations.
3

​
Agregar datos

¡ClickHouse es mejor con datos! Existen múltiples formas de agregar datos y la mayoría están disponibles en la página de Fuentes de datos, a la que se puede acceder desde el menú de navegación.
Puede cargar datos mediante los siguientes métodos:
  • Configure un ClickPipe para empezar a ingestar datos de fuentes como S3, Postgres, Kafka y GCS
  • Usa la consola SQL
  • Use el cliente de ClickHouse
  • Sube un archivo - los formatos admitidos incluyen JSON, CSV y TSV
  • Cargar datos desde la URL del archivo

​
ClickPipes

ClickPipes es una plataforma de integración administrada que simplifica la ingesta de datos desde un conjunto diverso de fuentes con solo unos pocos clics. Diseñada para los workloads más exigentes, la arquitectura robusta y escalable de ClickPipes garantiza un rendimiento y una fiabilidad consistentes. ClickPipes puede utilizarse tanto para necesidades de streaming a largo plazo como para trabajos puntuales de carga de datos.

​
Agregar datos mediante la SQL Console

Como la mayoría de los sistemas de gestión de bases de datos, ClickHouse agrupa lógicamente las tablas en bases de datos. Use el comando CREATE DATABASE para crear una nueva base de datos en ClickHouse:
CREATE DATABASE IF NOT EXISTS helloworld
Ejecute el siguiente comando para crear una tabla llamada my_first_table en la base de datos helloworld:
CREATE TABLE helloworld.my_first_table
(
    user_id UInt32,
    message String,
    timestamp DateTime,
    metric Float32
)
ENGINE = MergeTree()
PRIMARY KEY (user_id, timestamp)
En el ejemplo anterior, my_first_table es una tabla MergeTree con cuatro columnas:
  • user_id: un entero sin signo de 32 bits (UInt32)
  • message: un tipo de dato String que sustituye tipos como VARCHAR, BLOB, CLOB y otros de otros sistemas de bases de datos
  • timestamp: un valor DateTime que representa un instante en el tiempo
  • metric: un número de coma flotante de 32 bits (Float32)
Motores de tablaLos motores de tabla determinan:
  • Cómo y dónde se almacenan los datos
  • Qué consultas se admiten
  • Si los datos se replican o no

Hay muchos motores de tabla entre los que elegir, pero para una tabla sencilla en un servidor ClickHouse de un solo nodo, MergeTree será probablemente la opción más adecuada.

​
Breve introducción a las claves primarias

Antes de continuar, es importante entender cómo funcionan las claves primarias en ClickHouse (¡la implementación de las claves primarias puede resultar sorprendente!):
  • las claves primarias de ClickHouse no son únicas para cada fila de una tabla
La clave primaria de una tabla de ClickHouse determina cómo se ordenan los datos al escribirse en disco. Cada 8.192 filas o 10 MB de datos (denominado granularidad del índice) genera una entrada en el archivo de índice de clave primaria. Este concepto de granularidad crea un índice disperso que cabe fácilmente en memoria, y los gránulos representan una franja de la menor cantidad de datos de columna que se procesa durante las consultas SELECT.La clave primaria puede definirse mediante el parámetro PRIMARY KEY. Si se define una tabla sin especificar un PRIMARY KEY, la clave pasa a ser la tupla indicada en la cláusula ORDER BY. Si se especifican tanto PRIMARY KEY como ORDER BY, la clave primaria debe ser un subconjunto del orden de ordenación.La clave primaria es también la clave de ordenación, que es una tupla de (user_id, timestamp). Por lo tanto, los datos almacenados en cada archivo de columna estarán ordenados por user_id y, a continuación, por timestamp.Para profundizar en los conceptos fundamentales de ClickHouse, consulte “Conceptos fundamentales”.

​
Insertar datos en tu tabla

Puede utilizar el conocido comando INSERT INTO TABLE con ClickHouse, pero es importante entender que cada inserción en una tabla MergeTree genera la creación de una parte en el almacenamiento.
Práctica recomendada de ClickHouseInserta una gran cantidad de filas por lote: decenas de miles o incluso millones de filas de una sola vez. No te preocupes: ClickHouse puede manejar fácilmente ese volumen, y te ahorrará dinero al enviar menos solicitudes de escritura a tu servicio.

Incluso para un ejemplo sencillo, insertemos más de una fila a la vez:
INSERT INTO helloworld.my_first_table (user_id, message, timestamp, metric) VALUES
    (101, 'Hello, ClickHouse!',                                 now(),       -1.0    ),
    (102, 'Insert a lot of rows per batch',                     yesterday(), 1.41421 ),
    (102, 'Sort your data based on your commonly-used queries', today(),     2.718   ),
    (101, 'Granules are the smallest chunks of data read',      now() + 5,   3.14159 )
Observa que la columna timestamp se rellena mediante varias funciones de Date y DateTime. ClickHouse tiene cientos de funciones útiles que puedes consultar en la sección Funciones.
Verifiquemos que funcionó:
SELECT * FROM helloworld.my_first_table

​
Agregar datos con el ClickHouse Client

También puede conectarse a su servicio de ClickHouse Cloud mediante una herramienta de línea de comandos llamada clickhouse client. Haga clic en Connect en el menú de la izquierda para acceder a estos detalles. En el cuadro de diálogo, seleccione Native en el menú desplegable:
  1. Instala ClickHouse.
  2. Ejecute el comando sustituyendo su hostname, username y password: 
./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password <password>
Si aparece el prompt con la carita sonriente, ¡ya está listo para ejecutar consultas!
:)
  1. Pruébelo ejecutando la siguiente consulta:

SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
Observe que la respuesta se devuelve en un formato de tabla ordenado:
┌─user_id─┬─message────────────────────────────────────────────┬───────────timestamp─┬──metric─┐
│     102 │ Insert a lot of rows per batch                     │ 2022-03-21 00:00:00 │ 1.41421 │
│     102 │ Sort your data based on your commonly-used queries │ 2022-03-22 00:00:00 │   2.718 │
│     101 │ Hello, ClickHouse!                                 │ 2022-03-22 14:04:09 │      -1 │
│     101 │ Granules are the smallest chunks of data read      │ 2022-03-22 14:04:14 │ 3.14159 │
└─────────┴────────────────────────────────────────────────────┴─────────────────────┴─────────┘

4 rows in set. Elapsed: 0.008 sec.
  1. Agregue una cláusula FORMAT para especificar uno de los numerosos formatos de salida que admite ClickHouse:

SELECT *
FROM helloworld.my_first_table
ORDER BY timestamp
FORMAT TabSeparated
En la consulta anterior, la salida se devuelve separada por tabulaciones:
Query id: 3604df1c-acfd-4117-9c56-f86c69721121

102 Insert a lot of rows per batch      2022-03-21 00:00:00     1.41421
102 Sort your data based on your commonly-used queries  2022-03-22 00:00:00     2.718
101 Hello, ClickHouse!  2022-03-22 14:04:09     -1
101 Granules are the smallest chunks of data read       2022-03-22 14:04:14     3.14159

4 rows in set. Elapsed: 0.005 sec.
  1. Para salir del clickhouse client, escriba el comando exit:

exit

​
Cargar un archivo

Una tarea habitual al comenzar a trabajar con una base de datos es insertar datos que ya se tienen en archivos. Disponemos de datos de muestra en línea que puede insertar y que representan datos de clickstream; incluyen un ID de usuario, una URL visitada y el timestamp del evento.Supongamos que tenemos el siguiente texto en un archivo CSV llamado data.csv:
data.csv
102,This is data in a file,2022-02-22 10:43:28,123.45
101,It is comma-separated,2022-02-23 00:00:00,456.78
103,Use FORMAT to specify the format,2022-02-21 10:43:30,678.90
  1. El siguiente comando inserta los datos en my_first_table:

./clickhouse client --host HOSTNAME.REGION.CSP.clickhouse.cloud \
--secure --port 9440 \
--user default \
--password <password> \
--query='INSERT INTO helloworld.my_first_table FORMAT CSV' < data.csv
  1. Observa que las nuevas filas ya aparecen en la tabla al consultar desde la SQL Console:


Filtrado mediante lista de acceso IPAntes de continuar, recomendamos configurar el filtrado mediante lista de acceso IP. Consulta “Configurar filtros IP” para obtener más información.

​
¿Qué sigue?

Última modificación el 10 de junio de 2026