(原作者:贺晓群,某数字教育出版公司DBA,引用或转帖请注明出处)
1 范围
本规范规定了SQL DQL和DML语言的编写总则,从书写格式归纳了SQL 书写的具体要求。
2 SQL编写总则
2.1 SQL语句应正确、规范、高效和最优。
2.2 应确保变量和参数的类型和大小与数据库中表数据列相匹配。
2.3 使用SELECT语句时,应指出列名,不应使用列的序号或者用“*”替代所有列名。(必须)
2.4 使用INSERT语句时,应指定插入的字段名,不应不指定字段名直接插入VALUES。
2.5 如果 SQL 语句连接多表时,应使用表的别名来引用列。
示例:
//正确的示例
1
2
3
4
5
6
|
SELECT
shopcatalog.catalogname, productinfo.producttitle
FROM
t_e_shopcatalog shopcatalog
JOIN
t_con_shopcatalog_product con
ON
shopcatalog.catalogid = con.shopcatalogid
JOIN
t_e_productinfo productinfo
ON
con.productid = productinfo.productid;
|
2.6 SQL语句应避免对大表的全表扫描操作,对大表的操作应尽量使用索引。
2.7 SQL语句应避免不必要的排序。
2.8 SQL语句应避免删除全表的操作,如有需要请使用TRUNCATE方式。
2.9 应减少对表的更新。
示例:
//错误的书写方式
1
2
3
4
|
UPDATE
t_con_catalog2content
SET
catalogid =
REPLACE
(catalogid,
'CNBJTW2'
,
'CNBJTW0'
);
UPDATE
t_con_catalog2content
SET
contentid =
REPLACE
(contentid,
'CNBJTW2'
,
'CNBJTW0'
);
|
//正确的书写方式
1
2
3
|
UPDATE
t_con_catalog2content
SET
contentid =
REPLACE
(contentid,
'CNBJTW2'
,
'CNBJTW0'
),
contentid =
REPLACE
(contentid,
'CNBJTW2'
,
'CNBJTW0'
);
|
2.10 SQL语句尽可能避免多表联合复杂查询,穷举解析开销大。
2.11 应将SQL语句中的数据库函数、计算表达式等放置在等号右边。
2.12 应按照业务需要使用事务,同时应保持事务简短,避免大事务。
2.13 在同一语句中避免出现多个相同子查询,未避免此情况可以使用WITH语法。
示例:
//上面的表示with改写前语句;下面的表示with改下后语句
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
SELECT
MAX
(b.ans)
FROM
(
SELECT
a.questionid
FROM
(
SELECT
a.paperid, a.questionid, a.questionsequence
FROM
t_con_paper_question a
WHERE
NOT
EXISTS (
SELECT
b.questionid
FROM
t_con_paper_question b
WHERE
a.questionid = b.questionid
AND
b.childid
IS
NOT
NULL
)
UNION
SELECT
a.paperid, a.childid
AS
questionid, a.questionsequence
FROM
t_con_paper_question a
WHERE
a.childid
IS
NOT
NULL
) a,
t_e_paper_publish c
WHERE
a.paperid = c.paperid
AND
c.publishid = $1) a,
(
SELECT
questionid,
COUNT
(
DISTINCT
sequenceno)
AS
ans
FROM
(
SELECT
questionid, sequenceno
FROM
t_e_question_item
WHERE
childid =
'0'
UNION
ALL
SELECT
childid questionid, sequenceno
FROM
t_e_question_item
WHERE
childid <>
'0'
) gg
GROUP
BY
questionid) b
WHERE
a.questionid = b.questionid;
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
WITH
question
AS
(
SELECT
a.questionid, a.childid
FROM
t_con_paper_question a, t_e_paper_publish c
WHERE
a.paperid = c.paperid
AND
c.publishid =
'CNGDLG0200000001297'
)
SELECT
MAX
(b.ans)
FROM
(
SELECT
questionid,
COUNT
(
DISTINCT
sequenceno)
AS
ans
FROM
(
SELECT
questionid, sequenceno
FROM
t_e_question_item
WHERE
childid =
'0'
AND
questionid
IN
(
SELECT
questionid
FROM
question
WHERE
childid
IS
NULL
)
UNION
ALL
SELECT
childid questionid, sequenceno
FROM
t_e_question_item
WHERE
childid <>
'0'
AND
childid
IN
(
SELECT
childid
FROM
question
WHERE
childid
IS
NOT
NULL
)) gg
GROUP
BY
questionid) b;
|
2.14 SQL语句应避免频繁引起数据库事务回滚。
2.15 外连接时,注意被连接表条件的位置。
示例:
//上面的表示书写错误;下面的表示书写正确
1
2
3
4
5
6
7
8
9
|
SELECT
a.status, b.content
FROM
t_e_message_delivery_status a
LEFT
JOIN
t_e_us_message b
ON
a.messageid = b.messageid
WHERE
a.status =
'1'
AND
b.messagetype
IN
(
'7'
,
'10'
)
AND
a.recipienttype =
'1'
AND
b.recipienttype
IN
(
'1'
,
'11'
)
AND
a.readtime
IS
NULL
;
|
1
2
3
4
5
6
7
8
9
|
SELECT
a.status, b.content
FROM
t_e_message_delivery_status a
LEFT
JOIN
t_e_us_message b
ON
a.messageid = b.messageid
AND
b.messagetype
IN
(
'7'
,
'10'
)
AND
b.recipienttype
IN
(
'1'
,
'11'
)
WHERE
a.status =
'1'
AND
a.recipienttype =
'1'
AND
a.readtime
IS
NULL
;
|
3 SQL书写规则
3.1 SQL语句的大小写
3.1.1 SQL语句中出现的所有表名、表别名、字段名、序列名、视图等数据库对象都应小写。
3.1.2 SQL 语句中出现的系统保留字、内置函数名、SQL保留字等都应大写。
3.3 SQL构建
3.3.1 如果一行有多列并超过80个字符,基于列对齐原则,应采用下行缩进。
3.3.2 缩进应为4个字符。
3.3.3 同层次的SQL语句缩进应保持一致。
3.3.4 SQL 文中不应出现空行。
3.4 SQL 书写应遵循以下空格规则。
3.4.1 SQL语句内的算术运算符、逻辑运算符(AND、OR、NOT)、 比较运算符(=、<=、>=、>、<、<>、!=、BETWEEN AND)、IN、LIKE等运算符前后都应加一空格。
3.4.2 SQL 语句中逗号后应加一空格。
3.5 SQL 语句的注释。
3.5.1 对较为复杂的 SQL 语句应注释,并说明算法和功能。
3.5.2 注释应单独成行,并放在语句前面。
3.5.3 应对不易理解的分支条件表达式加注释。
3.5.4 对重要的计算应说明其功能。
3.5.5 过长的函数实现,应将其语句按实现的功能分段加以概括性说明。
3.5.6 对常量及变量注释时,应注释被保存值的含义,宜包括合法取值的范围。
3.5.7 应可采用多行注释。(/* */ 方式)。
3.6 函数几点约束。
3.6.1 函数参数使用显示定义。
3.6.2 使用$BODY$包裹代码块。
3.6.3 函数必须注释创建人、创建时间、功能、参数说明及修改信息等。
3.6.4 如果是定时函数则必须记录运行日志。