#MySQL兼容模式参考手册

# MySQL兼容模式简介

YashanDB数据库管理系统提供了丰富的标准SQL语句、常用内置函数等功能，与主流的数据库产品高度兼容。但由于不同的数据库的概念、语法存在较大的差异甚至冲突。导致一个数据库产品无法同时兼容多个其他数据库产品的功能。因此，YashanDB提供了MySQL兼容模式，在该模式下，用户输入的SQL命令，将优先按照MySQL的语法体系进行解析，如果MySQL的语法与YashanDB现有语法存在冲突时，MySQL的语法将覆盖YashanDB语法。

MySQL兼容模式仅适用于单机部署。

# 通信协议兼容

YashanDB数据库管理系统通信协议与MySQL协议不同，因此MySQL的客户端无法直接连接YashanDB服务。YashanDB数据库管理系统自23.3版本开始，支持在YashanDB服务进程中启动单独的MySQL监听服务，该服务可打开单独的监听端口，处理通过MySQL协议向YashanDB服务端发起的连接、执行等协议命令。

配置方法请参考MySQL监听服务。

# 语法兼容

YashanDB支持将语法体系切换为MySQL体系。用户通过客户端连接到YashanDB服务后，可通过以下命令将语法体系切换为MySQL体系：

ALTER SESSION SET COMPAT_VECTOR=MYSQL;

例如，YashanDB的语法体系中，SELECT语句必须包含FROM子句，而MySQL的语法允许SELECT语句不带FROM子句。通过以上语句切换成MySQL语法模式后，执行以下语句，将返回当前会话的登录用户名，而不是报错：

SELECT USER();

Note:

• 通过基于YashanDB驱动程序开发的客户端工具（例如yasql工具）连接YashanDB的会话，其默认的语法模式为YashanDB语法模式，需要手动设置COMPAT_VECTOR=MYSQL才能切换成MySQL语法模式。

• 通过基于MySQL协议开发的客户端工具（例如mysql、mysqldump等）连接到YashanDB的会话，默认为MySQL语法模式。

当会话的语法模式切换为MySQL后，语法解析、语句执行将按照MySQL 5.7的风格。与YashanDB可能存在以下差异：

• 词法

  例如MySQL模式下，反引号（`）表示对象名，单引号（'）表示字符串，双引号（"）默认表示字符串，但在sql_mode中包含ANSI_QUOTES时，表示对象名。而YashanDB模式下，双引号表示对象，单引号表示字符串。

• 对象的概念

  例如create Database命令，在MySQL模式下表示创建一个Schema。

• 数据类型

  例如Bool类型，在MySQL模式下表示Tinyint(1)。

• 数据定义语言

  例如create Table命令，在MySQL模式下会兼容Engine、Character set等选项，不再支持pctfree等选项。

• 数据操作语言

  例如MySQL模式下支持select语句不带From子句。

• 权限

  例如执行select for update语句，在MySQL模式下需要用户具有表的读权限，以及插入、删除、更新三者之中任意一种权限。而在YashanDB模式下，select语句需要读（read）权限，select for update语句需要单独的select权限。

Caution:

• YashanDB 23.3未能覆盖MySQL的所有语法及行为，因此，部分功能语句在执行时，仍会按照YashanDB风格解析和执行。

• 部分YashanDB的功能，MySQL不支持，这类语句在MySQL模式下不会产生歧义，因此在MySQL模式下仍然可以执行，例如查询语句的集合操作（MINUS、INTERSECTS）、层次查询（CONNECT BY）。

# 保留字兼容

YashanDB兼容了MySQL数据库大部分保留字，但目前个别保留字仍存在一定区别，包括：

• CONNECT
• EXCEPT
• IF
• INTERSECT
• MINUS
• OF
• PUBLIC
• ROW
• ROWS
• START
• SYSDATE

# 规格

YashanDB数据库在MySQL模式下，绝大多数规格与YashanDB模式保持一致，以下仅列出与YashanDB模式下存在差异的规格。

# 对象规格

# 数据类型规格

# 功能约束

使用MySQL模式时，存在如下约束：