全球响应中心 (WRC) 是 InterSystems 的支持服务。我们每天 24 小时为客户提供专业的技术帮助。我们在全球 15 个国家/地区拥有支持顾问，他们精通英语、西班牙语、葡萄牙语、意大利语、威尔士语、阿拉伯语、印地语、汉语、泰语、瑞典语、韩语、日语、芬兰语、俄语、法语、德语、希伯来语和匈牙利语。我们的每一位客户都会从真正关心客户成功的高素质支持专家那里获得及时的帮助。
提示：本文包含在Java中通过JDBC Driver对Caché/IRIS数据库进行查询的示例代码。
近期有客户反应使用Java从老版本Caché中读取数据时，如果数据中包含long varchar, Caché数据库中与之对应的属性类型为%Stream.GlobalCharacter，即使实际上该流数据长度非常小，也会成十几倍的降低性能。
大家先来看一段代码,
本文讨论了在使用或维护InterSystems产品中遇到问题时，试图确定问题时可能用到的思路和工具。
确定问题发生的地点和时间
审查日志中的警告、错误和警报
以下日志可能包含有关该问题的有用信息。可以尝试在以下日志中寻找问题开始前后的警告或报错。
检查实例是否可以访问足够的存储空间
检查CPU活动
InterSystems 已修复了一个缺陷，该缺陷可能会导致使用 IBM POWER8 或更高版本的 POWER 处理器的 AIX 系统上的数据库和Journal日志文件损坏。只有在使用数据库或Journal日志加密时才会触发此缺陷。
当满足以下条件时，会触发此缺陷：
如果环境满足所有这些条件，则用于数据库或Journal日志加密的密钥计划可能会被损坏。
该缺陷存在于以下产品和基于这些产品的任何 InterSystems 产品中：
请注意，此缺陷不会直接影响 HealthShare 解决方案，因为它们不使用数据元素加密功能。但是，如果 HealthShare 环境有一个使用上述数据元素加密功能的客户化定制，则它们必须遵循此警报中提供的补救措施。
InterSystems已修复一个缺陷，该缺陷在罕见情况下会导致ECP客户端不稳定。
该缺陷存在于以下产品和基于这些产品的任何InterSystems产品中。
受影响的版本是2022.1.x、2022.2和2022.3：
InterSystems IRIS®
InterSystems IRIS for Health™
HealthShare® Health Connect
受影响的版本是2022.2（只针对部署ECP的客户）：
InterSystems HealthShare®
这个问题只发生在ECP客户端系统中。当这个问题被触发时，进程可能遇到<SYSTEM>或<DATABASE>错误。出错后，ECP客户端会出现不稳定；在某些情况下，实例可能会挂起。对数据没有影响，ECP数据库服务器不受影响。
要清除不稳定性，必须重新启动ECP客户端实例。
如果您的 IRIS、IRIS for Health 或 Health Connect 实例受到影响，补救措施是升级到版本 2023.1 或 2022.1.3，这两个版本都将很快发布。
如果您有受影响的 HealthShare 实例，一组单独的警报文档和补救建议将很快发布。
InterSystems 已修复一个导致SQL查询返回不正确结果的缺陷。
该缺陷存在于以下产品和基于这些产品的任何InterSystems产品中。
受影响的版本是 2021.2、2022.1.x、2022.2 和 2022.3：
受影响的版本是 2022.2：
当启用 SQL 运行时计划选择 (RTPC) 被启用（默认），并且查询包含一个“truth value”“WHERE ?=? 时，该缺陷会被触发，当被触发时，一些判断可能不会被正确评估；这导致了不正确的查询结果。
注意：通过查看SQL语句，无法完全评估一个查询的脆弱性。这是因为InterSystems SQL查询优化可以在查询的内部表示中增加“truth value”。
如果你的环境使用 InterSystems SQL，那么你可以通过禁用RTPC 功能来补救这个问题。
注意：关于 InterSystems HealthShare® 缓解措施的其他信息将很快发布。
InterSystems 纠正了一个可能导致 InterSystems IRIS® 和 Caché 无法在 Windows 上利用大页共享内存的问题，即使这些产品得到的信息是已分配到了大页内存。这会对系统性能产生不利影响。
该问题是由于 Windows 10 中的一个更改引起的，该更改需要 InterSystems IRIS® 和 Caché做相应的修改。请注意，此问题还会影响所有基于 InterSystems IRIS® 或 Caché 的 InterSystems 产品。以下版本的 Windows 会出现此问题：
Windows 10（版本 1703 及以上）
Windows 11
Windows Server 2019
Windows Server 2022
Windows Server 2016 不受影响。
作为参考，此问题的更正标识为 RJF533。此更正将包含在所有未来的 InterSystems IRIS® 和 Caché 发行版中。该更正也作为受支持产品版本的补丁提供。
InterSystems 建议采取以下措施以避免潜在的严重系统性能下降：
“池大小”（PoolSize）设置的值决定了一个组件的作业的量和启动方式。在这篇文章中我们将具体讨论对于不同类型的组件来说“池大小”设置的可能值和这些值所代表的含义。
Pool Size = 1
对于所有的组件来说，运行池大小为1的含义都是一样的: 该组件有且只有一个作业，单独运行该组件的代码，顺序处理发送到该组件的消息（FIFO）。
Pool Size > 1
对于业务进程（BP）和业务操作（BO）来说，当运行池大小大于1时，该组件将运行多个作业（作业数=运行池大小设置数）。每个作业都只运行该组件的代码，但消息处理的顺序将被打乱。将运行池的大小设为大于1的值可以在一定程度上提升组件处理消息的性能，但是每个作业的性能还是受限于系统资源的，所以并不是说组件的性能可以随着运行池的大小增加而无限提升。
对于轮询类业务服务（Polling BS）来说，当运行池大小大于1时，该服务也将运行多个作业（作业数=运行池大小设置数）。但这种配置会导致多个进程对轮询结果产生竞争（race condition），所以一般情况下轮询服务不应将运行池大小设为大于1的数值。
上线一个新的集成平台production或者组件是需要很多精力的，用户常常需要对每一个组件所满足的需求和所能提供的功能，使用到的协议，以及组件对系统资源的调用有深入细致的了解。在配置好一个production之后，您可能需要将这个production推送到测试或者正式环境，或者需要将一个写好的组件代码应用到不同的项目上。这些时候，production的导出功能可以方便您传输production或组件的配置和代码。
导出
需要导出production时，您可以移步到管理门户 - Interoperability - 相应的命名空间 - 列表 - Production 页面，选择您需要导出的production，再点击页面上的导出键进行导出。如下图1所示：
在弹出的对话框中，您可以选择在导出文件中您想包括的内容。如下图2所示：
您也可以通过管理门户 - Interoperability - 相应的命名空间 - 配置 - Production 页面，点击“Production 设置” - “操作”选项卡 - “导出”键进行导出。弹出的对话框同样如图2所示，会自动包括大部分production及其组件所需要的类。如果需要添加或更改导出的类，可以在此对话框进行操作。
这种情况先抽查这些消息所处的会话中是否有未完成操作周期的消息（状态为除“Completed”“Error”“Discarded”之外的状态）。如有，且定期清除任务配置了“KeepIntegrity”，且该环境并不需要保留这些消息，可通过关闭清除任务中的“KeepIntegrity”配置清除这些会话和包含的消息。如果有这类消息，但是定期清除任务未配置“KeepIntegrity”，可能是定期清除任务的逻辑或消息数据问题导致清楚任务查找的时候没有覆盖这些消息，请联系WRC帮助排查具体原因。
有关定期清除任务的更多信息请参见文档
Purging Production Data | Managing Productions | InterSystems IRIS for Health 2022.1
这种情况需要具体排查每个较大的global。可能有以下原因：
系统文件根据版本不同，大约会占用1GB左右的空间。这部分空间是不能省略的，随意删除文件会导致实例无法正常运行。
备份文件应及时转存到另外的磁盘或磁盘分区上，不应与.DAT数据库占用相同的磁盘分区。
Journal日志文件存储路径应设置为与.DAT数据库存储路径不同的磁盘或磁盘分区上，不应与.DAT数据库占用相同的磁盘分区。
因为HSHC集成平台设计上不支持过多的消息存储，用户应该为每个有消息流量的命名空间配置定期消息清除任务。
定义消息清除任务时 “BodiesToo”默认是没有选择的，需要手动选择。系联软件研发核心认为我们的软件不能在客户不知情的情况下自动删除客户自定义的数据，消息也属于客户自定义的数据，所以默认选项只会删除Message Header，不会删除消息本身。但是保留默认值运行清除消息任务就会导致孤立消息（指不存在配套Message Header的消息对象）的问题。BodiesToo=0也是孤立消息产生的主要原因之一。有关孤立消息的常见问题会在之后的文章做进一步讨论。
另一个消息清除任务选项“KeepIntegrity”默认是打开的。如果您需要保留“Queued”，“Suspended”，“Deferred”等未完成所有操作的消息，请保持打开。如果不需要可以关闭。
具体保留多少天的消息（清除周期）可以根据平台业务需求和消息量综合考量决定。
亲爱的社区开发者们，
我很高兴地向大家介绍一位我们的新版主 @Tete Zhang (张特特）！
@Tete Zhang (张特特） 目前任职于InterSystems中国，在WRC部门任职资深技术支持专家一职。
以下是@Tete Zhang (张特特）的自我介绍：
在2015年夏天实习结束后，我于2016年正式作为技术支持工程师加入InterSystems，从那时起，我在InterSystems全球支持中心北美分部工作了六年，2022年，我调职至北京，服务于InterSystems中国，希望能为成长中的中国市场出一份力。
很高兴可以在社区与大家相遇，希望能与大家一起努力，创造更精彩的社区！
根据日期范围查询的SQL性能让你失望？ 我有一个比较特别的技巧，可能会帮助你解决这个问题! (SQL开发人员讨厌这个!)*
如果你有一个类，在添加数据时记录时间戳，那么这些数据将与你的IDKEY值保持顺序--也就是说，当且仅当ID1<ID2时，表内所有ID和时间戳值的TimeStamp1<TimeStamp2--那么你可以利用这一知识来提高对时间戳范围的查询性能。 考虑一下下面这个表:
Class User.TSOrder extends %Persistent
{
Property TS as %TimeStamp;
Property Data as %String (MAXLEN=100, MINLEN=200);
Index TSIdx on TS;
Index Extent [type=bitmap, extent];
}用过去30天内的30,000,000条随机行来填充，每天将得到1,000,000条行。 现在，如果我们想查询某一天的信息，你可以这样写：
SELECT ID, TS, Data
FROM TSOrder
WHERE
TS >= '2016-07-01 00:00:00.00000' AND
TS <= '2016-07-01 23:59:59.999999'Production是指Ensemble/HealthShare Health Connect/IRIS/IRIS for Health产品中提供的互操作功能模块，更多关于Production介绍，可参见在线文档，
https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=AFL_productions#AFL_productions_quicklook
Production中访问外部数据库常用的适配器Adapter有两个，一个是用于Business Service中的Enslib.SQL.InboundAdapter，另一个是用于Business Operation中的Enslib.SQL.OutboundAdapter,
更多关于这两个Adapter的使用说明可以参见在线文档"Using SQL Adapters in Productions",
1. 基本配置步骤（仅涉及与JDBC连接相关配置）
2. JDBC Gateway和Java Gateway Service的区别
3. 常见的问题类型
4. 常用基本故障排查
近日遇到客户反映在Business Operation中使用SQL Outbound Adapter调用Oracle存储过程时，无法获取CLOB完整的返回内容。借此在这里介绍下该如何调用，话不多说，直接上代码。
注意，以下代码片段直接应用于Business Operation中，
InterSystems许可证是指InterSystems发放的电子或纸质版的产品许可证，内容包括许可证订购日期、产品描述等。
激活码/License Key是InterSystems随许可证发放的许可软件激活码。通常情况下，客户收到的是电子许可证。
以下是一些许可证，激活码/License key常见咨询问题参考：
纸质版许可证或是安装介质盘，可通过合作伙伴或是致电原厂核验许可证信息后获取。
申请准备：
WRC全球响应中心联络信息：
方法1： 使用管理门户
以管理员身份登录到系统管理门户，进入菜单：系统管理>软件许可颁发>软件许授权码 (或英文菜单：System Administartion>Licensing>License Key)
记录客户名和授权密钥：
方法2 ：使用命令行
所有人现在可以在 https://evaluation.intersystems.com下载IRIS和IRIS for Health社区和企业版 。
客户以及潜在客户都可以尝试我们最新最强的功能，包括一些还没有发布的新特性。
对于潜在客户，只要选择名称中带有"（预览）"的选项，就可以下载预览软件。
对于客户和InterSystems员工--只需拨动预览复选框，这将包括可用版本菜单下拉中的预览软件:
https://community.intersystems.com/post/introducing-evaluation-service-community-edition-downloads
https://community.intersystems.com/post/intersystems-evaluation-service
有任何问题欢迎拨打 4006019890 或咨询您的ISC客户经理。
以下示例代码可实现在Java中通过JDBC向IRIS数据库中写入Stream数据，插入的该Stream大小约为4M，对应在IRIS中字段类型为%Stream.GlobalCharacter。以下代码在IRIS2021上测试成功，供大家参考，
Java代码，
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。
Linux内核机制OOM Killer，也即Out of Memory Killer, 顾名思义，该机制的主要职能就是当内存不足时，选择并杀掉一些进程，以使系统继续运行。
Caché/Ensemble/IRIS的多个客户曾经遇到过与此相关的系统宕机，宕机的直接原因是数据库核心写进程Write Daemon被OOM Killer选中并杀掉了，在我们的日志文件中可以看到如下信息，
06/15/21-10:50:31:035 (13579) 3 Daemon WRTDMN (pid 13588) died. Freezing system
06/15/21-10:52:25:940 (13601) 2 System Process 'WRTDMN' terminated abnormally (pid 13588)与之对应，在操作系统的日志文件中可以看到如下记录，
如果想快速查看锁表空间的使用情况，可以通过GetLockSpaceInfo()方法来获得。
%SYS>w ##class(SYS.Lock).GetLockSpaceInfo() 4717392,4712512,1200
返回值是 "AvailableSpace,UsableSpace,UsedSpace"，每个值的单位都是Byte。
AvailableSpace：锁表的总空间减去已用空间的大小（UsedSpace）。
UsableSpace：预估的可用空间。AvailableSpace里有一些空间是系统内部保留的，所以UsableSpace比AvailableSpace要小。UsableSpace是用户在锁表中可用的自由空间的数量。
UsedSpace：已经使用的空间。
照顾好我们的客户并打造伟大的产品。这是我们InterSystems自从1978年成立以来的座右铭。40多年很快过去，这始终驱动着我们前进。过去是，未来也将一直是我们的基因。
追求卓越和持续提升的价值观是我们的“客户至上”方法取得成功的关键。这也是过去三年我们一直积极参与Gartner及其Peer Insights项目的原因，该项目主要征求最终用户的反馈意见和对厂商的打分。InterSystems连续两年荣膺Peer Insights运营数据库管理系统（ODBMS）客户选择奖，而且是该类别评分最高的供应商之一。
此外，InterSystems还入选Gartner目前推出的Gartner“客户至上”计划，并获得相应标识（上图），这一计划认可了我们为客户提供的坦诚分享、公正反馈的环境，根据用户反馈，我们不断改善产品和服务，从而最大程度地满足不断变化的客户需求。简言之，我们没有人为影响客户在Gartner网站上对我们的评价。这体现了我们对客户的承诺以及开放沟通渠道的重要性。InterSystems IRIS®数据平台是Gartner最新的云数据库管理系统魔力象限（Cloud Database Management Systems Magic Quadrant）中唯一获得此标识的产品，我们对此深感自豪。
以客户为中心的基因DNA
众所周知，Object Script是一个弱类型开发语言，%String是我们非常常用的一个类型，时不时有客户在初次接触Object Script编写程序时遇到%String长度限制的问题，在这里做一个简单总结，以便于相关开发人员作为参考。
1. MAXLEN设置字符串的长度。
Property Name As %String(MAXLEN = 50);
a) 如果不设置MAXLEN, 默认长度限制为50
b) MAXLEN = "", 没有限制长度，也就是字符串本身的长度限制。
如果超限，您将会看到如下报错，
错误 #7201: 数据类型值'abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz'的长度超过50允许的MAXLEN
2. 字符串本身的长度限制。
在没有开启长字符串的情况下，%String类型的长度限制是32,767个字符。
1 磁盘空间不足的常见情形
1）Journal所在磁盘空间不足。造成这种情况的原因有多种，比如，Mirror中备机未处于宕机状态，因此主机保留了Journal文件。
2）数据库所在磁盘空间不足。比如，集成平台上Ensemble/Health Connect/IRIS for Health的消息从未清除过，导致消息数据库DAT文件不断增大，直至将磁盘空间用尽。
我们可以看到以上两种情形下，Mirror都帮不上忙，也就是说一旦问题出现，主机和备机都没有办法立即承担起业务系统的运行，
第1)种，备机可能在故障出现前就已经宕机很长一段时间而没被发现，备机的数据很可能已经与主机严重不一致。实际上，主机之所以保留了大量的journal文件没有删除，就是为了让备机同步数据时使用。
第2)种，虽然配置了Mirror，但是消息主库正常情况下都是镜像库，在一个健康的Mirror中，备机和主机的镜像库数据保持同步，镜像库大小应当是相同的，假设主备机的硬件配置相同（这也是我们推荐的方式）那么磁盘空间不足在备机上同样存在。
2 应急措施
切忌手动从文件系统中删除Journal文件！
以上两种情形我们都遇到过客户为了快速地腾出空间、恢复系统，第一时间手动从文件系统中将必要的Journal文件删除掉了，删除了这些Journal文件之后，尽管腾出了空间，但会造成系统无法启动，通常这个时候您会在日志文件中看到如下信息，
可以使用%SYS.Journal.File类中的ByTimeReverseOrder查询，以及%SYS.Journal.Record类中的List查询来实现。
下面是这两个查询的具体作用：
A) %SYS.Journal.File类中的ByTimeReverseOrder查询
这个查询会获取journal日志文件名并按降序排列
USER>set rs=##class(%ResultSet).%New("%SYS.Journal.File:ByTimeReverseOrder")
USER>do rs.Execute()
USER>while rs.Next() { write rs.Name,! }
c:\intersystems\cache\mgr\journal\20190620.003
c:\intersystems\cache\mgr\journal\20190620.002
c:\intersystems\cache\mgr\journal\20190620.001
c:\intersystems\cache\mgr\journal\20190610.001B) %SYS.Journal.Record类中的List查询
这个查询可以从指定journal日志文件中获取日志记录
与Windows上默认安装为服务随机自启动不同，我们在Linux上安装完InterSystems IRIS后，默认是没有配置系统服务的，需要做手动配置。本文提供使用systemd方式来配置InterSystems IRIS服务随机自启动的简单示例，供大家参考。
假设我们已经安装了InterSystems IRIS产品，安装完成后您可以通过iris list来来查看实例信息，包括安装路径，如："/intersystems/iris"
[root@RHEL8-64-001 ~]# iris list
Configuration 'IRIS' (default)
directory: /intersystems/iris
versionid: 2021.2.0L.546.0
datadir: /intersystems/iris
conf file: iris.cpf (SuperServer port = 51773, WebServer = 52773)
status: running, since Mon May 31 05:03:09 2021
state: ok
product: InterSystems IRIS一个实例中可创建的最大命名空间数量为2048个。这个上限不可修改。
一个实例中可创建的最大数据库数量（包括远程数据库）为15998个。这个上限也不可修改。
一个实例中可创建数据库的总数量还有其他因素制约：
1. 数据库路径信息总量最大为256KB，也就是所有数据库的路径字符加起来不能多于256KB。设置的路径越长，可创建的数据库数量越少。
计算公式：最大数据库数量=258048/(平均数据库路径长度+3)
2. 镜像的数据库一个按两个算。也就是创建一个镜像的数据库，相当于创建了2个非镜像数据库。
更多细节请参考在线文档：
https://docs.intersystems.com/irislatest/csp/docbook/Doc.View.cls?KEY=G…
如果您在升级了系统之后，打开SMP时看到如下报错，
ERROR #5001: 对象的服务器版本与客户端发送的版本不一致: %ZEN.Component.vgroup
一般情况下，这个报错是由浏览器缓存中残留的过期信息造成的，可以通过清除浏览器缓存来解决。
如果清除浏览器缓存之后仍然未能解决此问题，请您前往系统安装目录, 如：d:\InterSystems\IRIS\CSP\broker，查看css/js文件的时间戳在本次更新安装之后是否并没有相应地更新，如果没有，请您做以下尝试，
1）在IRIS中更改数据库IRISLIB, 之前的版本是CACHELIB, 取消只读装载，方法如下，打开管理门户SMP, 系统管理->配置->本地数据库，选择要更改的数据库，取消"只读方式挂载",点击【保存】。
2）重新编译%Zen组件，
w ##class(%SYSTEM.OBJ).Compile("%ZEN.Component.vgroup")
此时，再次前往，d:\InterSystems\IRIS\CSP\broker，会看到相关的css/js文件时间戳已经更新。
3）恢复上述数据库的只读装载。
如果以上办法仍然未能解决您的问题，建议您联系WRC，寻求Support的进一步帮助。
InterSystems产品有四种备份方法:
(1) 外部备份
(2) 在线备份
(3) 冷备份
(4) 传统的并行外部备份
有关这些方法的细节请参考在线文档 https://docs.intersystems.com/irisforhealthlatest/csp/docbook/DocBook.U…
以下是对每种备份方法的简要描述:
尊敬的HealthShare用户：
本帖是HealthShare HS2021-03提醒沟通流程的一部分，同样的信息也会以以下渠道分发：
2021年3月23日 – 提醒：镜像Dejournaling的潜在数据完整性问
InterSystems 已经纠正了一个缺陷，该缺陷在极少数情况下会导致非主镜像成员的数据不一致问题。此缺陷影响到InterSystems产品的所有发布版本。
如果发生该缺陷，则会在镜像系统的正常运行中悄然发生。该缺陷的结果是，镜像成员未能删除数据库日志的子集，然后导致镜像成员之间的数据不一致。这对故障转移和异步成员都有影响。虽然这个缺陷遇到的可能性非常小，但InterSystems建议所有使用镜像的客户都要获得修正，并使用DataCheck验证镜像数据库的一致性。有关可能触发该缺陷的具体情况以及将遇到该缺陷的风险降至最低的步骤的更多详细信息，请联系全球响应中心（WRC）。
该缺陷的更正被确定为 SML2898、HYY2434 和 HYY2435，并将包含在所有未来的产品版本中，包括 Caché 和 Ensemble 2018.1.5 以及 InterSystems IRIS 和 InterSystems IRIS for Health 2019.1.2 和 2020.1.1。这些更正也可通过InterSystems全球响应中心（WRC）的Ad hoc分发版本获得。
如果您对这个提醒有任何疑问，请联系 Worldwide Response Center。