ClickHouse 数据源插件用于 Grafana
使用 Grafana，您可以通过仪表板探索和分享所有数据。 Grafana 需要一个插件来连接 ClickHouse，该插件可以在其用户界面中轻松安装。
1. 收集连接详情
要通过原生 TCP 连接到 ClickHouse，您需要以下信息：
-
主机（HOST）和端口（PORT）：通常，当使用 TLS 时，端口为 9440，当不使用 TLS 时，端口为 9000。
-
数据库名称（DATABASE NAME）：开箱即用有一个名为
default的数据库，使用您要连接的数据库的名称。 -
用户名（USERNAME）和密码（PASSWORD）：开箱即用时，用户名为
default。使用适合您用例的用户名。
您 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中找到。选择您要连接的服务，然后单击 Connect：
选择 Native，然后详细信息将在示例 clickhouse-client 命令中提供。
如果您使用的是自管理的 ClickHouse，连接详细信息由您的 ClickHouse 管理员设置。
2. 创建只读用户
在将 ClickHouse 连接到像 Grafana 这样的数据可视化工具时，建议创建一个只读用户，以保护您的数据免受未授权的修改。
Grafana 不会验证查询是否安全。查询可以包含任何 SQL 语句，包括 DELETE 和 INSERT。
要配置只读用户，请按照以下步骤操作：
- 创建一个
readonly用户配置文件，参见 在 ClickHouse 中创建用户和角色 指南。 - 确保
readonly用户有足够的权限来修改基础 clickhouse-go client 所需的max_execution_time设置。 - 如果您使用的是公共 ClickHouse 实例，不推荐在
readonly配置中设置readonly=2。相反，保持readonly=1，并将max_execution_time的约束类型设置为 changeable_in_readonly，以允许修改该设置。
3. 安装 ClickHouse 插件用于 Grafana
在 Grafana 连接到 ClickHouse 之前，您需要安装适当的 Grafana 插件。假设您已登录 Grafana，请按照以下步骤操作：
-
在侧边栏的 Connections 页面，选择 Add new connection 标签。
-
搜索 ClickHouse 并点击由 Grafana Labs 签名的插件：
-
在下一个屏幕上，点击 Install 按钮：
4. 定义 ClickHouse 数据源
-
安装完成后，点击 Add new data source 按钮。（您也可以从 Connections 页面上的 Data sources 标签中添加数据源。）
-
向下滚动找到 ClickHouse 数据源类型，或可以在 Add data source 页面上的搜索栏中搜索它。选择 ClickHouse 数据源，将出现以下页面：
- 输入您的服务器设置和凭据。关键设置包括：
- 服务器主机地址： 您的 ClickHouse 服务的主机名。
- 服务器端口： 您的 ClickHouse 服务的端口。将根据服务器配置和协议而有所不同。
- 协议： 用于连接到您的 ClickHouse 服务的协议。
- 安全连接： 如果您的服务器需要安全连接，请启用该选项。
- 用户名 和 密码：输入您的 ClickHouse 用户凭据。如果还未配置任何用户，可以尝试使用
default作为用户名。建议您 配置只读用户。
有关更多设置，请查看 插件配置 文档。
-
点击 Save & test 按钮，以验证 Grafana 是否可以连接到您的 ClickHouse 服务。如果成功，您将看到 Data source is working 消息：
5. 后续步骤
您的数据源现在可以使用了！了解更多有关如何使用 查询构建器 构建查询的信息。
有关配置的更多详细信息，请查看 插件配置 文档。
如果您在这些文档中寻找的信息不在其中，请查看 GitHub 上的插件库。
升级插件版本
从 v4 开始，配置和查询可以随着新版本的发布而升级。
v3 版本的配置和查询会在打开时迁移到 v4。虽然旧的配置和仪表板将在 v4 中加载，但迁移不会被保留，直到它们在新版本中再次保存。如果您在打开旧配置/查询时发现任何问题，请放弃您的更改并 在 GitHub 上报告问题。
如果配置/查询是使用较新版本创建的，则插件无法降级到以前的版本。