在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类型的数据。

参数

string

第五十五章 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值。

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

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

代码示例

痴呆症是一个重大的全球性问题，困扰着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 }
	}
}

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

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

1.2. 示例代码

在刚刚过去的2021年，InterSystems举办了多场线上直播，我们汇总了多场重要直播，您可以点击链接或扫描相应二维码进入直播间，即可观看精彩回放！

第五十三章 SQL函数 %EXACT

排序规则函数，可将字符转换为精确的排序规则格式。

大纲

%EXACT(expression)

%EXACT expression

参数

• expression - 字符串表达式，可以是列名、字符串文字、数字或另一个函数的结果，其中底层数据类型可以表示为任何字符类型(如CHAR或VARCHAR2)。

描述

%Exact返回精确排序规则序列中的表达式。此归类序列按如下方式对值进行排序：

1. NULL排序在所有实际值之前。%Exact对空值没有影响。这与默认排序规则相同。
2. 规范数值(无论输入为数字还是字符串)在字符串值之前按数字顺序排序。
3. 字符串值按区分大小写的字符串顺序排序。字符串的精确排序顺序与ANSI标准的ASCII排序顺序相同：数字在大写字母字符之前排序，大写字母字符在小写字母字符之前排序。标点符号出现在序列中的多个位置。

这将导致如下所示的序列：

class '%Library.RoutineMgr', property 'Code': 错误 #5002: Cache错误: <WRITE>zWrite+23^%Library.FileCharacterStream.1 报错JS 时报这个错误 应该怎么办？

类似: "set obj = ##class(myClass).%OpenId(id)" 把一个id 赋予对象的实例，有没有办法可以通过提供类名和id 作为参数来实现功能/类方法来返回同样的结果,例如 用ObjectScript 中的getObjectInstanceByNameId(className As %String, id As %Integer)？谢谢！

第五十二章 SQL函数 DEGREES

将弧度转换为角度的数值函数。

大纲

DEGREES(numeric-expression)

{fn DEGREES(numeric-expression)}

参数

• numeric-expression - 以弧度表示的角度的量度。解析为数值的表达式。

度返回NUMERIC或DOUBLE数据类型。如果NUMERIC-EXPRESSION的数据类型为DOUBLE，则度返回DOUBLE；否则返回NUMERIC。

度数可以指定为标准标量函数，也可以指定为使用大括号语法的ODBC标量函数。

描述

DEGREES以弧度为单位进行角度测量，并以度为单位返回相应的角度测量值。如果传递空值，度将返回空。

返回值的默认精度为36，默认小数位数为18。

可以使用弧度函数将度数转换为弧度。

示例

下面的嵌入式SQL示例返回与弧度值0到6对应的等价度：

ClassMethod Degrees()
{
	s a = 0
	while a < 7 {
		&sql(SELECT DEGREES(:a) INTO :b)
		if SQLCODE '= 0 {
			w !,"Error code ",SQLCODE
			q 
		} else {
			w !,"radians ",a," = degrees ",b
			s a=a+1 }
		}
}

第五十一章 SQL函数 DECODE

计算给定表达式并返回指定值的函数。

大纲

DECODE(expr {,search,result}[,default])

参数

• expr - 要解码的表达式。
• search - 要与Expr进行比较的值。
• result - Expr匹配搜索时返回的值。
• default - 可选-如果expr与任何搜索都不匹配，则返回默认值。

描述

可以指定多个搜索和结果对，以逗号分隔。您可以指定一个默认值。DECODE表达式(包括EXPR、SEARCH、RESULT和DEFAULT)中的最大参数数约为100。搜索、结果和默认值可以从表达式派生。

为了计算DECODE表达式，会逐个将expr与每个搜索值进行比较：

• 如果expr等于search ，则返回相应的结果。
• 如果expr不等于search ，则返回默认值，如果省略默认值，则返回NULL。

仅在将search与Expr进行比较之前计算每个search，而不是在将所有search与Expr进行比较之前评估所有search。因此，如果上一次搜索等于EXPR，不会对搜索求值。

在DECODE表达式中，将两个NULL视为等效。如果expr为NULL，则将返回同样为NULL的第一次搜索结果。

请注意，为了与Oracle兼容，支持解码。

返回值的数据类型

Hello 家人们，

    InterSystems 学习网站有许多非常棒的课程。 因此，如果您想了解 InterSystems 并开始使用 InterSystems，希望这些资源可以帮到你：

第五十章 SQL函数 DAYOFWEEK

Date函数，它返回日期表达式的整型日期。

参数

• date-expression - 日期表达式，它是列名、另一个标量函数的结果或日期或时间戳文字。

描述

DAYOFYEAR返回一个介于1到366之间的整数，该整数对应于给定日期表达式的一年中的第几天。DAYOFYAR计算闰年日期。

根据日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式日期字符串或时间戳计算一年中的日期。

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

时间戳的时间部分不计算，可以省略。

在计算$HOROLOG值的月份日期时，DAYOFYAR会计算闰年差异，包括世纪日调整：2000年是闰年，1900和2100不是闰年。

DAYOFYEAR可以将1840年12月31日之前的日期表达式值处理为负整数。下面的示例显示了这一点：

SELECT {fn DAYOFYEAR(-306)} AS LastDayFeb, 
       {fn DAYOFYEAR(-305)} AS FirstDayMar  
       
       
60	61

最早有效日期表达式为-672045(0001-01)。

第四十九章 SQL函数 DAYOFWEEK

Date函数，它返回日期表达式的整型星期几。

大纲

{fn DAYOFWEEK(date-expression)}

参数

• date-expression - 有效的ODBC格式日期或$HOROLOG格式日期，带或不带时间组件。作为列名、另一个标量函数的结果或日期或时间戳文字的表达式。

描述

DAYOFWEEK接受日期表达式，并返回与该日期的星期几对应的整数。一周的天数从一周的第一天开始计算；的默认设置是星期天是一周的第一天。因此，默认情况下，返回值表示这些天：

• 1 — Sunday
• 2 — Monday
• 3 — Tuesday
• 4 — Wednesday
• 5 — Thursday
• 6 — Friday
• 7 — Saturday

请注意，ObjectScript $ZDATE和$ZDATETIME函数计算一周中的天数从0到6(而不是1到7)。

日期表达式可以是日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式的日期字符串或时间戳。

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

时间戳的时间部分不被评估，可以省略。

第四十八章 SQL函数 DAYOFMONTH

返回日期表达式的月份日期的日期函数。

大纲

{fn DAYOFMONTH(date-expression)}

参数

• date-expression - 要从中返回月值日期的日期或时间戳表达式。作为列名、另一个标量函数的结果或日期或时间戳文字的表达式。

描述

DAYOFMONTH以1到31之间的整数形式返回每月的第几天。日期表达式可以是日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式的日期字符串或时间戳。

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

TIMESTAMP或$HOROLOG字符串的时间部分不计算，可以省略。

DAYOFMONTH和DAY函数在功能上是相同的。

也可以使用DAYOFMONTH（）方法调用从ObjectScript调用此函数：

DHC-APP>  w $SYSTEM.SQL.DAYOFMONTH("2018-02-25")
25

Timestamp date-expression

说明

欢迎来到InterSystems广播站--数据点！在这一集里，我们和在线培训团队负责人Jenny Ames聊了聊InterSystems IRIS--稳定、灵活、可扩展、可互操作的数据平台，它为世界上许多最关键的核心应用提供支持。从它的多模型性质到它的集成引擎，再到它的医疗保健功能，在一次谈话中，有很多东西需要解读。

本期节目回放：https://datapoints.castos.com/episodes/1-what-is-intersystems-iris-jenn…

关于InterSystems广播站的更多信息，请访问https://datapoints.intersystems.com。

今天就试用InterSystems IRIS，请到https://www.intersystems.com/try，启动你的实例!

更多资料欢迎访问：https://gettingstarted.intersystems.com。

以下是本期对话中文全文。

InterSystems 数据平台团队非常高兴地宣布，InterSystems IRIS数据平台、InterSystems IRIS for Health和HealthShare Health Connect的2021.2版本现已向我们的客户和合作伙伴全面开放（GA）。

第四十七章 SQL函数 DAYNAME

Date函数，它返回日期表达式的星期几的名称。

大纲

{fn DAYNAME(date-expression)}

参数

• date-expression - 计算结果为日期整数、ODBC日期或时间戳的表达式。该表达式可以是列名、另一个标量函数的结果或日期或时间戳文字。

描述

DAYNAME返回与指定日期对应的日期的名称。返回值为字符串，最大长度为15。默认返回的日期名称为：Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday。

要更改这些默认日期名称值，请使用带有WEEKDAY_NAME选项的SET OPTION命令。

日期名称是针对日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式日期字符串或时间戳计算的。

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

时间戳的时间部分不计算，可以省略。

DAYNAME检查提供的日期是否为有效日期。年份必须介于0001和9999之间(包括0001和9999)、月01到12和适合该月的日期(例如，02/29仅在闰年有效)。如果日期无效，DAYNAME将发出SQLCODE-400错误(发生致命错误)。

第四十六章 SQL函数 DAY

返回日期表达式的月份日期的日期函数。

大纲

DAY(date-expression)

{fn DAY(date-expression)}

参数

• date-expression - 作为列名、另一个标量函数的结果或日期或时间戳文字的表达式。

描述

注意：DAY函数是DAYOFMONTH函数的别名。提供DAY是为了与TSQL兼容。

SELECT day("2022-02-28") AS day

28

SELECT day(+$h) AS day

5

    本文是上一篇关于如何从流行数据库（如 PostgreSQL 和 MySQL）迁移到 IRIS 的后续文章。

    我们将使用与从 PostgreSQL 迁移相同的过程。 但是，您会发现它更容易，因为 MySQL 中的数据类型与 IRIS 非常相似。 这就是为什么我们不需要在列中创建转换规则。

    获取示例数据到迁移过程

    在 GitHub 中，可以下载 docker-compose 项目来构建和运行 2 个数据库：

•     源数据库：带有示例数据库的 MySQL 数据库 Docker 实例。
•     目标数据库：InterSystems IRIS 数据平台 Docker 实例，具有用于接收源数据库的现成模式。

    要获取示例并运行它，请执行以下步骤：

    转到 git 存储库 https://github.com/yurimarx/migration-mysql-iris。
    克隆项目：https://github.com/yurimarx/migration-mysql-iris.git。
    转到项目文件夹migration-mysql-iris。
    进行构建：docker-compose build。
    执行容器：docker-compose up -d。
    如果一切正常，请使用实例检查您的 docker 桌面：

    我的几个孩子都很喜欢手工艺品，您可能会觉得作为一个父亲我会用夸张的表情表扬他们很有创意然后还拍照片发到Pinterest（世界上最大的图片社交分享网站）上去，但是我从来都没这么做过。我肯定爱我的孩子，我也确实认为他们有创意，但老实讲如果你有一个正上小学的孩子，你肯定很清楚他们实际的水平。

第四十五章 SQL函数 DATEPART

日期/时间函数，返回表示日期/时间表达式指定部分的值的整数。

大纲

DATEPART(datepart,date-expression)

参数

• datepart - 要返回的日期/时间信息的类型。日期或时间部分的名称(或缩写)。这个名称可以用大写或小写来指定，有或没有引号。datepart可以指定为文字或主机变量。
• date-expression - 从中返回datepart值的日期、时间或时间戳表达式。日期表达式必须包含datepart类型的值。

描述

DATEPORT函数以整数数据类型返回关于指定日期/时间表达式的DATEPORT信息。唯一的例外是sqltimestamp (sts)，它以数据类型%Library.Timestamp返回。要以字符串形式返回日期部分信息，请使用DATENAME。

DATEPART只返回日期表达式中一个元素的值；要返回包含多个日期部分的字符串，请使用TO_DATE。

也可以使用DATEPART()方法调用从ObjectScript调用此函数:

$SYSTEM.SQL.Functions.DATEPART(datepart,date-expression)

提供DATEPART是为了与Sybase和Microsoft SQL Server兼容。

Datepart 参数

听IRIS 专家聊IRIS，学技术，练英语听力，尽在Intersystems 系联在线培训广播电台
 https://datapoints.intersystems.com.

21. Embedded Python — Released February 3, 2022

20. The InterSystems Kubernetes Operator — Released July 27, 2021 [Transcript available]

19. What's New in Version 2021.1 of InterSystems IRIS? — Released June 3, 2021

18. The InterSystems IRIS® FHIR® Accelerator Service — Released May 5, 2021

17. The Analytics & AI Landscape — Released April 6, 2021

16. A Cloud DBMS Visionary — Released January 27, 2021

15. Writing ObjectScript in VS Code — Released November 17, 2020