第六十九章 SQL函数 JSON_OBJECT

将数据作为JSON对象返回的转换函数。

大纲

JSON_OBJECT(key:value [,key:value][,...] [NULL ON NULL | ABSENT ON NULL])

参数

• key:value - 键：值对或逗号分隔的键：值对列表。键是由单引号分隔的用户指定的文字字符串。值可以是列名、聚合函数、算术表达式、数字或字符串文字或文字NULL。
• ABSENT ON NULL NULL ON NULL - 可选-指定如何在返回的JSON对象中表示空值的关键字短语。NULL ON NULL(缺省值)表示带有单词NULL(未引号)的NULL(缺少)数据。在NULL上缺失将从JSON对象中省略NULL数据；当value为NULL且不保留占位符逗号时，它将删除key：value对。此关键字短语对空字符串值没有影响。

描述

JSON_OBJECT接受逗号分隔的键：值对列表(例如，‘MyKey’：colname)，并返回包含这些值的JSON对象。可以指定任何单引号字符串作为键名；JSON_OBJECT不强制任何命名约定或对键名进行唯一性检查。可以为值指定列名或其他表达式。

JSON_OBJECT可以在SELECT语句中与其他类型的SELECT-Items

Hi开发者们，

是时候公布 InterSystems开发者Python竞赛的优胜者了！准备好了吗！

这些开发者和他们的应用程序赢得了雷鸣般的掌声:

第六十八章 SQL函数 JSON_ARRAY

以JSON数组形式返回数据的转换函数。

大纲

JSON_ARRAY(expression [,expression][,...] [NULL ON NULL | ABSENT ON NULL])

参数

• expression - 表达式或逗号分隔的表达式列表。这些表达式可以包括列名、聚合函数、算术表达式、文字和文字NULL。
• ABSENT ON NULL NULL ON NULL - 可选-指定如何在返回的JSON数组中表示空值的关键字短语。NULL ON NULL(缺省值)表示带有单词NULL(未引号)的NULL(缺少)数据。在NULL上不存在将从JSON数组中省略空数据；它不会保留占位符逗号。此关键字短语对空字符串值没有影响。

描述

Json_array接受表达式或(更常见的)逗号分隔的表达式列表，并返回包含这些值的JSON数组。Json_array可以在SELECT语句中与其他类型的SELECT-Items结合使用。可以在可以使用SQL函数的其他位置指定json_array，例如在WHERE子句中。

返回的JSON数组格式如下：

[ element1 , element2 , element3 ]

Json_array以字符串(用双引号括起来)或数字形式返回每个数组元素值。数字以规范格式返回。

第六十七章 SQL函数 ISNUMERIC

测试有效数字的数值函数。

大纲

ISNUMERIC(check-expression)

参数

• check-expression - 要计算的表达式。

ISNUMERIC返回SMALLINT数据类型。

描述

ISNUMERIC计算check-expression并返回下列值之一：

• 如果check表达式是有效数字，则返回1。有效数字可以是数字表达式，也可以是表示有效数字的字符串。
  • 数值表达式首先转换为规范形式，解析多个前导符号；因此，诸如+-+34这样的数值表达式是有效的数字。
  • 在求值之前不会转换数字字符串。数字字符串最多只能有一个前导符号才能计算为有效数字。带有尾随小数点的数字字符串的计算结果为有效数字。
• 如果check-expression不是有效数字，则返回0。任何包含非数字字符的字符串都不是有效数字。具有多个前导符号的数字字符串(如‘+-+34’)不会被计算为有效数字。编码列表始终返回0，即使其元素是有效数字也是如此。空字符串ISNUMERIC(‘’)返回0。
• 如果check-expression为NULL，则返回NULL。ISNUMERIC(NULL)返回NULL。

如果科学记数法指数大于308(308-(整数数-1))，ISNUMERIC会生成SQLCODE-7，指数超出范围错误。

在ensemble使用中遇到过重启组件失败需要强制更新的情况，报错为作业未在10秒内停止，此时需要手动停止报错的作业，或者重新启动production，强制更新是不能解决作业不能及时停止的问题，所以目前对强制更新的使用场景有疑问

In the use of ensemble, when the component fails to restart and needs to be forced to update, the error is that the job has not stopped within 10 seconds. At this time, the error reporting job needs to be stopped manually, or the production needs to be restarted. Forced update can not solve the problem that the job cannot stop in time. Therefore, there are so me questions about the use scenarios of forced update

Hello 社区成员们，

    这篇文章是对Muhammad Waseem的 OpenExchange IRIS-Python-Apps 应用程序的介绍。 使用嵌入式 Python 和 Python Flask Web 框架构建。

投票三部曲：

1. 注册用户或登陆；

2. 成为社区活跃者获取投票资格

3. 投票

第六十六章 SQL函数 ISNULL

测试NULL并返回相应表达式的函数。

大纲

ISNULL(check-expression,replace-expression)

参数

• check-expression - 要计算的表达式。
• replace-expression - Check-Expression为NULL时返回的表达式。

ISNULL返回与Check-Expression相同的数据类型。

描述

ISNULL计算check-expression并返回以下两个值之一：

• 如果check-expression为NULL，则返回Replace-Expression。
• 如果Check-Expression不为空，则返回Check-Expression。

Replace-Expression的数据类型应该与Check-Expression的数据类型兼容。

请注意，ISNULL函数与NVL函数相同，后者是为了与Oracle兼容而提供的。

日期和时间显示转换

某些检查表达式数据类型需要从逻辑模式转换为ODBC模式或显示模式。例如日期和时间数据类型。如果替换表达式值不是相同的数据类型，则不能在ODBC模式或显示模式下转换此值，并生成SQLCODE错误：日期数据类型为-146；时间数据类型为-147

第六十五章 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最受欢迎的视频！