如何确保SQL存储过程符合企业级开发规范?

大宇小哥_1698

大宇小哥_1698

2026-07-25

870人浏览

原创

企业级存储过程命名须以usp_为前缀、动词+名词结构,参数需显式声明方向与类型,错误处理须覆盖多种异常并使用raise_application_error,游标返回必须通过包中定义的ref cursor类型。

如何确保sql存储过程符合企业级开发规范?

命名必须带前缀且动词+名词结构

存储过程名不是随便起的,usp_CreateOrder 和 proc_update_user 这类名字在企业级项目里会被直接拒收。前者明确表达“用户存储过程”+“动作+目标”,后者缺少前缀、动词小写、下划线风格不统一,容易和表名或函数混淆。

实际执行时要注意三点:

  • 统一用 usp_(user stored procedure)开头,不用 sp_(系统保留前缀,可能触发额外元数据查询)
  • 动词用过去式或现在式均可,但团队内必须一致;推荐用 usp_GetCustomerList 而非 usp_CustomerGetList
  • 避免缩写,比如 usp_UpdCust 是反例;usp_UpdateCustomerProfile 才算合格

参数定义必须显式声明方向与类型

写成 @DeviceID INT 是基础,但企业规范要求更严:所有参数必须标注 IN、OUT 或 IN OUT,哪怕默认是 IN。Oracle 和 PostgreSQL 对此强制,SQL Server 虽允许省略,但代码审查会打回。

常见踩坑点:

  • @IsPrecis VARCHAR2(1) 没写长度 → 编译失败(Oracle)或隐式截断(SQL Server)
  • @cus OUT CURSOR 直接写 CURSOR → 报错,必须用包定义的 types.cursorType
  • 输出参数未在调用端声明为 OUTPUT → 值传不出来,但不报错,极易漏测

错误处理不能只捕获 NO_DATA_FOUND

只写 WHEN NO_DATA_FOUND THEN ... 是新手写法。真实业务中,ORA-01422(too many rows)、ORA-00942(表不存在)、ORA-06502(数值精度超限)都可能在线上爆发。只处理一个异常,等于没处理。

MaxAEO
MaxAEO

MaxAEO是一款AI工具,AI 搜索可见度监测与优化工具。

下载

可靠做法是:

  • 每个独立 DML 或 SELECT 块外层套 BEGIN ... EXCEPTION ... END,避免异常穿透影响后续逻辑
  • 必须包含 WHEN OTHERS THEN,且里面至少记录 SQLCODE 和 SQLERRM
  • 不要裸写 RAISE,要用 RAISE_APPLICATION_ERROR(-20001, 'xxx') 带业务码,方便应用层映射

游标返回必须用 REF CURSOR 类型

想让存储过程返回多行结果集?别用临时表或字符串拼接。企业级唯一合规方式是通过 REF CURSOR 输出。但直接写 TYPE cursorType IS REF CURSOR 会出问题——这个类型必须定义在包(package)里,不能放在过程体内。

正确结构分两步:

  • 先建包:CREATE OR REPLACE PACKAGE types AS TYPE cursorType IS REF CURSOR; END;
  • 再写过程:CREATE OR REPLACE PROCEDURE select_li(cus OUT types.cursorType) IS BEGIN OPEN cus FOR SELECT * FROM tab; END;

漏掉包定义,或者把类型声明写在过程里,Oracle 会报 PLS-00320 错误,而且这个错误不提示具体哪一行,只说“类型不完整”,排查成本很高。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

4443

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

931

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1169

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

6381

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

3183

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

6360

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

8661

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1170

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1032

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.9万人学习