InterSystems IRIS 是一个完整的数据平台
InterSystems IRIS 为您提供了捕获、共享、理解组织最宝贵的资产（数据）并采取相应行动所需的一切。
作为一个完整的平台，InterSystems IRIS 不需要集成多种开发技术。应用程序需要更少的代码、更少的系统资源和更少的维护。
在本文中，我们将使用基于分布式存储的 Kubernetes 部署来构建一个 IRIS 的高可用配置，而不使用“传统的”IRIS Mirror。 这种部署将能够容忍与基础架构相关的故障，如节点、存储和可用区故障。 所描述的方法可以大大降低部署的复杂性，代价是 RTO的略微延长。
VSCode中安装InterSystems Language Server后，EXPLORER资源树使用Ctrl+F可以打开文件检索框，快速检索文件。 不知是VSCode版本更新不支持了，还是InterSystems Language Server更新，导致在EXPLORER资源树无法快速检索文件
首先，祝开发者社区的各位成员新年快乐！ 我们希望今年为大家带来更多好东西，今天我想介绍 VS Code的最新版 Intersystems Language Server 扩展程序。 大多数 Language Server 改进都可以通过 ObjectScript 扩展 UI 体验到，因此您可能不知道 2024 年我们发布了 Intellisense 和鼠标悬停等方面的许多改进。 请快速浏览 Language Server 更新日志 看看您错过了什么。 最近发布的2.7.0 版本带来了对 Windows ARM 平台的支持，因此，如果您使用 Surface Pro 11 这类设备（我正在用这台设备愉快地写这篇帖子），那么您现在可以在您的设备上获得出色的 ObjectScript 开发体验。 赶快试用一下，并在下方评论区中分享您的使用心得。
InterSystems IRIS、InterSystems IRIS for Health 和 HealthShare Health Connect 的最新扩展维护版本现已发布。
版本 2024.1.3 修复了 2024.1.x 上一版中的 bug，包括针对最近发布的以下提醒的修复 – 提醒：在执行特定的操作时，数据库和日志文件中引入了无效数据…。
您可以在以下页面上找到详细的变更列表和升级核对清单：
软件以经典安装包和容器镜像两种形式提供。有关可用安装程序和容器镜像的完整列表，请参阅支持的平台网页。
InterSystems IRIS 和 InterSystems IRIS for Health 的完整安装包可从本 WRC 的 InterSystems IRIS 数据平台完整套件页面获取。 HealthShare Health Connect 套件可从 WRC 的 HealthShare 完整套件页面获取。
容器镜像可通过 InterSystems 容器注册表获取。
这些版本中的所有套件和容器的编号为：
近期有些小伙伴需要查询某张特定的表所占用的磁盘大小，可能其他小伙伴也有类似的需求。
给大家一个例子供参考。
应当考虑到IRIS的表底层使用global存储数据，包括表数据、索引数据和流数据（如果表中有流属性的话），因此一张表的完整占用应当包含至少上述三种global的求和，如下所示：
ClassExtends%RegisteredObject上述代码定义了一个SQL函数，可以通过SQL直接查询，效果如下：
.png)
其中，HCC为表所在的数据库，Test.Test是测试用的数据表。返回的结果统计单位是MB。
读者可以在这个demo基础上添加些自己需要的其他特性和异常处理。现在这个函数返回的是系统分配给表的占用（不一定真用完了），读者可以参考在线文档中的API说明，获得更多详细的信息，例如要获取实际占用的空间而不是已分配的空间，应该如何调用API等。
InterSystems 已更正导致在使用特定 $LIST 语法时引入无效数据库和日志记录的缺陷。 遇到此缺陷的可能性非常低，但它对操作的影响可能会很大。
受影响的产品
该问题仅影响 Unicode 安装。
使用以下语法在 global 中向列表附加新元素时，会出现此问题：
SET $LIST(<global reference>, *+1) = value.
当此调用的结果列表超出最大字符串长度时，正确的行为是返回 <MAXSTRING> 错误。此错误会出现在 InterSystems IRIS、InterSystems IRIS for Health 和 Health Connect 2023.
我们已经有一段时间没有在开发者社区上发表关于嵌入式 Git 的文章了，我想借此机会更新一下今年我们完成的大量工作以及未来的工作计划。
如果您要在 IRIS 上构建解决方案，并想要使用 Git，那就太棒了！ 只需将 VSCode 与本地 Git 仓库结合使用，并将更改推送到服务器上即可，就是这么简单。
但在以下使用场景中该怎么办：
在以上任何情况下，您都非常需要嵌入式源代码控制。
2024.3 版 InterSystems IRIS® 数据平台、InterSystems IRIS® for Health 和 HealthShare® Health Connect 现已正式发布 (GA)。
在此版本中，您可以期待一系列激动人心的更新，包括：
请通过开发者社区分享您的反馈，与我们共同打造更好的产品。
请访问以下链接了解所有亮点功能的详细信息：
此外，请查看此版本的升级信息。
目前提供多个 EAP。 请查看此页面并注册您感兴趣的计划。
像往常一样，持续交付 (CD) 版本包含适用于所有受支持平台的经典安装包，以及 Docker 容器格式的容器镜像。
InterSystems IRIS® 数据平台、InterSystems IRIS® for Health 和 HealthShare® Health Connect 2025.1 的首个开发者预览版已发布到 WRC 开发者预览网站。容器可在我们的容器注册表中找到，并已添加 latest-preview 标签。
这些开发者预览版包含用于迁移到 IBM Open XL C/C++ for AIX 17.x 编译器的功能，从而在旧版编译器接近支持终止时确保与未来的 AIX 版本兼容。 此迁移侧重于 aixopenssl30 目标，支持 AIX 7.2 和 7.3 上的 SSL3。
可以在以下链接中找到初始文档：
此版本提供适用于所有受支持平台的经典安装包。有关完整列表，请参阅“支持的平台”文档。
安装包和预览版密钥可从 WRC 的预览版下载网站或通过评估服务网站（勾选“Show Preview Software”（显示预览软件）框）获取。
java如何使用IRIS sdk这个方法创建MIRROR
.png)
许多使用InterSystems IRIS的用户在调试代码的时候习惯使用命令行的方式，比如运行一个函数查看输出或者查看代码运行过程中保存在global中的数据等等。
对于将 InterSystems IRIS 安装在 Windows 操作系统的用户，只需要点击右下角图标选择Terminal 就可以很方便的使用。
但是对于将其安装到 Linux 或者Docker 容器中的用户，要使用命令行却不那么方便，下面我将会介绍在我们 Openexchange 中的一个应用 -- Web Terminal。
也就是说可以在网页中直接执行Terminal中的命令。
或者查看SQL执行结果：
可以在其中输入 /help ，获取更多帮助信息
1. 点击进入项目下载页面，选择下载最新的版本。
2. 在任意的命名空间下导入下载的xml文件。
注意在这里选择导入文件的同时也要勾选上 “编译导入的项”
3. 之后会出现下面提示导入成功的提示
请将下载的 WebTerminal-v4.9.3.xml 文件编辑做下面修改
1 . 第1611行：修改为
set requiredRole = "%DB_IRISSYS"2. 第1730行：修改为
set dbPrefix = "IRIS"重新导入就可以了。
Web Terminal 已经存在相当长一段时间了，但它存在诸多限制，并非所有功能都能正常使用。它不支持 shell，也没有诸如嵌入式 Python 支持这样的最新功能。对于那些需要编程模式的工具来说，存在一些问题。基本身份验证也不如简单的登录页面便捷，使用登录页面的话，倘若你想要改变登录应用程序的方式（比如使用单点登录，即 SSO），你还可以自行添加登录页面。
通过将最初的iris terminal 封装到一个网页表单中，利用在网络领域应用极为广泛且同样被像 Visual Studio Code（VSCode）这类工具所使用的 xterm.js，并借助 Python 施展的一些 “魔法”（这些 “魔法” 有助于实现进程间的终端交互），我们就能在网络上完整地实现终端功能了。
安装方法
在
zn"%SYS""install iterm"
为了测试它是如何在web中工作的，可以执行 term routine，如下
现有一个数据表的数据像这样：
.png)
我们的需求是基于表中的Item列新增一个status字段，如果item的内容是第一次出现，那么status列就是New，反之显示Old,
比如，应该是下面的显示内容
在原文章的回复中， Robert Cemper给出了下面的建议
新建一个存储过程，并在SELECT查询语句中生效：
/// Return NEW for first occurance of item /// otherwise return OLDClass使用下面SELECT语句使之生效：
Status结果如下：
ID date item Status
技术支持团队在不同的项目中发现了类似中间人攻击的情况， 和各位分享一下。
我们的系统一般是安装在内网里，没有恶意的中间人攻击的风险。但是在有些医院发现了这样的情况：IT在网络中安装了某种网络监控或者嗅探的设备， 它会在通信通道中模拟其中一方，或者双方的通信节点， 以截获通信双方的网络流量。通常它不影响双方的通信，但偶尔，它会中断双方的连接， 造成业务的中断。实质上这也是一种中间人攻击的情况，只不过这是用户允许的行为，偶然出现了故障。
我们看看以下的例子:
以下的wireshark抓包截图中， 172.18.1.131和172.18.1.145在正常的通信过程中， 忽然收到了RST消息，造成了TCP连接上的复位。
.png)
其中172.18.1.131是intersystems的health connect系统， 它在序号50134的包里面首先发送了RST，因此客户怀疑是不是Health Connect出错，中断了连接，也就把问题提交了InterSystems的技术支持。
我们的技术支持检查了各种内部日志，没有发现任何错误，咨询了InterSystems的网络专家，才发现这是个网络层的错误，也就是说： 这个RST不是Health Connect发送的， 同样， 序号50135的RST消息， 也不一定是172.18.1.145发送的，这是中间网络层的行为。
.png)
当我们将 InterSystems IRIS 安装在Windows 系列操作系统中时，往往同时使用IIS 作为其Web 服务器。
但这时候我们却发现，由RESTful返回的错误信息却不能正常显示出来了，特别是在调试程序的时候，非常不方便。
比如在测试 FHIR Post/Put 请求时，我们的请求消息体中包含不正确的内容，这时我可以看到返回的是HTTP 400 Bad Request的返回内容.
我无法具体知道请求消息体哪句出错了，这对我调试程序造成很大困扰。
解决方法：
1. 打开IIS的管理页面，双击 错误页
2. 选择右侧 编辑功能设置
3. 选择错误响应下的 详细错误 选项。
我们再次请求，此时可以看到页面上显示了详细的错误信息
相关详细信息可以查看文档：Configuring IIS to Return SOAP Fault Details 以及 HTTP Errors
READ 命令从服务器或客户端发出 READ 命令以读取客户端或服务器设置的任何字符。
语法如下：
READ var:timeout
READ *var:timeout
READ var#length:timeout
超时参数虽然是可选的，但强烈建议使用，因为如果指定了超时，则 READ 的成功或失败由 $TEST 特殊变量的值指示。如果在超时到期之前读取尝试成功，则 设置为 ；如果超时到期， 设置为 。
超时参数支持秒和秒的分数到 秒。例如，、、、。
对于 连接，如果连接建立后另一方从未发出读或写命令，则作业可以等待第一个读或第一个写命令。在这种情况下， 支持 READ 命令的读取超时和 命令的写入超时（使用 选项）。如果没有指定读或写超时，则作业将等待，直到对方发出读或写命令。
可以使用 类的 方法确定当前 TCP 连接执行的读取次数。
应用程序可以通过测试 和 的值来了解连接和读取是如何成功的。
报告连接状态。当设置 位 () 时，此 设备在服务器模式下运行。当设置 位 () 时，设备当前处于与远程主机通信的连接状态。
| $ZA Value | $TEST Value | Meaning |
|---|---|---|
| 4096 | 0 |
我们公司在和其他公司合作，需要从Cache2016的数据库中执行sql获取数据
sql的内容是调用存储过程
CALL DHCXXXXice.MKPIQuery_QueryXXXX('K007XXXX.JJR','2024-08-01','2024-08-01')
在java代码中执行会报错误如下
但是通过数据库连接工具却能查询到结果
通过数据库连接工具查询到 该存储过程，可接收参数为8个
尝试 CALL DHCXXXXice.MKPIQuery_QueryXXXX('K007XXXX.JJR','2024-08-01','2024-08-01',null,null,null,null,null)
在通过java连接查询时，依然报Parameter list mismatch错误
通过jdbc连接工具依然能查出结果
Automating Configuration of InterSystems IRIS with Configuration Merge
CPF merge通过合并一个人工编辑的merge file, 自动的配置新创建的iris instance， 或者修改已有的iris instance。适用于：
Caché 和早期的IRIS版本提供了manifest功能，用来做IRIS实例的配置。 Manifest很繁琐，而且各个版本的配置中有细微的区别，非常难以管理。 如今有了CPF merge, maifest的所有功能都可以在CPF merge实现， 因此manifest在新版IRIS中也就完全被替代了。
执行merge可以在操作系统命令行下执行， 如下面的例子
# 第2个参数可选，如果为空，自动使用系统当前的iris.cpf
$ iris merge iris /external/irismerge.conf /usr/irissys/iris.cpf
iris-main是IRIS镜像的的ENTRYPOINT程序。 在Container中，ENTRYPOINT 指令允许你指定一个可执行程序或者脚本，作为容器启动后运行的主程序。这个程序会在容器启动时自动执行。
执行docker ps 命令可以看到当前container的ENTRYPOINT是什么：
hma@CNMBP23HMA demo % docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
8f31a857dc90 .../irishealth:2024.2 "/tini -- /iris-main" 3 days ago Up 3 days 2188/tcp, 52773/tcp, 53773/tcp, 54773/tcp, 0.0.0.0:1980->1972/tcp iris-a
hma@CNMBP23HMA demo %
在创建webgateway的container时，可以使用ISC_DATA_DIRECTORY=参数， 选择把CSP文保存在主机而不仅仅是container内部。如下面的例子: 使用volumnes映射了主机的./dur-wg-a目录到container的目录， 而command中的会讲webgateway的配置文件， log文件等保存在主机。
webgateway-apache:
image: containers.intersystems.com/intersystems/webgateway-arm64:2024.1
container_name: wg-tls
hostname: wg-tls
ports:
- "8080:80"
- "4433:443"
volumes:
- ./webgateway/csp:/external
- ./dur-wg-a:/dur
environment:
- TZ=CST-8
- ISC_CSP_CONF_FILE=/external/CSP-apache.conf
- ISC_CSP_INI_FILE=/external/CSP-merge.ini
- ISC_DATA_DIRECTORY=/dur
上一篇文章使用人工配置的方法简单的配置了webgateway container. 接下来来介绍如何在docker-compose里做自动化部署。
先总结我们要做的事情：
这些是最基本的功能。除此之外， 用户还可能会要求建立WebGateway到IRIS的TLS连接，或者在Apache2部署自己的网页等等。后面的文章会一一介绍。
上一篇文章中，我通过Webgateway管理页面定义了Webgateway到IRIS的连接，其实是定义了webgateway的配置文件CSP.ini。 无论WebServer是什么类型，IIS，Apache, Nginx, CSP.ini的都是一样的。在Linux中， CSP.ini位于/opt/webgateway/bin目录。
InterSystems提供了一个工具叫 CSP merge。 简单的说，就是可以定义一个被合并的文件, webgateway运行时会不停的扫描这个文件，发现有内容的修改，就把修改后的配置项合并到工作中的CSP.
在
#；这一部有可能需要科学上网,否则无法正常登陆
hma@CNMBP23HMA ~ % docker login -u="hma" -p="k8zIqpoafIUaViP2BA4gCZdcC4EeKyb0svSjnyVtcWMb" containers.intersystems.com
WARNING! Using --password via the CLI is insecure. Use --password-stdin.
Login Succeeded
# pull iris image，webgateway，Passhash, arbiter, etc.
hma@CNMBP23HMA ~ % docker pull containers.intersystems.com/intersystems/healthconnect-arm64:latest-cd
hma@CNMBP23HMA ~ % docker pull containers.intersystems.com/intersystems/webgateway-arm64:latest-cd
...
我在3年前写过同样内容的文章。随着IRIS版本的更新，安装的细节有了些变化，而且，尤其是2024年以后的版本不再使用PWS(Private Web Server), 安装最新版本的IRIS通常同时要安装一个外部的Web服务器，Apache或者nginx。 另外， 大家对自动部署的需要越来越多，因此我也会在下面的内容里面包括自动部署，配置iris, 安装软件等等内容。希望给各位一个基本完整的介绍。
内容列表如下：
基础篇
iris-main和在container外保存iris数据随时更新
一个实例上的最大命名空间数量是 2047. 但是，要使用这么大量的命名空间，你需要相应地配置好内存。
一个实例里可以创建的数据库的最大数量（包括远程数据库） 15998. 根据授权的类型，可能会有所限制。具体细节请参考以下文档。
Database Configuration [IRIS]
Database Configuration
一个将文件转换成Studio导出的xml格式的工具
通过此工具可以将本地文件转换成xml格式文件，然后通过Studio导入到服务器中，而不再需要其他工具将文件传至服务器。
下面以为ensemble2016自带的一个示例界面增加背景图为例。
http://localhost:57772/csp/samples/cinema/Cinema.csp
.png)
确定此示例界面的Web应用程序为：/csp/samples
选择本地电脑要作为背景图的图片
想要放到cinema下，故相对于web应用程序的路径为：cinema
想要将文件命名为：search_bg.jpg
然后修改下Search.csp的样式代码，就可以使用此背景图了
工具地址：
我们最近在向量搜索抢险体验计划中提供了新版的 InterSystems IRIS，新版本采用了新的基于分层可导航小世界 (HNSW) 索引算法的近似最近邻索引。 这一新增功能可对大型向量数据集进行高效的近似最近邻搜索，从而显著提高查询性能和可扩缩性。
HNSW 算法旨在通过构建基于图形的结构来优化高维数据的向量搜索，从而更快地在大型向量集合中找到近似邻。 无论您使用的是推荐系统、自然语言处理，还是其他机器学习应用，HNSW 都能显著缩短搜索时间，同时允许您调整准确度水平，但准确度提高的代价是查询时间变慢。
HNSW 的主要优点包括：
• 即使数据集规模不断扩大，也能加快搜索速度
• 减少内存占用，同时保持高准确度
• 与现有的 IRIS 向量搜索功能无缝集成
最新版本现已通过向量搜索抢先体验计划提供。 要参与，请在此处注册，下载新版本并开始测试。 我们正在持续增强向量搜索的功能，因此您的反馈至关重要！
我们鼓励您探索性能改进方法，并与社区分享您的想法。 如果您在抢先体验阶段遇到任何问题或有任何反馈，请联系我。
祝您编码愉快！
欢迎来到我的 CI/CD 系列的下一个章节，我们将探讨使用 InterSystems 技术和 GitLab 进行软件开发可以采用的几种方式。
今天，我们来谈谈互操作性。
当您有一个有效的互操作性生产时，您有两个独立的流程：一个是处理消息的可以正常运行的生产流程，另一个是更新代码、生产配置和系统默认设置的 CI/CD 流程。
显然，CI/CD 流程会影响互操作性。 但问题是：
经过将近四年的停顿，我的 CI/CD 系列又回来了！ 这些年来，我与多个 InterSystems 客户合作，为不同的用例开发 CI/CD 管道。 希望本文中提供的信息对您有所帮助。
此系列文章探讨了使用 InterSystems 技术和 GitLab 进行软件开发可以采用的几种方式。
我们有一系列激动人心的话题要讨论：但今天，我们来谈谈代码之外的事情 – 配置和数据。
之前我们探讨过代码提升，这在某种程度上是无状态的 – 我们总是从一个（大概）空实例到完整的代码库。 但有时，我们需要提供数据或状态。 不同的数据类型包括：
我们来探讨所有这些数据类型，以及如何先将它们提交到源代码控制工具中，然后进行部署。
系统配置分布在许多不同的类中，但 InterSystems IRIS 可以将大多数类导出为 XML。 首先是一个安全软件包，其中包含以下信息：
所有这些类都提供 Exists、Export 和 Import 方法，允许您在不同的环境之间移动它们。
一些注意事项：
在这一系列文章中，我想向大家介绍并探讨使用 InterSystems 技术和 GitLab 进行软件开发可以采用的几种方式。 我将介绍以下主题：
在本文中，我们将讨论如何构建并部署您自己的容器。