> ## 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 ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
QuickSight 可通过 MySQL 接口，使用官方 MySQL 数据源和 Direct Query 模式连接到本地部署的 ClickHouse (23.11+) 。
## 本地部署 ClickHouse 服务器设置
有关如何配置启用 MySQL 接口的 ClickHouse 服务器，请参阅[官方文档](/zh/concepts/features/interfaces/mysql)。
除了在服务器的 `config.xml` 中添加一个条目之外
```xml theme={null}
9004
```
对于将通过 MySQL 接口 连接的用户，还*必须*使用 [Double SHA1 密码加密](/zh/concepts/features/configuration/settings/settings-users#user-namepassword)。
在 shell 中生成一个经 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 '-'
```
输出应类似于以下内容：
```text theme={null}
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
```
第一行是生成的密码，第二行是可用于配置 ClickHouse 的哈希值。
下面是 `mysql_user` 的一个示例配置，使用了生成的哈希值：
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
fbc958cc745a82188a51f30de69eebfc67c40ee4
::/0
default
default
```
将 `password_double_sha1_hex` 条目替换为你自己生成的 Double SHA1 哈希值。
QuickSight 要求在 MySQL user 的 profile 中添加若干额外设置。
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
1
1
1
```
不过，建议将其分配给另一个 profile，供你的 MySQL user 使用，而不要使用默认的 profile。
最后，配置 ClickHouse 服务器 使其监听所需的 IP 地址。
在 `config.xml` 中，取消注释以下内容以监听所有地址：
```bash theme={null}
::
```
如果你本机可用 `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.
```
## 将 QuickSight 连接到 ClickHouse
首先，前往 [https://quicksight.aws.amazon.com](https://quicksight.aws.amazon.com)，进入 Datasets，然后点击“New dataset”：
搜索 QuickSight 附带的官方 MySQL 连接器 (名称就是 **MySQL**) ：
填写连接信息。请注意，MySQL 接口的默认端口是 9004，
具体端口可能会因服务器配置而有所不同。
现在，您有两种方式可以从 ClickHouse 获取数据。首先，您可以从列表中选择一张表：
或者，您也可以指定自定义 SQL 来获取数据：
点击“Edit/Preview data”后，您应该能够看到识别出的表结构；如果您选择的是自定义 SQL 方式，也可以在这里进行调整：
请确保在 UI 左下角选择了“Direct Query”模式：
现在，您可以继续发布数据集并创建新的可视化！
## 已知限制
* SPICE 导入未能如预期正常工作；请改用 Direct Query 模式。参见 [#58553](https://github.com/ClickHouse/ClickHouse/issues/58553)。