Conectar Databrain a ClickHouse

Databrain es una plataforma de analítica embebida que se integra a la perfección con ClickHouse para crear dashboard orientados al cliente, métricas y visualizaciones de datos.

Databrain es una plataforma de analítica embebida que le permite crear y compartir dashboard interactivos, métricas y visualizaciones de datos con sus clientes. Databrain se conecta a ClickHouse mediante la interfaz HTTPS, lo que facilita visualizar y analizar sus datos de ClickHouse desde una interfaz moderna y fácil de usar.

Esta guía le guiará por los pasos necesarios para conectar Databrain con su instancia de ClickHouse.

​

Requisitos previos

• Una base de datos de ClickHouse alojada en su propia infraestructura o en ClickHouse Cloud.
• Una cuenta de Databrain.
• Un espacio de trabajo de Databrain para conectar su fuente de datos.

​

Pasos para conectar Databrain a ClickHouse

​

1. Recopila los datos de conexión

Para conectarse a ClickHouse con HTTP(S), necesita esta información:

Parámetro(s)	Descripción
HOST and PORT	Normalmente, el puerto es 8443 cuando se usa TLS o 8123 cuando no se usa TLS.
DATABASE NAME	De forma predeterminada, existe una base de datos llamada default; use el nombre de la base de datos a la que desea conectarse.
USERNAME and PASSWORD	De forma predeterminada, el nombre de usuario es default. Use el nombre de usuario adecuado para su caso de uso.

Los detalles de su servicio de ClickHouse Cloud están disponibles en la consola de ClickHouse Cloud. Seleccione un servicio y haga clic en Connect:

Elija HTTPS. Los detalles de conexión se muestran en un comando curl de ejemplo.

Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.

​

2. Permita las direcciones IP de Databrain (si es necesario)

Si su instancia de ClickHouse tiene habilitado el filtrado por IP, deberá añadir las direcciones IP de Databrain a la lista de IP permitidas.

Para los usuarios de ClickHouse Cloud:

1. Vaya a su servicio en la consola de ClickHouse Cloud
2. Vaya a Settings → Security
3. Añada las direcciones IP de Databrain a la lista de IP permitidas

Consulte la documentación de Databrain sobre la lista de IP permitidas para ver la lista actual de direcciones IP que debe añadir.

​

3. Añadir ClickHouse como data source en Databrain

1. Inicia sesión en tu cuenta de Databrain y ve al espacio de trabajo en el que quieres añadir el data source.

2. Haz clic en Data Sources en el menú de navegación.

3. Haz clic en Add a Data Source o Connect Data Source.

4. Selecciona ClickHouse de la lista de conectores disponibles.

5. Completa los detalles de conexión:
   • Destination Name: Introduce un nombre descriptivo para esta conexión (por ejemplo, “ClickHouse de producción” o “DB de analítica”)
   • Host: Introduce la URL del host de tu instancia de ClickHouse (por ejemplo, https://your-instance.region.aws.clickhouse.cloud)
   • Port: Introduce 8443 (puerto HTTPS predeterminado para ClickHouse)
   • Username: Introduce tu nombre de usuario de ClickHouse
   • Password: Introduce tu contraseña de ClickHouse

6. Haz clic en Test Connection para verificar que Databrain pueda conectarse a tu instancia de ClickHouse.

7. Cuando la conexión se haya establecido correctamente, haz clic en Save o Connect para añadir el data source.

​

4. Configura los permisos del usuario

Asegúrate de que el usuario de ClickHouse con el que te conectas tenga los permisos necesarios:

-- Otorgar permisos para leer información del esquema
GRANT SELECT ON information_schema.* TO your_databrain_user;

-- Otorgar acceso de lectura a tu base de datos y tablas
GRANT SELECT ON your_database.* TO your_databrain_user;

Reemplaza your_databrain_user y your_database por tu nombre de usuario real y el nombre real de tu base de datos.

​

Uso de Databrain con ClickHouse

​

Explora tus datos

1. Después de conectarte, ve a tu espacio de trabajo en Databrain.

2. Verás tus tablas de ClickHouse en el explorador de datos.

3. Haz clic en una tabla para explorar su esquema y ver una vista previa de los datos.

​

Crear métricas y visualizaciones

1. Haz clic en Create Metric para empezar a crear visualizaciones con tus datos de ClickHouse.

2. Selecciona tu fuente de datos de ClickHouse y elige la tabla que quieres visualizar.

3. Usa la interfaz intuitiva de Databrain para:

   • Seleccionar dimensiones y medidas
   • Aplicar filtros y agregaciones
   • Elegir tipos de visualización (gráficos de barras, gráficos de líneas, gráficos circulares, tablas, etc.)
   • Añadir consultas SQL personalizadas para análisis avanzados

4. Guarda tu métrica para reutilizarla en distintos dashboards.

​

Crear dashboards

1. Haz clic en Create Dashboard para empezar a crear un dashboard.

2. Añade métricas a tu dashboard arrastrando y soltando métricas guardadas.

3. Personaliza el diseño y la apariencia de tu dashboard.

4. Comparte tu dashboard con tu equipo o incrústalo en tu aplicación.

​

Funcionalidades avanzadas

Databrain ofrece varias funcionalidades avanzadas al trabajar con ClickHouse:

• Consola SQL personalizada: Escribe y ejecuta consultas SQL personalizadas directamente en tu base de datos de ClickHouse
• Multitenencia y tenencia única: Conecta tu base de datos de ClickHouse con arquitecturas de tenant único o multi-tenant
• Programación de informes: Programa informes automatizados y envíalos por correo electrónico a las partes interesadas
• Insights con IA: Usa IA para generar resúmenes e insights a partir de tus datos
• Analítica embebida: Integra dashboards y métricas directamente en tus aplicaciones
• Capa semántica: Crea modelos de datos y lógica de negocio reutilizables

​

Solución de problemas

​

La conexión falla

Si no logras conectarte a ClickHouse:

1. Verifica las credenciales: vuelve a comprobar tu nombre de usuario, contraseña y la URL del host
2. Comprueba el puerto: asegúrate de usar el puerto 8443 para HTTPS (o 8123 para HTTP si no usas SSL)
3. Lista blanca de IP: confirma que las direcciones IP de Databrain estén incluidas en la lista blanca de la configuración de firewall/seguridad de ClickHouse
4. SSL/TLS: asegúrate de que SSL/TLS esté configurado correctamente si usas HTTPS
5. Permisos del usuario: verifica que el usuario tenga permisos SELECT sobre information_schema y tus bases de datos de destino

​

Rendimiento lento de las consultas

Si las consultas se ejecutan lentamente:

1. Optimice sus consultas: Use filtros y agregaciones de forma eficiente
2. Cree vistas materializadas: Para las agregaciones a las que se accede con frecuencia, considere crear vistas materializadas en ClickHouse
3. Use tipos de datos adecuados: Asegúrese de que el esquema de ClickHouse use tipos de datos óptimos
4. Optimización de índices: Aproveche las claves primarias y los índices de omisión de ClickHouse

​

Más información

Para obtener más información sobre las funcionalidades de Databrain y cómo crear análisis avanzados:

• Documentación de Databrain
• Guía de ClickHouse Integration
• Creación de dashboard
• Creación de métricas