第四十章 SQL函数 DATALENGTH

返回表达式中字符数的函数。

大纲

DATALENGTH(expression)

参数

• expression - 表达式，可以是列的名称、字符串字面值或另一个标量函数的结果。
  基础数据类型可以是字符类型(如CHAR或VARCHAR)、数字或数据流。

DATALENGTH返回INTEGER数据类型。

描述

注意:DATALENGTH、CHAR_LENGTH和CHARACTER_LENGTH函数是相同的。
对于新代码，建议使用CHAR_LENGTH函数。
DATALENGTH是为TSQL兼容性而提供的。

第五十章 SQL命令 HAVING（一）

对一组数据值指定一个或多个限制性条件的SELECT子句。

大纲

SELECT field
FROM table
GROUP BY field
HAVING condition-expression

SELECT aggregatefunc(field %AFTERHAVING)
FROM table
[GROUP BY field]
HAVING condition-expression

参数

• condition-expression - 由一个或多个布尔谓词组成的表达式，用于控制要检索哪些数据值。

描述

可选的HAVING子句出现在FROM子句、可选的WHERE和GROUP BY子句之后，可选的ORDER BY子句之前。

第二十二章 参考 - HL7业务服务的设置

提供HL7业务服务设置的参考信息。

HL7最重要的设置如下:
- 池大小-默认值为1，可以支持FIFO(先进先出)处理。在许多情况下，必须按顺序接收多个患者的人口统计更新。例如，许多应用程序在处理订单消息之前需要接收ADT注册消息，在收到结果消息之前必须接收订单消息，等等。
- 类别—此文本标签允许在配置图中对配置项进行排序。
- 追加时间戳-(仅限文件)在存档路径中的文件名追加时间戳。
- 归档路径-(仅限文件和FTP)指定HL7消息归档的位置。
- 呼叫间隔-在寻找更多输入之前等待的秒数。缺省值是5秒。最小值是0.1秒。

Ack Mode

帮助建立发布 HL7 确认消息以响应收到的 HL7 消息的格式和约定。对于业务服务，此设置可以具有下表中显示的值之一。

第四十九章 开发Productions - ObjectScript Productions - 使用复杂记录映射器 - 复杂的记录映射类结构

复杂的记录映射类结构

有两个类以类似于描述记录映射的两个类的方式描述复杂的记录映射。描述复杂记录映射的两个类是：

• 复杂记录映射，描述复杂记录的外部结构并实现复杂记录解析器和编写器。
• 生成的复杂记录类定义了包含数据的对象的结构。该对象允许在数据转换和路由规则条件中引用数据。

一个复杂的记录映射业务服务读取并解析传入的数据并创建一条消息，该消息是生成的记录类的一个实例。业务流程可以读取、修改或生成生成的复杂记录类的实例。最后，复杂记录映射业务操作使用实例中的数据，使用复杂记录映射作为格式化模板写入输出数据。复杂记录映射类和生成的复杂记录类都具有描述数据的层次结构。复杂记录映射类和生成的复杂记录类具有并行结构。这与 RecordMap 类不同，其中生成的记录类可以具有不同的层次结构。

第六十一章 开发Productions - ObjectScript Productions - 部署Production

部署Production

通常，在开发系统上开发Production，然后在测试部署上完成并测试生产后，将其部署在实时生产系统上。本页介绍如何使用管理门户打包开发系统中的部署，然后将其部署到另一个系统上。它还描述了如何开发和测试对生产的更改，然后将这些更新部署到使用实时业务数据运行的系统。

[toc]

第二十八章 管理许可（一）

配置许可

每个 IRIS 实例维护其许可证容量和当前使用的独立本地视图，并且每个实例都需要访问许可证密钥。可以在每个实例上安装和激活本地许可证密钥文件。或者，如果要管理多个实例，可以配置许可证服务器来管理存储在中央位置的密钥文件，然后它可以将其分发到其他实例。在这种情况下，必须为每个实例配置密钥文件的 LicenseID，以便它可以在启动时检索密钥的副本。

多服务器许可证可以在同一台机器或不同机器上的协作实例之间共享。仅允许使用多服务器密钥进行共享。要使用多服务器许可，必须配置一个或多个 IRIS 许可服务器来分配密钥授权的 IRIS 许可单元。共享密钥的所有实例都必须配置为使用相同的许可证服务器或一组许可证服务器。许可服务器可以在运行 IRIS 实例的任何计算机上运行。监控进程向许可服务器发送更新消息，当多个实例共享一个许可时，许可服务器协调许可分配。

第五十八章 SQL函数 FLOOR

数值函数，返回小于或等于给定数值表达式的最大整数。

大纲

FLOOR(numeric-expression)

{fn FLOOR(numeric-expression)}

参数

• numeric-expression - 下限要计算的数字。

FLOOR返回与NUMERIC-EXPRESSION相同的数据类型。

描述

FLOOR返回小于或等于NUMERIC-EXPRESSION的最接近的整数值。返回值的小数位数为0。当numeric-expression为空值、空字符串(‘’)或非数字字符串时，FLOOR返回NULL。

请注意，Floor可以作为ODBC标量函数(使用花括号语法)调用，也可以作为SQL常规函数调用。

第三十七章 SQL命令 DROP ROLE

删除角色

大纲

DROP ROLE role-name

参数

• role-name - 要删除的角色的名称。名称是一个标识符。角色名称不区分大小写。

描述

DROP ROLE语句删除角色。删除角色时， IRIS会将其从已授予该角色的所有用户和角色中撤消，并将其从数据库中删除。

可以通过调用$SYSTEM.SQL.Security.RoleExists()方法来确定角色是否存在。如果尝试删除不存在(或已被删除)的角色，则DROP ROLE将发出SQLCODE-118错误。

第九十三章 属性关键字 - Aliases

指定此属性的其他名称，以便通过对象访问使用。

用法

要为属性指定其他名称，请使用以下语法:

Property name As classname [ Aliases=othernames ]; 

其中othernames是用逗号分隔的有效属性名列表，用大括号括起来。

详解

如果指定别名关键字，编译器会创建一个或多个给定的别名，这些别名指向原始属性所指向的同一基础数据。例如，重新定义Sample.Person的Name属性，如下所示：

Property Name As %String(POPSPEC = "Name()") [ Aliases = {Alternate}, Required ];

然后，代码可以使用Name属性或等效的Alternate属性，如以下终端会话所示：

第六十八章 SQL命令 SAVEPOINT

在事务中标记一个点。

大纲

SAVEPOINT pointname

参数

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

描述

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

第二章 使用 /api/mgmnt/ 服务

本章介绍如何使用 /api/mgmnt 服务来创建、更新和删除 REST 服务。

/api/mgmnt 服务还提供了可用于发现和记录 Web 服务的选项，如本书后面所述。

使用 /api/mgmnt 服务创建 REST 服务

创建 REST 服务的推荐方法是为 REST 服务创建 OpenAPI 2.0（也称为 Swagger）描述，并使用它来生成 REST 服务类。如果您正在实现由第三方定义的 REST 服务，他们可能会提供此 OpenAPI 2.0 描述。有关 OpenAPI 2.0 描述格式的详细信息，请参阅 OpenAPI 2.0 规范。以下主题描述了如何使用 /api/mgmnt 服务来执行此操作。

第四十八章 管理镜像 - 将备份降级为 DR 异步

除了将 DR 异步提升为故障转移成员外，还可以执行相反的操作 — 将不是当前主要成员的故障转移成员降级为 DR 异步，这样镜像就只剩下一个故障转移镜像。当不希望故障转移成员响应镜像配置中的临时更改时，这在计划中断情况下很有用。例如：

针对InterSystems开发者社区的分析。使用InterSystems IRIS BI (DeepSee)、Power BI和Logi Report Designer制作的项目，可视化并分析InterSystems 开发者社区上的成员、文章、问题、答案、观点和其他内容和活动。

你可以看到自己的活动、文章和问题。跟踪你的贡献如何改变开发者社区。

使用IRIS BI、Adaptive Analytics、InterSystems Reports、Tableau和Power BI分析关于你和你朋友的统计数据。

该项目包含预配置的IRIS和Atscale在Docker容器中的部署以及BI系统的项目文件。

更多细节信息请见相应应用的README。

[toc]

第三十一章 管理许可（四）

显示本地许可证信息的方法

下面列出的子例程转储实例共享内存中本地包含的许可证表的内容。一般来说，他们识别客户：

$System.License.DumpLocalAll 将所有本地许可证表条目转储到当前目录中的 all.dmp 文件中：

USER> Do $System.License.DumpLocalAll()

25 条目转储到 c:\intersystems\irishealth\mgr\user\all.dmp

all.dmp 文件的内容示例：

$System.License.DumpLocalInUse 将所有正在使用的本地许可证表条目转储到当前目录中的 inuse.dmp 文件：