QuickSight

ClickHouse Supported

QuickSight 可以通过官方 MySQL 数据源，并使用 Direct Query 模式，经由 MySQL 接口连接到本地部署的 ClickHouse 集群（23.11+）。

本地部署 ClickHouse 服务器的设置

请参阅官方文档，了解如何设置启用了 MySQL 接口的 ClickHouse 服务器。

除了在服务器的 config.xml 中添加一条配置项之外

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

对于将要使用 MySQL 接口的用户，还必须使用 Double SHA1 密码加密。

在 shell 中生成一个使用 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>

不过，建议将其分配给一个不同的 profile，这样你的 MySQL 用户可以使用该 profile，而不是使用默认的那个。

最后，配置 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.