> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Holistics es una plataforma impulsada por IA para BI de autoservicio y analítica embebida que ayuda a todos a tomar mejores decisiones con métricas gobernadas y de fácil acceso.

# Conectar ClickHouse con Holistics

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            Mantenimiento de la comunidad
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

[Holistics](https://www.holistics.io/) es una plataforma de BI de autoservicio con IA nativa y una capa semántica programable para ofrecer métricas coherentes y fiables.

Al conectar ClickHouse con Holistics, sus equipos obtienen una experiencia de autoservicio rápida y fiable, impulsada por IA y basada en una capa semántica definida en código. Los usuarios de negocio pueden explorar los datos con confianza mediante funciones de arrastrar y soltar e IA, mientras mantienen definiciones de métricas reutilizables, combinables y versionadas en Git.

<div id="prerequisites">
  ## Requisitos previos
</div>

Antes de conectarte, asegúrate de tener lo siguiente:

* **Permisos:** Debes ser Admin en Holistics para añadir nuevas fuentes de datos.
* **Acceso de red:** Tu servidor de ClickHouse debe ser accesible desde las [direcciones IP de Holistics](https://docs.holistics.io/docs/connect/ip-whitelisting).
* **Usuario de la base de datos:** Crea un usuario dedicado de solo lectura para Holistics en lugar de usar una cuenta de administrador.

<div id="recommended-privileges">
  ### Privilegios recomendados
</div>

El usuario dedicado necesita privilegios `SELECT` sobre las tablas que quiera consultar, así como sobre las tablas `system` (para detectar el esquema).

```sql theme={null}
-- Example: Grant read access to a specific database
GRANT SELECT ON my_database.* TO holistics_user;

-- Grant access to system metadata
GRANT SELECT ON system.* TO holistics_user;
```

<Steps>
  <Step title="Reúne los datos de conexión" id="step-1-gather-connection-details">
    Para conectarte a ClickHouse mediante HTTP(S), necesitarás esta información:

    | **Parámetro**     | **Descripción**                                                                                         |
    | ----------------- | ------------------------------------------------------------------------------------------------------- |
    | **Host**          | El hostname de tu servidor ClickHouse (por ejemplo, `mz322.eu-central-1.aws.clickhouse.cloud`).         |
    | **Port**          | **8443** para ClickHouse Cloud (SSL/TLS). **8123** para instancias autogestionadas sin SSL.             |
    | **Database Name** | El nombre de la base de datos a la que quieres conectarte. El valor predeterminado suele ser `default`. |
    | **Username**      | El usuario de la base de datos. El valor predeterminado es `default`.                                   |
    | **Password**      | La contraseña del usuario de la base de datos.                                                          |

    Puedes encontrar estos datos haciendo clic en el botón **Connect** en la consola de ClickHouse Cloud y seleccionando **HTTPS**.

    <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=512a3ef076212baa4887e0f241b400c4" alt="Ubicación del botón Connect en la consola de ClickHouse Cloud" border width="998" height="932" data-path="images/integrations/data-visualization/holistics_01.webp" />
  </Step>

  <Step title="Configura el acceso de red" id="step-2-configure-network-access">
    Como Holistics es una aplicación en la nube, sus servidores deben poder acceder a tu base de datos. Tienes dos opciones:

    1. **Conexión directa (recomendada):** Añade las direcciones IP de Holistics a la lista de permitidas de tu firewall o a la IP Access List de ClickHouse Cloud. Puedes consultar la lista de IP en la guía de [IP Whitelisting](https://docs.holistics.io/docs/connect/ip-whitelisting).

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_02.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=ec2b20fe5329b6bd9ed39a5547b5c1cc" alt="Ejemplo de inclusión de IP en la lista de permitidas en ClickHouse Cloud" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_02.webp" />

    2. **Túnel SSH inverso:** Si tu base de datos está en una red privada (VPC) y no puede exponerse públicamente, usa un [Reverse SSH Tunnel](https://docs.holistics.io/docs/connect/connect-tunnel).
  </Step>

  <Step title="Agrega una fuente de datos en Holistics" id="step-3-add-data-source-in-holistics">
    1. En Holistics, ve a **Settings → Fuentes de datos**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=140bed8bce68e86bcb0f42e6486ea30a" alt="Navegación a fuentes de datos en la configuración de Holistics" border width="1647" height="1129" data-path="images/integrations/data-visualization/holistics_03.webp" />

    2. Haz clic en **New Data Source** y selecciona **ClickHouse**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=d92626890c46a53d7ff9dc980c02cf6a" alt="Selección de ClickHouse en la lista de nuevas fuentes de datos" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_04.webp" />

    3. Completa el formulario con los datos reunidos en el paso 1.

       | **Campo**         | **Configuración**                                                              |
       | ----------------- | ------------------------------------------------------------------------------ |
       | **Host**          | El hostname de tu ClickHouse                                                   |
       | **Port**          | `8443` (o `8123`)                                                              |
       | **Require SSL**   | Actívalo en **ON** si usas el puerto 8443 (obligatorio para ClickHouse Cloud). |
       | **Database Name** | `default` (o tu DB específica)                                                 |

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_05.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=cf2745f7ec9288d499a9d1a8ba349a73" alt="Completar los datos de conexión de ClickHouse en Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_05.webp" />

    4. Haz clic en **Test Connection**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=c48de7963b5e10198c670e3f62ec4496" alt="Prueba de conexión de ClickHouse correcta en Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_06.webp" />

       * **Correcto:** Haz clic en **Save**.
       * **Error:** Verifica tu nombre de usuario y contraseña, y asegúrate de que las [IP de Holistics estén en la lista de permitidas](https://docs.holistics.io/docs/connect/ip-whitelisting).
  </Step>
</Steps>

<div id="known-limitations">
  ## Limitaciones conocidas
</div>

Holistics admite la mayoría de las funciones estándar de SQL en ClickHouse, con las siguientes excepciones:

* **Total acumulado:** Actualmente, esta función analítica tiene compatibilidad limitada en ClickHouse.
* **Tipos de datos anidados:** Las estructuras JSON o Array muy anidadas pueden requerir aplanarse mediante modelos SQL antes de su visualización.

Para consultar la lista completa de funciones compatibles, consulta la [página de limitaciones específicas de la base de datos](https://docs.holistics.io/docs/connect/faqs/clickhouse-limitations).