文档中心

MySQL 兼容性

最近更新时间：2024.02.27 10:40:13

首次发布时间：2023.11.08 16:10:09

ByteHouse 企业版在 2.4.0 版本开始，增加了对 MySQL 5.7 和 MySQL 8.0 常用功能及语法的兼容，可以实现与 MySQL 客户端应用程序和工具的无缝集成。这将使用户能够使用熟悉的 MySQL 协议与 ByteHouse 企业版进行交互，并利用 MySQL 生态系统的功能。

说明

请在 ByteHouse 2.4 及以上版本使用此功能，并建议您升级到最新版本以获得更好的支持。
升级方法：火山引擎控制台 > 集群管理 > 集群列表 > 集群详情 > 基本信息 > 引擎版本 > 版本变更

协议兼容情况

通过 MySQL Client 命令行连接

如果您已经安装好 mysql client，您可以通过以下语法连接到 ByteHouse。

--访问命令  其中默认端口为9004
mysql --protocol tcp -h [hostname] -u [username] -P [port_number] --password=[password]

--访问命令示例
mysql --protocol tcp -h 7277767706697666852-public.bytehouse-ce.volces.com -u bytehouse_test -P 9004 --password=XXXXXX

成功连接ByteHouse集群后，可查询现有数据库，参考语句如下。

show databases;

通过 ClickHouse Client 命令行连接

您可参考 ClickHouse Client 连接到 ByteHouse，并使用 MySQL 语法操作 ByteHouse。

语法兼容情况

支持但需要设置模式

部分 MySQL 函数，与 ClickHouse 模式下的同名函数存在冲突。
因此，在使用时需要设置 dialect_type='MYSQL'，举例如下：

select adddate('2022-01-22',interval '3' day) settings dialect_type='MYSQL';

目前需要设置方言才能使用的查询，包括但不限于：

函数 Function
1. adddate
2. date_sub
3. subdate
4. concat_ws
5. format AS
DQL：
1. union except

与 MySQL 有差异的特性详细说明

locate：ByteHouse 企业版运算逻辑和 MySQL 不同，所以需要设置方言才能够保持一致
cast：在 MySQL 模式下，部分函数返回值与 ClickHouse 模式下不同（主要为类型默认值的差异），部分在 ClickHouse 模式下会报错。如
1. 返回值不同：
  1. SELECT cast(4.3 AS boolean);
2. 报错：
  1. SELECT cast('a' AS boolean);
  2. SELECT cast( 'China' AS decimal(5,2));
  3. SELECT cast('China' AS smallint);
  4. SELECT cast('a' AS bigint);
  5. SELECT cast(date '2021-09-18' AS bigint);
  6. SELECT cast( date '2021-09-17' AS double);
  7. SELECT cast(timestamp '2001-1-22' AS time);
avg函数的内置类型默认值不同，结果为空时，ClickHouse 模式下返回nan，MySQL返回NULL
min、max：ByteHouse 数值类型默认值为0，MySQL上为NULL，这样会导致两者上min，max结果不同

暂无计划支持的问题

log函数不支持使用两个参数的用法。
1. MySQL支持；
2. ByteHouse 可使用log_with_base作为替代；
rand函数的结果范围。
1. MySQL返回的是范围是0～1；
2. ByteHouse 上用randCanonical()来返回[0,1)随机数；
round函数的差异。
1. ByteHouse 返回结果末尾是0会省略，如SELECT round(345.983,1);在ByteHouse 返回346，abd和MySQL返回346.0；
curdate函数不加小括号语法报错。
1. MySQL支持；
2. 使用select curdate时报错，ByteHouse 需要加括号select curdate();
date_format函数不同。
1. 目前ByteHouse 中dateformat已经被占用所以可用date_format_mysql代替date_format；
部分非标准用法的参数不支持，如：
1. 非yyyy-mm-dd标准用法：select datediff('2022-01-22 23:59:59','2022-1-21') settings dialect_type='MYSQL';
2. 非hh-mm-ss标准用法：select subtime('2022-10-31 23:59:59','0:1:1');
dayofweek函数的返回值不同。
1. ClickHouse dialect下和ClickHouse一致，MySQL dialect下和MySQL、adb返回值相同；
localtime返回值格式不同。
1. MySQL返回年月日+时间，ByteHouse 只返回时间且ClickHouse的时间有三位小数；
2. ByteHouse 可使用localtimestamp()替代；
时间函数在计算时间时，时间范围和MySQL不同。
1. 目前time只支持00:00:00 - 23:59:59；MySQL会返回一个负值，ByteHouse 不会返回负值；
2. 如
  1. select maketime(-1,15,30);
  2. select sec_to_time(86401);
  3. select subtime(date '2022-10-31','00:01:01');
  4. select subtime(time '02:12:59','10:13:01');
  5. select timediff(time '12:09:11','13:59:30');
  6. select timediff(time '12:09:10',time '12:56:34');
缺少一些异常时间值的合法性校验，如
select minute('2022-02-03 10:61:03');
time_format返回值不同
如select time_format(date '2022-01-22','%H %k %h %I %l');MySQL的%k是0...23, 我们的是00...23
默认时区不同，导致部分函数返回值不同
SELECT to_seconds('2022-02-02');
select to_seconds('2022-02-02 09:09:00');
select to_seconds(timestamp '2022-02-02 09:09:00');
select to_seconds(time '09:09:00');
bin函数返回值不同
ClickHouse上会比MySQL上多个前缀，如SELECT bin(12);
部分函数 MySQL 比 ByteHouse 多了一层hex的转化，如
SELECT char(97,110,97,108,121,116,105,99,100,98);
SELECT unhex(hex('China'));
SELECT from_base64('Q2hpbmE=');
Concat 中的参数校验
其中Space参数为负值时，MySQL没有强校验，ClickHouse会报错
如SELECT concat('#', space(-1), '#');
encrypt函数使用diff
ClickHouse只支持三个参数，MySQL 5.6可以支持两个参数
ClickHouse上暂不支持|，需要使用bitOr(a,b)代替
如SELECT make_set(bitOr(1,4),'hello','nice',NULL,'world')AS result;
unnest函数不支持

其他注意事项

使用低于 2.4 版本的 ClickHouse client时，部分MySQL function会报错语法不识别，如select adddate();。
生态兼容问题：通过 Workbench、Navicat 等程序连接 ByteHouse 时可能产生不兼容情况，目前主要存在Unknow function：current_user和Database doesn't exists：information_schema两种报错，计划会在未来的版本中修复。