| SQL代码编码原则和规范 | 您所在的位置：网站首页 › 编码格式规范标准 › SQL代码编码原则和规范 |
SQL代码编码原则和规范
|
代码头部
代码头部添加主题、功能描述、作者和日期等信息，并预留修改日志及标题栏，以便后续添加修改记录。注意每行不超过80个字符，模板如下。 -- MaxCompute(ODPS) SQL --************************************************************************** -- ** 所属主题: 交易 -- ** 功能描述: 交易退款分析 -- ** 创建者 : 有码 -- ** 创建日期: 20170616 -- ** 修改日志: -- ** 修改日期 修改人 修改内容 -- yyyymmdd name comment -- 20170831 无码 增加对biz_type=1234交易的判断 --************************************************************************** 字段排列要求 SELECT语句选择的字段按照每行1个字段的方式编排。 首个选择的字段与SELECT之间隔1个缩进量。 换行缩进2个缩进量后，添加逗号再输入其它字段名。 2个字段之间的逗号分隔符紧跟在第2个字段的前面。 AS语句应与相应的字段在同一行，多个字段的AS建议尽量对齐在同一列上。
INSERT子句排列要求
INSERT子句写在同一行，请勿换行。 SELECT子句排列要求 SELECT语句中所用到的from、where、group by、having、order by、join和union等子句，需要遵循如下要求： 换行编写。 与相应的SELECT语句左对齐编排。 子句首个单词后添加2个缩进量，再编写后续的代码。 WHERE子句下的逻辑判断符and、or等，与WHERE左对齐编排。 超过2个缩进量长度的子句加1个空格后，再编写后续代码，例如order by和group by等。
运算符前后间隔要求
算术运算符、逻辑运算符前后要保留1个空格，并写在同一行（超过每行80个字符长度的限制除外）。
CASE语句的编写
CASE语句可以用于SELECT语句中对字段值进行判断取值的操作。CASE语句编排的规则如下：
WHEN子语在CASE语句的同一行，并缩进1个缩进量后开始编写。
每个WHEN子句尽量在1行内编写，如果语句较长可以换行。
CASE语句必须包含ELSE子语，ELSE子句与WHEN子句对齐。
查询嵌套编写规范
在数据仓库系统ETL开发中经常使用子查询嵌套，其编写规范示例如下。
表别名定义约定
一旦在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……区分，并根据情况对表别名添加注释。
SQL注释
每条SQL语句均应添加注释说明。
每条SQL语句的注释单独成行，并放在语句的前面。
字段注释紧跟在字段后面。
对不易理解的分支条件表达式添加注释。
对重要的计算添加注释，说明其功能。
过长的函数实现，应将其语句按实现的功能分段，添加注释进行说明。
添加常量及变量的注释时，应注释被保存值的含义（必选），合法取值的范围（可选）。
将鼠标放置对应SQL语句之后，使用Crtl+/或Cmd+/快捷键即可注释当前语句。如果您需要注释多行语句，则可以选中需要注释的语句，使用Crtl+/或Cmd+/批量完成注释。
说明
Windows系统仅支持使用Crtl+/快捷键注释SQL语句。
Mac系统仅支持使用Cmd+/快捷键注释SQL语句。
|
【本文地址】
公司简介
联系我们