连接建议

ClickHouse Supported

初始 SQL 选项卡

如果在“高级”选项卡中勾选了 Set Session ID 复选框（默认勾选），就可以使用以下方式自由设置会话级设置：

SET my_setting=value;

在 99% 的情况下你不需要使用高级选项卡，只有在剩下的 1% 情况下才可能需要使用以下设置：

Custom Connection Parameters。默认情况下已经指定了 socket_timeout，如果某些抽取任务更新耗时非常长，可能需要调整此参数。该参数的值以毫秒为单位。其余可用参数可以在这里找到，将它们用逗号分隔后填入此字段。
JDBC Driver custom_http_params。该字段允许你通过向驱动的 custom_http_params 参数传递值，将一些参数附加到 ClickHouse 连接字符串中。例如，当勾选 Set Session ID 复选框时，就可以通过这种方式指定 session_id。
JDBC Driver typeMappings。该字段允许你传递 ClickHouse 数据类型到 JDBC 驱动使用的 Java 数据类型的映射列表。连接器会借助此参数自动将大整数显示为字符串，你可以通过传入自己的映射集合来更改这一行为（我不知道为什么），例如使用
```
UInt256=java.lang.Double,Int256=java.lang.Double
```
关于类型映射的更多信息请参阅相应章节。

JDBC Driver URL Parameters。您可以在此字段中传递其余的驱动参数，例如 jdbcCompliance。请注意，参数值必须以 URL 编码格式传递；如果同时通过此字段以及 Advanced 选项卡前两个字段传递了 custom_http_params 或 typeMappings，则以 Advanced 选项卡中前两个字段的值为准。
Set Session ID 复选框。用于在 Initial SQL 选项卡中设置会话级别的设置，会生成一个带时间戳和伪随机数的 session_id，格式为 "tableau-jdbc-connector-*{timestamp}*-*{number}*"。

默认情况下，驱动会将 UInt64、Int128、(U)Int256 类型的字段显示为字符串，只是显示而非转换。这意味着当您尝试编写如下计算字段时，将会报错。

LEFT([myUInt256], 2) // Error!

若要像处理字符串一样处理大整数 Integer 字段，需要将该字段显式包装在 STR() 函数中。

LEFT(STR([myUInt256]), 2) // 运行良好！

然而，此类字段最常用于统计唯一值的数量（例如在 Yandex.Metrica 中的 Watch ID、Visit ID），或作为用于控制可视化粒度的 Dimension（维度） 使用，在这些场景下表现良好。

COUNTD([myUInt256]) // 同样可以正常工作!

现在在对包含 UInt64 字段的表使用数据预览（View data）时，不会再出现错误。