第123章 SQL函数 SEARCH_INDEX

从索引的 Find() 方法返回一组值的函数。

大纲

SEARCH_INDEX([[schema_name.]table-name.]index-name[,findparam[,...])

参数

• table-name - 可选 — 为其定义了 index-name 的现有表的名称。不能是一个视图。表的 schema_name 是可选的。如果省略，则搜索 FROM 子句中指定的所有表。
• index-name - 要搜索的索引。现有索引的索引映射的 SqlName。
• findparam - 可选 — 要传递给索引的 Find() 方法的参数或逗号分隔的参数列表。

描述

SEARCH_INDEX 调用 index-nameFind() 方法并返回一组值。可以选择将参数传递给此 Find() 方法。例如，SEARCH_INDEX(Sample.Person.NameIDX) 调用 Sample.Person.NameIDXFind() 方法。

SEARCH_INDEX 可以与 WHERE 子句中的 %FIND 谓词一起使用，以提供对象的 oref，该对象提供封装一组值的抽象表示。这些值通常是查询运行时调用的方法返回的行 ID。 SEARCH_INDEX 调用索引的 Find() 方法来返回这个 oref。此用法显示在以下示例中：

    我一直希望 VSCode 能够拥有熟悉的 Studio 外观。

    值得庆幸的是，VSCode 易于定制，因此您可以为任何元素选择任何颜色。

    这是我到目前为止得到的：

Kong提供了一个开源的配置管理工具（用Go语言编写），称为decK（代表声明式Kong）

• 通过deck ping检查deck是否能识别你的Kong Gateway安装

deck ping   
Successfully connected to Kong!
Kong version:  2.3.3.2-enterprise-edition

• 通过deck dump把 Kong Gateway配置倒出到 "kong.yaml" 文件 

deck dump

• 修改 kong.yaml以后通过deck diff 通过把区别显示出来

在一次重大的版本升级中，建议重新编译你所有命名空间的类和例程。 (主要版本的安装后任务).

do $system.OBJ.CompileAllNamespaces("u")

do ##Class(%Routine).CompileAllNamespaces()

为了自动完成这项管理任务并记录任何错误，下面是一个导入并编译到USER命名空间的类的例子，你可以在每次升级后使用它 : admin.utils.cls

InterSystems流程自动化与工作流引擎

InterSystems工作流程引擎的主要功能    2

使用InterSystems工作流程引擎    3

场景描述    3

环境配置与测试    5

任务管理    15

任务API和自定义任务用户界面    16

展望    17

15

集成平台除了集成业务系统，打通数据与业务流程外，另一个核心的功能就是流程自动化(BPA)。

流程自动化涉及几个重要的特性：

1. 流程建模
2. 流程协同
3. 决策自动化
4. 低代码工作流程自动化
5. 任务协同与任务管理

其中第4和5点都是和工作流程相关的。

什么是工作流程(Workflow)？它和业务流程(Business Process)有何区别？为何集成平台要涉及对工作流程的管理？

在HIMSS 2022的一次讨论中，小组成员讨论了长期执行登陆火星任务的健康挑战，以及新的交互如何保证宇航员的安全。

将人类送上火星的任务是一项艰巨的任务。但是在这些开创性的旅程中，对宇航员健康主要风险相关的关注却小得令人吃惊。

"你会认为太空飞行真的很复杂，但我们把它归结为五个方面，"美国宇航局总部NASA的首席科学家和科技利用经理朱莉-罗宾逊在HIMSS22的一个小组讨论会上说。

"而且我们在地球上以及在当前和计划中的太空任务中模拟了未来的火星任务。我们利用我们所做的每一次任务来推进我们对如何在未来任务中保持船员安全和健康的理解。" 

载人航天飞行期间的这五个主要危险包括：辐射；隔离和禁闭，如长期与相同的人困在一个狭小的空间里的行为和社会心理影响；远离地球，因为你不能离开或迅速与家乡的其他人沟通；失重；以及不友好和封闭的环境，因为宇航员不断重复使用水和重新呼吸相同的空气。

但是美国宇航局可以在地球上和国际空间站上模拟其中一些健康风险，为前往火星的长期任务做准备。这也是将人类送回月球的Artemis计划的一个目标。

Artemis计划将对这些重力、辐射、环境和隔离风险提供一个更好的模拟。当然，月球比火星离家近得多，通信延迟将短得多。

"如果在去火星的路上真的出了问题，船员还是会去火星。”罗宾逊说："不管是死是活，船员都会去火星，因为物理学定律不会让你更快地回来。

第122章 SQL函数 RTRIM

字符串函数，它返回一个删除了尾随空格的字符串。

大纲

RTRIM(string-expression)

{fn RTRIM(string-expression)}

参数

• string-expression - 字符串表达式，可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。

描述

RTRIM 从字符串表达式中去除尾随空格，并将字符串作为 VARCHAR 类型返回。如果 string-expression 为 NULL，则 RTRIM 返回 NULL。如果 string-expression 是一个完全由空格组成的字符串，则 RTRIM 返回空字符串 ('')。

无论要裁剪的输入表达式的数据类型是什么，RTRIM总是返回数据类型VARCHAR。

RTRIM 留下前导空白；要删除前导空格，请使用 LTRIM。要删除任何类型的前导和/或尾随字符，请使用 TRIM。要使用尾随空格或其他字符填充字符串，请使用 RPAD。要创建一串空白，请使用 SPACE。

请注意，RTRIM 可用作 ODBC 标量函数（使用大括号语法）或 SQL 通用函数。

示例

以下嵌入式 SQL 示例从字符串中删除了五个尾随空格。它留下五个前导空白：

基于Docker的Apache Web Gateway

Hi 社区

在本文中，我们将基于Docker程序化地配置一个Apache Web Gateway，使用。:

• HTTPS protocol.
• TLS\SSL to secure the communication between the Web Gateway and the IRIS instance.

我们将使用两个镜像：一个用于Web网关，第二个用于IRIS实例。

所有必需的文件都在这 GitHub repository.

我们从git clone开始:

git clone https://github.com/lscalese/docker-webgateway-sample.git
cd docker-webgateway-sample

准备系统

为了避免权限方面的问题，你的系统需要一个用户和一个组:

• www-data
• irisowner

需要与容器共享证书文件。 如果你的系统中不存在这些文件，只需执行:

sudo useradd --uid 51773 --user-group irisowner
sudo groupmod --gid 51773 irisowner
sudo useradd –user-group www-data

生成证书

在这个示例中，我们使用以下三个证书:

第121章 SQL函数 RPAD

字符串函数，它返回一个右填充到指定长度的字符串。

大纲

RPAD(string-expression,length[,padstring])

参数

• string-expression - 字符串表达式，可以是列名、字符串文字、主机变量或另一个标量函数的结果。可以是可转换为 VARCHAR 数据类型的任何数据类型。字符串表达式不能是流。
• length - 整数，指定返回的字符串中的字符数。
• padstring - 可选 — 由一个字符或一串字符组成的字符串，用于填充输入字符串表达式。 padstring 字符或字符附加到 string-expression 的右侧，以提供创建长度字符的输出字符串所需的尽可能多的字符。 padstring 可以是字符串文字、列、主机变量或另一个标量函数的结果。如果省略，则默认为空格字符。

描述

RPAD 用尾随填充字符填充字符串表达式。它返回填充到长度字符数的字符串的副本。如果字符串表达式的长度超过 length 个字符，则返回字符串被截断为 length 个字符。

如果 string-expression 为 NULL，则 RPAD 返回 NULL。如果 string-expression 为空字符串 ('') ，则 RPAD 返回一个完全由填充字符组成的字符串。返回的字符串是 VARCHAR 类型。

第120章 SQL函数 ROUND

以指定位数舍入或截断数字的数值函数。

大纲

ROUND(numeric-expr,scale[,flag])

{fn ROUND(numeric-expr,scale[,flag])}

参数

• numeric-expr - 要四舍五入的数字。一个数值表达式。
• scale - 计算结果为整数的表达式，该整数指定要舍入到的位数，从小数点开始计数。可以是零、正整数或负整数。如果 scale 是小数， 会将其四舍五入为最接近的整数。
• flag - 可选 — 一个布尔标志，指定是舍入还是截断 numeric-expr：0=round, 1=truncate。默认值为 0。

ROUND 返回与 numeric-expr 相同的数据类型。

描述

此函数可用于将数字舍入或截断为指定的小数位数。

ROUND 将 numeric-expr 舍入或截断以缩放位置，从小数点开始计数。舍入时，数字 5 始终向上舍入。在 ROUND 循环或截断操作后删除尾随零。不返回前导零。

问题： 通过JDBC连接Oracle19C数据报错 "ORA-28040: No matching authentication protocal"

解决 : 1、在数据库服务器上找到sqlnet.ora文件，一般在oracle安装目录app/oracle/product/19.0.0.0/db_1/network/admin/sqlnet.ora

2、如果有进行修改，没有直接创建

3、slqnet.ora文件新增或修改以下 SQLNET.ALLOWED_LOGON_VERSION_SERVER=8 SQLNET.ALLOWED_LOGON_VERSION_CLIENT=8

4、注意事项： ① 如果没有sqlnet.ora文件可以直接创建 vi sqlnet.ora ② 如果有不能直接vi 需要使sed -a 命令追加，否则会导致ora文件乱码 ③ 添加参数后新无需重启数据库或者监听，但是需要修改用户密码，否则会报错

5、修改用户名密码

sqlplus / as sysdba

alter user 用户名 identified by 新密码;

第119章 SQL函数 RIGHT

标量字符串函数，它从字符串表达式的末尾（最右边的位置）返回指定数量的字符。

大纲

{fn RIGHT(string-expression,count)}

参数

• string-expression - 字符串表达式，可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。
• count - 整数，指定从 string-expression 的结束（最右边）位置返回的字符数。

描述

RIGHT 从字符串表达式的末尾（最右边的位置）返回 count 个字符。如果为任一参数传递 NULL 值，RIGHT 将返回 NULL。

RIGHT 只能用作 ODBC 标量函数（使用大括号语法）。

示例

以下示例返回 Sample.Person 表中每个名称最右边的两个字符：

SELECT Name,{fn RIGHT(Name,2)}AS MiddleInitial
     FROM Sample.Person

以下嵌入式 SQL 示例显示 RIGHT 如何处理比字符串本身长的计数：

以下示例代码可实现在Java中通过JDBC向IRIS数据库中写入Stream数据，插入的该Stream大小约为4M，对应在IRIS中字段类型为%Stream.GlobalCharacter。以下代码在IRIS2021上测试成功，供大家参考，

Java代码，

第118章 SQL函数 REVERSE

标量字符串函数，它以相反的字符顺序返回一个字符串。

大纲

REVERSE(string-expression)

参数

• string-expression - 要反转的字符串表达式。表达式可以是列名、字符串文字、数字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。

描述

REVERSE 返回字符顺序颠倒的字符串表达式。例如 'Hello World!' 返回为 '!dlroW olleH'。这是一个简单的字符串顺序反转，没有额外的处理。

返回的字符串是数据类型 VARCHAR，与输入值的数据类型无关。数字转换为规范形式，数字字符串在反转之前不会转换为规范形式。

前导和尾随空白不受反转的影响。

反转 NULL 值会导致 NULL。

注意：因为 REVERSE 总是返回一个 VARCHAR 字符串，所以某些类型的数据在反转时会变得无效：

• 反向列表不再是有效列表，无法从存储格式转换为显示格式。
• 反转日期不再是有效日期，并且无法从存储格式转换为显示格式。

示例

以下示例反转 Name 字段值。在这种情况下，这会导致名称按中间名首字母排序：

SELECT Name,REVERSE(Name) AS RevName
FROM Sample.Person
ORDER BY RevName

附件中的压缩文件包含了一些我多年来所做的Cache SQL Storage映射的例子。

如果你有现有的globals，并且想通过Objects或SQL暴露它们，你需要设置Cache SQL Storage映射。  如果你没有看到对你的情况有帮助的例子，请给我发一个例子，我可以帮你解决。

下载附件：https://community.intersystems.com/sites/default/files/post-associated-…

开发者们好, 

我们在Bilibili的”InterSystems中国“频道 发布了新的视频！

本文档只是给您一个大致的概念，方便您了解IRIS安装的方方面面。并非官方安装手册或者安装建议。生产环境的安装请仔细研究并参照IRIS官方的安装文档

操作系统的选择

IRIS支持多种Linux系统。详细的列表请参见各个版本的支持列表，比如这个是最新的2021IRIS的支持列表。需要注意的是, CentOS只支持作为测试系统, 并不支持生产系统的安装。

官方文档是以Redhat为主介绍的IRIS安装， 这是IRIS在生产环境中最常用的Linux系统之一。另一个Ubantu， InterSystems提供的docker版本是安装在Ubantu上的。

我自己测试的时候喜欢使用CentOS, 所以后面有具体安装步骤中，使用的CentOS上的记录。

服务器的配置

对于生产系统，安装前需要一个硬件配置方案，这个方案通常是您的项目的实施部门根据用户需求提供的。

对于测试系统，只有一个最小的磁盘的要求：1.5G。无论是实体服务器， 虚拟服务器，或者docker container，根据您要测试的内容， 一切以方便为准。如果不做性能测试，我个人经常使用的CentOS虚拟机是2核CPU, 2G或4G内存，没有运行不流畅的问题。

磁盘分区

标准的Linux磁盘分区并不适合IRIS的生产运行。哪怕要创建一个尽量接近生产的测试环境，建议您安装软件前要有一个完整的磁盘分区规划。在官方文档中，创建IRIS服务器分区有以下原则：

第117章 SQL函数 REPLICATE

将字符串重复指定次数的字符串函数。

大纲

REPLICATE(expression,repeat-count)

参数

• expression - 要重复的字符串表达式。
• repeat-count - 重复的次数，以整数表示。

描述

注意：REPLICATE 函数是 REPEAT 函数的别名。提供 REPLICATE 是为了与 TSQL 兼容。有关详细信息，请参阅重复。

有很多方法可以使用Intersystems生成excel文件，其中一些是ZEN报告、IRIS报告（Logi报告或正式称为JReports），或者我们可以使用第三方Java库，可能性几乎是无限的。

但是，如果你想只用Caché ObjectScript创建一个简单的电子表格呢？(没有第三方应用程序)

在我的案例中，我需要生成包含大量原始数据的报告（财务人员喜欢这些数据），但是我的ZEN/IRIS失败了，给了我一个我想称之为 "零字节的文件"，基本上说java的内存用完了，并导致报告服务器上的重载。

这可以用Office Open XML（OOXML）来完成。Office Open XML格式是由一个ZIP包内的一些XML文件组成的。因此，基本上我们需要生成这些XML文件，并将其压缩重命名为.xslx。就这么简单。

这些文件遵循一套简单的惯例，称为开放包装惯例。你需要声明各部分的内容类型，以及告诉消费应用程序应该从哪里开始。

为了创建一个简单的电子表格，我们至少需要5个文件。

• workbook.xml
• worksheet.xml
• [Content_Types].xml
• styles.xml
• _rels
  • .rels
  • workbook.xml.rels

第116章 SQL函数 REPLACE

字符串函数，用于替换字符串中的子字符串。

大纲

REPLACE(string,oldsubstring,newsubstring)

参数

• string - 作为子字符串搜索目标的字符串表达式。
• oldsubstring - 字符串中要匹配的子字符串。
• newsubstring - 用于替换 oldsubstring 的子字符串。

描述

REPLACE 在字符串中搜索子字符串并替换所有匹配项。匹配区分大小写。如果找到匹配项，它将用 newsubstring 替换 oldsubstring 的每个实例。替换子串可能比它替换的子串长或短。如果找不到子字符串，则 REPLACE 将原样返回原字符串。

无论字符串的数据类型如何，REPLACE 返回的值始终是数据类型 VARCHAR。这允许替换操作，例如 REPLACE(12.3,'.','_')。

REPLACE 不能对字符串、oldsubstring 或 newsubstring 参数使用 %Stream.GlobalCharacter 字段。尝试这样做会生成 SQLCODE -37 错误。

空字符串是字符串值。因此，可以将空字符串用于任何参数值。但是，请注意 ObjectScript 空字符串作为 NULL 传递给 SQL。

各位开发者们好,

欢迎在我们的 Bilibili 频道观看新视频：

各位开发者们好, 

InterSystems IRIS 数据平台的最大特点之一是它允许您创建自己的自定义，您可以使用InterSystems IRIS 中支持的所有其他模型，例如对象和关系结构，而无需创建任何自定义结构。

⏯  InterSystems Globals与灵活的数据建模 Globals

<iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen="" frameborder="0" height="315" width="650" scrolling="no" src="//player.bilibili.com/player.html?aid=980348263&bvid=BV1s44y1P78C&cid=563611041&page=1"></iframe>

第115章 SQL函数 REPEAT

将字符串重复指定次数的字符串函数。

大纲

REPEAT(expression,repeat-count)

{fn REPEAT(expression,repeat-count)}

参数

• expression - 要重复的字符串表达式。
• repeat-count - 重复的次数，以整数表示。

描述

REPEAT 返回一串重复计数的表达式实例，连接在一起。

如果表达式为 NULL，则 REPEAT 返回 NULL。如果 expression 是空字符串，则 REPEAT 返回一个空字符串。

如果重复计数是小数，则仅使用整数部分。如果重复计数为 0，则 REPEAT 返回一个空字符串。如果重复计数是负数、NULL 或非数字字符串，则 REPEAT 返回 NULL。

示例

以下示例显示了 REPEAT 的两种形式。两个示例都返回字符串“BANGBANGBANG”：

SELECT REPEAT('BANG',3) AS Tripled

BANGBANGBANG

SELECT {fn REPEAT('BANG',3)} AS Tripled

BANGBANGBANG

在最近一次探索马里兰小镇的 "度假 "期间，我偶然发现了一家非常令人愉快的书店，在那里我愉快地消磨了一下午。我和我的家人都是读者，喜欢各种类型的书--新的、二手的、印刷的、电子的。我们尽量在当地购物，以帮助零售店保持运营。

这次访问促使我思考图书行业所发生的事情与我们的医疗保健系统所发生的事情之间的一些相似之处。

医疗保健行业与图书行业的趋势

数字化

我们阅读内容的格式已经发生了根本性的变化。在2020年，电子书几乎占美国市场的四分之一。音频书占美国图书收入的10亿美元。许多印刷书籍是按需出版的，而不是保存在库存中。同样，医疗保健早已不再是一个“伸出舌头说啊 ”的行业，基因组测试、由人工智能算法读取的X射线、可植入设备和远程医疗访问已经改变了医疗的面貌。

虚拟服务

书店现在有多种形式，医疗机构也是如此。订阅图书服务，从当地独立的小公司、大的连锁店、电子零售的网上订单。而与你的本地门诊竞争的是你手机上的一个应用程序。同样，你的治疗师可能是一个机器人，你的基层医疗服务可能由你社区附近药店的驻店医师提供，你可能在一个办公园区做手术。在所有这些竞争中，我们如何确保在我们需要时仍有健康的、提供全面服务的医院？

更智能的算法

在IRIS容器里添加VSCode

设置可重复的开发环境的最简单的方法之一是使用容器。我发现在快速迭代时，在我的开发环境容器里托管一个vscode实例是非常方便的。因此，我创建了一个快速的容器脚本，将一个基于浏览器的vscode添加到IRIS容器中。这应该适用于大多数2021.1以上的容器。我的代码库可以在这里找到

带VSCode 且预连接好的InterSystems IRIS 容器

概要

这个项目创建了一个IRIS容器，在同一个IRIS容器中提供了vscode的托管（web-based）版本。这提供了：

• 同样的容器代码编辑
• 预连接到容器内的IRIS 实例
• 管理门户里的链接
• 自动启动IDE

快速启动

第114章 SQL函数 RADIANS

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

大纲

RADIANS(numeric-expression)

{fn RADIANS(numeric-expression)}

参数

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

RADIANS 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，RADIANS 返回 DOUBLE；否则，它返回 NUMERIC。

RADIANS 可以指定为标准标量函数或带有大括号语法的 ODBC 标量函数。

描述

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

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

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

示例

以下嵌入式 SQL 示例以 30 度为增量返回与从 0 到 365 的度值对应的弧度等效值：

第113章 SQL函数 QUARTER

日期函数，它将一年中的季度作为日期表达式的整数返回。

大纲

{fn QUARTER(date-expression)}

参数

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

描述

QUARTER 返回一个从 1 到 4 的整数。季度是针对 日期整数、$HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串或时间戳计算的。

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

四个季度的时间段如下：

8. 应用安全

InterSystems数据平台上可能运行着多种应用，例如Web网页应用、SOAP服务、REST API、HL7 接口、SQL服务等等。这些应用种类繁多，面临的安全风险也是巨大的，例如代码注入攻击和HTTP的跨站请求伪造攻击等。

这其中代码注入攻击和针对Web应用的攻击尤其需要重视。

8.1 代码注入攻击

代码注入攻击通常和我们编写的程序相关，需要在程序编写时注意避免。

8.1.1 SQL注入攻击

SQL注入攻击是典型的代码注入攻击，通过从外部注入恶意SQL语句获得数据权限并获得敏感数据。关系型访问方式都是通过客户端SQL语句传入执行的，因此它是数据库重点需要防范的。

InterSystems数据平台并不支持以分号分割的多条SQL语句作为一个SQL命令执行，因此它本身免疫了主要的SQL注入攻击手段。

InterSystems数据平台支持动态SQL，即允许SQL命令作为方法的字符串参数传入，这会给SQL注入攻击留有隐患。在编程时，应避免开放服务用于接受完整的SQL语句作为参数，而是通过SQL动态传参来构建运行时SQL。

InterSystems数据平台支持行级安全，这有助于避免在SQL注入攻击时，将所有数据返回给攻击请求。

8.1.2 $ZF

第111章 SQL函数 PREDICT

IntegratedML 函数，它应用指定的训练模型来预测提供的每个输入行的结果。

大纲

PREDICT(model-name )

PREDICT(model-name USE trained-model-name )

PREDICT(model-name WITH feature-columns-clause )

PREDICT(model-name USE trained-model-name WITH feature-columns-clause )

描述

PREDICT 是一个 IntegratedML 函数，可用作 SELECT 选择项以返回将经过训练的机器学习模型应用于指定查询的结果。