SQL书写规范/SQL编码规范,这一篇就够了

您所在的位置:网站首页 三的规范书写 SQL书写规范/SQL编码规范,这一篇就够了

SQL书写规范/SQL编码规范,这一篇就够了

2024-07-05 20:48| 来源: 网络整理| 查看: 265

SQL语句中出现的所有表名、表别名、字段名、序列等数据库对象都应小写。

SQL语句中出现的系统保留字、内置函数名、SQL保留字、绑定变量等都应大写或小写,严禁使用大小写混合的书写。

例如:

select SELECT where WHERE union UNION insert INSERT count COUNT

错误示范:

Select -- 常见犯错 seLECT select clo1 FROM table1 where 1=1 AND 2=2

推荐使用单引号来表示字符值、字符串。

扩展:【SQL中单引号、双引号的区别】

原则上英文单引号、英文双引号都可以,一般应使用单引号。

如果字符串内需要包含单引号时,除了使用转义的办法外,我们可以选用一对双引号来包括字符串,这样字符串内的单引号被视作普通字符,无需特殊处理。 例如:Dljiang’s dog。以下三条语句输出是一致的,显然第一句更清晰

select "Dljiang's dog"; select 'Dljiang''s dog'; select 'Dljiang\'s dog';

如果使用英文双引号引用的字符串内需要包含双引号时,除了使用转义的办法外,我们可以用一对单引号来包括字符串,这样字符串内的双引号被视作普通字符,无需特殊处理。 例如:She said: “Handsome Dljiang”。以下三条语句输出是一致的,显然第一句更清晰

select 'She said: "Handsome Dljiang"'; select "She said: ""Handsome Dljiang"""; select "She said: \"Handsome Dljiang\"";

缩进应为1个Tab或者4个字符,所有的缩进均为1个缩进量的整数倍,按照代码层次对齐,同层次的SQL语句缩进应保持一致(纵向对齐)。

禁止使用select *操作,所有操作必须明确指定列名。

对应的括号要求在同一列的位置上,尤其用在子查询嵌套中!

代码中需要添加必要的注释,以增强代码的可读性。注释的规范:

每条SQL语句的注释单独成行,并放在语句的前面;

字段注释紧跟在字段后面;

对不易理解的分支条件表达式添加注释;

对重要的计算添加注释,说明其功能。

-- 单行注释 /* 多行注释 多行注释 */

select / from / where / order by / group by 等语句应独占一行。

子句跟语句占同一行原则:

select子句内容如果只有一项,应与 select 同占一行;

from 子句内容如果只有一项,应与 from 同占一行;

where 子句内容如果只有一项,应与 where 同占一行。

子句单独占一行原则:

select 子句内容如果多于一项,每一项都应独占一行,并在对应 select 的基础上向右缩进1个Tab或者4个字符;

from 子句内容如果多于一项,每一项都应独占一行,并在对应 from 的基础上向右缩进1个Tab或者4个字符;

where 子句的条件如果有多项,每一个条件应独占一行,并以 and 开头,并在对应 where 的基础上向右缩进1个Tab或者4个字符。

SQL文中不应出现空行。

合理使用空格。代码中应该适当留有一些空格,如果一点不留,代码都凑到一起, 逻辑单元不明确。

-- 好的示例 SELECT col_1 ,col_2 FROM tbl_A A WHERE A.col_1 >= 100 ; -- 坏的示例 SELECT col_1 ,col_2 FROM tbl_A A WHERE A.col_1>=100 ;

不等于推荐使用符号。

表名要有意义,且标准 SQL 中规定表名的第一个字符应该是字母。

insert 子句写在同一行,请勿换行。

SQL语句中出现多个表时,给每个表加上表别名。表别名的规范:

一旦在SELECT语句中给操作表定义了别名,在整个语句中对此表的引用都必须以别名替代,所以需要给所有的表添加别名;

表别名采用简单字符命名,建议按a、b、c、d…的顺序进行命名,并避免使用关键字;

多层次的嵌套子查询别名之前要体现层次关系,SQL语句的别名需要分层命名,从第1层次至第4层次,分别用P(Part) 、S(Segment)、 U(Unit) 和D(Detail)表示。您也可以用a、b、c、d来表示第1层次到第4层次。

对于同一层次的多个子句,在字母后加1、2、3、4……区分,并根据情况对表别名添加注释;

select 语句查询的字段,推荐将 , 写在字段前面。

-- 好的示例 SELECT col_1 ,col_2 ,col_3 FROM tbl_A A; -- 不推荐的示例 SELECT col_1, col_2, col_3 FROM tbl_A A;


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3