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

> Amazon QuickSight предоставляет организациям, ориентированным на данные, единую платформу бизнес-аналитики (BI).

# 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
        </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>;
};

QuickSight может подключаться к ClickHouse, развернутому в собственной инфраструктуре (23.11+), через интерфейс MySQL, используя официальный источник данных MySQL и режим Direct Query.

<div id="on-premise-clickhouse-server-setup">
  ## Настройка сервера ClickHouse в собственной инфраструктуре
</div>

См. [официальную документацию](/ru/concepts/features/interfaces/mysql), где описано, как настроить сервер ClickHouse с включенным интерфейсом MySQL.

Помимо добавления записи в `config.xml` сервера

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

также *необходимо* использовать [шифрование пароля методом двойного хэша SHA1](/ru/concepts/features/configuration/settings/settings-users#user-namepassword) для пользователя, который будет использовать интерфейс MySQL.

Генерация случайного пароля, зашифрованного методом двойного хэша SHA1, в оболочке:

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

Результат должен выглядеть следующим образом:

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

Первая строка — это сгенерированный пароль, а вторая — хеш, который можно использовать для настройки ClickHouse.

Вот пример конфигурации для `mysql_user`, в которой используется сгенерированный хеш:

`/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>
```

Замените значение `password_double_sha1_hex` на собственный сгенерированный двойной хэш SHA1.

Для QuickSight требуется несколько дополнительных настроек в профиле пользователя 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>
```

Однако рекомендуется назначить для него другой профиль, который будет использовать ваш пользователь MySQL вместо профиля по умолчанию.

Наконец, настройте сервер ClickHouse так, чтобы он прослушивал нужный IP-адрес или адреса.
В `config.xml` раскомментируйте следующее, чтобы сервер прослушивал все адреса:

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

Если у вас доступен бинарный файл `mysql`, вы можете проверить подключение из командной строки.
Используя приведённые выше примерные имя пользователя (`mysql_user`) и пароль (`LZOQYnqQN4L/T6L0`), команда будет такой:

```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">
  ## Подключение QuickSight к ClickHouse
</div>

Прежде всего перейдите на [https://quicksight.aws.amazon.com](https://quicksight.aws.amazon.com), откройте раздел Datasets и нажмите "New dataset":

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_01.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=49b1475d7a434f610ae6cf35c3f40e42" alt="Панель мониторинга Amazon QuickSight с кнопкой New dataset в разделе Datasets" border width="1555" height="1038" data-path="images/integrations/data-visualization/quicksight_01.webp" />

<br />

Найдите официальный коннектор MySQL, встроенный в QuickSight (он называется просто **MySQL**):

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_02.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=cc25cccdea446662d9957a7433f0281f" alt="Экран выбора источника данных в QuickSight, где в результатах поиска выделен MySQL" border width="2006" height="1040" data-path="images/integrations/data-visualization/quicksight_02.webp" />

<br />

Укажите сведения о подключении. Обратите внимание, что порт интерфейса MySQL по умолчанию — 9004,
и он может отличаться в зависимости от конфигурации сервера.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_03.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=8d12ce47aad260d73c210d436d39653c" alt="Форма настройки подключения MySQL в QuickSight с полями hostname, port, database и учетных данных" border width="1059" height="1143" data-path="images/integrations/data-visualization/quicksight_03.webp" />

<br />

Теперь у вас есть два варианта получения данных из ClickHouse. Во-первых, вы можете выбрать таблицу из списка:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_04.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=c906b615fff9e0b735fc0df219a06b35" alt="Интерфейс выбора таблицы в QuickSight, показывающий таблицы базы данных, доступные из ClickHouse" border width="1061" height="845" data-path="images/integrations/data-visualization/quicksight_04.webp" />

<br />

Либо вы можете указать собственный SQL-запрос для получения данных:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_05.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=8d200a00f885e178c7279ca430ec0aa8" alt="Редактор пользовательского SQL-запроса в QuickSight для получения данных из ClickHouse" border width="1061" height="845" data-path="images/integrations/data-visualization/quicksight_05.webp" />

<br />

Нажав "Edit/Preview data", вы сможете увидеть автоматически определённую структуру таблицы или скорректировать свой SQL-запрос, если выбрали именно такой способ доступа к данным:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_06.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=29b929b76b27810accdf9c118a0ddc6e" alt="Предпросмотр данных в QuickSight, показывающий структуру таблицы со столбцами и примером данных" border width="1743" height="1277" data-path="images/integrations/data-visualization/quicksight_06.webp" />

<br />

Убедитесь, что в левом нижнем углу интерфейса выбран режим "Direct Query":

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/quicksight_07.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=e17b486cb3b7a2a0109569697b38dbe8" alt="Интерфейс QuickSight с выделенным в нижнем углу режимом Direct Query" border width="677" height="341" data-path="images/integrations/data-visualization/quicksight_07.webp" />

<br />

Теперь вы можете опубликовать набор данных и создать новую визуализацию!

<div id="known-limitations">
  ## Известные ограничения
</div>

* Импорт в SPICE работает некорректно; используйте вместо него режим Direct Query. См. [#58553](https://github.com/ClickHouse/ClickHouse/issues/58553).
