第四十九章 Caché 变量大全 ^$ROUTINE 变量

提供例程信息。

大纲

^$|nspace|ROUTINE(routine_name)
^$|nspace|R(routine_name)

参数

• |nspace|或[nspace] 可选-扩展SSVN引用，可以是显式名称空间名称，也可以是隐含名称空间。必须计算为带引号的字符串，该字符串括在方括号([“nspace”])或竖线(|“nspace”|)中。命名空间名称不区分大小写；它们以大写字母存储和显示。
• routine_name 计算结果为包含例程名称的字符串的表达式。

描述

可以将^$ROUTINE结构化系统变量用作$DATA、$ORDER和$QUERY函数的参数，以从当前命名空间(默认)或指定命名空间返回例程信息。^$ROUTINE返回有关例程的OBJ代码版本的例程信息。

在InterSystems ObjectScript中，一个例程有三个代码版本：MAC(用户编写的代码，可能包括宏预处理器语句)、INT(编译的MAC代码，用于执行宏预处理)和OBJ(可执行目标代码)。可以使用^$ROUTINE global返回关于int代码版本的信息。可以使用^$ROUTINE返回有关OBJ代码版本的信息。

参数

nspace

此可选参数允许使用扩展SSVN引用在另一个命名空间中指定全局。

第四章 标识符

标识符

标识符是SQL实体的名称，例如表、视图、列(字段)、模式、表别名、列别名、索引、存储过程、触发器或其他SQL实体。 标识符名称在其上下文中必须是唯一的; 例如，同一模式中的两个表或同一表中的两个字段不能具有相同的名称。 但是，不同模式中的两个表或不同表中的两个字段可以具有相同的名称。 在大多数情况下，相同的标识符名称可以用于不同类型的SQL实体; 例如，一个模式、该模式中的表以及该表中的字段都可以具有相同的名称，而不会产生冲突。 但是，同一个模式中的表和视图不能具有相同的名称。

InterSystems IRIS®数据平台SQL标识符遵循一组命名约定，根据标识符的使用，这可能会受到进一步的限制。 标识符不区分大小写。

标识符可以是简单标识符，也可以是分隔符。 InterSystems SQL默认支持简单标识符和分隔标识符。

简单标识符

简单标识符有以下语法:

simple-identifier ::= identifier-start { identifier-part }
      identifier-start ::= letter | % | _ 
      identifier-part ::=  letter | number | _ | @ | # | $

命名约定

标识符start是SQL标识符的第一个字符。 它必须是下列之一:

• 大写或小写字母。

上一篇： IRIS中的权限管理

在上一篇文章中，我们介绍了IRIS中的权限控制体系。在本文中我们将以一个常见的实施需求为例介绍如何使用IRIS的权限配置出一个只能使用SQL的用户。

需求的分解

和所有用户需求一样，当用户提出一个需求时，除其语义显式的含义之外，还需分析其是否具有没有明确说明的含义。 对于一个只能使用SQL的用户这样一个需求，即应当结合平台的特征分解成为功能需求： 具有一个合法，可通过用户名和密码使用IRIS的用户 该用户的数据库权限

• 确认项：可以使用SQL访问所有数据库还是某几个特定的数据库？ 该用户的SQL权限
• 确认项：对于特定的数据库，是否可以执行所有的DDL？
• 确认项：对于特定的数据库，是否对每一张表都可以执行Select、Update等所有的DML 该用户的程序权限
• 确认项：用户是否可以通过Portal登录并管理IRIS？

如上所示，一个只能使用SQL的用户，这样一个看似简单的需求，如果需要与用户获得一致的理解并付诸实施，则需要将其分解，对于没有在用户需求中明确约定的部分，应作为待确认项与用户确认。 另外，需要注意的是，IRIS作为一个数据平台，除了提供底层的数据库之外，也提供了Portal等Web应用程序便于使用Sharding、HA、Interoperability等平台功能，通过平台对外提供的Webservice、REST等web接口也受Web应用程序控制。

本周进入 InterSystems 编程大奖赛 的投票时间！ 此次中国有多位参赛者，我们将其项目罗列在此，欢迎投票！

大家好!

InterSystems IRIS开发者们，我们有一个好消息要跟大家分享! 我们很高兴能够邀请大家参加我们今年的年度大奖赛，利用InterSystems IRIS数据平台创建开源解决方案！

🏆 InterSystems编程大奖赛🏆

时间: 2021年2月8日 - 3月8日

奖金总额: $16,000 

这是我们团队参加的第一届InterStstems编程竞赛！ 快来看看投票给我们！

超额预订管理系统结合了酒店业的独特条件，例如房价，订购渠道，客户需求等。 本系统使用机器学习算法（例如：KNN / ES-RNN ...）来准确预测酒店的每日未入住和入住率，并进一步与收益结合以找到最佳的最大客房销售量，从而精准增加酒店的边际收益。

移步欣赏作品点击如下连接

https://github.com/BroadCastAir/hotel_api    &      https://github.com/BroadCastAir/Hotel_OverBooking_Sys

投票给我们点击：  Check the related application on InterSystems Open Exchange

在InterSystems IRIS中使用ObjectScript构建REST API。

开发的API可以遵循OPEN API规范，可以使用Docker和VSCode开发，可以部署为ZPM模块，同时也可用作酒店超售系统的Data API。

什么是酒店超售管理系统？

超售管理系统结合了酒店的独特条件，例如房价，订购渠道，客户需求等。系统使用机器学习算法（例如：KNN / ES-RNN ...）来准确预测酒店的每日未入住和入住率，并进一步与收益方程式结合以找到最佳的最大客房销售量，从而可以大大增加酒店的边际收益。

来看看我们的Repo！

https://github.com/BroadCastAir/hotel_api

和

https://github.com/BroadCastAir/Hotel_OverBooking_Sys

投票支持我们的应用程序！

InterSystems IRIS不仅在医疗保健行业，在零售和酒店业中也具有广阔的发展前景。

第二章 InterSystems SQL基础

本章概述了InterSystems SQL的特性，特别是那些SQL标准未涵盖的特性，或者与InterSystems IRIS®数据平台统一数据架构相关的特性。 本教程假定读者具备SQL知识，并不是为介绍SQL概念或语法而设计的。

本章讨论以下主题:

• 表
• 查询
• 权限
• 数据显示选项
• 数据排序类型
• 执行SQL

表

在InterSystems SQL中，数据显示在表中。每个表都包含许多列。一个表可以包含零个或多个数据值行。以下术语大体上等效：

表有两种基本类型：基表（包含数据，通常简称为表）和视图（基于一个或多个表提供逻辑视图）。

模式与架构

SQL模式提供了一种将相关表，视图，存储过程和缓存查询的集合进行分组的方法。模式的使用有助于防止表级别的命名冲突，因为表，视图或存储过程的名称在其模式内必须唯一。应用程序可以在多个架构中指定表。

SQL模式与持久性类包相对应。通常，模式与其相应的程序包具有相同的名称，但是由于不同的模式命名约定或故意指定了不同的名称，因此这些名称可能有所不同。模式到程序包的映射在SQL到类名的转换中有进一步描述。

亲爱的社区开发者们：

本周进入 InterSystems 编程大奖赛 的投票时间！ 来为你心目中基于InterSystems IRIS而构建的最佳方案投票吧！

🔥 点击投票 投票入口 🔥

如何投票？有哪些最新信息值得了解一下?

第三章 SQL语言元素（一）

命令和关键字

InterSystems SQL命令（也称为SQL语句）以关键字开头，后跟一个或多个参数。其中一些参数可能是子句或函数，由它们自己的关键字标识。

• InterSystems SQL命令没有命令终止符，除非在特殊情况下（例如SQL过程代码或触发代码），在这种情况下，SQL命令以单个分号（;）终止。否则，InterSystems SQL命令不需要或接受分号命令终止符。在InterSystems SQL中指定分号命令终止符会导致SQLCODE -25错误。 TSQL的InterSystemsIRIS®数据平台实现（Transact-SQL）接受但不需要分号命令终止符。在将SQL代码导入Inter Systems SQL时，会去除分号命令终止符。
• InterSystems SQL命令没有空格限制。如果命令项之间用空格隔开，则至少需要一个空格。 如果命令项之间用逗号分隔，则不需要空格。算术运算符之前或之后不需要空格。可以在以空格分隔的项目之间，以逗号分隔的参数列表中的项目之间或在算术运算符之前或之后插入换行符或多个空格。

InterSystems SQL关键字包括命令名称，函数名称，谓词条件名称，数据类型名称，字段约束，优化选项和特殊变量。

第四十八章 Caché 变量大全 ^$LOCK 变量

提供锁名信息。

大纲

^$|nspace|LOCK(lock_name,info_type,pid) 
^$|nspace|L(lock_name,info_type,pid)

参数

• |nspace|或[nspace] [nspace]可选-扩展SSVN引用，显式名称空间名称或隐含名称空间。必须计算为带引号的字符串，该字符串括在方括号([“nspace”])或竖线(|“nspace”|)中。命名空间名称不区分大小写；它们以大写字母存储和显示。
• lock_name 计算结果为包含锁定变量名称(带下标或无下标)的字符串的表达式。如果是文字，则必须指定为带引号的字符串。
• info_type 可选-解析为所有大写字母指定为带引号字符串的关键字的表达式。info_type指定返回关于lock_name的哪种类型的信息。可用选项有“所有者”、“标志”、“模式”和“计数”。作为独立函数调用^$LOCK时需要。
• pid 可选-用于“计数”关键字。一个整数，指定锁所有者的进程标识。如果指定，最多为“计数”返回一个列表元素。如果省略(或指定为0)，将为持有指定锁的每个所有者返回一个列表元素。pid对其他info_type关键字没有影响。

描述

^$LOCK结构化系统变量返回有关当前命名空间或本地系统上指定命名空间中的锁的信息。

大家好，

正如我在上一个帖子分片评估（第 1 部分）中所承诺的，我继续研究了分片数量的影响。

为了完成概览，我还添加了以下实例：
在 WIN (Server 2012 R2)  8 核上
- Cache for Windows (x86-64) 2016.2.2 - 12 GB 全局缓冲区
- IRIS for Windows (x86-64) 2018.1.1  - 400 MB 全局缓冲区，无分片
在 LINUX (Ubuntu 16.04 LTS)  2 核上
- IRIS for UNIX (Ubuntu Server LTS for x86-64) 2018.1.1   400MB 全局缓冲区
- 无分片、2 个分片、3 个分片、4 个分片。

我使用的表有 2650 万条记录，并且在所有具有相同索引的实例上均相同

查询：
- SELECT $LISTLENGTH($LISTFROMSTRING(LIST(<property>))) FROM ... WHERE ... %STARTSWITH  <value>
 这里使用了 2 个不同的值，结果为 47000 和 19000 次命中。
 我将其称为简单查询 S47 和 S19
- SELECT $LISTLENGTH($LISTFROMSTRING(LIST(<property1>))) FROM .

大家好！

InterSystems IRIS 有一个名为 Interoperability（互操作性）的菜单。

它提供了轻松创建系统集成（适配器、记录映射、BPM、数据转换等）的机制，因此可以轻松连接不同的系统。

数据中继过程中可以包括各种操作，例如：为了连接没有正常连接的系统，可以根据目标系统的规范来接收（或发送）数据。 此外，在发送数据之前，可以从其他系统获取和添加信息。 还可以从数据库（IRIS 等）获取和更新信息。

在本系列文章中，我们将讨论以下主题，同时查看 示例代码 以帮助您了解工作原理以及在系统中集成互操作性时需要进行哪种开发。

• 工作原理
• 什么是Production
• 消息
• 组件创建
  • 业务操作
  • 业务流程
  • 业务服务

首先，我介绍一下我们将在本系列文章中使用的案例研究。

某公司运营着一个购物网站，他们正在更改产品信息的显示顺序以配合季节变化。
但是，有些商品无论季节如何都能卖得很好，而有些商品在意料之外的时间卖出，这不符合当前的显示顺序更改规则，
因此，我们研究了按照当天的温度而不是季节来更改显示顺序的可能性。 调查购买产品时的温度变得非常必要。
由于可以使用外部 Web API 来查询天气信息，因此我们计划收集购买时的天气信息，并将其记录在后面的审核数据库中。

案例非常简单，但您需要使用“外部 Web API”来收集信息，并且需要将获得的信息和购买信息结合起来记录在数据库中。

InterSystems IRIS 元素周期表

PDF 版本：

GIT 源：

InterSystems IRIS 是一个具有许多功能的数据平台。 这些功能和相关的 IRIS 主题都体现在元素周期表中。

这是一个第三方写的在 IRIS 2020.1 和 Caché 2018.1.3 上工作的代码示例
不会与新版本保持同步
也不会获得 InterSystems 支持提供的服务！     

Caché/Ensemble/IRIS 中的 Global 通常在 SQL 访问中是不可见的  
本示例将展示如何克服此限制。

Global 扫描和切片

这是一个在 IRIS 2020.1 和 Caché 2018.1.3 上工作的代码示例
不会与新版本保持同步
也不会获得 InterSystems 提供的支持服务！   

大多数情况下，默认存储使用的 global 只有 1 个表示 IDKEY 的下标级别。 对于索引 global，可能有 2 个或更多下标级别。

数组、父子关系或扩展了基础数据类的持久化类 是具有更多下标级别的示例。 但所有这些 global 都非常统一。

InterSystems API Manager (IAM) 版本1.5已正式发布。

IAM容器，包括从原有IAM版本升级的所有相关工件, 现在可以在 WRC 软件发布网址 组件区下载。

该版本的小版本号是 IAM 1.5.0.9-4。

InterSystems API Manager 1.5 使管理API通讯、与你的环境集成、加载API用户更加容易。它包含很多新特性，包括:

• 改进的用户体验
• 新的开发者门户工具
• 对Kafka connectivity的支持

这个版本基于Kong Enterprise version 1.5.0.9。之前的IAM版本包括一个贴牌版本的Kong Enterprise, 在本版本中的Kong Enterprise不再贴牌。 这个变化让我们可以更快的节奏带给您新的版本，并更有效地利用Kong提供的文档和其它资源。

请在 这里 查看IAM 1.5 的文档。这个文档仅说明IAM特殊的元素。产品中的文档链接直接打开Kong Enterprise的文档。

从IAM 0.34-1 升级需要通过3个中间版本累积升级，在 文档中有详细的说明。

IAM 仅以OCI (Open Container Initiative) 或 Docker 容器格式发放。

这是我们团队参加的第一届InterStstems编程竞赛！ 快来看看投票给我们！

超额预订管理系统结合了酒店业的独特条件，例如房价，订购渠道，客户需求等。 本系统使用机器学习算法（例如：KNN / ES-RNN ...）来准确预测酒店的每日未入住和入住率，并进一步与收益结合以找到最佳的最大客房销售量，从而精准增加酒店的边际收益。

简介

最近完成了针对IRIS医疗版2020.1版本的性能及可扩展性基准测试，重点关注HL7v2的互操作性。本文介绍了在各种工作负载下观察到的吞吐量，并提供了IRIS医疗版用作HL7v2消息传输互操作性引擎时的系统常规配置和调整准则。

基准测试模拟了与实际环境接近的工作负载（详细信息请参见“工作负载说明和方法”部分）。本次测试的工作负载包括HL7v2患者管理（ADT）和生命体征结果（ORU）数据，并包含数据内容转换和路由。

IRIS医疗版2020.1版本可以表明，采用第二代Intel®Xeon®可扩展处理器和Intel®Optane™SSD DC P4800X系列SSD存储的商用服务器，每天的持续消息吞吐量超过23亿条（入站和出站总量），与此前的Ensemble 2017.1 HL7v2吞吐量基准测试相比，扩展性提高了一倍多。

不少客户问我关于从Cache迁移到IRIS的问题。为什么要迁移到IRIS？Cache是优秀的，稳定的，有很好的性能，为什么要迁移到IRIS呢？这些客户是对的，但在过去几年，数字化转型提出了不少新问题、新需求和新挑战，客户需要更灵活、更完整、更前瞻的解决方案，InterSystems公司很有远见地洞察到了这一点，推出了IRIS。
一句话，IRIS是一套数据平台解决方案，它帮助客户和合作伙伴为迎接数字化转型的挑战提供了充足的弹药。

2020 年最佳 Open Exchange 开发者和应用程序！ 大家好，

2020 年是优秀应用程序丰收的一年！

将近 400 个应用程序已上传到 InterSystems Open Exchange！ 200 多个应用程序在 2020 年上传到我们的应用程序库！

我们很高兴向大家介绍最佳 Open Exchange 开发者和下载量最大的应用程序，这些应用程序绝对值得一试！

让我们仔细看一下我们的英雄们和卓越的应用程序：

第四十七章 Caché 变量大全 ^$JOB 变量

提供系统间IRIS进程(JOB)信息。

大纲

^$JOB(job_number)
^$J(job_number)

参数

• job_number 输入ObjectScript命令时创建的系统特定OBJ编号。每个活动的InterSystems IRIS进程都有一个唯一的作业号。登录到系统会启动一个作业。在UNIX®系统上，作业号是调用InterSystems IRIS时启动的子进程的PID。JOB_NUMBER必须指定为整数；不支持十六进制值。

描述

可以将^$JOB结构化系统变量用作$DATA、$ORDER和$QUERY函数的参数，以获取有关本地InterSystems IRIS系统上是否存在InterSystems IRIS作业的信息。

示例

以下示例显示如何将^$JOB用作$DATA、$ORDER和$QUERY函数的参数。

作为$DATA的参数

$DATA(^$JOB(job_number))

^$JOB作为$DATA的参数返回一个整数值，该值指示指定的作业是否作为节点存在于^$JOB中。下表显示了$DATA可以返回的整数值。

以下示例测试系统间IRIS进程是否存在。

DHC-APP>SET x=$JOB
 
DHC-APP>WRITE !

第四十六章 Caché 变量大全 ^$GLOBAL 变量

提供有关全局变量和进程私有全局变量的信息。

大纲

^$|nspace|GLOBAL(global_name)
^$|nspace|G(global_name)

^$||GLOBAL(global_name)
^$||G(global_name)

参数

• |nspace| 或 [nspace] - 可选-扩展SSVN引用，可以是显式名称空间名称，也可以是隐含名称空间。必须计算为带引号的字符串，该字符串括在方括号([“nspace”])或竖线(|“nspace”|)中。命名空间名称不区分大小写；它们以大写字母存储和显示。
• global_name 计算结果为包含无下标全局名称的字符串的表达式。全局名称区分大小写。使用^$||global()语法时，与进程专用全局名称相对应的无下标全局名称：^a表示^||a。

描述

可以将^$GLOBAL用作$DATA、$ORDER和$QUERY函数的参数，以返回有关当前名称空间(默认名称空间)或指定名称空间中是否存在全局变量的信息。还可以使用^$global返回有关存在进程私有全局变量的信息。

进程私有全局变量

可以使用^$global获取有关所有命名空间中是否存在进程私有全局变量的信息。可以将进程专用全局的查找指定为^$||global或^$|“^”|global。

第四十五章 Caché 变量大全 $ZVERSION 变量

包含一个字符串，描述do命令后面的InterSystems IRIS.line的当前版本。

大纲

$ZVERSION 
$ZV

描述

$ZVERSION包含一个字符串，该字符串显示当前运行的InterSystems IRIS®Data Platform实例的版本。

以下示例返回$ZVERSION字符串：

DHC-APP>WRITE $ZVERSION
Cache for Windows (x86-64) 2016.2 (Build 736U) Fri Sep 30 2016 11:46:02 EDT

此字符串包括InterSystems IRIS安装的类型(产品和平台，包括CPU类型)、版本号(2018.1)、该版本中的内部版本号(内部版本号中的“U”表示UNICODE以及创建此版本的InterSystems IRIS的日期和时间。“EST”是东部标准时间(美国东部的时区)，“EDT”是东部夏令时

通过调用GetVersion()类方法可以返回相同的信息，如下所示：

DHC-APP>WRITE $SYSTEM.Version.GetVersion()
Cache for Windows (x86-64) 2016.2 (Build 736U) Fri Sep 30 2016 11:46:02 EDT

以通过调用其他%SYSTEM.

大家好！

InterSystems开发者社区中文版正在招募版主，以更好地推动中文社区建设，期待每一位开发者的积极参与，共同打造一个高效沟通的技术社区！

欢迎点击报名（或扫描下方二维码），审核通过后，我们会与您详细沟通版主权益及义务。

第四十四章 Caché 变量大全 $ZTRAP 变量

包含当前错误陷阱处理程序的名称。

大纲

$ZTRAP
$ZT

描述

$ZTRAP包含当前错误陷阱处理程序的行标签名和/或例程名。有三种方法可以设置$ZTRAP:

• SET $ZTRAP=“location”
• SET $ZTRAP=“*location”
• SET $ZTRAP=“^%ET” or “^%ETN”

在这里，位置可以指定为标签(当前例程中的行标签)、^routine(指定外部例程的开始)或label^routine(指定外部例程中的指定标签)。

然而，$ZTRAP=label^routine不能用于程序块。过程块中的$ZTRAP不能用于转到过程体之外的位置；过程块中的$ZTRAP只能引用该过程块中的一个位置。

Location

使用设置命令，可以将位置指定为带引号的字符串。

• 在例程中，可以将位置指定为标签(当前例程中的行标签)、^routine(指定外部例程的开始)或label^routine(指定外部例程中的指定标签)。不要在引用过程或过程中的标签的例程中指定位置。这是一个无效位置；当InterSystems IRIS试图执行$ZTRAP时，会导致运行时错误。
• 在过程中，可以将位置指定为标签；过程块中私有标签。过程块中的$ZTRAP不能用于转到过程体之外的位置；过程块中的$ZTRAP只能引用该过程块中的一个位置。

第四十三章 Caché 变量大全 $ZTIMEZONE 变量

包含格林威治子午线的时区偏移量。

大纲

$ZTIMEZONE
$ZTZ

描述

$ZTIMEZONE可以通过两种方式使用：

• 返回计算机的本地时区偏移量。
• 为当前进程设置本地时区偏移量。

$ZTIMEZONE包含从格林威治子午线偏移的时区（以分钟为单位）。 （格林威治子午线包括整个英国和爱尔兰。）此偏移量表示为-1440到1440范围内的有符号整数。格林威治以西的时区指定为正数；格林威治东部的时区指定为负数。 （时区必须以分钟为单位，因为并非所有时区都以小时为单位。）默认情况下，$ZTIMEZONE初始化为计算机操作系统设置的时区。

注意：$ZTIMEZONE将本地时间调整为固定的偏移量。它不适应夏令时或其他当地时间的变化。 InterSystems IRIS从基础操作系统获取本地时间，该操作系统将本地时间变体应用于为该计算机配置的位置。因此，使用$ZTIMEZONE调整的本地时间将从配置的语言环境中获取其本地时间变化，而不是在$ZTIMEZONE中指定的时区。

使用格林威治子午线（$ZTIMEZONE = 0）的时区计数来计算UTC时间。它与当地格林威治时间不同。格林威治标准时间（GMT）一词可能令人困惑；格林威治的当地时间与冬季的UTC相同。在夏季，它与UTC的差异为一小时。这是因为应用了称为英国夏令时的本地时间变体。