本文讨论了在使用或维护InterSystems产品中遇到问题时，试图确定问题时可能用到的思路和工具。

一般故障排除

确定问题发生的地点和时间

• 问题是什么时候开始的？多久发生一次？
• 问题首先出现在哪里？
• 问题在什么条件下会被触发？

审查日志中的警告、错误和警报

以下日志可能包含有关该问题的有用信息。可以尝试在以下日志中寻找问题开始前后的警告或报错。

• 检查 messages.log（IRIS）或者 cconsole.log（Caché and Ensemble）
  • 通过文件系统（<install-dir>/mgr/messages.log）访问messages.log文件，或者
  • 通过管理门户（系统操作>系统日志>Messages Log）访问文件内容
• 检查production事件日志 （详细信息请参见文档）
• 查看应用程序错误日志 （详细信息请参见文档）
• 查看Web Gateway/CSP Gateway日志
• 查看网络服务器（IIS/Apache）日志

检查实例是否可以访问足够的存储空间

• 检查文件系统剩余空间（推荐设置操作系统层级的存储空间低告警）
• 检查数据库剩余空间
  • 通过管理门户（系统操作>数据库>Freespace View）查看数据库文件内剩余空间百分比
• 检查Journal日志空间

检查CPU活动

你好社区
在本文中，我将介绍我的应用程序irisChatGPT ，它是基于LangChain Framework构建的。
首先，让我们对框架进行一个简单的概述。

全世界都在谈论ChatGPT以及大型语言模型 (LLM) 如何变得如此强大，并且表现超出预期，提供类似人类的对话。这只是将其应用于每个企业和每个领域的开始！

上篇文章IRIS, Caché监控指导 - 警告和告警 发出后收到要求介绍一下发送SNMP通知的具体操作，这里介绍一下。

我省去了SNMP的原理，这个有需要的可以网上查找。这里只做一个配置的操作：测试怎么从一个Windows上安装的IRIS实例发送IRIS Alert给另一台Linux服务器。

第一步： 配置 Windows SNMP

因为安全原因，Windows 10不再默认安装中启动SNMP，用户需要手工安装SNMP启动服务。以下两个文章是古老的Window 2003和新的Windows 10中配置SNMP的安装，给各位做个参考。

• HOW TO: Configure the SNMP Service in Windows Server 2003
• How to Install and Configure SNMP Service on Windows 10

简单的总结一下：Windows系统中有两个服务:

第148章 SQL函数 $TRANSLATE

执行逐字符替换的字符串函数。

大纲

$TRANSLATE(string,identifier[,associator])

参数

• string - 目标字符串。它可以是字段名称、文字、主机变量或 SQL 表达式。
• identifier - 要在字符串中搜索的字符。它可以是字符串或数字文字、主变量或 SQL 表达式。
• associator - 可选 — 与标识符中的每个字符对应的替换字符。它可以是字符串或数字文字、主变量或 SQL 表达式。

描述

$TRANSLATE 函数在返回值字符串中执行逐字符替换。它一次处理一个字符的字符串参数。它将字符串中的每个字符与标识符参数中的每个字符进行比较。如果 $TRANSLATE 找到匹配项，它会记下该字符的位置。

• $TRANSLATE 的双参数形式从输出字符串中删除标识符参数中的所有字符实例。
• $TRANSLATE 的三参数形式将在字符串中找到的每个标识符字符的所有实例都替换为位置对应的关联字符。替换是基于字符而不是字符串执行的。如果标识符参数包含的字符多于关联参数，则从输出字符串中删除标识符参数中多余的字符。如果标识符参数包含的字符少于关联参数，则忽略关联参数中多余的字符。

$TRANSLATE 区分大小写。

$TRANSLATE 不能用于将 NULL 替换为字符。

++ 更新：2018 年 8 月 1 日

使用内置于 Caché 数据库镜像的 InterSystems 虚拟 IP (VIP) 地址有一定的局限性。特别是，它只能在镜像成员驻留在同一网络子网时使用。当使用多个数据中心时，由于增加了网络复杂性（ 此处有更详细的讨论），网络子网通常不会“延伸”到物理数据中心之外。出于类似的原因，当数据库托管在云端时，虚拟 IP 通常无法使用。

负载均衡器（物理或虚拟）等网络流量管理设备可用于实现相同级别的透明度，为客户端应用程序或设备提供单一地址。网络流量管理器自动将客户端重定向到当前镜像主服务器的真实 IP 地址。自动化旨在满足灾难后 HA 故障转移和 DR 升级的需求。

如果您已经使用%UnitTest 框架构建了单元测试，或者正在考虑这样做，请查看InterSystems 测试管理器Test Manager。

无需离开 VS Code，您现在可以浏览单元测试、运行或调试它们，并查看之前的运行结果。

InterSystems 测试管理器适用于 ObjectScript 扩展支持的两种源代码位置范例。您的单元测试类可以在 VS Code 的本地文件系统（“客户端编辑”范例）或服务器命名空间（“服务器端编辑”）中掌握。在这两种情况下，实际测试运行都发生在服务器命名空间中。

欢迎反馈。

InterSystems 支持的硬件OS平台更新 2023年2季度

我们经常收到有关 InterSystems IRIS 数据平台支持的平台和框架列表最近和即将发生的变化的问题。此更新旨在分享最近的更改以及我们对即将发生的更改的已知的情况，但预测未来是一项棘手的工作，不应将其视为承诺的路线图。

话虽如此，关于更新……

IRIS 生产操作系统和 CPU 架构

红帽企业 Linux

使用sql访问数据库时，如何对sql语句进行加密？

我在官网上提供的java方式访问cache下载了一个示例代码 下载地址为：https://gettingstarted.intersystems.com/language-quickstarts/java-quick…

我在示例代码中看到有这样一种调用 irisNative.functionString("functionName", "routineName") ，请问functionName和routineName主要指什么东西，我在studio中创建了routine，但是也不需要通过functionName来访问呀。

cache数据库如何收集慢SQL？

在使用jdbc 查询过程中 出现报错 [Cache Error: <<WIDE CHAR>Fetch2+4^%sqlcq.DHCdAPP.3726>]，这个可能原因是什么

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

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

编写mainfest

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

基本用法

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

题外话：我刚刚翻译了InterSystems专家Bob Binstock的Caché Mirroring 101：简要指南和常见问题解答。 尽管题目是Caché Mirror 101, 而且是写于2016年，但因为讲解的都是Mirror的基本原理，所以在大量使用IRIS的今天也完全适用。

前面的3篇文章，包括了配置Mirror的各个方面。如果您照着操作，现在已经有了一个工作的mirror环境，并加入了您的数据库。然而，还没完，这篇我来讨论一下后面的工作，首先的问题是：

Mirror不复制什么

简单说，Caché/IRIS镜像是数据库复制(Database Replication)。在Caché/IRIS里什么是数据库？也就是Cache.dat和iris.dat文件。数据库的修改日志，也就是journal，从主机被传送到其他镜像成员。而除此之外的内容，需要维护人员来分别的个个处理， 解决这些内容在各个镜像成员间的拷贝。需要很多的计划和细心。

系统数据库, 包括IRISSYS, IRISTEMP, IRISLIB等等, 这些Caché/IRIS本身的数据库不应该被加入Mirror，在大多数Caché/IRIS版本里也都设置成不可以加入入MIRROR。

例外的HealthCare产品， HSSYS需要做Mirror, HSCustom可以做Mirror, 而HSLIB不可以Mirror

InterSystems 已修复了一个缺陷，该缺陷可能会导致使用 IBM POWER8 或更高版本的 POWER 处理器的 AIX 系统上的数据库和Journal日志文件损坏。只有在使用数据库或Journal日志加密时才会触发此缺陷。

当满足以下条件时，会触发此缺陷：

• 该环境使用数据库或Journal日志加密
• 该环境还使用数据元素加密
• 用于数据元素加密的加密密钥已停用

如果环境满足所有这些条件，则用于数据库或Journal日志加密的密钥计划可能会被损坏。

该缺陷存在于以下产品和基于这些产品的任何 InterSystems 产品中：

• InterSystems IRIS ®–除 2022.1.3 和 2023.1 之外的所有版本
• InterSystems IRIS for Health ™——除 2022.1.3 和 2023.1 之外的所有版本
• HealthShare ® Health Connect –除 2022.1.3 和 2023.1 之外的所有版本
• HealthShare ®解决方案——所有版本

请注意，此缺陷不会直接影响 HealthShare 解决方案，因为它们不使用数据元素加密功能。但是，如果 HealthShare 环境有一个使用上述数据元素加密功能的客户化定制，则它们必须遵循此警报中提供的补救措施。

第二十一章 配置镜像

本章提供了镜像和镜像成员的设置、配置和管理的相关信息和步骤。

镜像的自动部署方法

本章提供了使用管理门户创建镜像和将现有实例配置为成员的过程。 IRIS Data平台还提供了几种自动部署镜像的方法，这些镜像在部署后完全可运行。

使用云管理器(ICM)部署镜像

ISC建议使用InterSystems Cloud Manager(ICM)部署 IRIS，包括镜像配置。通过将纯文本声明性配置文件、简单的命令行界面和Docker Containers中的 IRIS部署相结合，ICM为提供了一种简单、直观的方式来配置云或虚拟基础架构，并在该基础架构上部署所需的InterSystems IRIS体系结构以及其他服务。ICM可以显著简化部署流程，尤其是对于复杂的水平群集配置。

除了部署独立的镜像实例外，ICM还可以部署具有镜像数据服务器的分布式缓存集群和具有镜像数据节点的分片集群。

使用 Kubernetes运算符(IKO)部署镜像

第十八章 镜像架构和规划 - 在故障转移或灾难恢复后重定向应用程序连接

当备份故障转移成员通过自动故障转移成为主要成员或作为灾难恢复的一部分手动将 DR 异步提升为主要成员时，需要某种机制将应用程序连接重定向到新的主要成员。有许多方法可以实现这一点，本章将详细讨论其中的一些方法。一种解决方案可能适用于自动故障转移和 DR 提升，或者可以组合解决方案，例如用于自动故障转移的镜像 VIP 和用于 DR 提升的 DNS 更新。

内置机制

镜像配置中可以包含以下机制，如示例镜像体系结构和网络配置中所示，以解决应用程序重定向问题：

• 镜像虚拟 IP 地址 (VIP)

当镜像 VIP 正在使用时（请参阅规划镜像虚拟 IP (VIP)）并且成员成为主成员时，VIP 会自动绑定到新主成员上的本地接口，从而允许外部客户端继续连接到相同的 IP 地址.使用 VIP 要求有资格成为主要成员的成员位于同一子网上，如示例镜像体系结构和网络配置中所述。

注意：通常，VIP 不能在云环境中使用；有关在云中进行镜像时的备选方案和其他注意事项的信息，请参阅在云环境中进行镜像。

• 分布式缓存集群

如果您使用过 Caché Objects，你已经知道所有关于关系（一对多，父子孙继承等）......
但是您不会在文档中找到关于多对多关系的地方。

但我经常遇到 Caché 对象的新用户提出的问题：
“是否可以实现多对多关系？”答案是——当然！

如何实现取决于相关的任务：有一个比较重的和一个轻量级的解决方案。
两者的共同点是它们不能开箱即用需要添加一些代码来管理它。

让我们举一个基于 SAMPLES 命名空间的例子：

我们有 N:1 关系的情况

但是，您如何处理超过 1 个公司的员工？

重的解决方案：
您添加一个额外的持久类，与双方都有一个：多的关系。

优点：您可以添加管理信息作为有效性、各种时间戳……
以及与此“链接”相关的其他内容。
但它是一个额外的持久类，具有所有优点和缺点。所以我觉得这个很重。
该类可能如下所示：

一、背景

1.1 我遇到了几个项目，他们的接口服务器崩溃了。 项目上希望尽快恢复服务器。他们的服务器在局域网上运行，他们不能使用git，服务器中有多个命名空间运行不同的服务，而且通常只有一台平台服务器。

1.2 如果消息中有字符流类型的属性，消息搜索页面不支持使用字符流属性进行过滤，因此很难找到想要的消息。

1.3 其他同事可能会更新服务器上的代码，代码中可能有些错误。

2.挑战

2.1 如何快速恢复？

2.2 如何支持字符流属性过滤消息？

2.3 如何在编译类时自动备份？

3.解决方案

1.编译时自动导出为备份文件

首先，我们定义一个名为“SYS.base”的类，它只有一个名为“ CLSBAKPATH”的参数，并设置它的值

Class SYS.Base Extends%RegisteredObject 
{
   Parameter CLSBAKPATH = "D:\IRIS\CLSBAK";
}

然后，定义一个名为“SYS.Projection”的类，它继承了 base和%Projection.AbstractProjection，添加“Projection Reference As SYS.Projection”，重写类方法“CreateProjection”；

代码如下：

第十章 镜像架构和规划 - 仲裁器中断的影响

仲裁器中断的影响

仲裁器的中断对镜像的可用性没有直接影响。但是，如果在恢复仲裁器之前发生了自动故障转移以响应主中断场景中的主中断场景5或6，则备份无法自动接管。

备份中断的影响

在主应用程序可以恢复处理之前，某些应用程序可能会经历短暂的暂停（大约是 QoS 超时）。如果没有配置仲裁器，或者如果仲裁器在备份中断之前变得不可用，则经历的暂停可能会稍微长一些（大约是QoS 超时的三倍）。如果在恢复备份之前发生主要中断，则结果是整个镜像中断。

主要和仲裁联合中断的影响

这种情况的后果在响应主要中断情况的自动故障转移中进行了介绍。简而言之，如果备份可以联系主的 ISCAgent，它就会接管；如果不是，结果是整个镜像中断，手动干预强制备份成为主要可能是一个合适的选择。

联合备份和仲裁中断的影响

如果备份和仲裁器同时（或几乎同时）变得不可用，则主节点将无限期地保持在故障状态，因为它假定它是孤立的，因此备份节点可能已成为主要节点。结果是整个镜像中断。当备份再次可用时，它会联系主服务器，然后主服务器恢复作为主服务器运行。或者，可以通过手动干预强制恢复主节点。如果备份和仲裁程序依次失败，则在备份中断的影响中描述的短暂暂停之后，主要继续作为主要运行，因为它知道备份不可能成为主要。

主要和备份联合中断的影响

这种组合的结果总是镜像完全中断。

定位仲裁器以优化镜像可用性

第九章 镜像架构和规划 - 备份处于活动状态时自动进行故障转移

备份处于活动状态时自动进行故障转移

当备份处于活动状态时，如果它可以确认故障转移的第二个条件——即主服务器未作为主服务器运行并且在没有人为干预的情况下无法继续运行，则它有资格作为主服务器接管。备份可以通过以下三种方式之一执行此操作：

• 通过接收来自主要请求它接管的通信。

这发生在主实例正常关闭期间或当主实例检测到它已挂起时。一旦主要发送此消息，它就不能再充当主要并且活动备份可以安全地接管。如果前一个主节点挂起，新的主节点会迫使它关闭。

• 通过从仲裁器接收到它已与主节点失去联系的信息。

主要和备用 IRIS 实例与仲裁器保持持续联系，仲裁器会在与其他故障转移成员的联系中断或恢复时更新每个实例。当一个网络事件同时将主节点与备份节点和仲裁节点隔离开来时，它就会无限期地进入故障状态。因此，如果一个活动的备份失去了与主的联系，并从仲裁器得知它也失去了与主的联系，备份可以安全地接管，因为主必须要么已经失败，要么被隔离并处于故障状态，因此不能再充当主要角色。恢复连接时，如果以前的主节点挂起，新的主节点会强制关闭它。

• 通过从主系统的 ISCAgent 接收主实例已关闭或挂起的信息。

第八章 镜像架构和规划 - 镜像同步

镜像同步

如数据完整性指南的“日志”一章所述，日志文件包含自上次备份以来对 IRIS 实例中的数据库所做更改的时间顺序记录。在镜像中，记录对主数据库所做更改的日志数据成为对备份和异步数据库副本进行相同更改的基础。因此，镜像数据库始终记录在主数据库上，而在备份和 DR 异步上，它们始终是只读的，以防止来自其他来源的更新。通常它们在报告异步时也是只读的。

当镜像数据库上记录Global更新操作（主要是 Set 和 Kill 操作）的数据写入主数据库的日志时，日志记录将传输到其他镜像成员。一旦在备份或异步成员上收到日志记录，记录在其中的操作就会在该成员的数据库上执行。这个过程被称为dejournaling。

日志记录从主服务器到备份的传输是同步的，主服务器在关键点等待备份的确认。这使故障转移成员保持紧密同步并使备份处于活动状态，如备份状态和自动故障转移中详细描述的那样。相反，异步从主服务器异步接收日志数据。因此，异步镜像成员有时可能比主成员落后一些日志记录。

注意：当 IRIS 实例成为镜像的成员时，会发生以下日志更改以支持镜像：

1、默认samples空间没有Backup.General无法进行外部备份

2、%SYS空间有Backup.General

Backup.General怎么在其他空间里创建这个类

第五章 镜像概述

传统的高可用性和数据复制解决方案通常需要在基础架构、部署、配置、软件许可和规划方面进行大量资本投资。 IRIS® 数据库镜像旨在为两个 IRIS 实例之间快速、可靠、强大的自动故障转移提供经济的解决方案，从而提供有效的企业高可用性解决方案。

依赖共享资源（如共享磁盘）的传统可用性解决方案通常容易出现与该共享资源相关的单点故障。镜像通过在主镜像成员和备份镜像成员上维护独立的资源来降低这种风险。此外，通过利用逻辑数据复制，镜像避免了与基于 SAN 的复制等物理复制技术相关的风险，包括无序更新和结转损坏。

将分布式缓存与镜像相结合可提供更高级别的可用性；具有镜像数据服务器的分布式缓存集群中的应用程序服务器将镜像故障转移视为数据服务器重启，允许处理在新的主服务器上继续不间断，这大大减少了工作流和用户中断。在不同的数据中心配置两个故障转移镜像成员可提供额外的冗余并防止发生灾难性事件。

除了为计划外停机时间提供可用性解决方案外，镜像还可以灵活地将计划内停机时间（例如，IRIS 配置更改、硬件或操作系统升级等）纳入特定 IRIS 系统，而不会影响整体服务水平组织的协议 (SLA)。

第二章 高可用性解决方案 - 虚拟化平台高可用

虚拟化平台高可用

虚拟化平台通常提供 HA 功能，通常会监控来宾操作系统及其运行的硬件的状态。在任何一个失败时，虚拟化平台都会根据需要在备用硬件上自动重启失败的虚拟机。当 IRIS 实例重新启动时，它会自动执行正常的启动恢复，保持结构和逻辑的完整性，就好像 IRIS 在物理服务器上重新启动一样。

虚拟环境中的故障转移

虚拟化 HA 具有内置于虚拟化平台基础架构中的优势，因此只需很少的配置工作，在某些情况下根本不需要。此外，虚拟化平台允许有计划地将虚拟机重新定位到备用硬件以进行维护，从而实现物理服务器的升级，例如，无需任何停机时间。

IRIS 镜像

具有自动故障转移功能的 IRIS 镜像采用不同的 HA 方法，依靠完全独立系统之间的逻辑数据复制来避免共享存储的单点故障风险，并确保生产可以立即故障转移到几乎所有的备用 IRIS 实例故障场景——系统、存储和网络。

在 IRIS 镜像中，一个称为主要故障转移成员的 IRIS 实例提供对生产数据库的访问。单独主机上的另一个实例，称为备份故障转移成员，与主实例同步通信，检索其日志记录，确认收到它们，并将它们应用于同一数据库的自己的副本。通过这种方式，主备都始终知道备份是否有来自主的最新日志文件，因此可以将其数据库与主上的数据库精确同步。

第一章 高可用性解决方案 - HA 解决方案中的问题

高可用性(HA)指的是使系统或应用程序在长时间内保持正常运行并可供用户使用的目标，从而最大限度地减少计划内和计划外停机时间。 IRIS提供自己的HA解决方案，并轻松与操作系统提供商提供的常见HA解决方案集成。

维护高系统可用性的主要机制称为故障转移。在这种方法下，故障的主系统由备用系统代替；也就是说，生产故障转移到备份系统。许多HA配置还提供了灾难恢复(DR)机制，即当HA机制无法保持系统可用时，恢复系统可用性。

本页简要讨论可与基于 IRIS 的应用程序一起使用的一般 HA 策略，然后涵盖 IRIS HA 解决方案中的问题，提供 HA 解决方案功能比较，并讨论使用分布式缓存和故障转移策略

IRIS HA 解决方案中的问题

在为IRIS 系统评估潜在的 HA 解决方案时，请牢记以下两个重要问题：

• 共享存储

HA 架构的一个重要原则是避免单点故障。大多数 HA 解决方案依赖于共享存储组件；这代表了这样的风险；如果存储出现故障，就不可能保持系统可用。存储级冗余可以在一定程度上减轻这种风险，但也可以延续某些类型的数据损坏。

另一方面，IRIS 镜像在完全独立的主存储和备份存储之间使用逻辑数据复制，完全消除了单点故障问题并避免了大多数类型的损坏。

• IRIS 升级

正式名称为Class Query 的意思可以追溯到 Caché 的早期。
使用CLASS是因为它嵌入在 COS 类中。
尽管官方文档中有精确的描述，但它仍然相当抽象。
我的教程应该通过 COS 中的一个简单示例逐步指导您，使您有直观的体会

尽管作为一个没有资金支持的医科专业学生，Case Western Reserve大学的Jane Hinkle最近在不到一周的时间里利用EHR供应商Epic的去识别化病人数据库Cosmos进行了临床研究，还得了奖。

Cosmos是一个HIPAA限定的数据集，整合了超过1.22亿名患者的Epic EHR数据。

"我们围绕Cosmos建立的概念就是我们所说的自助分析，这意味着Cosmos中的大数据被设置为Cosmos的任何用户都可以访问，"Epic的临床信息学家Dave Little博士在采访中告诉EHRIntelligence。"在简的案例中，我们看到一个医科学生能够带着一个有针对性的问题，从1.22亿的患者数据中找到她所需要的数据来回答这个问题。这在研究界历来是闻所未闻的。"

Hinkle的研究发现，儿科病人从COVID-19引发心肌炎的可能性是COVID-19疫苗的三到五倍。她告诉EHRIntelligence，她最初关注的是一项使用大数据工具来分析阻塞性睡眠呼吸暂停的研究。然而，当关于心肌炎是否是COVID-19疫苗接种的不良反应的问题出现时，Hinkle和她的研究导师、公共卫生硕士、医学博士、MetroHealth 公司的首席医疗信息官David Kaelber转移了他们的重点。

您好，有没有一种简单的方法可以导出与Production相关的所有内容并在另一个实例中导入？

例如导出Production保存的 db、ns、映射、webapp 相关、资源、角色等