ClickHouse 数据连接

1. 概述

1.1 功能概述

Wyn支持连接 ClickHouse 数据库，然后对接入的数据进行加工和处理，并最终通过仪表板或报表实现数据的可视化展示。

1.2 应用场景

当您需要使用 ClickHouse 数据库，并将其数据接入 Wyn，借助 Wyn 强大的可视化图表与报表功能进行数据展示时，本文将为您详细介绍从 ClickHouse 数据库接入 Wyn 的具体操作流程，为您提供全面且实用的参考。

2. 操作步骤

2.1 前提条件

连接 ClickHouse 数据库前，需满足以下条件：

1. 版本要求：Wyn 支持 ClickHouse 数据库的最低版本为 v20。

2. 启用数据源： 标准版系统中默认没有开启该数据源的连接入口，开启方法详见标准版中启用JDBC驱动支持(Windows)和标准版中启用JDBC驱动支持(Linux)。

2.2 操作步骤

步骤一：创建数据源，选择ClickHouse

1. 文档门户单击创建文档 ，选择数据源。

   
   

2. 下图图标视图选择ClickHouse。

   
   

步骤二：填写配置信息

1. 填写数据库配置信息。

   
   

2. 配置信息具体介绍见下表：

   参数	说明
   名称	自定义输入数据源的名称。
   服务器	主机名或主机IP。
   端口	端口号，默认为8123。
   用户名	连接数据库的用户名。
   密码	连接数据库用户的密码。
   数据库	输入数据库名或单击下拉箭头选择数据库。
   使用配置连接字符串（高级）	如果您勾选了此选项，则只需要填写此项与数据源的名称即可。填写此项的格式为： jdbc:clickhouse://myServerAddress:mySeverPort/myDatabase?user=myUser&password=myPassword 比如：jdbc:clickhouse://10.32.3.195:8123/Northwind 另外，字符串中可以使用用户上下文和组织上下文来进行数据过滤。格式为： “@{用户上下文名称}”如“@{DBName}”，详见用户上下文属性管理。 和“#{组织信息上下文}”如“#{DBName}”，详见组织属性和组织信息上下文。
   使用表/字段名称映射	修改数据源中的表名或列名，使其在数据集中显示为期望的名称。 详情请见使用表/字段名称映射(修改数据源表名或列名)。

步骤三：测试连接

1. 单击页面左下角的测试数据连接测试连接是否正常。

   
   

2. 连接成功后，单击确定。

   
   

步骤四：保存

1. 单击创建，保存 ClickHouse 数据源。

   
   

Wyn成功连接 ClickHouse 数据库后，可以在「文档门户>我的分析>数据源」列表中找到创建成功的 ClickHouse 数据源。更多介绍，请见数据源操作。

3. 注意事项

1. 使用 ClickHouse 数据源创建的数据集中，不支持在数据源级别添加针对 IPV4 和 IPV6 格式字段的过滤器。

2. 连接 ClickHouse 数据源后，日期时间字段将按照系统所在的时区显示数据。

3. 在 Dashboard 中使用 ClickHouse 数据源时，FirstValue 返回的结果是第一个不为 NULL 的值。