前言

生产环境下我们部署和使用IRiS引擎，往往采用其主备镜像模式，虽然此架构简单但是往往我们需要持续在电脑前点击或者操作1到2小时，如果中间有个环节出现了问题有时我们可能需要部署一天.

接下来我分享的是IRIS自带的一个功能帮助我们部署---manifest-安装清单。他的主要使用方式是提前通过配置约定好我们期望的安装设置，在安装的过程中由IRIS程序直接执行脚本，简化IRIS集群的部署，减少运维人员的操作步骤，让我们有更多的精力放在实际项目和业务上。

IRISHealth以其完备且系统化的安全特性在医疗行业的数据库中独树一帜，这些特性包括安全认证、安全授权、安全审计、数据加密以及安全配置。其中数据传输无疑是其中最重要的一环。为此，IRISHealth采用了SSL/TLS技术来对传输的数据进行加密，有效保障了从IRIS数据平台的超级服务数据传输、Telnet服务数据传输、java/.net/Studio客户端的访问数据传输、MIRROR与DB的数据传输，到DBServer和ECPApp之间的数据传输的安全性。

本文是在两个IRISHealth2021实例之间进行ECP服务通信的示例，一个作为DBServer，一个作为ECPApp，两个实例之间通过使用SSL/TLS的ECP协议进行TCP的加密传输通信。

1.IRIS的DB和ECP环境：

SqlDbx是我们常用的数据库查询与操作工具，因其轻量且无须安装而无处不在，然而习惯了在Intersystems的CACHE和ENSEMBLE版本下使用SqlDbx在升级到IRIS版本后却无法使用了，为此进行了一系列尝试，并最终获得成功，形成本文攻略，分享给大家。

1、在SqlDbx的连接登录窗口，从DBMS Type中直接选择 “InterSystems CACHE”连接IRIS会报错，提示“通过IRISconnect失败”，说明“InterSystems CACHE”不再适用于IRIS。

在日常Cache运维过程中可能会由于数据或者程序等原因造成锁的异常增长，导致数据库性能受到影响会出现程序报错或卡顿无法正常运行的问题。遇到此类问题需查看数据库当前锁列表情况，找到出现次数最多关键锁，根据关键锁对应的进程来判断处理。总结有以下三种方式查看关键锁。

iris 是数据平台，更是一种数据库。对于熟悉SQL语句的人来说，会认为“既然是数据库，数据应该就能使用sql语句来查询”。这是对的，但是因为有global这个概念，保存的数据可能在global里面，而没有对应的表，也可能保存在类的参数定义里面。这些数据，不能使用sql直接查询。要查询iris数据库的数据，通常有几种方式：1.直接查询表的数据。2.查询视图。3.调用存储过程(call 命令)。其中要查询“只存于global里面或者类参数里定义的数据”，只有使用存储过程。但是存储过程有个问题，就是程序如果迁移到低版本的cache数据库后，数据类型的定义会有问题，且不再支持使用select的方式，只能使用call。这对于第三方熟悉sql的人员来说很不友好。因此结合global和表的关系，介绍一种我称为“进程表”的表。进程表，指数据只存于该进程中，global的样式为"^||global名“。通常按照默认存储新加一个持久类(对应会生成一个表)，然后手动的把global改成进程global，也就是加上”||“。然后写个方法，把需要查询出来的数据写入进程global。这样就能查询出来 了。调用形式为 SELECT * FROM People WHERE People_GLB()=1。

示例如下：

1. IRIS RAG Demo

这是 IRIS 与 RAG（检索增强生成）示例的一个简单演示。
后端是使用 IRIS 和 IoP用 Python 编写的，LLM 模型是 orca-mini 并由 ollama 服务器提供。
前端是用 Streamlit 编写的聊天机器人。

浅谈一下个人基于IRIS后端业务开发框架的理解

现状

由于国内使用基于M语言IRIS平台几乎都在医疗行业。医疗系统又非常的庞大和复杂。前期由于快速占领市场，系统数量越来越多，到了临界点后就产生了质变，所以前期基于功能的线性开发注重效率，所以导致大量的产品业务代码有如下集中情况：
- 系统交互乱如麻，各系统的交互关系变成了网状。
- 系统规模庞大，内部耦合严重，牵一发而动全身，后续修改和扩展困难，开发效率低。
- 关键功能逻辑复杂，容易出现问题，出现问题后很难排查和修复，开发成本高。
- 功能越来越多，导致系统复杂度指数级上升。

- 重复造轮子，相似的功能不断重复开发。

如上图所示，这仅仅是展示了五个模块之前的交互，在此基础上继续增加模块则复杂度成指数级上升，并且如果每个模块之间如果没有做好接口管理，维护起来也是地狱级别。

这是在 IRIS 中完全运行向量搜索演示的尝试。
没有外部工具，您需要的只是终端/控制台和管理门户。
特别感谢Alvin Ryanputra作为他的软件包iris-vector-search的基础
灵感和测试数据的来源。
我的软件包基于 IRIS 2024.1 版本，需要注意您的处理器功能。

我尝试用纯 ObjectScript 编写演示。
仅描述向量的计算是在嵌入式Python中完成的

计算 2247 个记录的 384 维向量需要时间。
在我的 Docker 容器中，它正在运行 01:53:14 来完全生成它们。

前言

在日常工作中经常会遇到大量的接口开发需求，对于没有IRIS开发经验的同事来说很不友好，需要求助于公司开发人员来做接口开发，对项目联调进度多少会有些影响，本文站在没有IRIS开发经验的工作人员角度来阐述一下如何利用xslt转换文件自动生成接口联调所需要的Message模型。

基本思路是首先定义一套通用的数据模型，用来接收定义消息所需要的基础属性，包括类名，请求&响应（对应继承Ens.Request&Ens.Response），节点名称、节点长度、是否必填、默认值、字段约束等等。

前言

对于第三方接口进行交互的时候，往往需要大量的进行参数合法性校验。以前的方法就是对每个参数进行验证。如下截图：

上图的会存在大量的if else if else..,如果字段很多，那导致一个方法存在大量的验证的代码，那我们考虑是否可以进行统一的验证参数的合法性。

思路

平时建立类的时候我们可以写参数MAXLEN=100，TRUNCATE=1 是否截取等，那找找这些参数的定义地方。如截图：

那我们想要定义自己的参数，该如何定义呢？根据面向对象设计原则之一：

Manifest也许应该被翻译成“清单”， 字典上是这么解释的： 提供船舶及其货物和其他物品、乘客和船员的全面细节的文件，供海关官员使用，比如：飞机上的乘客或货物清单； 一辆货运列车的车厢清单。

在计算机语言中， Manifest可以是各种格式，用的最多的是xml和json，在IRIS中，manifest是xml格式的， 放在objectscript类的XDATA块里。

编写mainfest

IRIS用manifest来做配置。内部工具%install, 会读取manifest, 生成真正的objectscript代码来配置IRIS。我们来看个基本的例子。

基本用法

下面的User.Manifest.cls` ,它配置了IRIS的global buff, bbsize等等, 然后还创建了一个命名空间。

当系统发生严重危机，一般错误，以及其他需要管理员关注的其他事件发生时， 管理员必须及时的收到系统发出的警告信息。

上篇文章中介绍了控制台日志。这是个文本文件，包含几乎所有的系统级别的错误信息，并且有严重级别的标识，那么使用工具来监控控制台日志文件，并给管理员发送通知是可行的方案吗？

当然。实际上，有些用户正是这样来管理Caceh'/IRIS的。他们有自己熟悉的监控工具，实时读取控制台日志，分析内容，并完成警告通知的发送。

这篇文章我来介绍的是Cache'/IRIS内置的处理警告的机制和配置方法。 通过把严重的错误和事件写入另一个文本文件alert.log，并配置邮件，SNMP, API接口发送通知，可以基本的实现caceh'/IRIS系统的警告通知工作。

Alerts.log

控制台日志中最严重的两个级别(级别2和3)， 的记录会被写入另一个文本文件，名字是Alert.log。 默认存储于\installDir\mgr\路径。

• 在操作门户中“系统>系统日志>控制台日志” ，你会发现 Alerts.log的内容会以红色的字体显示在最上方。比如下图中有2个严重级别的Alert。

第二十章 开发Productions - ObjectScript Productions - 指定设置的默认值

当定义业务主机类（可能还有适配器类）时，应该考虑如何控制这些项目的任何设置的默认值。 IRIS 可以从三个来源之一获取设置的默认值：
- production定义。
- 为 IRIS 实例定义的值，但存储在production定义之外。有关信息，请参阅配置制作中的定义制作默认值。
- 主机类中定义的属性的默认值。在这种情况下，默认值由 InitialExpression 属性关键字确定。

某些设置取决于环境，例如 TCP/IP 地址或文件路径；通常，将这些设置配置为在生产之外提供它们的源，而其他设置（例如 ReplyCodeActions）是设计决策，并且很可能开发应用程序以从生产定义中检索这些设置。

可以开发作品，使配置设置来自不同的来源。主要目的是更轻松地将制作从一个 IRIS 实例转移到另一个实例，例如从测试转移到现场。

这是在 Ensemble 中实现“微服务”设计的初学者指南。 “微服务”是当今流行的一个词，具有广泛的解释。我的解释是：“微服务”是一种“NoSQL 服务”。一个什么？答案在文章中。

我们了解了 SQL 和 NoSQL 数据库之间的区别。对我来说，SOA Web 服务和“微服务”之间的区别几乎相同。我将通过一个例子来解释它。

请注意，虽然这是一本初学者指南，但我假定我对数据建模、RESTful 服务和 Ensemble 有深入的技术知识。

航班预订——示例

我的例子很简单。我想为我的家人订一张机票。我使用www.skyscanner.hu ，但它可以是任何预订网站。那我该怎么办？在着陆页上，我输入了航班信息：我需要从布达佩斯到布拉格并返回的机票，10 月²⁹日起飞，11 月 1^日返回，直飞航班，经济舱四人。提交搜索表单后，我会返回可用选项。我选择一个并输入乘客详细信息、折扣计划，最后通过 PayPal 付款。直截了当。

在更详细的版本中：后台发生了什么。

n 开始预订