第六十五章 SQL函数 %INTERNAL

返回逻辑格式表达式的格式转换函数。

大纲

%INTERNAL(expression)

%INTERNAL expression

参数

• expression - 要转换的表达式。 字段名、包含字段名的表达式，或返回可转换数据类型(如DATE或%List)中的值的函数。

描述

%INTERNAL将表达式转换为逻辑格式，与当前选择模式(显示模式)无关。逻辑格式是数据的内存格式(对其执行操作的格式)。%INTERNAL通常用于选择列表SELECT-ITEM。

可以在WHERE子句中使用%INTERNAL，但强烈建议不要使用%INTERNAL，因为使用%INTERNAL会阻止在指定字段上使用索引，并且%INTERNAL会强制所有比较区分大小写，即使该字段有默认排序规则也是如此。

应用%INTERNAL会将列标题名称更改为诸如“Expression_1”之类的值；因此，通常需要指定列名别名，如下面的示例所示。

%INTERNAL将数据类型%DATE的值转换为整数数据类型值。%INTERNAL将数据类型%TIME的值转换为数字(15，9)数据类型值。之所以提供此转换，是因为ODBC或JDBC客户端不识别逻辑%DATE和%TIME值。

%INTERNAL是否转换日期取决于日期字段或函数返回的数据类型。

请教各位老师：

Cache数据日志怎么读取？

如果是想写代码去读取，应该怎么操作？如果是不知道数据日志在哪，应该在哪可以获取？

How to use Studio Coding to do service registration function of service component in production system 如何通过studio代码开发，实现production界面的服务组件的服务注册功能

第六十四章 SQL函数 INSTR

返回子字符串在字符串中的位置的字符串函数，具有可选的搜索起始点和出现次数。

大纲

INSTR(string,substring[,start[,occurrence]])

参数

• string - 要在其中搜索子字符串的字符串表达式。 它可以是列的名称、字符串字面值或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型(如CHAR或VARCHAR2)。
• substring - 一个子字符串，被认为出现在字符串中。
• start - 可选-子字符串搜索的起始点，指定为正整数。 从字符串开始的字符计数，从1开始计数。 若要从字符串的开头开始搜索，请忽略此参数或指定从1开始。 起始值为0、空字符串、NULL或非数字值会导致INSTR返回0。 指定start为负数会导致INSTR返回。
• occurrence - 可选-一个非零整数，指定从起始位置搜索时返回哪个子字符串。 默认情况是返回第一个出现的位置。

INSTR返回INTEGER数据类型。

描述

INSTR在字符串中查找子字符串，并返回子字符串的第一个字符的位置。 位置以整数形式返回，从字符串的开头开始计算。 如果substring没有找到，则返回0(0)。 如果传递给任何一个参数一个NULL值，INSTR将返回NULL。

INSTR支持指定start作为子字符串搜索的起始点。

@Ming Zhou 在 https://community.intersystems.com/post/how-get-all-properties-defined-c 上问了一个很好的问题......而这个答案正好总结了为什么ObjectScript 是我最喜欢的语言。

当我第一次向别人介绍ObjectScript或IRIS时，我总是解释说，你可以写一个类，编译它，得到一个表，并从对象或关系的角度来处理你的数据--这是一种最自然的方式。

但无论哪种方式，它都只是一个薄薄的包装，包裹着被称为Globals的超级快速的内部数据结构，当你真的需要更快的速度时，你可以使用这些结构。

当我和比较爱较真的技术人员沟通时，我会告诉他们：ObjectScript允许各种炫酷的元编程，因为你可以用完全相同的方式与你刚刚写的类进行交互--从对象或关系的角度。或者在你需要额外的速度时直接使用超快的底层数据结构。

你可以在对这个问题的回答中看到答案： "我怎样才能得到一个类中的所有属性，包括继承的属性？"

这里有三种不同的方式来获得相同的答案。

Class DC.

第六十三章 SQL函数 IFNULL

测试NULL并返回适当表达式的函数。

大纲

IFNULL(expression-1,expression-2 [,expression-3])

{fn IFNULL(expression-1,expression-2)}

参数

• expression-1 - 要计算以确定是否为NULL的表达式。
• expression-2 - 如果expression-1为NULL，则返回的表达式。
• expression-3 - 可选-如果expression-1不是NULL返回的表达式。 如果没有指定expression-3，则当expression-1不是NULL时返回NULL值。

返回的数据类型描述如下。

描述

支持IFNULL作为SQL通用函数和ODBC标量函数。 请注意，虽然这两个执行非常相似的操作，但它们在功能上是不同的。 SQL通用函数支持三个参数。 ODBC标量函数支持两个参数。 SQL通用函数和ODBC标量函数的双参数形式是不一样的; 当expression-1不为空时，它们返回不同的值。

SQL通用函数计算表达式1是否为NULL。 它永远不会返回expression-1:

• 如果expression-1为NULL，则返回expression-2。
• 如果expression-1不为NULL，则返回expression-3。

投票时间到！

来为你最欣赏的应用投上一票吧！ 【投票时间】InterSystems 开发者竞赛：Python

🔥 为你的最爱投票 🔥

如何投票？请看以下细节。

最新一期“极客聊吧”，InterSystems销售工程师们聊了聊这些话题：为什么有些医院和某些商保之间可以直接结算，有些又不能？医院和保险之间的结算难在哪儿？在InterSystems 2021全球线上峰会中提到的医保结算案例对国内实践有哪些借鉴意义？FHIR又能起到什么关键作用？医疗数据实现互联互通的关键是什么？来听听的答案。

开发者们大家好!

你可能已经注意到了在IRIS 2021 Global的名字是随机的。

如果你用DDL来创建类而且想给Global一个确定的名字，实际上是可以做的。

在CREATE Table 里使用 WITH %CLASSPARAMETER DEFAULTGLOBAL='^GLobalName' ，如文档。参考以下例子:

第六十二章 SQL函数 HOUR

Time函数，它返回DateTime表达式的小时数。

大纲

{fn HOUR(time-expression)}

• time-expression - 作为列名、另一个标量函数的结果或字符串或数字文字的表达式。它必须解析为日期时间字符串或时间整数，其中基础数据类型可以表示为%Time、%Timestamp或%PosiTime。

描述

Hour返回一个整数，指定给定时间或日期时间值的小时。小时是根据$HOROLOG或$ZTIMESTAMP值、ODBC格式的日期字符串或时间戳计算的。

时间表达式时间戳可以是数据类型%Library.PosiTime(编码的64位有符号整数)，也可以是数据类型%Library.TimeStamp(yyyy-mm-dd hh：mm：ss.fff)。

要更改此默认时间格式，请使用SET OPTION命令。

请注意，可以提供时间整数(已用秒数)，但不能提供时间字符串(hh：mm：ss)。必须提供日期时间字符串(yyyy-mm-dd hh：mm：ss)。可以省略日期时间字符串的秒(：ss)或分钟和秒(mm：ss)部分，但仍返回小时部分。日期时间字符串的时间部分必须是有效的时间值。未验证日期时间字符串的日期部分。

小时以24小时表示。小时数(HH)部分应该是介于0到23之间的整数。输入上的前导零是可选的；输出上不显示前导零。

InterSystems 安全基础线InterSystems Security Basics

通过本课程可以：

• 识别安全模式下的各个组件.
• 选择合适的认证方法.
• 创建用户和角色.
• 利用针对资源的许可来保护资产.
• 激活系统审计.

https://learning.intersystems.com/course/view.php?id=1774

点击此处或扫描下方二维码进入调研。

第六十一章 SQL函数 GREATEST

从一系列表达式中返回最大值的函数。

大纲

GREATEST(expression,expression[,...])

参数

• expression - 解析为数字或字符串的表达式。 对这些表达式的值进行比较。 表达式可以是字段名、文字、算术表达式、主机变量或对象引用。 最多可以列出140个逗号分隔的表达式。

描述

GREATEST返回逗号分隔的一系列表达式中的最大值。 表达式按从左到右的顺序求值。 如果只提供一个表达式，则GREATEST返回该值。 如果任何表达式为NULL，则GREATEST返回NULL。

如果所有表达式值都解析为规范数，则按数值顺序对它们进行比较。 如果引用的字符串包含规范格式的数字，则按数字顺序对其进行比较。 但是，如果引用的字符串包含非规范格式的数字(例如，'00'、'0.4'或'+4')，则将其作为字符串进行比较。 字符串比较按排序顺序逐字符执行。 任何字符串值都大于任何数字值。

空字符串大于任何数字值，但小于任何其他字符串值。

如果返回值是一个数字，则GREATEST将以规范格式返回它(删除前导和末尾的零，等等)。 如果返回值是一个字符串，则GREATEST将不改变返回值，包括任何前导或末尾空格。

GREATEST返回逗号分隔的一系列表达式中的最大值。 LEAST

关于产品原型的设计软件有哪些推荐？如何快速和高效地提升设计能力？

第六十章 SQL函数 GETUTCDATE

日期/时间函数，返回当前UTC日期和时间。

大纲

GETUTCDATE([precision])

参数

• precision - 可选-一个正整数，指定时间精度为小数秒的位数。 默认值是0(没有小数秒); 这个默认值是可配置的。

描述

GETUTCDATE返回通用时间常数(UTC)日期和时间作为时间戳。由于UTC时间在地球上的任何地方都是相同的，不依赖于当地时区，也不受当地时差(如夏令时)的影响，因此当不同时区的用户访问同一数据库时，此函数对于应用一致的时间戳非常有用。

GETUTCDATE可以返回%TIMESTAMP数据类型格式(yyyy-mm-dd hh：mm：ss.ffff)或%PosiTime数据类型格式(编码的64位有符号整数)的时间戳。以下规则确定返回哪种时间戳格式：

1. 如果当前UTC时间戳被提供给数据类型为%PosiTime的字段，则此时间戳值将以POSIXTIME数据类型格式返回。例如，WHERE PosixField=GETUTCDATE() or INSERT INTO MyTable (PosixField) VALUES (GETUTCDATE())。
2. 如果当前UTC时间戳被提供给数据类型为%TIMESTAMP的字段，则此时间戳值以TIMESTAMP数据类型格式返回。其ODBC类型为TIMESTAMP，长度为16，精度为19

第五十九章 SQL函数 GETDATE

日期/时间函数，返回当前本地日期和时间。

大纲

GETDATE([precision])

参数

• precision - 可选-一个正整数，指定时间精度为小数秒的位数。 默认值是0(没有小数秒); 这个默认值是可配置的。 精度值是可选的，括号是必选的。

描述

GETDATE将此时区的当前本地日期和时间作为时间戳返回；它根据本地时间变量(如夏令时)进行调整。

GETDATE可以返回%TIMESTAMP数据类型格式(yyyy-mm-dd hh：mm：ss.ffff)或%PosiTime数据类型格式(编码的64位有符号整数)的时间戳。以下规则确定返回哪种时间戳格式：

1. 如果当前时间戳被提供给数据类型为%PosiTime的字段，则当前时间戳值将以POSIXTIME数据类型格式返回。例如， WHERE PosixField=GETDATE() or INSERT INTO MyTable (PosixField) VALUES (GETDATE())

2. 如果当前时间戳被提供给数据类型为%TIMESTAMP的字段，则当前时间戳值将以TIMESTAMP数据类型格式返回。

第五十八章 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常规函数调用。

也可以使用Floor()方法调用从ObjectScript调用此函数：

$SYSTEM.SQL.Functions.FLOOR(numeric-expression)

示例

以下示例显示Floor如何将分数转换为其Floor整数：

SELECT FLOOR(167.111) AS FloorNum1,
       FLOOR(167.456) AS FloorNum2,
       FLOOR(167.999) AS FloorNum3

167	167	167

SELECT {fn FLOOR(167.

InterSystems的产品包括Caché/Ensemble/Health Connect/IRIS/IRIS for Health，均基于进程，当它们及在它们之上开发的应用运行时，您能在操作系统上看到大量cache/irisdb进程。下面以InterSystems IRIS为例，来说明下InterSystems产品的内存使用。

InterSystems IRIS进程的内存使用主要有以下两大类，

第一类，进程私有内存。

私有内存只由该进程使用，且会为每个进程单独分配。进程初始时会被分配128KB的内存空间，随着进程运行根据需要，这个内存空间会自动扩展。
InterSystems IRIS对于进程内存使用的限制是Maximum Per-Process Memory, 该参数的设置位置在系统管理门户SMP，System > Configuration > Memory and Startup，允许的取值范围是256KB到2147483647KB（2TB）。如果系统遇到<STORE>错误，那么可以尝试增加该数值，来解决进程运行时无法申请到更多内存的问题。从InterSystems IRIS开始，我们推荐将该值设置为-1, 也就是取上限2TB。

在InterSystems IRIS和InterSystems Caché 里，是否您遇到过执行一个SQL Insert/Update语句，明明给的是正确的日期值，但被告知“值‘2022-01-01’ 校验失败”的类似情况，并感到困惑？

如果有，那么您需要了解一下InterSystems IRIS和InterSystems Caché保存和显示数据的模式。

一 数据模式

InterSystems IRIS和InterSystems Caché里，数据有3种模式，称之为SELECT MODE：
逻辑模式：这是数据被保存到InterSystems IRIS和InterSystems Cache'时的格式。例如，%Date类型的数据，在数据库里被保存为一个整数，即从1840年12月31号到这个日期的天数，而不是YYYY-MM-DD的格式。

ODBC模式：这是ODBC对数据定义的格式。在这个模式下，%Date类型的数据就会显示为YYYY-MM-DD的格式。

显示模式：这是数据在InterSystems IRIS和InterSystems Caché里默认的显示格式。例如在美国语言环境下，%Date的默认显示格式是DD/MM/YYYY格式。

InterSystems IRIS和InterSystems Caché只会使用逻辑模式保存数据，但可以以任何模式显示数据。

第五十七章 SQL函数 $FIND

字符串函数，返回字符串中子字符串的结束位置，可选的搜索起始点。

大纲

$FIND(string,substring[,start])

参数

• string - 要搜索的目标字符串。 它可以是变量名、数值、字符串字面值或任何有效表达式。
• substring - 要搜索的子字符串。 它可以是变量名、数值、字符串字面值或任何有效表达式。
• start - 可选-子字符串搜索的起始点，指定为正整数。 从字符串开始的字符计数，从1开始计数。 若要从字符串的开头开始搜索，请忽略此参数或指定从0或1开始。 负数、空字符串或非数字值将被视为0。 指定start为NULL会导致$FIND返回< NULL >。

$FIND返回SMALLINT数据类型。

描述

$FIND返回一个整数，指定子字符串在字符串中的结束位置。 $FIND搜索字符串的子字符串。 如果找到子字符串，$FIND返回子字符串后面第一个字符的整数位置。 如果substring未找到，$FIND返回0值。

可以包含start选项来指定搜索的起始位置。 如果start大于字符串中的字符数，$FIND返回一个值为0。 如果省略start，则默认为字符串位置1。 如果起始值为0、负数或非数字字符串，则位置1是默认值。

$FIND是区分大小写的。 使用其中一个大小写转换函数来定位字母或字符串的大写和小写实例。

windows 前台调试

1. 在Production配置中，勾选 ‘开发与调试’ 中的 ‘测试开启’ 。 
2. 选中需要调试的组件（业务服务，业务流程，业务操作），在'设置'中勾选 ‘开发与调试’ 中的 ‘在前台运行’ 。 
3. 继续选中需要调试的组件，在'操作'中点击 ‘测试’ 。 
4. 选择相应的请求类型，点击‘调用测试服务’。
5. 前台窗口会被弹出。

Container 前台调试

可以在运行容器时直接发布63300端口，主机的telnet客户端将能够连接到前台端口。

如果你愿意，你可以改变这个端口号，直接设置到全局的

Set tPortRangeStart=$G(^Ens.Config("FGTelnetRange","start"),63300)
Set tPortRangeEnd=$G(^Ens.Config("FGTelnetRange","end"),63499)

Linux 前台调试

Do $system.Process.Terminate(<BO JOB>)
Do ##class(Ens.Job).Start("BO CONFIGNAME", 1)

嗨开发者们！

欢迎查收 InterSystems开发者YouTube频道 2021最受欢迎的视频！

实时人工智能/机器学习计算的挑战

我们将从我们在 InterSystems 数据科学实践中遇到的示例开始讲起：

• “高负载”客户门户与在线推荐系统相集成。 计划是在整个零售网络层面重新配置促销活动（我们将假设使用“细分策略”矩阵而非“平面”促销活动母版）。 推荐机制会有哪些变化？ 推荐机制内的数据馈送和数据更新会有哪些变化（输入数据量增加了 25000 倍）？ 推荐规则生成设置会有哪些变化（生成规则的总量和“分类”呈千倍增加，因此需要将推荐规则筛选阈值缩小千倍）？
• 设备健康监控系统使用“手动”方式馈送数据样本。 现在，它将连接到每秒可传输数千个过程参数读数的 SCADA 系统。 监控系统会有哪些变化（它能否应对以秒为单位的设备健康监控）？ 当输入数据接收到包含数百列最近在 SCADA 系统中实现的数据传感器读数的新块时，会发生什么（是否有必要关闭监控系统以将新的传感器数据整合到分析当中，以及要关闭多久）？
• 复杂的人工智能/机器学习机制（推荐、监控、预测）依赖于彼此的结果。 要调整这些人工智能/机器学习机制的功能以适应输入数据的变化，每月需要多少人工工时？ 人工智能/机器学习机制在支持制定业务决策方面的总体“延迟”是多少（支持信息的刷新频率对比新输入数据的馈送频率）？

亲爱的开发者们！

“InterSystems中国”在B站现在已经有两百多位粉丝啦，欢迎查收2021年InterSystems中国在B站最受欢迎的视频列表！

第五十六章 SQL函数 $EXTRACT

按位置从字符串中提取字符的字符串函数。

大纲

$EXTRACT(string[,from[,to]])

参数

• string - 要从中提取子字符串的目标字符串。
• from - 可选-单个字符在目标字符串中的位置，或要提取的字符范围(包括)的开头。 指定为从1开始计数的正整数。
• to - 可选-要提取的字符范围的结束位置(包括)。 指定为从1开始计数的正整数。

描述

$EXTRACT返回字符串中指定位置的子字符串。 返回的子字符串的性质取决于所使用的参数。

• $EXTRACT(string)提取字符串中的第一个字符。
• $EXTRACT(string,from)从from指定的位置提取字符。 例如，如果变量var1包含字符串“ABCD”，下面的命令提取“B”(第二个字符):

SELECT $EXTRACT('ABCD',2) AS Extracted

2

• $EXTRACT(string,from,to)提取以from位置开始，以to位置结束的字符范围。 例如，下面的命令从字符串“1234Alabama567”中提取字符串“Alabama”(即从位置5到位置11的所有字符，包括在内):

SELECT $EXTRACT('1234Alabama567',5,11) AS Extracted

Alabama

这个函数返回VARCHAR类型的数据。

第五十五章 SQL函数 %EXTERNAL

以显示格式返回表达式的格式转换函数。

大纲

%EXTERNAL(expression)

%EXTERNAL expression

参数

• expression - 要转换的表达式。字段名、包含字段名的表达式或返回值为可转换数据类型(如DATE或%LIST)的函数。不能是流字段。

描述

%EXTERNAL将表达式转换为显示格式，与当前选择模式(显示模式)无关。显示格式表示VARCHAR数据类型的数据，无论字段或数据类型LogicalToDisplay方法执行什么数据转换。

%EXTERNAL通常用于选择列表SELECT-ITEM。它可以在WHERE子句中使用，但不建议这样使用，因为使用%EXTERNAL会阻止在指定字段上使用索引。

应用%EXTERNAL会将列标题名称更改为诸如“Expression_1”之类的值；因此，通常需要指定列名别名，如以下示例所示。

%EXTERNAL是否转换日期取决于日期字段或函数返回的数据类型。%EXTERNAL转换CURDATE、CURRENT_DATE、CURTIME和CURRENT_TIME值。它不转换CURRENT_TIMESTAMP、GETDATE、GETUTCDATE、NOW和$HOROLOG值。

当%EXTERNAL将%List结构转换为显示格式时，显示的列表元素似乎由空格分隔。

1. 使用PyODBC访问InterSystems IRIS数据库

pyodbc是一个开源的Python模块，可以利用ODBC来访问底层数据库。InterSystems支持使用pyodbc作为使用关系模式从Python访问数据库的一种方式。这个模块也可以用于InterSystems IRIS的早期版本。

代码示例

import pyodbc
 
def run():
   # connection information
   ip = localhost
   port = 51773 # IRIS超级服务端口号
   namespace = USER
   username = <userName>
   password = <password>
   driver = "{InterSystems IRIS ODBC35}" # ODBC data source名称, IRIS 安装时一般自带ODBC驱动，所以不需要独立安装
​
   # Create connection to InterSystems IRIS
   connection_string = 'DRIVER={};SERVER={};PORT={};DATABASE={};UID={};PWD={}' \
      .

痴呆症是一个重大的全球性问题，困扰着5400万人，到2050年这个数字将上升到1.3亿。由英国剑桥大学的学者创立的Cognetivity Neurosciences公司设计了一个尖端的解决方案，以帮助缓解全球痴呆症的流行。

根植于先进神经科学的简单解决方案

在出现临床症状之前的早期检测，为专家干预和改变生活方式打开了大门，可以减缓痴呆症的发展，提高生活质量。生活方式的改变有可能将症状的出现推迟五年，进而将普通人群中的痴呆症发病率降低50%。

Cognetivity Neurosciences的综合认知评估测试（ICA）是基于人类对动物刺激的强烈反应，以及健康的大脑在不到200毫秒内处理动物图像的能力。

ICA将基于云的人工智能和神经科学的进展结合起来，进行快速的动物/非动物视觉分类测试，目的是在记忆症状出现之前发现疾病的迹象。它涉及在阿尔茨海默症的前症状阶段受到影响的大脑区域，并检测出信息处理速度的细微损伤。

ICA基于云的敏捷性使临床医生和用户能够在熟悉的硬件上进行ICA测试，如iPad和智能手机，并在任何有互联网连接的地方进行。

Cognetivity Neurosciences正在通过一个先进的、可扩展的解决方案，利用神经科学的进步、人工智能和InterSystems IRIS for Health云数据管理平台的力量，重新发明痴呆症检测。

第五十四章 SQL函数 EXP

返回数字的指数(自然对数的倒数)的标量数值函数。

大纲

{fn EXP(expression)}

参数

• expression - 对数指数，数值表达式。

EXP返回NUMERIC或DOUBLE数据类型。如果表达式的数据类型为DOUBLE，则EXP返回DOUBLE；否则返回NUMERIC。

描述

Exp是指数函数e n，其中e是常数2.718281828。因此，要返回e的值，可以指定{fn exp(1)}。Exp是自然对数函数log的逆函数。

EXP返回一个精度为36、小数位数为18的值。如果传递的值为NULL，则EXP返回NULL。

EXP只能用作ODBC标量函数(使用花括号语法)。

示例

下面的示例返回常量e：

SELECT {fn EXP(1)} AS e_constant

2.718281828459045235

下面的嵌入式SQL示例返回整数0到10的指数值：

ClassMethod Exp()
{
	s a = 0
	while a < 11 {
	&sql(SELECT {fn EXP(:a)} INTO :b)
	if SQLCODE'=0 {
		w !,"错误代码 ",SQLCODE
		q 
	} else {
		w !,"指数 ",a," = ",b
		s a=a+1 }
	}
}

DHC-APP>d ##class(PHA.TEST.

1. 互操作性-嵌入式Python（interoperability-embedded-python）

这个概念旨在展示iris互操作性框架如何与嵌入的python一起使用。

1.2. 示例代码

import grongier.pex
import iris
import MyResponse

class MyBusinessOperation(grongier.pex.BusinessOperation):

    def OnInit(self):
        print("[Python] .MyBusinessOperation:OnInit() is called")
        self.LOGINFO("Operation OnInit")
        return

    def OnTeardown(self):
        print("[Python] .MyBusinessOperation:OnTeardown() is called")
        return

    def OnMessage(self, messageInput):
        if hasattr(messageInput,"_IsA"):
            if messageInput.