QuickSight

Community Maintained

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 на ваш собственный сгенерированный хеш Double 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, чтобы он прослушивал нужные 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, перейдите к Наборам данных и нажмите "Новый набор данных":

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

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

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

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

Нажав "Редактировать/Предпросмотр данных", вы сможете увидеть структуру таблицы или изменить свой пользовательский SQL, если вы решили получать данные таким образом:

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

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

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

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