Seata入门系列【9】Seata之SQL语句限制
1 前言
以下内容摘自官网(地址:http://seata.io/zh-cn/docs/user/sqlreference/sql-restrictions.html)
在使用Seata 的时候，对SQL语句还是有很多限制，所以在使用的时候需要格外注意这个问题（较新版本可能已支持）
2 SQL限制
Seata 事务目前支持 INSERT、UPDATE、DELETE 三类 DML 语法的部分功能，这些类型都是已经经过Seata开源社区的验证。SQL 的支持范围还在不断扩大，建议在本文限制的范围内使用。如果您有意帮助社区支持更多类型的SQL，请提交PR申请。
2.1 使用限制
-
不支持 SQL 嵌套
-
不支持多表复杂 SQL(自1.6.0版本，MySQL支持UPDATE JOIN语句)
-
不支持存储过程、触发器
-
部分数据库不支持批量更新，在使用 MySQL、Mariadb、PostgreSQL9.6+作为数据库时支持批量，批量更新方式如下以 Java 为例
// use JdbcTemplate
public void batchUpdate() {
jdbcTemplate.batchUpdate(
"update storage_tbl set count = count -1 where id = 1",
"update storage_tbl set count = count -1 where id = 2"
);
}
// use Statement
public void batchUpdateTwo() {
statement.addBatch("update storage_tbl set count = count -1 where id = 1");
statement.addBatch("update storage_tbl set count = count -1 where id = 2");
statement.executeBatch();
}
2.2 DML语句
主要介绍 DML 语句类型、SQL 实例以及 Seata 是否支持
| 类型 | SQL 实例 | 是否支持 |
|---|---|---|
| INSERT | INSERT INTO tb1_name (col_name,…) VALUES ({expr | FAULT},…),(…),…或 INSERT INTO tb1_name SET col_name={expr | DEFAULT}, … 或INSERT INTO tb1_name (col_name,…) VALUES ({expr | FAULT},…) ON DUPLICATE KEY UPDATE field1=value1,…; | 是 |
| UPDATE | UPDATE tb1_name SET col_name1=expr1 [, col_name2=expr2 …][WHERE where_definition] | 是 |
| DELETE | DELETE FROM tb1_name [WHERE where_definition] | 是 |
| SELECT | SELECT [ALL | DISTINCT | DISTINCTROW ]select_expr, … FROM tb1_name[WHERE where_definition] | 是 |
| REPLACE | REPLACE [LOW_PRIORITY | DELAYED][INTO] tb1_name [(col_name,…)]VALUES ({expr | DEFAULT},…),(…),…或REPLACE [LOW_PRIORITY | DELAYED][INTO] tb1_nameSET col_name={expr | DEFAULT}, … | 否 |
| TRUNCATE | TRUNCATE [TABLE] tb1_name | 否 |
| UPDATE JOIN | UPDATE tb1_name tb1 JOIN tb2_name tb2 ON tb2.col_name=tb1.col_name SET tb1.col_name1=expr1 [, tb1.col_name2=expr2 …][ [WHERE where_definition] | 是 since 1.6.0 |
2.3 SQL修饰
Seata 的隔离级别默认为读未提交，该模式下本文表中的 select 语句的 SQL 修饰用法都是支持的；使用 for update 代理可以让 Seata 达到读已提交，该模式下 select 语句的用法只能部分支持。
2.3.1 DML语句支持
| 类型 | SQL 实例 | 是否支持 |
|---|---|---|
| AND & OR | UPDATE … WHERE col_name1=expr1 AND col_name2= expr2 | 是 |
| LIKE | UPDATE … WHERE col_name1 LIKE ‘NE’ | 是 |
| 通配符 | UPDATE … WHERE col_name1 LIKE ‘NE%’ | 是 |
| BETWEEN | UPDATE … WHERE col_name1 BETWEEN expr1 AND expr2 | 是 |
| ON DUPLICATE | INSERT INTO tb1_name [(col_name,…)]VALUES ({expr | DEFAULT},…),(…),…[ ON DUPLICATE KEY UPDATE col_name=expr, … ] | 是 |
2.3.2 Select语句支持
| 类型 | SQL 实例 | 读未提交 | 读已提交 |
|---|---|---|---|
| AND & OR | SELECT * FROM tb1_name WHERE col_name1=expr1 AND col_name2= expr2 | 是 | 是 |
| ORDER BY | SELECT col_name1, col_name2 FROM tb1_name ORDER BY col_name1 | 是 | 是 |
| GROUP BY | SELECT col_name1, col_name2 FROM tb1_name GROUP BY col_name1 | 是 | 是 |
| LIKE | SELECT col_name1, col_name2 FROM tb1_name WHERE col_name1 LIKE ‘NE’ | 是 | 是 |
| 通配符 | SELECT col_name1, col_name2 FROM tb1_name WHERE col_name1 LIKE ‘NE%’ | 是 | 是 |
| EXISTS | SELECT col_name1, col_name2 FROM tb1_name WHERE EXISTS (expr1) | 是 | 是 |
| IN | SELECT col_name1, col_name2 FROM tb1_name WHERE col_name1 IN (expr1, expr2,…) | 是 | 是 |
| BETWEEN | SELECT col_name1, col_name2 FROM tb1_name WHERE col_name1 BETWEEN expr1 AND expr2 | 是 | 是 |
| ON DUPLICATE | INSERT INTO tb1_name [(col_name,…)]VALUES ({expr | DEFAULT},…),(…),…[ ON DUPLICATE KEY UPDATE col_name=expr, … ] | 是 | 是 |
| ALIASES | SELECT t1. col_name1, t2.col_name2 FROM tb1_name AS t1, tb2_name AS t2 WHERE t1. col_name=expr AND t2. col_name=expr | 是 | 是 |
| TOP | SELECT TOP 2 * FROM tb1_name | 是 | 是 |
| LIMIT | SELECT col_name1, col_name2 FROM tb1_name LIMIT 5 | 是 | 是 |
| JOININNER JOINLEFT JOINRIGHT JOINFULL JOIN | SELECT col_name1, col_name2 FROM tb1_name JOIN tb2_name>ON tb1_name. col_name1= tb2_name. col_name1 | 是 | 否 |
| UNIONUNION ALLSELECT INTO | SELECT col_name1, col_name2 FROM tb1_name UNION SELECT col_name1, col_name2 FROM tb2_name | 是 | 否 |
2.4 函数
下面的表列出了 DQL 语句和 DML 语句对函数的支持情况。需要注意的是，在 DML 语句中使用函数，不能将其作为主键
2.4.1 DML语句支持
| 类型 | 是否支持 |
|---|---|
| CONCAT(string2[,…]) | 是 |
| INSTR(string,substring) | 是 |
| LCASE(string2) | 是 |
| LEFT(string2,length) | 是 |
| LENGTH(string) | 是 |
| LOAD_FILE(file_name) | 是 |
| LOCATE(substring,string[,start_position]) | 是 |
| LPAD(string2,length,pad) | 是 |
| LTRIM(string2) | 是 |
| REPEAT(string2,count) | 是 |
| REPLACE(str,search_str,replace_str) | 是 |
| RPAD(string2,length,pad) | 是 |
| RTRIM(string2) | 是 |
| STRCMP(string1,string2) | 是 |
| SUBSTRING(str,position[,length]) | 是 |
| TRIM([[BOTH|LEADING|TRAILING][padding]FROM]string2) | 是 |
| UCASE(string2) | 是 |
| RIGHT(string2,length) | 是 |
| SPACE(count) | 是 |
| ABS(number2) | 是 |
| BIN(decimal_number) | 是 |
| CEILING(number2) | 是 |
| CONV(number2,from_base,to_base) | 是 |
| FLOOR(number2) | 是 |
| FORMAT(number,decimal_places) | 是 |
| HEX(DecimalNumber) | 是 |
| LEAST(number,number2[,…]) | 是 |
| MOD(numerator,denominator) | 是 |
| POWER(number,power) | 是 |
| RAND([seed]) | 是 |
| ROUND(number[,decimals]) | 是 |
| SIGN(number2) | 是 |
| SQRT(number2) | 是 |
| ADDTIME(date2,time_interval) | 是 |
| CONVERT_TZ(datetime2,fromTZ,toTZ) | 是 |
| CURRENT_DATE() | 是 |
| CURRENT_TIME() | 是 |
| CURRENT_TIMESTAMP() | 是 |
| DATE(datetime) | 是 |
| DATE_ADD(date2,INTERVALd_valued_type) | 是 |
| DATE_FORMAT(datetime,FormatCodes) | 是 |
| DATE_SUB(date2,INTERVALd_valued_type) | 是 |
| DATEDIFF(date1,date2) | 是 |
| DAY(date) | 是 |
| DAYNAME(date) | 是 |
| DAYOFWEEK(date) | 是 |
| DAYOFYEAR(date) | 是 |
| EXTRACT(interval_nameFROMdate) | 是 |
| MAKEDATE(year,day) | 是 |
| MAKETIME(hour,minute,second) | 是 |
| MONTHNAME(date) | 是 |
| NOW() | 是 |
| SEC_TO_TIME(seconds) | 是 |
| STR_TO_DATE(string,format) | 是 |
| TIMEDIFF(datetime1,datetime2) | 是 |
| TIME_TO_SEC(time) | 是 |
| WEEK(date_time[,start_of_week]) | 是 |
| YEAR(datetime) | 是 |
| DAYOFMONTH(datetime) | 是 |
| HOUR(datetime) | 是 |
| LAST_DAY(date) | 是 |
| MICROSECOND(datetime) | 是 |
| MONTH(datetime) | 是 |
| MINUTE(datetime) | 是 |
| FIRST() | 否 |
| LAST() | 否 |
| MIN() | 否 |
| MAX() | 否 |
| AVG() | 否 |
| SUM() | 否 |
| COUNT() | 否 |
2.4.2 DQL语句支持
| 类型 | 读未提交 | 读已提交 |
|---|---|---|
| CONCAT(string2[,…]) | 是 | 是 |
| INSTR(string,substring) | 是 | 是 |
| LCASE(string2) | 是 | 是 |
| LEFT(string2,length) | 是 | 是 |
| LENGTH(string) | 是 | 是 |
| LOAD_FILE(file_name) | 是 | 是 |
| LOCATE(substring,string[,start_position]) | 是 | 是 |
| LPAD(string2,length,pad) | 是 | 是 |
| LTRIM(string2) | 是 | 是 |
| REPEAT(string2,count) | 是 | 是 |
| REPLACE(str,search_str,replace_str) | 是 | 是 |
| RPAD(string2,length,pad) | 是 | 是 |
| RTRIM(string2) | 是 | 是 |
| STRCMP(string1,string2) | 是 | 是 |
| SUBSTRING(str,position[,length]) | 是 | 是 |
| TRIM([[BOTH|LEADING|TRAILING][padding]FROM]string2) | 是 | 是 |
| UCASE(string2) | 是 | 是 |
| RIGHT(string2,length) | 是 | 是 |
| SPACE(count) | 是 | 是 |
| ABS(number2) | 是 | 是 |
| BIN(decimal_number) | 是 | 是 |
| CEILING(number2) | 是 | 是 |
| CONV(number2,from_base,to_base) | 是 | 是 |
| FLOOR(number2) | 是 | 是 |
| FORMAT(number,decimal_places) | 是 | 是 |
| HEX(DecimalNumber) | 是 | 是 |
| LEAST(number,number2[,…]) | 是 | 是 |
| MOD(numerator,denominator) | 是 | 是 |
| POWER(number,power) | 是 | 是 |
| RAND([seed]) | 是 | 是 |
| ROUND(number[,decimals]) | 是 | 是 |
| SIGN(number2) | 是 | 是 |
| SQRT(number2) | 是 | 是 |
| ADDTIME(date2,time_interval) | 是 | 是 |
| CONVERT_TZ(datetime2,fromTZ,toTZ) | 是 | 是 |
| CURRENT_DATE() | 是 | 是 |
| CURRENT_TIME() | 是 | 是 |
| CURRENT_TIMESTAMP() | 是 | 是 |
| DATE(datetime) | 是 | 是 |
| DATE_ADD(date2,INTERVALd_valued_type) | 是 | 是 |
| DATE_FORMAT(datetime,FormatCodes) | 是 | 是 |
| DATE_SUB(date2,INTERVALd_valued_type) | 是 | 是 |
| DATEDIFF(date1,date2) | 是 | 是 |
| DAY(date) | 是 | 是 |
| DAYNAME(date) | 是 | 是 |
| DAYOFWEEK(date) | 是 | 是 |
| DAYOFYEAR(date) | 是 | 是 |
| EXTRACT(interval_nameFROMdate) | 是 | 是 |
| MAKEDATE(year,day) | 是 | 是 |
| MAKETIME(hour,minute,second) | 是 | 是 |
| MONTHNAME(date) | 是 | 是 |
| NOW() | 是 | 是 |
| SEC_TO_TIME(seconds) | 是 | 是 |
| STR_TO_DATE(string,format) | 是 | 是 |
| TIMEDIFF(datetime1,datetime2) | 是 | 是 |
| TIME_TO_SEC(time) | 是 | 是 |
| WEEK(date_time[,start_of_week]) | 是 | 是 |
| YEAR(datetime) | 是 | 是 |
| DAYOFMONTH(datetime) | 是 | 是 |
| HOUR(datetime) | 是 | 是 |
| LAST_DAY(date) | 是 | 是 |
| MICROSECOND(datetime) | 是 | 是 |
| MONTH(datetime) | 是 | 是 |
| MINUTE(datetime) | 是 | 是 |
| FIRST() | 是 | 否 |
| LAST() | 是 | 否 |
| MIN() | 是 | 否 |
| MAX() | 是 | 否 |
| AVG() | 是 | 否 |
| SUM() | 是 | 否 |
| COUNT() | 是 | 否 |