DuckDB分析实例兼容性说明

函数中支持的隐式类型转换规则

说明

• “/”表示不涉及隐式转换，“✔️”表示支持隐式转换，“✖️”表示不支持隐式转换。

• 常规字符串类型代指MySQL中的CHAR、VARCHAR、TINYTEXT、TEXT、MEDIUMTEXT、LONGTEXT、JSON、SET和ENUM。

• 二进制字符串类型代指MySQL中的BINARY、VARBINARY、BIT、TINYBLOB、BLOB、MEDIUMBLOB和LONGBLOB。

• 不支持大范围整数类型转换为小范围整数类型。

类型比较中支持的隐式转换规则

DuckDB分析实例在类型转换和比较规则上具有更高的严格性和一致性，但在某些场景下可能与MySQL存在行为差异。具体如下：

• 字符串到日期的隐式转换：字符串隐式转换为日期时，如果字符串格式无法正确解析为有效的日期值，SQL查询将报错并执行失败。

• 整数类型之间的比较规则：不同整数类型之间进行比较时，DuckDB分析实例会统一向取值范围更大的整数类型进行转换。

• 多元表达式的类型转换顺序：对于col1 in (col2, col3, col4, ...)、col1 between col2 and col3、coalesce(col1, col2, col3, ...)等多元表达式，会按照顺序进行类型转换。

• YEAR类型的兼容性差异：在DuckDB分析实例中，YEAR类型会被转换为INTEGER类型进行比较，可能与MySQL存在不兼容。例如：

  CREATE TABLE t1 (id YEAR PRIMARY KEY);
  INSERT INTO t1 VALUES (1980);
  SELECT * FROM t1 WHERE id BETWEEN 70 AND 90;
  
  # MySQL查询结果
  +------+
  | id   |
  +------+
  | 1980 |
  +------+
  
  # DuckDB分析实例查询结果
  Empty set.

• 布尔类型的字符串转换规则：DuckDB分析实例支持将'1'、'0'、'yes'、'no'、'true'、'false'六种字符串转换为BOOLEAN类型，其余字符串转换会报错；而MySQL会将'1'转换为true，其余字符串均转换为false。因此，如下SQL可能会存在结果不一致问题：

  CREATE TABLE t1 (id INT PRIMARY KEY);
  INSERT INTO t1 VALUES (1);
  SELECT id FROM t1 WHERE 'true';
  
  # MySQL查询结果
  Empty set
  
  # DuckDB分析实例查询结果
  +------+
  | id   |
  +------+
  |    1 |
  +------+

说明

• 当不同类型的数据进行比较时，系统会按下表规则，将数据“转换为同一类型”后进行比较；对于不支持（✖️）的类型比较，会直接报错。

• 常规字符串类型代指MySQL中的CHAR、VARCHAR、TINYTEXT、TEXT、MEDIUMTEXT、LONGTEXT、JSON、SET和ENUM。

• 二进制字符串类型代指MySQL中的BINARY、VARBINARY、BIT、TINYBLOB、BLOB、MEDIUMBLOB和LONGBLOB。

数值运算

• 浮点数的大小比较存在不兼容。例如：

  CREATE TABLE t1 (id FLOAT PRIMARY KEY);
  INSERT INTO t1 VALUES (1.22), (1.23), (1.24);
  SELECT * FROM t1 WHERE t1.id > 1.23;
  
  # MySQL查询结果
  +------+
  | id   |
  +------+
  | 1.23 |
  | 1.24 |
  +------+
  
  # DuckDB分析实例查询结果
  +------+
  | id   |
  +------+
  | 1.24 |
  +------+

• 浮点数的复杂复合运算结果因为浮点误差会存在不一致。

• 当整数、DECIMAL类型之间做运算时，结果不能超过该类型的取值范围，否则可能出现结果溢出导致的执行失败。

  CREATE TABLE t1 (id TINYINT PRIMARY KEY);
  INSERT INTO t1 VALUES (100);
  SELECT id * 2 FROM t1;
  
  # MySQL查询结果
  +--------+
  | id * 2 |
  +--------+
  |    200 |
  +--------+
  
  # DuckDB分析实例查询结果
  ERROR 7577 (HY000): [DuckDB] Out of Range Error: Overflow in multiplication of INT8 (100 * 2)!.

校对规则导致的结果不一致问题

utf8mb4_0900_xx系列的校对规则在部分符号字符的比较中存在不兼容。例如：

CREATE TABLE t1 ( id varchar(20) COLLATE utf8mb4_0900_ai_ci PRIMARY KEY );
INSERT INTO t1 VALUES ('!'), ('_');
SELECT * FROM t1 ORDER BY id;

# MySQL查询结果
+----+
| id |
+----+
| _  |
| !  |
+----+

# DuckDB分析实例查询结果
+----+
| id |
+----+
| !  |
| _  |
+----+

IN的向量子查询对于NULL值的处理

在DuckDB分析实例中，IN的向量子查询对于NULL值的处理存在不兼容问题。例如：

CREATE TABLE t1 (id INT PRIMARY KEY, col1 INT);
INSERT INTO t1 VALUES (1, 1), (2, 2);
CREATE TABLE t2 (id INT PRIMARY KEY, col1 INT);
INSERT INTO t2 VALUES (1, NULL);

select (id, col1) in (select id, col1 from t2) from t1;

# MySQL查询结果
+-----------------------------------------+
| (id, col1) in (select id, col1 from t2) |
+-----------------------------------------+
|                                    NULL |
|                                       0 |
+-----------------------------------------+

# DuckDB分析实例查询结果
+-----------------------------------------+
| (id, col1) in (select id, col1 from t2) |
+-----------------------------------------+
|                                    NULL |
|                                    NULL |
+-----------------------------------------+

对于数据(2, 2)，IN后不存在向量前缀的匹配项，MySQL返回0，DuckDB分析实例返回NULL。

聚合函数

数值函数

数值函数不支持BOOLEAN类型。

字符串函数

MySQL DuckDB严格区分二进制字符串（BLOB，VARBINARY等）和字符串（VARCHAR，TEXT，JSON等），因此以下字符串函数使用限制只考虑以字符串为输入，不以二进制字符串为输入。部分能够以二进制字符串为输入的函数有：CONCAT()、CONCAT_WS()、LENGTH()、MID()、OCTET_LENGTH()、REPEAT()、TO_BASE64()，对于这些函数，如果没有额外说明，则无使用限制。

日期函数

JSON函数

窗口函数