TDengine 的 CASE WHEN 语法技术详细

背景

TDengine 3.3.5.0 之前的版本， case when 的结果类型是按照第一个 then 之后的类型来确定，同时允许then 和 else 的类型不一致，后续 then 和 else 需要转换为第一个 then 之后的类型，带来的问题是当第一个 then 的类型长度较小时，其他 then/else 的值会被截断处理，造成用户无法理解输出结果，也可能出现两种类型不能转换的情况。

TDengine 3.3.5.0 中解决了以上问题，下面介绍详细的类型转化规则，方便开发人员使用此 SQL 时可以准确掌握类型转化规则。

定义

如下矩阵的行和列的标签表示的是需要显示的两种数据类型，共有20种不同的数据类型，行和列对应的表格中的数据(只需要看矩阵的上三角部分)表示的是上述需要显示的两种类型最终展示的结果类型。

行为说明

create stable test_stable_json (ts TIMESTAMP,c_int INT,c_uint INT UNSIGNED, c_bigint BIGINT, c_ubigint BIGINT UNSIGNED, c_float FLOAT, c_double DOU
BLE, c_binary BINARY(20), c_smallint SMALLINT, c_usmallint SMALLINT UNSIGNED, c_tinyint TINYINT,c_utinyint TINYINT UNSIGNED,c_bool BOOL,c_nchar NCHAR(20)
, c_varchar VARCHAR(20), c_varbinary VARBINARY(20), c_geometry GEOMETRY(50)) tags(tag_id JSON);

create table t_test using test_stable_json tags('{\"tag1\":5}');

insert into t_test values ('2022-09-30 15:15:01',123,456,1234567890,9876543210,123.45,678.90,'binary_val',32767,65535,127,255,true,'涛思数据',
'varchar_val', '1101', 'point(10 10)');

• 对于两种类型可以显示为其中的一种的情况（如int和bigint显示的最终结果类型为int，int和double显示的结果类型为double）不做过多说明，下文只列出两种类型不能显示为其中的一种的情况。
• TSDB_DATA_TYPE_NULL : 和其大于TSDB_DATA_TYPE_NULL（0）类型的显示类型为其它类型

  select case when 1 then 'abc' end from t_test;  
  // 此时只有一个then，结果类型即为该then的类型varchar
  

• TSDB_DATA_TYPE_BOOL ： 和其余大于TSDB_DATA_TYPE_BOOL（1）的类型t，最终显示类型为类型t（和JSON例外，显示为VARCHAR）

  select case when 0 then c_bool else c_int end from t_test;//结果类型为int，
  

• TSDB_DATA_TYPE_TINYINT：和其它大于TSDB_DATA_TYPE_TINYINT（2）的类型t，最终显示为类型t；其它的例外情况如下

  select case when 0 then c_tinyint else ts end from t_test; //结果类型为BIGINT
  select case when 0 then c_tinyint else c_utinyint end from t_test; //结果类型为smallint
  select case when 0 then c_tinyint else c_usmallint end from t_test; //结果类型为int
  select case when 0 then c_tinyint else c_uint end from t_test; //结果类型为BIGINT
  select case when 0 then c_tinyint else c_ubigint end from t_test;//结果类型为varchar
  

• TSDB_DATA_TYPE_SMALLINT : 和其它大于TSDB_DATA_TYPE_SMALLINT（3）的类型t，显示结果为类型t；其它的例外情况如下：

  select case when 0 then c_smallint else ts end from t_test; //结果类型为BIGINT
  select case when 0 then c_smallint else c_utinyint end from t_test; //结果类型为SAMLLINT
  select case when 0 then c_smallint else c_usmallint end from t_test;//结果类型为INT
  select case when 0 then c_smallint else c_uint end from t_test;//结果类型为BIGINT
  select case when 0 then c_smallint else c_ubigint end from t_test;//结果类型为VARCHAR
  

• TSDB_DATA_TYPE_INT： 和其它大于TSDB_DATA_TYPE_INT（4）的类型t，显示结果类型为t；其它例外情况如下：

  select case when 0 then c_int else ts end from t_test; //结果类型为BIGINT
  select case when 0 then c_int else c_utinyint end from t_test; //结果类型为INT
  select case when 0 then c_int else c_usmallint end from t_test; //结果类型为INT
  select case when 0 then c_int else c_uint end from t_test; //结果类型为BIGINT
  select case when 0 then c_int else c_ubigint end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_BIGINT :

  select case when 0 then c_bigint else c_ubigint end from t_test; //结果类型为VARCHAR
  select case when 0 then c_bigint else tag_id end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_FLOAT:

  select case when 0 then c_float else ts end from t_test; //结果类型为VARCHAR
  select case when 0 then c_float else c_ubigint end from t_test; //结果类型为VARCHAR
  select case when 0 then c_float else tag_id end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_DOUBLE:

  select case when 0 then c_double else ts end from t_test; //结果类型为VARCHAR
  select case when 0 then c_double else tag_id end from t_test; //结果类型为VARCHAR
  select case when 0 then c_double else c_ubigint end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_VARCHAR: 与其它类型一块均显示为VARCHAR，和NCHAR一块则显示为NCHAR

  select case when 0 then c_char else c_nchar end from t_test; //结果类型为NCHAR
  

• TSDB_DATA_TYPE_TIMESTAMP:

  select case when 0 then ts else c_nchar end from t_test; //结果类型为NCHAR
  select case when 0 then ts else c_utinyint end from t_test; //结果类型为BIGINT
  select case when 0 then ts else c_usmallint end from t_test; //结果类型为BIGINT
  select case when 0 then ts else c_uint end from t_test; //结果类型为BIGINT
  select case when 0 then ts else c_ubigint end from t_test; //结果类型为VARCHAR
  select case when 0 then ts else tag_id end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_NCHAR ： 和其它类型的显示结果均为NCHAR
• TSDB_DATA_TYPE_UTINYINT：

  select case when 0 then c_utinyint else tag_id end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_USMALLINT :

  select case when 0 then c_usmallint else tag_id end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_UINT:

  select case when 0 then c_uint else tagid end from t_test; //结果类型为VARCHAR
  

• TSDB_DATA_TYPE_UBIGINT :
• TSDB_DATA_TYPE_JSON：由于目前cast函数对于json还不支持，所以不能和其它类型选择最终的结果类型。
• TSDB_DATA_TYPE_VARBINARY : 由于该类型和其它类型无法进行cast，所以不能和其它类型选择最终的结果类型。
• TSDB_DATA_TYPE_GEOMETRY : 由于目前cast函数对于geometry还不支持，所以不能和其它类型选择最终的结果类型。

常见错误和排查

• 由于VARBINARY无法类型强转为其它类型，所以VARBINARY只能和VARBINARY做显示兼容，和其它类型则返回类型强转失败的错误码：TSDB_CODE_SCALAR_CONVERT_ERROR
• 如果输入类型为TDengine暂时还不支持的类型或者非法的类型码（<0)，则返回错误码：TSDB_CODE_INVALID_PARA

关于 TDengine

TDengine 是一款专为物联网、工业互联网等场景设计并优化的大数据平台，其核心模块是高性能、集群开源、云原生、极简的时序数据库。它能安全高效地将大量设备每天产生的高达 TB 甚至 PB 级的数据进行汇聚、存储、分析和分发，并提供 AI 智能体对数据进行预测与异常检测，提供实时的商业洞察。