ClickHouseV2 数据连接

1. 概述

1.1 功能概述

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

1.2 应用场景

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

2. 操作步骤

2.1 前提条件

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

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

2.2 操作步骤

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

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

   
   

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

   
   

步骤二：填写配置信息

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

   
   

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

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

步骤三：测试连接

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

   
   

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

   
   

步骤四：保存

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

   
   

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

3. 注意事项

1. 不支持int128 和int256 类型。

2. 在仪表板中使用ClickHouseV2数据源时，“第一个值”返回的结果是第一个不为NULL的值。

3. Wyn 所在的服务器无法直接访问Clickhouse所在的服务器时，可通过代理服务器访问Clickhouse。