> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-1d264819.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Amazon QuickSight ofrece a las organizaciones orientadas a los datos una inteligencia empresarial (BI) unificada.

# QuickSight

export const ClickHouseSupportedBadge = () => {
  return <div className="ClickHouseSupportedBadge">
            <div className="ClickHouseSupportedIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <path d="M1.30762 1.39073C1.30762 1.3103 1.37465 1.22986 1.46849 1.22986H2.64824C2.72868 1.22986 2.80912 1.29689 2.80912 1.39073V14.4886C2.80912 14.5691 2.74209 14.6495 2.64824 14.6495H1.46849C1.38805 14.6495 1.30762 14.5825 1.30762 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M4.2832 1.39073C4.2832 1.3103 4.35023 1.22986 4.44408 1.22986H5.62383C5.70427 1.22986 5.7847 1.29689 5.7847 1.39073V14.4886C5.7847 14.5691 5.71767 14.6495 5.62383 14.6495H4.44408C4.36364 14.6495 4.2832 14.5825 4.2832 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M7.25977 1.39073C7.25977 1.3103 7.3268 1.22986 7.42064 1.22986H8.60039C8.68083 1.22986 8.76127 1.29689 8.76127 1.39073V14.4886C8.76127 14.5691 8.69423 14.6495 8.60039 14.6495H7.42064C7.3402 14.6495 7.25977 14.5825 7.25977 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M10.2354 1.39073C10.2354 1.3103 10.3024 1.22986 10.3962 1.22986H11.576C11.6564 1.22986 11.7369 1.29689 11.7369 1.39073V14.4886C11.7369 14.5691 11.6698 14.6495 11.576 14.6495H10.3962C10.3158 14.6495 10.2354 14.5825 10.2354 14.4886V1.39073Z" fill="currentColor" />
                    <path d="M13.2256 6.6057C13.2256 6.52526 13.2926 6.44482 13.3865 6.44482H14.5662C14.6466 6.44482 14.7271 6.51186 14.7271 6.6057V9.27354C14.7271 9.35398 14.6601 9.43442 14.5662 9.43442H13.3865C13.306 9.43442 13.2256 9.36739 13.2256 9.27354V6.6057Z" fill="currentColor" />
                </svg>
            </div>
            ClickHouse Supported
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

QuickSight puede conectarse a una implementación on-premise de ClickHouse (23.11+) a través de la interfaz MySQL, mediante el origen de datos oficial de MySQL y el modo Direct Query.

<div id="on-premise-clickhouse-server-setup">
  ## Configuración del servidor ClickHouse on-premise
</div>

Consulta [la documentación oficial](/es/concepts/features/interfaces/mysql) sobre cómo configurar un servidor ClickHouse con la interfaz MySQL habilitada.

Además de agregar una entrada al archivo `config.xml` del servidor

```xml theme={null}
<clickhouse>
    <mysql_port>9004</mysql_port>
</clickhouse>
```

también es *obligatorio* usar [cifrado de contraseña Double SHA1](/es/concepts/features/configuration/settings/settings-users#user-namepassword) para el usuario que utilizará la interfaz MySQL.

Generar desde la shell una contraseña aleatoria cifrada con Double SHA1:

```shell theme={null}
PASSWORD=$(base64 < /dev/urandom | head -c16); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'
```

La salida debería verse así:

```text theme={null}
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
```

La primera línea es la contraseña generada y la segunda es el hash que podemos usar para configurar ClickHouse.

Aquí tienes una configuración de ejemplo para `mysql_user` que usa el hash generado:

`/etc/clickhouse-server/users.d/mysql_user.xml`

```xml theme={null}
<users>
    <mysql_user>
        <password_double_sha1_hex>fbc958cc745a82188a51f30de69eebfc67c40ee4</password_double_sha1_hex>
        <networks>
            <ip>::/0</ip>
        </networks>
        <profile>default</profile>
        <quota>default</quota>
    </mysql_user>
</users>
```

Sustituya la entrada `password_double_sha1_hex` por el hash Double SHA1 que haya generado.

QuickSight requiere varias opciones de configuración adicionales en el perfil del usuario MySQL.

`/etc/clickhouse-server/users.d/mysql_user.xml`

```xml theme={null}
<profiles>
    <default>
        <prefer_column_name_to_alias>1</prefer_column_name_to_alias>
        <mysql_map_string_to_text_in_show_columns>1</mysql_map_string_to_text_in_show_columns>
        <mysql_map_fixed_string_to_text_in_show_columns>1</mysql_map_fixed_string_to_text_in_show_columns>
    </default>
</profiles>
```

Sin embargo, se recomienda asignarlo a un perfil diferente que pueda utilizar su usuario MySQL en lugar del predeterminado.

Por último, configure el servidor ClickHouse para que escuche en la(s) dirección(es) IP deseada(s).
En `config.xml`, descomente lo siguiente para escuchar en todas las direcciones:

```bash theme={null}
<listen_host>::</listen_host>
```

Si tienes disponible el binario `mysql`, puedes probar la conexión desde la línea de comandos.
Usando el nombre de usuario de ejemplo (`mysql_user`) y la contraseña (`LZOQYnqQN4L/T6L0`) indicados arriba, el comando sería:

```bash theme={null}
mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0
```

```response theme={null}
mysql> show databases;
+--------------------+
| name               |
+--------------------+
| INFORMATION_SCHEMA |
| default            |
| information_schema |
| system             |
+--------------------+
4 rows in set (0.00 sec)
Read 4 rows, 603.00 B in 0.00156 sec., 2564 rows/sec., 377.48 KiB/sec.
```

<div id="connecting-quicksight-to-clickhouse">
  ## Conectar QuickSight a ClickHouse
</div>

Antes que nada, ve a [https://quicksight.aws.amazon.com](https://quicksight.aws.amazon.com), navega hasta Datasets y haz clic en "New dataset":

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-1d264819/FyUWFK9PtgyNRd_A/images/integrations/data-visualization/quicksight_01.png?fit=max&auto=format&n=FyUWFK9PtgyNRd_A&q=85&s=97931072733277fa455ddd7656b39954" alt="Panel de Amazon QuickSight que muestra el botón New dataset en la sección Datasets" border width="1555" height="1038" data-path="images/integrations/data-visualization/quicksight_01.png" />

<br />

Busca el conector oficial de MySQL incluido con QuickSight (llamado simplemente **MySQL**):

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-1d264819/FyUWFK9PtgyNRd_A/images/integrations/data-visualization/quicksight_02.png?fit=max&auto=format&n=FyUWFK9PtgyNRd_A&q=85&s=834275d24e6d5fe379e79c0d4ab3087c" alt="Pantalla de selección de fuente de datos de QuickSight con MySQL resaltado en los resultados de búsqueda" border width="2006" height="1040" data-path="images/integrations/data-visualization/quicksight_02.png" />

<br />

Especifica los detalles de tu conexión. Ten en cuenta que el puerto de la interfaz MySQL es 9004 de forma predeterminada,
y puede ser diferente según la configuración del servidor.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-1d264819/FyUWFK9PtgyNRd_A/images/integrations/data-visualization/quicksight_03.png?fit=max&auto=format&n=FyUWFK9PtgyNRd_A&q=85&s=96c04125066bf081c6a21ca76b5c70fe" alt="Formulario de configuración de conexión MySQL en QuickSight con campos de hostname, puerto, base de datos y credenciales" border width="1059" height="1143" data-path="images/integrations/data-visualization/quicksight_03.png" />

<br />

Ahora tienes dos opciones para obtener los datos desde ClickHouse. Primero, puedes seleccionar una tabla de la lista:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-1d264819/FyUWFK9PtgyNRd_A/images/integrations/data-visualization/quicksight_04.png?fit=max&auto=format&n=FyUWFK9PtgyNRd_A&q=85&s=d0abcce8f3aa9a4fc433c7ca1b4524dd" alt="Interfaz de selección de tablas de QuickSight que muestra las tablas de la base de datos disponibles desde ClickHouse" border width="1061" height="845" data-path="images/integrations/data-visualization/quicksight_04.png" />

<br />

Como alternativa, puedes especificar una consulta SQL personalizada para obtener tus datos:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-1d264819/FyUWFK9PtgyNRd_A/images/integrations/data-visualization/quicksight_05.png?fit=max&auto=format&n=FyUWFK9PtgyNRd_A&q=85&s=46230bbc2124cc2cef0734bb387656b0" alt="Editor de consultas SQL personalizadas de QuickSight para obtener datos desde ClickHouse" border width="1061" height="845" data-path="images/integrations/data-visualization/quicksight_05.png" />

<br />

Al hacer clic en "Edit/Preview data", deberías poder ver la estructura de la tabla detectada o ajustar tu consulta SQL personalizada, si así decidiste acceder a los datos:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-1d264819/FyUWFK9PtgyNRd_A/images/integrations/data-visualization/quicksight_06.png?fit=max&auto=format&n=FyUWFK9PtgyNRd_A&q=85&s=3c4341c1dc904a64d1aeae73f9df53e0" alt="Vista previa de datos de QuickSight que muestra la estructura de la tabla con columnas y datos de muestra" border width="1743" height="1277" data-path="images/integrations/data-visualization/quicksight_06.png" />

<br />

Asegúrate de tener seleccionado el modo "Direct Query" en la esquina inferior izquierda de la interfaz de usuario:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-1d264819/FyUWFK9PtgyNRd_A/images/integrations/data-visualization/quicksight_07.png?fit=max&auto=format&n=FyUWFK9PtgyNRd_A&q=85&s=2645bd45cf21edea1c1cfbf8303b3a8a" alt="Interfaz de QuickSight con la opción del modo Direct Query resaltada en la esquina inferior" border width="677" height="341" data-path="images/integrations/data-visualization/quicksight_07.png" />

<br />

Ahora puedes continuar publicando tu conjunto de datos y creando una nueva visualización.

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

* La importación de SPICE no funciona como se espera; utilice en su lugar el modo Direct Query. Consulte [#58553](https://github.com/ClickHouse/ClickHouse/issues/58553).
