07 Crear un panel en vivo con tus datos
Ejecuta en tu portátil un panel en contenedor conectado a tu propio servicio de ClickHouse Cloud y observa cómo cambian el tiempo de consulta y las filas examinadas al filtrar.
¿Quieres sentir la velocidad? Ejecuta en tu portátil un pequeño panel que consulta la tabla
forex de tu servicio de ClickHouse Cloud. Dibuja gráficos interactivos de velas y volumen y,
cada vez que cambias un filtro, muestra el tiempo de consulta de ClickHouse y el número de
filas examinadas, normalmente en pocos milisegundos. Esa es la idea: cambia el par, arrastra el
intervalo de fechas y recibe los datos de inmediato.
¿Por qué Docker?
La aplicación se ejecuta dentro de un contenedor Docker con su propia versión fija de Python, por lo que no importa qué Python tengas instalado, si es que tienes alguno. Solo necesitas Docker.
Paso 1 — Instalar Docker
Si aún no lo tienes, instala
Docker Desktop e inícialo. Incluye el comando
docker compose que usarás más adelante. Comprueba que está en ejecución:
docker --versionPaso 2 — Clonar el repositorio
Clona el repositorio del taller y entra en la carpeta del panel:
git clone https://github.com/ClickHouse/ClickHouse_Demos.git
cd ClickHouse_Demos
cd "$(git rev-parse --show-toplevel)/workshop_public/RTA-mini-workshop/dashboard"Paso 3 — Añadir los datos de conexión
Copia la plantilla a un archivo .env real; después, ábrelo en cualquier editor de texto y
rellena los datos de tu servicio:
cp .env.example .env
# now edit .env and fill in the values belowEncontrarás estos valores en la consola de Cloud, en Connect (menú izquierdo) → HTTPS:
| Variable | Valor que debes introducir |
|---|---|
CLICKHOUSE_HOST | por ejemplo, abc123.ap-southeast-1.aws.clickhouse.cloud: sin https:// y sin puerto |
CLICKHOUSE_PORT | 8443 |
CLICKHOUSE_USER | default |
CLICKHOUSE_PASSWORD | la contraseña que definiste al crear el servicio |
CLICKHOUSE_DATABASE | la base de datos que contiene forex (normalmente default) |
CLICKHOUSE_SECURE | true |
Paso 4 — Ejecutarlo
Construye e inicia el contenedor. La primera ejecución descarga la imagen base e instala las dependencias (uno o dos minutos); después, arrancará de inmediato.
docker compose up --buildCuando indique que escucha en el puerto 8000, abre
http://localhost:8000 en el navegador. Para detenerlo, usa Ctrl-C.
Qué puedes probar
Cambia el par de divisas, arrastra el intervalo de fechas o pulsa un botón de intervalo rápido. Cada cambio vuelve a consultar ClickHouse, y el indicador de la esquina superior derecha muestra el nuevo tiempo de consulta y las filas examinadas. Reduce el intervalo a un solo par y observa cómo baja a unos miles de filas y unos pocos milisegundos: es la clave de ordenación en acción, igual que en el módulo 4.7.
¿No aparecen datos?
Una franja roja indica que la aplicación no puede acceder a ClickHouse. Vuelve a comprobar los
valores de .env: host sin https:// ni puerto, puerto 8443; asegúrate también de que la tabla
forex esté cargada. La configuración completa y la resolución de problemas están en el
README.md del panel.
06 Preguntar en lenguaje natural
Conecta ClickHouse Agents al servicio que acabas de cargar y formula preguntas en lenguaje natural: escribirá el SQL, lo ejecutará y dibujará el gráfico.
08 Has terminado: próximos pasos
Cómo seguir aprovechando la prueba y qué alternativas usar si algo falló durante el recorrido.