Skip to content

Desarrollo local de ClickHouse con FlyEnv

ClickHouse es una base de datos columnar de código abierto diseñada para consultas analíticas rápidas sobre conjuntos de datos muy grandes, y complementa a las bases de datos orientadas a filas como PostgreSQL. Se usa habitualmente para analítica de logs, métricas y datos de eventos, donde las agregaciones sobre miles de millones de filas deben responder en segundos, y herramientas de BI como Metabase pueden trabajar sobre ella. FlyEnv ejecuta ClickHouse como un servicio local gestionado en macOS y Linux: instala versiones desde una lista en línea, inicia el servidor con una configuración generada automáticamente y te ofrece archivos de configuración editables, visores de logs y un cliente web CH-UI con un solo clic. El módulo ClickHouse solo está disponible en macOS y Linux.

Vista general del módulo ClickHouse de FlyEnv

Gestión de versiones de ClickHouse

Instala versiones de ClickHouse desde ClickHouse → Version Manager y cambia entre ellas en cualquier momento.

  • Solo lista en línea estática: las versiones provienen de la lista de descargas en línea de FlyEnv; las fuentes Homebrew y MacPorts no se ofrecen para ClickHouse. En macOS la descarga es un binario independiente, y en Linux el binario se extrae del archivo clickhouse-common-static.
  • Versiones personalizadas: apunta FlyEnv a cualquier directorio que contenga tu propio binario clickhouse y aparecerá junto a las versiones gestionadas.
  • Una versión en ejecución: inicia, detén o reinicia una versión desde la pestaña Service o el interruptor de la barra lateral (también disponible en la bandeja del sistema); solo una versión de ClickHouse se ejecuta a la vez.

Version Manager de ClickHouse con la lista de versiones en línea

Servicio y configuración

ClickHouse se distribuye como un binario multiuso, y FlyEnv lo inicia como clickhouse server con una configuración que gestiona por ti.

  • Configuración generada automáticamente: en el primer arranque, FlyEnv crea config.xml y users.xml en su directorio de ClickHouse, preconfigurados con el puerto HTTP 8123, el puerto TCP nativo 9000 y una dirección de escucha solo loopback 127.0.0.1.
  • Dos archivos de configuración en un solo editor: la pestaña Config File alterna entre config.xml y users.xml, cada uno abierto como un editor de código XML completo, de modo que puertos, rutas, usuarios y perfiles se pueden editar sin buscar archivos; la guía de usuarios y contraseñas de bases de datos explica las cuentas predeterminadas en los módulos de bases de datos de FlyEnv.

Editando el config.xml de ClickHouse en el editor de código

Logs

La pestaña Log alterna entre los archivos de log que FlyEnv captura para el servicio ClickHouse: el log principal del servidor, el log de errores del servidor, los logs de stdout y stderr del arranque y los logs de arranque del cliente CH-UI. La vista se actualiza automáticamente cuando el archivo cambia, y la barra de herramientas puede abrir el archivo en tu gestor de archivos, recargarlo bajo demanda o borrarlo, de modo que un arranque fallido o una consulta lenta sea fácil de rastrear.

Alternando entre los logs del servidor y de arranque de ClickHouse

CH-UI

CH-UI es un cliente ClickHouse basado en web, y FlyEnv lo configura por ti.

  • Configuración con un solo clic: el botón CH-UI descarga el binario de CH-UI desde sus releases de GitHub y lo ejecuta en el puerto 3488.
  • Conexión preconfigurada: FlyEnv añade una conexión llamada "FlyEnv ClickHouse" que apunta a la instancia en ejecución y luego abre CH-UI en tu navegador; no necesitas introducir host ni puerto manualmente.

Continúa con una guía práctica, una solución, una demo o una perspectiva de la comunidad.

Notas de compatibilidad

El módulo ClickHouse solo está disponible en macOS y Linux; no aparece en Windows. FlyEnv gestiona el runtime local y la configuración que genera; el conjunto exacto de funciones de cada compilación de ClickHouse proviene de la release upstream. Consulta la página de descarga para la versión actual de FlyEnv y las demos para ver recorridos de los módulos de servicios de FlyEnv en acción.