QuickSight

ClickHouse Supported

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

Настройка локально развернутого сервера ClickHouse

Обратитесь к официальной документации по настройке сервера ClickHouse с включённым интерфейсом MySQL.

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

<clickhouse>
    <mysql_port>9004</mysql_port>
</clickhouse>

также обязательно использовать шифрование пароля Double SHA1 для пользователя, который будет работать через интерфейс MySQL.

Генерация случайного пароля, зашифрованного с помощью Double SHA1, из командной оболочки:

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

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

LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4

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

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

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

<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

<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 Server на прослушивание нужных IP-адресов. В config.xml раскомментируйте следующие строки, чтобы прослушивать все адреса:

<listen_host>::</listen_host>

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

mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0

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.

Подключение QuickSight к ClickHouse

Для начала перейдите на https://quicksight.aws.amazon.com, откройте раздел Datasets и нажмите "New dataset":

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

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

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

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

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

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

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

Известные ограничения

• Импорт SPICE работает некорректно; вместо него используйте режим Direct Query. См. #58553.