# 简介
DDM兼容MySQL协议及其语法，但因分布式数据库与单机数据库之间存在一定的差异性，导致SQL使用存在些限制。
在评估DDM方案之前，请先完成当前应用中的SQL语法及与DDM支持语法的兼容性评估。
#### DDM EXPLAIN
当您在需要执行的SQL语句前加上EXPLAIN，然后执行SQL时，您将会看到其具体的执行计划，以此分析耗时，进而修改SQL，达到优化的效果。
表1**常见算子的解释** 
| 算子名称               | 描述                                                                                |
|:---|:---|
| ExtTableScan       | 优化自LogicalTableScan，主要是数据拉取， 但并不仅限于全表扫描。                                          |
| Union              | 表示将多个输入的数据合并在一起。                                                                  |
| HashAggregate      | 根据输入行的分组列的值，按照指定的聚合函数进行聚合计算，比如group by，distinct，sum，count等。该类算子通常会消耗较多的CPU、内存等资源。 |
| Join               | NestedLoopJoin：非等值Join，LookUpJoin在 NestedLoopJoin 基础上进行了改进。                       |
| Sort               | 常见有MergeSort、MemorySort和TopN。                                                     |
| DirectPushdownNode | 可直接下推算子，将SQL直接下推到DN节点执行。                                                          |
| Project            | 表示投影操作，即从输入数据中选择部分列输出，或者对某些列进行计算（通过函数或者表达 式计算）后输出。                                |
   
表2**EXPLAIN列的解释** 
| 列名称           | 描述                                                                                                                                 |
|:---|:---|
| table         | 显示该行数据所归属的表。                                                                                                                       |
| type          | 显示连接使用了何种类型。连接类型按照执行速度从快到慢排序为：const、eq_reg、ref、range、index、ALL。                                                                    |
| possible_keys | 显示可能应用在该表中的索引。                                                                                                                     |
| key           | 实际使用的索引。如果为NULL，则没有使用索引。个别情况下，MySQL会选择优化不足的索引。在SELECT语句中使用USE INDEX（indexname）来强制使用一个索引或者用IGNORE INDEX（indexname）来强制MySQL忽略索引。     |
| key_len       | 使用的索引的长度。在不损失精确性的情况下，长度越短越好。                                                                                                       |
| ref           | 显示索引被使用的列，通常为一个常数。                                                                                                                 |
| rows          | MySQL用来返回请求数据的行数。当前只返回0号库查询结果，如需查看当前表所有物理分布，可以使用[SHOW TOPOLOGY](https://support.huaweicloud.com/usermanual-ddm/ddm-08-0017.html)命令 |
| Extra         | 关于MySQL如何解析查询的额外信息。                                                                                                                |
   
#### SQL大类限制
- 不支持临时表。
 
- 不支持外键、视图、游标、触发器及存储过程。
- 不支持用户自定义数据类型及自定义函数。
- 不支持"IF"，"WHILE" 等流程控制类语句。
- 不支持 BEGIN...END、LOOP...END LOOP、REPEAT...UNTIL...END REPEAT、WHILE...DO...END WHILE 等复合语句。
#### DDL语法
- 拆分表和广播表不支持外键。
- 不支持修改分片字段（拆分键）。
- 不支持ALTER DATABASE Syntax。
- 不支持从另一张表创建新的拆分表、广播表。
- create table不支持generated column语法。
- 不支持ALTER命令修改拆分键和全局序列字段。
- 不支持创建TEMPORARY类型的拆分表、广播表。
- 逻辑表名只允许字母(不区分大小写)数字以及下划线。
- 不支持CREATE TABLE tbl_name LIKE old_tbl_name。
- 不支持CREATE TABLE tbl_name SELECT statement。
- 不支持insert into on duplicate key update 更新拆分键值。
- 暂不支持跨Schema的DDL, 例如， CREATE TABLE db_name.tbl_name (... )。
- 使用MySQL关键字或保留字做表名、列名、索引名等标识符时，需要使用反引号扩起来。
 
#### DML语法
- 不支持PARTITION子句。
- 不支持UPDATE使用子查询。
- 不支持INSERT DELAYED Syntax。
- 不支持STRAIGHT_JOIN和NATURAL JOIN。
- 受限支持跨分片UPDATE多表需要join update的表需要有PK。
- 受限支持跨分片DELETE多表中的数据，需要Join delete的表需要有PK。

- 不支持SQL中对于变量的引用和操作。 例如：
  ```
  SET @c=1, @d=@c+1; 
  SELECT @c, @d;
  ```
  
- INSERT或者UPDATE时，不支持插入或者更新拆分键值为DEFAULT关键字。
- UPDATE不支持在一个语句中对同一字段重复更新。
- UPDATE不支持关联更新拆分键。
- UPDATE不支持自关联更新。
- 关联更新中，不支持在目标列的赋值语句或表达式中引用其它目标列，将造成更新结果不符合预期。 例如：
  ```
  update tbl_1 a,tbl_2 b set a.name=concat(b.name,'aaaa'),b.name=concat(a.name,'bbbb') on a.id=b.id;
  ```
  
- 当使用文本协议时，BINARY、VARBINARY、TINYBLOB、BLOB、MEDIUMBLOB、LONGBLOB数据必须转换成16进制数据。
- DDM对非法数据的处理与后端MySQL的sql_mode有关。
- 关联更新不支持不带关联条件的Join。
- SQL语句中表达式的因子数量请勿超过1000个。
 
#### 函数
- 不支持XML函数。
- 不支持GTID函数。
- 不支持全文检索函数。
- 不支持企业加密函数。
- 不支持row_count()函数。
 
#### 子查询
不支持HAVING子句中的子查询，JOIN ON条件中的子查询。
#### 数据类型
不支持空间数据类型。
#### 注释说明
- 单行注释
  - 使用井号（#）开头，后面直接写注释内容。#后面的所有内容直到行尾都被视为注释。 示例如下：
    ```
    SELECT * FROM customers; #注释内容
    ```
    
  
  - 使用两个连续的短划线（--），但这种注释要求第二个短划线后面至少有一个空格符，否则可能不会被正确解析。 示例如下：
    ```
    SELECT * FROM Product; -- 注释内容
    ```
    
   
- 多行注释 以/\*开始并且以\*/结束，可以包含多行文本。这种方式允许注释跨越多行。
  示例如下：
  ```
  /* 
  注释内容
  */
  SELECT DISTINCT product_id, purchase_price FROM Product;
  ```