第八十一章 SQL命令 UNLOCK

解锁表

大纲

UNLOCK [TABLE] tablename IN EXCLUSIVE MODE [IMMEDIATE]

UNLOCK [TABLE] tablename IN SHARE MODE [IMMEDIATE]

参数

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

描述

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

和是同义词。

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

权限

该命令为特权操作。 在使用之前，进程必须对指定的表拥有权限。 在使用之前，进程必须对指定的表具有、或权限。 对于或特权必须在表的至少一个字段上。 未能持有足够的特权将导致错误(特权违反)。 可以通过调用

第八十章 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的每一边都作为单独的进程并行运行。
• - 从数据库中检索数据的语句。
• query - 组合一个或多个SELECT语句的查询。

描述

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

为了在语句之间实现联合，每个分支中指定的列数必须匹配。 指定具有不同列数的将导致SQLCODE -9错误。 可以指定一个中的列与另一个中的数据列配对，以匹配列的数量。 例如:

SQL通过自动计算

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

我们欢迎您来参加 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.Rewind()    
  set st=JSON.Read(3000000)    
  set dyno={}.%FromJSON(st)    
  set rep=$Property(dyno,item)    
  quit rep
}

第七十八章 SQL命令 TUNE TABLE

基于代表性数据调优表。

大纲

TUNE TABLE tablename [ tune_options ]

参数

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

描述

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

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

更新SQL表定义(因此需要特权来更改表定义)。 通常，还会更新相应的持久类定义。 这允许查询优化器使用调优后的值，而不需要进行类编译。 但是，如果部署了类，那么TUNE TABLE只更新SQL表定义; 查询优化器间接使用表定义中的调优值。

如果成功，它将设置为0

第七十七章 SQL命令 TRUNCATE TABLE

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

大纲

TRUNCATE TABLE [restriction] tablename

参数

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

描述

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

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

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

总是将本地变量设置为; 它没有将设置为删除的行数。

不会重置计数器。

TRUNCATE TABLE禁止提取基表触发器，否则在处理期间提取基表触发器。 因为执行的是带有行为的删除，用户必须被授予权限(使用

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

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

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

第七十六章 SQL命令 TOP

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

大纲

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

参数

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

描述

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

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

语句的子句将返回的行数限制为int中指定的行数。 如果没有指定子句，则默认显示满足条件的所有行。 如果指定了子句，则显示的行数或行数要么为

第七十五章 SQL命令 START TRANSACTION

开始一个事务。

大纲

START TRANSACTION [%COMMITMODE commitmode]

START TRANSACTION [transactionmodes]

参数

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

描述

START TRANSACTION语句启动一个事务。 立即启动一个事务，而不管当前的提交模式设置如何。 无论当前的提交模式设置如何，以开始的事务必须通过发出显式或来结束。

是可选的。

• 如果流程只查询数据(语句)，可以使用来建立隔离级别。 不需要。
• 如果进程正在修改数据，那么是否需要通过发出来显式地开始事务，这取决于进程的当前提交模式设置(也称为AutoCommit设置)。 如果当前进程的提交模式是隐式的或显式的，则发出是可选的。 如果忽略，则在调用修改数据操作(、或

第七十四章 SQL命令 SET TRANSACTION

设置事务的参数。

大纲

SET TRANSACTION [%COMMITMODE commitmode]

SET TRANSACTION [transactionmodes]

参数

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

描述

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

单个语句可用于设置提交模式参数或事务模式参数，但不能同时设置两者。

可以使用命令设置相同的参数，该命令既可以设置参数，也可以开始一个新事务。 也可以使用方法调用设置参数。

SET TRANSACTION不会开始一个事务，因此不会增加事务级别计数器。

SET TRANSACTION可以在动态SQL(包括)和嵌入式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配置设置和控制日期、时间和数字约定的区域设置。 每个语句只能设置一个关键字选项。

支持以下选项:

• `AUTO_PARALLEL_THRESHOLD
• COMPILEMODE
• `DEFAULT_SCHEMA``
• EXACT_DISTINCT
• LOCK_ESCALATION_THRESHOLD

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

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

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

IRIS支持下列选项:

选项被设置为一个整数n，用于确定当启用自动并行处理时是否应该对查询应用并行处理。 由于与并行处理相关的性能成本，因此需要为并行处理的优势确定一个阈值。 越高，SQL查询使用并行处理执行的可能性就越低。 默认为。 这是一个系统范围的设置。 值n大致对应于所访问的映射中发生并行处理所需的最小元组数量。

当自动并行被禁用时，选项没有作用。

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

• 使用自定義實用程序函數從數據庫更新 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逻辑操作符链接这些测试(谓词)。 这些谓词可以使用一元逻辑操作符进行反转。

SQL谓词可分为以下几类:

• Comparison 谓词
• BETWEEN 谓词
• LIKE 谓词
• 谓词
• 谓词
• EXISTS 谓词
• 谓词
• 谓词

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

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

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

GROUP BY子句

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

这个查询为每个不同的返回一行。

HAVING 子句

子句类似于对组进行操作的WHERE子句。 它通常与子句或关键字一起使用。 子句限定或取消查询选择中的特定行。 符合条件的行是那些条件表达式为真的行。

最近应用到加密技术，看到平台具有内置的%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别名可以是分隔的标识符。使用带分隔符的标识符允许列别名包含空格、其他标点符号或作为保留名称。例如，。

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

SELECT Name PersonName, DOB BirthDate, ...

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

其他SELECT子句中列别名的使用由查询语义处理顺序控制。 可以通过子句中的列别名引用列。 不能在选择列表中的另一个选择项、子句、子句、子句或子句中引用列别名。 不能在操作的子句或子句中引用列别名。 但是，可以使用子查询使列别名可用来供其他这些其他子句使用。

字段列别名

选择项字段名不区分大小写。

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，该字段引用定义属性的嵌入式串行对象。 对于字段名，该表包含一个引用字段，该字段引用嵌入式串行对象属性，该属性引用定义属性的嵌套嵌入式串行对象。 如果选择一个引用字段，如或，则以数据类型格式接收串行对象中所有属性的值。

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

字段上的返回打开的对象的(对象引用):

SELECT Name,Picture FROM Sample.Employee WHERE Picture IS NOT NULL

当

快速了解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.]*   |
  [t-alias.]scalar-expression [[AS] c-alias]

第六十八章 SQL命令 SAVEPOINT

在事务中标记一个点。

大纲

SAVEPOINT pointname

参数

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

描述

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

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

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

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

保存点名称不区分大小写；因此resetpt,和是相同的点名。

第六十七章 SQL命令 ROLLBACK

回滚事务。

大纲

ROLLBACK [WORK]

ROLLBACK TO SAVEPOINT pointname

参数

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

描述

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

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

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

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

不回滚

操作不影响以下项目:

• 回滚不会减少默认类的计数器。 是由$INCREMENT(或)自动生成的，它维护一个独立于事务的计数。
• 回滚不会逆转缓存查询的创建、修改或清除。 这些操作不被视为事务的一部分。
• 在事务中发生的操作或调优表操作可以创建并运行临时例程。