Conectar Databrain a ClickHouse

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.

• 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.

Reúne los detalles de tu 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.

Permite las direcciones IP de Databrain (si es necesario)

Si tu instancia de ClickHouse tiene el filtrado de IP habilitado, tendrás que incluir en la lista de permitidos las direcciones IP de Databrain.

Para los usuarios de ClickHouse Cloud:

1. Ve a tu servicio en la ClickHouse Cloud console
2. Ve a Settings → Security
3. Añade las direcciones IP de Databrain a la lista de permitidos

Añadir ClickHouse como fuente de datos en Databrain

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

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 la fuente de datos.

Configura los permisos de usuario

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

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

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

Sustituye your_databrain_user y your_database por tu nombre de usuario y el nombre real de tu base de 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.

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.

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.

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

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

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

Para obtener más información sobre las funcionalidades de Databrain y cómo crear analítica avanzada:

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