# SAP SQLScript 开发指南 ## 概述 SQLScript 是 SAP HANA 对 SQL 的过程扩展，可直接在数据库层内执行复杂的数据密集型逻辑。它遵循**代码到数据范式**，将计算推到数据所在的位置，而不是将数据移动到应用程序层。 ### 主要特征 * **不区分大小写**语言 * 所有语句均以 **分号** 结尾 * 变量在引用时使用 **冒号前缀** (`:variableName`) * **赋值时无冒号** * 使用`DUMMY`表进行单行操作 ### 两种逻辑类型类型 |描述 |执行 ---|---|--- **声明式** |纯 SQL 序列 |转换为数据流图，并行处理 **势在必行** |控制结构（IF、WHILE、FOR）|按顺序处理，防止并行执行 ** ** ## 目录 * 概述 * 集装箱类型 * 匿名区块 * 存储过程 * 用户自定义函数 * 数据类型 * 变量声明 * 控制结构 * 表类型 * 光标 * 异常处理 * AMDP 集成 * 性能最佳实践 * 系统限制 * 调试工具 * 快速参考 * 额外资源 ** ** ## 容器类型 ### 1\.匿名区块一次性逻辑不存储在数据库中。对于测试和临时执行很有用。 DO [(<参数子句>)] 开始[顺序执行] <正文> 结束； **示例：** 溶解氧开始声明 lv_count INTEGER；从“MYTABLE”中选择 COUNT(*) INTO lv_count；选择：lv_count AS record_count FROM DUMMY；结尾; ### 2\.存储过程具有输入/输出参数的可重用数据库对象。创建[或替换]过程<过程名称> （ [IN <参数> <数据类型>], [OUT <参数> <数据类型>], [INOUT <参数> <数据类型>] ）语言 SQL 脚本 [SQL 安全性{定义器|祈求者}] [默认架构 ] [读取 SQL 数据 |使用结果视图读取 SQL 数据 ] AS 开始 <程序主体> 结束； ### 3\.用户定义函数 **标量 UDF** \- 返回单个值：创建函数 <函数名称> (<输入参数>) 返回<标量类型> 语言 SQL 脚本 AS 开始 <函数体> 返回<值>；结尾; **表 UDF** \- 返回表（只读）：创建函数 <函数名称> (<输入参数>) 返回表（<列定义>）语言 SQL 脚本读取 SQL 数据 AS 开始返回选择...从...; 结尾; ** ** ## 数据类型 SQLScript 支持针对不同用例的全面数据类型。请参阅“references/data-types.md”以获取完整的文档，包括： * 数字类型（TINYINT、INTEGER、DECIMAL 等） * 字符类型（VARCHAR、NVARCHAR、CLOB 等） * 日期/时间类型（日期、时间、时间戳、秒） * 二进制类型（VARBINARY、BLOB） * 类型转换函数（CAST、TO_函数） * NULL 处理模式 ** ** ## 变量声明 ### 标量变量 DECLARE <变量名称> <数据类型> [:= <初始值>]; -- 例子声明 lv_name NVARCHAR(100); 声明 lv_count INTEGER := 0; 声明 lv_date DATE := CURRENT_DATE; > **注意：** 未初始化的变量默认为 NULL。 ### 表变量 **隐式声明：** lt_result = SELECT * FROM "MYTABLE" WHERE status = 'A'; **明确声明：** 声明 lt_data 表 ( id 整数，名称 NVARCHAR(100), 金额 DECIMAL(15,2) ）； **使用类似表格：** 声明 lt_copy 表 LIKE :lt_original; ### 数组声明 arr 整数数组 := ARRAY(1, 2, 3, 4, 5); -- 访问：arr[1]、arr[2]等（从1开始索引） -- 注意：过程中不能返回数组 ** ** ## 控制结构 ### IF-ELSE 语句 IF <条件 1> 那么 <语句> [ELSEIF <条件2> THEN <声明>] [否则 <声明>] 结束如果； **比较运算符：** 操作员|含义 ---|--- `=` |等于 `>` |大于 `<` |小于 `>=` |大于或等于 `<=` |小于或等于 `!=`、`<>` |不等于 > **重要提示：** IF-ELSE 不能在 SELECT 语句中使用。请改用 CASE WHEN。 ### WHILE 循环 WHILE <条件> DO <语句> 结束同时； ### FOR 循环 -- 数字范围对于 i 在 1..10 DO <语句> 结束； -- 反向 FOR i 反向 10..1 DO <语句> 结束； -- 光标迭代 FOR 行 AS <光标名称> DO <使用 row.column_name 的语句> 结束； ### 带退出的循环循环 <语句> IF <条件> 那么打破；结束如果；结束循环； ** ** ## 表类型定义可重用的表结构：创建类型 <类型名称> 作为表 ( <列1> <数据类型>, <列2> <数据类型>, ... ）； **程序中的使用：** 创建过程 get_employees (OUT et_result MY_TABLE_TYPE) 语言 SQLScript AS 开始 et_result = 从“员工”中选择*；结尾; ** ** ## 光标游标逐行处理结果集。模式：**声明→打开→获取→关闭** > **性能说明：** 游标绕过数据库优化器并按顺序处理行。主要用于基于主键的查询。尽可能首选基于集合的操作。声明游标 <游标名称> FOR SELECT <列> FROM <表> [WHERE <条件>]; OPEN <光标名称>; FETCH <光标名称> INTO <变量>; 关闭 <光标名称>; **完整示例：** 溶解氧开始声明 lv_id 整数；声明 lv_name NVARCHAR(100); 声明游标 cur_employees FOR 从“员工”中选择 ID、姓名，其中部门 = 'IT'；打开 cur_employees; FETCH cur_employees INTO lv_id, lv_name; 虽然不是 cur_employees::NOTFOUND 可以 -- 处理行从虚拟中选择：lv_id、：lv_name； FETCH cur_employees INTO lv_id, lv_name; 结束同时；关闭 cur_employees; 结尾; **FOR 循环替代方案：** FOR 行 AS cur_employees DO SELECT row.id, row.name FROM DUMMY; 结束； ** ** ## 异常处理 ### 退出处理程序发生异常时暂停执行并执行清理。声明的退出处理程序 <声明>； **条件值：** * `SQLEXCEPTION` \- 任何 SQL 异常 * `SQL_ERROR_CODE ` \- 特定错误代码 **访问错误详细信息：** * `::SQL_ERROR_CODE` \- 数字错误代码 * `::SQL_ERROR_MESSAGE` \- 错误消息文本 **示例：** 创建过程 safe_insert (IN iv_id INTEGER, IN iv_name NVARCHAR(100)) 语言 SQLScript AS 开始声明 SQLEXCEPTION 的退出处理程序开始选择::SQL_ERROR_CODE AS err_code， ::SQL_ERROR_MESSAGE AS err_msg FROM DUMMY；结尾; 插入“我的表”值（：iv_id，：iv_name）；结尾; ### 条件将用户定义的名称与错误代码关联： DECLARE CONDITION FOR SQL_ERROR_CODE ; -- 示例声明 SQL_ERROR_CODE 301 的重复键条件；声明重复键的退出处理程序从 DUMMY 中选择“重复键错误”； ### 信号和信号抛出用户定义的异常（代码10000-19999）： -- 抛出异常 SIGNAL <条件名称> SET MESSAGE_TEXT = '<消息>'; -- 重新扔进处理程序 RESIGNAL [<条件名称>] [SET MESSAGE_TEXT = '<消息>']; **常见错误代码：** 代码|描述 ---|--- 301 | 301违反唯一约束 1299 | 1299没有找到数据 ** ** ## AMDP 集成 ABAP 托管数据库过程允许在 ABAP 类中使用 SQLScript。 ### 类定义类 zcl_my_amdp 定义公共最终创建公共。公共部分。接口 if_amdp_marker_hdb。 " 需要的接口类型： ty_result 开头， id 类型 i, 名称类型字符串， ty_结果结束， tt_result ty_result 类型标准表。类方法：get_data 导入值（iv_filter）类型字符串导出值（et_result）类型 tt_result。 ENDCLASS。 ### 方法实现 zcl_my_amdp 类实现。通过数据库过程获取数据的方法对于组屋语言 SQL 脚本选项只读使用 ztable。 et_result = 选择 ID、名称来自z表其中类别 = :iv_filter; 结束方法。 ENDCLASS。 ### AMDP 限制 * 参数必须是**按值传递**（无返回） * 仅允许**标量类型、结构、内部表** * 没有嵌套表或深层结构 * **不允许提交/回滚** * 必须使用**Eclipse ADT**进行开发 * 第一次调用时自动创建 ** ** ## 性能最佳实践 ### 1\.尽早减少数据量 -- 好：尽早过滤和项目 lt_filtered = 从“BIGTABLE”中选择 col1、col2，其中 status = 'A'； lt_result = SELECT a.col1, b.name 来自：lt_filtered AS a JOIN "LOOKUP" AS b ON a.id = b.id; -- 不好：加入然后过滤 lt_result = SELECT a.col1, b.name 从“BIGTABLE”作为 JOIN "LOOKUP" AS b ON a.id = b.id WHERE a.status = 'A'; ### 2\.更喜欢声明式而非命令式 -- 好：基于集合的操作 lt_result = SELECT id, amount * 1.1 AS new_amount FROM "ORDERS"; -- 不好：逐行处理 FOR 行 AS cur_orders DO UPDATE "ORDERS" SET amount = row.amount * 1.1 WHERE id = row.id; 结束； ### 3\.避免发动机混合 * 不要在同一查询中混合行存储和列存储表 * 避免使用纯 SQL 的计算引擎函数 * 使用一致的存储类型 ### 4\.使用 UNION ALL 代替 UNION -- 当重复不可能或可以接受时更快 SELECT * FROM table1 UNION ALL SELECT * FROM table2; -- 较慢：删除重复项 SELECT * FROM table1 UNION SELECT * FROM table2; ### 5\.避免动态 SQL -- 不好：重新优化每次执行立即执行“SELECT * FROM”|| :lv_表； -- 好：带参数的静态 SQL 从“MYTABLE”中选择 *，其中 id = :lv_id; ### 6\.将命令式逻辑置于最后将控制结构放在过程的末尾，以最大限度地并行处理声明性语句。 ** ** ## 系统限制限制|价值 ---|--- 每个事务的表锁 | 16,383 声明中的表格| 4,095 SQL语句长度| 2GB 程序大小|受 SQL 语句长度 (2 GB) 限制 > **注意：** 实际限制可能因 HANA 版本而异。有关特定于版本的限制，请参阅 SAP 文档。 ** ** ## 调试工具 * **SQLScript 调试器** \- SAP Web IDE / Business Application Studio * **计划可视化工具** \- 分析执行计划 * **昂贵的语句跟踪** \- 识别瓶颈 * **SQL 分析器** \- 查询优化建议 ** ** ## 快速参考 ### 字符串连接 lv_结果 = lv_str1 || ' ' || lv_str2； ### 空处理合并（值，默认值） IFNULL（值，默认值） NULLIF(值1,值2) ### 日期操作 ADD_DAYS（日期，n） ADD_MONTHS（日期，n） DAYS_BETWEEN（日期 1，日期 2）当前_日期 CURRENT_TIMESTAMP ### 类型转换 CAST（值 AS 数据类型） TO_VARCHAR（值） TO_INTEGER（值） TO_DATE(字符串, 'YYYY-MM-DD') TO_TIMESTAMP(字符串, 'YYYY-MM-DD HH24:MI:SS') ** ** ## 相关技能对于全面的 SAP 开发，请将此技能与以下技能结合起来：技能|使用案例 ---|--- **sap-abap** | AMDP 上下文的 ABAP 编程模式 **sap-abap-cds** |使用 SQLScript 过程的 CDS 视图 **sap-cap-capire** | CAP框架数据库程序集成 **sap-hana-cli** |用于过程部署和测试的 HANA CLI **sap-btp-云平台** | HANA 工件的 BTP 部署 ** ** ## 捆绑资源 ### 参考文档 * `references/skill-reference-guide.md` \- **所有参考文献的索引，可快速导航** * `references/glossary.md` \- **SQLScript 术语和概念** * `references/syntax-reference.md` \- 完整的 SQLScript 语法参考 * `references/built-in-functions.md` \- 内置函数目录 * `references/data-types.md` \- 数据类型和转换 * `references/exception-handling.md` \- 异常处理模式 * `references/amdp-integration.md` \- AMDP 集成模式 * `references/performance-guide.md` \- 优化技巧 * `references/advanced-features.md` \- 横向连接、JSON、查询提示、货币转换 * `references/troubleshooting.md` \- 常见错误及解决方案 ### 生产就绪模板复制并自定义这些模板以实现常见模式： * `templates/simple-procedure.sql` \- 带错误处理的基本存储过程 * `templates/procedure-with-error-handling.sql` \- 全面的错误处理模式 * `templates/table-function.sql` \- 带验证的表 UDF * `templates/scalar-function.sql` \- 标量 UDF 示例 * `templates/amdp-class.abap` \- 完整的 AMDP 类样板 * `templates/amdp-procedure.sql` \- AMDP 实现模板 * `templates/cursor-iteration.sql` \- 游标模式（经典和 FOR 循环） * `templates/bulk-operations.sql` \- 高性能批量操作 ### 专业代理 * **sqlscript-analyzer** \- 分析代码的性能问题和最佳实践 * **程序生成器** \- 根据需求交互式生成程序 * **amdp-helper** \- 协助 AMDP 类创建和调试 ### 斜线命令 * `/sqlscript-validate` \- 验证具有自动修复功能的代码 * `/sqlscript-optimize` \-性能分析和优化建议 * `/sqlscript-convert` \- 在独立格式和 AMDP 格式之间转换 ### 验证挂钩对写入/编辑操作进行自动代码质量检查： * 错误处理完整性 * 安全漏洞 * 性能反模式 * 命名约定 * AMDP 合规性

SAP SQL脚本

包含技能