> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> 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.
# Conectar Databrain a ClickHouse
export const CommunityMaintainedBadge = () => {
return
Mantenimiento de la comunidad
;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
[Databrain](https://usedatabrain.com) 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](https://clickhouse.com/).
* Una [cuenta de Databrain](https://app.usedatabrain.com/users/sign-up).
* 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](https://docs.usedatabrain.com/guides/datasources/allow-access-to-our-ip) 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:
```sql theme={null}
-- 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](https://docs.usedatabrain.com/)
* [Guía de ClickHouse Integration](https://docs.usedatabrain.com/guides/datasources/connecting-data-sources-to-databrain/clickhouse)
* [Creación de dashboard](https://docs.usedatabrain.com/guides/dashboards/create-a-dashboard)
* [Creación de métricas](https://docs.usedatabrain.com/guides/metrics/create-metrics)