第八十一章 SQL命令 UNLOCK

解锁表

大纲

UNLOCK [TABLE] tablename IN EXCLUSIVE MODE [IMMEDIATE]

UNLOCK [TABLE] tablename IN SHARE MODE [IMMEDIATE]

参数

• tablename - 要解锁的表的名称。 Tablename必须是已经存在的表。 表名可以是限定的(schema.table)，也可以是非限定的(table)。 非限定表名接受默认模式名。 模式搜索路径被忽略。
• IN EXCLUSIVE MODE / IN SHARE MODE - IN EXCLUSIVE MODE关键字短语释放常规的IRIS锁。 IN SHARE MODE关键字短语在IRIS级别释放共享锁。

描述

UNLOCK命令用来解锁被LOCK命令锁定的SQL表。 此表必须是已存在的表，您对其具有必要的特权。 如果tablename是临时表，则命令执行成功，但不执行任何操作。 如果tablename是视图，则命令失败，并出现SQLCODE -400错误。

UNLOCK和UNLOCK TABLE是同义词。

UNLOCK命令用来反转LOCK操作。 即使没有锁被持有，UNLOCK命令也会成功完成。 可以使用LOCK多次锁定一个表; 必须显式解锁表，解锁次数为表被显式锁定的次数。

权限

该命令为特权操作。

第八十章 SQL命令 UNION

组合两个或多个SELECT语句。

大纲

select-statement {UNION [ALL] [%PARALLEL] select-statement}

select-statement {UNION [ALL]  [%PARALLEL] (query)}

(query) {UNION [ALL]  [%PARALLEL] select-statement}

(query) {UNION [ALL]  [%PARALLEL] (query)}

参数

• ALL - 可选——关键字字面量。 如果指定，则返回重复的数据值。 如果省略，重复的数据值将被抑制。
• %PARALLEL - 可选—%PARALLEL关键字。 如果指定，则union的每一边都作为单独的进程并行运行。
• select-statement - 从数据库中检索数据的SELECT语句。
• query - 组合一个或多个SELECT语句的查询。

描述

UNION将两个或多个查询组合为一个查询，该查询将数据检索到结果中。 由UNION组合的查询可以是由单个SELECT语句组成的简单查询，也可以是复合查询。

为了在SELECT语句之间实现联合，每个分支中指定的列数必须匹配。 指定具有不同列数的select将导致SQLCODE -9错误。

亲爱的社区开发者们，大家好！

我们欢迎您来参加 2021年欧洲医疗编程马拉松 ，这一赛事时间为2021年11月19日-21日，免费参赛，线上赛道（On-line Track）的申请截止日期延长至11月15日。

我们将有一个InterSystems的挑战:“用FHIR创新”。InterSystems赛道的奖金设置如下：

🥇第一名: 1500 EUR
🥈第二名: 1000 EUR
🥉第三名: 500 EUR
我们为所有参加InterSystems挑战的人准备了奖品!
参考下图，了解我们的挑战细节：）你愿意参加吗？请在下面的投票中告诉我们！

REF: https://docs.intersystems.com/healthconnectlatest/csp/docbook/Doc.View.cls?KEY=GREST

REF: https://docs.intersystems.com/healthconnectlatest/csp/docbook/DocBook.UI.Page.cls?KEY=AFL_rest#AFL_C4838

开发REST服务有两个方式， 一个是生生的写代码， 定义接口的标准，被称为"Manually Coding"。第2个方式是目前越来越流行的"Sepcification-first"，也就是使用描述性的语言定义接口规范，然后通过这个规范生成接口代码。第2种方式更快捷，但这里我还是从第一种介绍起，对理解里面的代码层次更容易一些，而这是调试一个接口必须的。

从代码开发REST服务

不同于HTTP和SOAP, Ensemble里面没有REST的inbound Adaptor，也没有可用的BS组件。在Production里开发一个REST服务的步骤是：

1. 开发一个REST Service, 这个Service是一个CSP Page, 是一个网页服务，和Ensemble没关系。要在Production中使用这个服务，您需要在这个服务里调用一个Production的业务服务BS。

内容摘自英文社区，原文见这里。主要解答了如何对于JSON对象中的某个字段创建索引。

在解答中Robert Cemper给出了下面示例

主要思路是将%Stream --> %DynamicObject --> 提取索引字段内容保存到计算字段内

Property JSON As %Stream.GlobalCharacter;

Property FirstName As %String [ Calculated, SqlComputed , SqlComputeCode = { set {*}=.GetDyn({ID},"FirstName") } ];

Property LastName As %String [ Calculated, SqlComputed , SqlComputeCode = { set {*}=.GetDyn({ID},"LastName") } ];

Index fn on FirstName; Index ln on LastName;

ClassMethod GetDyn(ID As %Integer, item = "") As %String
{    
  set JSON=.%OpenId(ID).JSON    
  do JSON.

第七十八章 SQL命令 TUNE TABLE

基于代表性数据调优表。

大纲

TUNE TABLE tablename [ tune_options ]

参数

• tablename - 要调优的现有表的名称。 表名可以是限定的(schema.table)，也可以是非限定的(table)。 非限定表名接受默认模式名。
• tune_options - 可选—如果指定，一个或多个TUNE TABLE选项，以任意顺序指定，由空格分隔。 这些tune_options不区分大小写。

描述

TUNE TABLE命令根据表中当前的数据对现有表进行调优。 该数据应该代表表完全填充时所期望的数据。

TUNE TABLE根据代表性数据计算和设置表的块大小、选择性和范围大小。 通常，TUNE TABLE设置一个或多个这些值，并清除所有使用这个持久类(表)的缓存查询，以便查询将使用这些新值。 但是，如果TUNE TABLE没有更改这些值(例如，自上次对该表运行TUNE TABLE以来数据没有更改)，则缓存查询不会被清除，该表的类定义也不会被标记为需要重新编译。

TUNE TABLE更新SQL表定义(因此需要特权来更改表定义)。 通常，TUNE TABLE还会更新相应的持久类定义。 这允许查询优化器使用调优后的值，而不需要进行类编译。

第七十七章 SQL命令 TRUNCATE TABLE

从表中删除所有数据并重置计数器。

大纲

TRUNCATE TABLE [restriction] tablename

参数

• restriction - 可选—以下限制关键字中的一个或多个，用空格隔开:%NOCHECK， %NOLOCK。
• tablename - 要从中删除所有行的表。 还可以指定一个可更新视图，通过该视图可以删除表中的所有行。 表名(或视图名)可以是限定的(schema.table)或非限定的(table)。 使用模式搜索路径(如果提供的话)或默认模式名将非限定名称匹配到其模式。

描述

TRUNCATE TABLE命令从表中删除所有行，并重置所有表计数器。 可以直接截断表，也可以通过视图截断表。 通过视图截断表会受到删除要求和限制，如CREATE view中所述。

TRUNCATE TABLE重置用于生成RowID字段、IDENTITY字段和SERIAL (%Library.Counter)字段连续整数值的内部计数器。 IRIS为插入到TRUNCATE表后的表中的第一行中的这些字段赋值为1。 对表的所有行执行DELETE操作不会重置这些内部计数器。

TRUNCATE TABLE重置用于在数据插入到流字段时生成流字段OID值的内部计数器。 对表的所有行执行DELETE操作不会重置此内部计数器。

亲爱的开发者们，我们很高兴地跟大家分享一个好消息！

我们的社区全球注册会员突破10000名！中国开发者社区不到一年时间突破270人！增速全球第一！这是一个了不起的成就！感谢大家的支持🎊

在InterSystems，我们相信社区的力量。所以我们非常感谢你们在过去六年里所做的贡献，并期待未来的道路!

第七十六章 SQL命令 TOP

指定返回多少行的SELECT子句。

大纲

SELECT  [DISTINCT clause] 
  [TOP {[((]int[))] | ALL}]
  select-item{,select-item}

参数

• int - 限制返回到指定整数的行数。 int参数可以是一个正整数、一个动态SQL输入参数(?)或一个解析为正整数的嵌入式SQL主机变量(:var)。在动态SQL中，int值可以选择用单括号或双括号括起来(双括号是首选语法); 这些括号禁止在相应的缓存查询中对int值进行文字替换。
• ALL - TOP ALL仅在子查询或CREATE VIEW语句中有意义。 它用于在这些情况下支持使用ORDER BY子句，满足在子查询或CREATE VIEW中使用的查询中ORDER BY子句必须与TOP子句配对的要求。 TOP ALL不限制返回的行数。

描述

可选的TOP子句出现在SELECT关键字和可选的DISTINCT子句之后，以及第一个选择项之前。

TOP关键字用于动态SQL和基于指针的嵌入式SQL。 在非游标嵌入式SQL中，TOP关键字的唯一有意义的用法是TOP 0。 任何其他TOP int(其中int是任何非零整数)都是有效的，但没有意义，因为非游标嵌入式SQL中的SELECT总是最多返回一行数据。

第七十五章 SQL命令 START TRANSACTION

开始一个事务。

大纲

START TRANSACTION [%COMMITMODE commitmode]

START TRANSACTION [transactionmodes]

参数

• commitmode - 可选-指定在当前进程中如何向数据库提交将来的事务。 取值包括EXPLICIT、IMPLICIT和NONE。 默认是维护现有的提交模式; 进程的初始提交模式默认值是IMPLICIT。
• transactionmodes - 可选—指定事务的隔离模式和访问模式。 可以将隔离模式、访问模式或这两种模式的值指定为逗号分隔的列表。隔离模式的有效值为ISOLATION LEVEL READ COMMITTED, ISOLATION LEVEL READ UNCOMMITTED, ISOLATION LEVEL READ VERIFIED. 默认 ISOLATION LEVEL READ UNCOMMITTED.访问模式的有效值为“READ ONLY”和“READ WRITE”。 注意，只有隔离级别READ COMMITTED与读写模式READ WRITE兼容。

描述

START TRANSACTION语句启动一个事务。 START TRANSACTION立即启动一个事务，而不管当前的提交模式设置如何。

第七十四章 SQL命令 SET TRANSACTION

设置事务的参数。

大纲

SET TRANSACTION [%COMMITMODE commitmode]

SET TRANSACTION [transactionmodes]

参数

• %COMMITMODE commitmode - 可选-指定向数据库提交事务的方式。 取值包括EXPLICIT、IMPLICIT和NONE。 默认为IMPLICIT。
• transactionmodes - 可选—指定事务的隔离模式和访问模式。 可以将隔离模式、访问模式或这两种模式的值指定为逗号分隔的列表。隔离模式的有效值为ISOLATION LEVEL READ COMMITTED, ISOLATION LEVEL READ UNCOMMITTED, and ISOLATION LEVEL READ VERIFIED。 默认为“ISOLATION LEVEL READ UNCOMMITTED”。 访问模式的有效值为“READ ONLY”和“READ WRITE”。 注意，只有隔离级别READ COMMITTED与读写模式READ WRITE兼容。

描述

SET TRANSACTION语句为当前进程设置控制SQL事务的参数。 这些参数在下一个事务开始时生效，并在当前进程持续期间或直到显式重置为止。 它们不会在事务结束时自动重置为默认值。

Gartner Peer Insight 一直持续公开对各类第三方软硬件的对比，是IT行业的“大众点评“。综合转载如下，仅供参考。

原文链接：https://www.gartner.com/reviews/market/cloud-database-management-system…

Gartner Peer Insights 是Gartner 提供的由专业最终用户用来对企业级技术解决方案进行打分和评估供企业使用的平台。Gartner 会将用户意见和他们的专业意见综合起来形成魔力象限。

第七十三章 SQL命令 SET OPTION

设置执行选项。

大纲

SET OPTION option_keyword = value

描述

SET OPTION语句用于设置执行选项，如编译模式、SQL配置设置和控制日期、时间和数字约定的区域设置。 每个set option语句只能设置一个关键字选项。

SET OPTION支持以下选项:

• `AUTO_PARALLEL_THRESHOLD
• COMPILEMODE
• `DEFAULT_SCHEMA``
• EXACT_DISTINCT
• LOCK_ESCALATION_THRESHOLD
• LOCK_TIMEOUT
• PKEY_IS_IDKEY
• SUPPORT_DELIMITED_IDENTIFIERS
• Locale Options (date, time, and numeric conventions)

SET OPTION可以在动态SQL(包括SQL Shell)和嵌入式SQL中使用。

为了SQL兼容性，IRIS会解析其他SET OPTION参数(这里没有文档)，但不执行任何操作。

因为SET OPTION的准备和执行速度很快，而且通常只运行一次，所以IRIS不会在ODBC、JDBC或动态SQL中为SET OPTION创建缓存查询。

在本文中，我將演示以下內容：

• 使用自定義實用程序函數從數據庫更新 ReferencesRange(OBX:7) 針對 ObservationIdentifier(OBX:3.1)[TestCode]
• 根據數據庫實用程序函數中的 ObservationIdentifier(OBX:3.1)[TestCode] 和 ObservationValue(OBX:5)[Result] 更新異常標誌 (OBX:8)
• 基於異常標誌的路由消息 (OBX:8)

以下是主要和轉換後的 HL7 2.5 ORU_R01 消息：

第 1 步：首先，我們需要在數據庫中保存參考範圍，為此我使用了 TestRanges 持久類：

第 2 步：我們需要創建一個自定義函數來獲取引用範圍，為此我在實用程序類中創建了 GetReferenceRange() ClassMethod 函數。 請注意這個類應該是來自 EnsRule.FunctionSet 的擴展

 

我們需要創建另一個函數來設置異常標誌，為此我在實用程序類中創建了 SetAbnormalFlag() ClassMethod 函數

第 3 步：現在我們將在數據轉換 (UpdateReferenceRangesDTL) 中使用這些函數。

亲爱的社区开发者们，大家好！

欢迎积极参与新一轮InterSystems开发者竞赛！

🏆 InterSystems开发者竞赛：安全 🏆

竞赛时间: 2021年11月15日-12月5日

奖金总额: $9,450!

分析

• 学习路径: 使用自适应分析建立数据模型
• 学习路径: 使用IRIS 商业智能BI建立数据模型
• 学习路径: 用InterSystems IRIS BI分析器BI Analyzer构建模型

其他

• 资源指南: 迁移资源指南
• 视频: 用交互式方式将应用从Cache迁移IRIS 演示Demo
• 学习路径: 实施合作伙伴起步 (金融行业) 和 所有行业
• 视频: 在Docker里运行InterSystems IRIS 社区版
• 视频: 开发和部署InterSystems Containers容器的工具

开发

• 视频: 什么是嵌入式 Embedded Python?
• 视频: 为多个ObjectScript 连接配置vs代码实现工作空间 Workspaces
• 视频: 在VS Code中用Objectscript 类进行客户端编辑
• 视频: 在InterSystems IRIS for Health 中将历史数据转化为HL7 FHIR R4 

服务

• 视频与练习: HealthShare 信息转化服务演示Demo与练习 exercise (S3 和 HealthLake 版本)

系统管理

• 课程 (更新): InterSystems 安全基础 (原Caché 安全概览)
• 视频: 配置 InterSystems Web Gateway 网关

“过敏”是生活中常见的病理表现，大众所熟知的荨麻疹、过敏性鼻炎、花粉症等都是常见的过敏性疾病。“过敏”在医学上归类为变态反应，是机体对外界有害物质（过敏原）的免疫应答，通常发挥保护作用。当变态反应过于激烈，以至于正常身体组织连同被攻击和损害时，则会对健康造成不利。本文将针对临床最为关心的医学信息系统如何支持“药物过敏”的识别、记录和管理进行探讨。

1. 详尽记录

因为变态反应的发生既取决于外因（过敏原），也取决于内因（遗传和基因缺陷），这就导致了不同的人暴露于不同的环境和接触不同的物质时，是否发生过敏反应以及过敏反应的表现和程度存在很大差异。及时、准确、详尽的过敏记录，可以为医务人员提供一手材料，从源头上遏制与“可避免的”药物过敏相关的医疗事件发生。

几乎所有医学信息系统都具备过敏记录功能，但部分系统仅提供自由文本录入。这种方式虽然给予医务人员极大的自由度，用自然的文字描述过敏相关信息，更贴合语言习惯；却带来了过敏信息难以复用、难以触发诊疗决策支持功能等弊端。

本文推荐结构化过敏记录（图1），将所有过敏原根据临床标准在系统中预先设置，医务人员必须从预设选项中进行选择，包括过敏的临床表现和严重程度等主要信息，均需以编码和描述的形式存在，以便复用和统计。当然，页面要保留自由文本字段，医务人员可以详尽记录与当前过敏相关的次要信息，也为其他需要查阅此患者病例的医务人员提供更多背景情况。

第七十二章 SQL命令 SELECT（四）

WHERE子句

WHERE子句限定或取消查询选择中的特定行。 符合条件的行是那些条件表达式为真的行。 条件表达式是逻辑测试(谓词)的列表，可以通过AND和OR逻辑操作符链接这些测试(谓词)。 这些谓词可以使用NOT一元逻辑操作符进行反转。

SQL谓词可分为以下几类:

• Comparison 谓词
• BETWEEN 谓词
• LIKE 谓词
• NULL 谓词
• IN and %INLIST 谓词
• EXISTS 谓词
• FOR SOME 谓词
• FOR SOME %ELEMENT 谓词

条件表达式不能包含聚合函数。 如果希望使用聚合函数返回的值指定选择条件，请使用HAVING子句。

WHERE子句可以使用=(内部连接)符号连接操作符指定两个表之间的显式连接。

WHERE子句可以使用箭头语法(- >)操作符在基表和来自另一个表的字段之间指定隐式连接。

GROUP BY子句

GROUP BY子句接受查询的结果行，并根据一个或多个数据库列将它们分成单独的组。 当将SELECT与GROUP BY结合使用时，将为GROUP BY字段的每个不同值检索一行。 GROUP BY子句在概念上类似于 IRIS扩展%FOREACH，但是GROUP BY操作整个查询，而%FOREACH允许在子填充上选择聚合，而不限制整个查询填充。

最近应用到加密技术，看到平台具有内置的%SYSTEM.Encryption 有具有一些内置的函数，但是，应用过程中碰到加密AES/ECB/PKCS5Padding，我们应该如何处理？不知道有没有好的解决方式？

照顾好我们的客户并打造伟大的产品。这是我们InterSystems自从1978年成立以来的座右铭。40多年很快过去，这始终驱动着我们前进。过去是，未来也将一直是我们的基因。

追求卓越和持续提升的价值观是我们的“客户至上”方法取得成功的关键。这也是过去三年我们一直积极参与Gartner及其Peer Insights项目的原因，该项目主要征求最终用户的反馈意见和对厂商的打分。InterSystems连续两年荣膺Peer Insights运营数据库管理系统（ODBMS）客户选择奖，而且是该类别评分最高的供应商之一。

此外，InterSystems还入选Gartner目前推出的Gartner“客户至上”计划，并获得相应标识（上图），这一计划认可了我们为客户提供的坦诚分享、公正反馈的环境，根据用户反馈，我们不断改善产品和服务，从而最大程度地满足不断变化的客户需求。简言之，我们没有人为影响客户在Gartner网站上对我们的评价。这体现了我们对客户的承诺以及开放沟通渠道的重要性。InterSystems IRIS®数据平台是Gartner最新的云数据库管理系统魔力象限（Cloud Database Management Systems Magic Quadrant）中唯一获得此标识的产品，我们对此深感自豪。

第七十一章 SQL命令 SELECT（三）

列别名

指定SELECT-ITEM时，可以使用AS关键字指定列名的别名：

SELECT Name AS PersonName, DOB AS BirthDate, ...

列别名在结果集中显示为列标题。指定列别名是可选的；始终提供默认值。列别名以指定的字母大小写显示；但是，当在ORDER BY子句中引用时，它不区分大小写。C别名必须是有效的标识符。C别名可以是分隔的标识符。使用带分隔符的标识符允许列别名包含空格、其他标点符号或作为SQL保留名称。例如，SELECT Name AS "Customer Name" or SELECT Home_State AS "From"。

As关键字不是必需的，但使查询文本更易于阅读。因此，以下也是有效的语法：

SELECT Name PersonName, DOB BirthDate, ...

SQL不执行列别名的惟一性检查。 字段列和列别名可能具有相同的名称(尽管不可取)，或者两个列别名相同。 当ORDER by子句引用此类非惟一列别名时，可能会导致SQLCODE -24“Ambiguous sort column”错误。 列别名与所有SQL标识符一样，不区分大小写。

其他SELECT子句中列别名的使用由查询语义处理顺序控制。 可以通过ORDER by

https://www.appeon.com/products/powerbuilder

Appeon PowerBuilder 是一个企业级开发工具，可以用来建立数据驱动的商业应用程序和组件。它是Appeon产品套件之一，同时提供了开发C/S、Web、移动和分布式应用程序的工具。

在这篇文章中，我将展示通过使用ODBC用Appeon PowerBuilder连接Caché的步骤。

步骤1 :
确保在安装IRIS时选择ODBC驱动程序选项。

步骤2:
通过使用ODBC数据源管理器配置ODBC IRIS数据源 

步骤 3: 配置InterSystems ODBC 数据源

步骤 4: 测试连接 (确保 IRIS 实例在运行)

步骤 5: 
从 PowerBuilder 打开数据库Profiles, 在列表选中ODB ODBC并单击“新建 New”... 按钮

 

步骤 6: 
选择我们已经用ODBC管理器创建的 "IRISHealth User"数据源

步骤 7: 点击“测试连接Test Connection” 按钮，在Preview页面下测试连接

恭喜! 我们已经成功建立了IRIS链接。现在我们可以用PowerBuilder database painter来看表和数据了

谢谢

第七十章 SQL命令 SELECT（二）

select-item

这是所有SELECT语句的必选元素。 通常，选择项指的是FROM子句中指定的表中的一个字段。 选择项由下列一个或多个项组成，多个项之间用逗号分隔:

• 列名(字段名)，带或不带表名别名:

SELECT Name,Age FROM Sample.Person

字段名不区分大小写。 但是，结果集中与字段关联的标签使用表定义中指定的SqlFieldName的字母大小写，而不是选择项中指定的字母大小写。

包含一个或多个下划线的字段名引用嵌入的串行对象属性。 例如，对于字段名Home_City，表包含一个引用字段Home，该字段引用定义属性City的嵌入式串行对象。 对于字段名Home_Phone_AreaCode，该表包含一个引用字段Home，该字段引用嵌入式串行对象属性Phone，该属性引用定义AreaCode属性的嵌套嵌入式串行对象。 如果选择一个引用字段，如Home或Home_Phone，则以%List数据类型格式接收串行对象中所有属性的值。

要显示RowID(记录ID)，可以使用%ID伪字段变量别名，该别名显示RowID，而不管它被分配的名称是什么。 默认情况下，RowID的名称是ID，但如果存在用户定义的名为ID的字段， IRIS可能会重命名它。 默认情况下，RowID是一个隐藏字段。

快速了解InterSystems客户服务理念，以及InterSystems TrakCare、HealthShare、IRIS数据平台的最新产品动态！

InterSystems 2021全球线上峰会精彩内容梳理：两个重磅论坛集中探讨Analytics（分析）的奥义，InterSystems数据平台与医疗行业的愿景分享！

第六十九章 SQL命令 SELECT（一）

从数据库中的一个或多个表中检索行。

大纲

[(] SELECT [%keyword]
    [DISTINCT [BY (item {,item2})] | ALL] 
    [TOP {int | ALL}]
    select-item {,select-item, .}
    [INTO host-variable-list]
    [FROM [optimize-option] table-ref [[AS] t-alias]
      {,table-ref [[AS] t-alias]} ]
    [WHERE condition-expression [{AND | OR condition-expression] ]
    [GROUP BY scalar-expression]
    [HAVING condition-expression [{AND | OR condition-expression] ]
    [ORDER BY item-order-list [ASC | DESC] ]
[)]

select-item ::= 
  [t-alias.

第六十八章 SQL命令 SAVEPOINT

在事务中标记一个点。

大纲

SAVEPOINT pointname

参数

• pointname - 保存点的名称，指定为标识符。

描述

SAVEPOINT语句标记事务中的一个点。建立保存点使能够执行事务回滚到保存点，撤消在此期间完成的所有工作并释放在此期间获得的所有锁。在长期运行的事务或具有内部控制结构的事务中，通常希望能够回滚事务的一部分，而不撤消在事务期间提交的所有工作。

保存点的建立会递增$TLEVEL事务级别计数器。回滚到保存点会将$TLEVEL事务级别计数器递减到紧接在保存点之前的值。可以在一个事务内建立最多255个保存点。超过这个保存点数量会导致SQLCODE-400致命错误，这是在SQL执行期间捕获的 异常。终端提示符将当前事务级别显示为提示符的TLn：前缀，其中n是介于1和255之间的整数，表示当前$TLEVEL计数。

每个保存点都与一个保存点名称相关联，这是一个唯一的标识符。保存点名称不区分大小写。保存点名称可以是分隔的标识符。

• 如果指定的保存点没有点名，或者指定的点名不是有效的标识符或SQL保留字，则会发出运行时SQLCODE-301错误。
• 如果指定点名称以“SYS”开头的保存点，则会发出运行时SQLCODE-302错误。这些保存点名称是保留的。

第六十七章 SQL命令 ROLLBACK

回滚事务。

大纲

ROLLBACK [WORK]

ROLLBACK TO SAVEPOINT pointname

参数

• pointname - 作为标识符指定的现有保存点的名称。

描述

ROLLBACK语句将回滚事务，撤消已执行但未提交的工作，减少$TLEVEL事务级别计数器，并释放锁。 ROLLBACK用于将数据库恢复到以前的一致状态。

• ROLLBACK回滚当前事务期间完成的所有工作，将$TLEVEL事务级别计数器重置为0，并释放所有锁。 这会将数据库恢复到事务开始之前的状态。 ROLLBACK和ROLLBACK WORK是等价的语句; 这两个版本都支持兼容性。
• ROLLBACK TO SAVEPOINT pointname将回滚自指定保存点以来已完成的所有工作，并按未完成的保存点的数量递减$TLEVEL事务级别计数器。 当所有保存点都被回滚或提交，并且事务级别计数器重置为零时，事务就完成了。 如果指定的保存点不存在，或者已经回滚，ROLLBACK将发出SQLCODE -375错误并回滚整个当前事务。

回滚到SAVEPOINT必须指定一个点名。 如果不这样做，将导致SQLCODE -301错误。

如果事务操作未能成功完成，则会发出SQLCODE -400错误。

不回滚

ROLLBACK操作不影响以下项目:

• 回滚不会减少默认类的IDKey计数器。