Hi 大家好，

我最近开始学习InterSystems IRIS 的互操作性，我发现官方文档对理解它的工作原理很有帮助，尽管我自己在实现它时仍有一些困难。在我的同事的帮助下，我成功地创建了一个系统的Demo，并从实践中学习。因此，我决定写一下文章，分享我得到的帮助，来帮助更多的其他人。

介绍

首先，让我们掌握一些基本概念:

• 互操作性 - 这个词的含义并不像它的发音那样复杂--它基本上是把各种信息从一个系统带到另一个系统的“魔术”。
• 业务主机 - 如果把互操作性比作是魔术，那么业务主机Business Host就是魔术师的魔法帽--业务主机里有能够识别和接收信息的业务服务Business Service/BS，并将其作为消息发送给业务流程BP或业务操作BO。业务操作执行所需的操作（顾名思义）并传递信息。业务流程控制着消息的流动：它们定义了消息的去向（基于你所选择的任何东西）以及它是如何被传递的。
• 适配器 - 适配器是一些我们可以用来识别和操作我们可能要处理的各种信息的类。在实践中，我们把它们作为参数和（可选）属性来访问其方法和属性

准备搭建Production

从简单的开始比较容易--让我们先想想服务和操作--比如说你有一个接收一种信息的服务，它很容易被我们唯一的操作所识别。

当生产的目的和它的部分非常清楚时，开发就比较容易。如果你愿意，画一张图或写下你希望它完成的步骤可能会有帮助。

IRIS的23种设计模式

第一章 Caché 设计模式 简单工厂模式

定义

• 简单工厂模式属于创建型模式，又可称为静态工厂模式，这是由一个工厂对象决定创建出哪一种产品类的实例

使用场景

• 工厂类负责创建的对象比较少
• 客户只需知道传入工厂类的参数，而无须关心创建对象的逻辑

优点

• 使用户根据参数获得对一个的类实例，避免了直接实例化类型，降低了耦合性
• 能把客户类和具体子类的实现解耦，客户类不再需要知道有哪些子类以及应当实例化哪个子类：客户类往往有多个，如果不使用简单工厂，那么所有的客户类都要知道所有子类的细节。而且一旦子类发生改变，所有的客户类都要进行修改

缺点

• 可实例化的类型在编译期间已经被确定。
• 如果增加新类型，则需要修改工厂，这违背了开放封闭原则
• 子类多过不适合使用

示例

• 用Caché 实现一个计算器控制台程序，要求输入两个数和运算符号。

可能会写成这样：

/// w ##class(PHA.YX.Design.Program).GetResult() 
ClassMethod GetResult()
{
	READ "输入第一个数字：", numberA,!
	READ "输入操作符：", operate,!
	READ "输入第二个数字：", numberB,!
	
	s result = ""
	i operate = "+" d
	.

在Cache 2018之前的版本中，数据库的高可用是通过第三方HA软件保障的，Cache数据库在2018以后及IRIS支持MIRROR技术，通过MIRROR可以保障数据库的高可用及数据的冗余，那么在新版本中，第三方HA软件与MIRROR是否可以同时使用以实现更高的数据库可用性？使用起来有哪些需要注意的？本文重点介绍探讨上述两个问题。

为得出正确结论，我们搭建了如下实验环境：

       我们采用3个服务器节点A、B、C分别部署IRIS 2021.1数据库，其中A节点、B节点部署第三方HA软件组成数据库高可用主备集群（本例中，采用的是基于POWER平台的PowerHA），该集群中定义A节点为主节点，B节点为备用节点，HA集群的共享资源组存放在共享SAN存储上，通过HA，生成HA集群的对外服务IP，即我们通常说的Service ip，保证在生产节点发生网络故障、主机故障、以及操作系统故障、手动切换等情况下，IRIS服务、共享资源组、以及HA的Service IP可自动切换至另外一台服务器，保障IRIS高可用，经测试，HA集群内部节点间服务切换时间约为30秒。

Hi Developers,

嗨，各位开发者们：

各位都知道，Python是一个庞大而强大的生态系统，包含了成千上万的库和包，特别是在数据科学方面。

因此，我想首次尝试使用IRIS最近的一项功能--嵌入式Python，简单地导入一个名为datetime的Python库，生成带有时间戳成分的数据，并在InterSystems IRIS for Health Data Platform中持久化。同样的方法在IRIS数据平台上也可以使用。

How to obtain the user's operation permission on the database， 

How to obtain the user's operation permission on the class

第二十章 用户、角色和权限

InterSystems IRIS®具有系统级安全性，以及一组与sql相关的额外安全性特性。 在数据库级保护之外，InterSystems SQL安全性提供了额外级别的安全功能。 SQL和系统级安全性之间的一些关键区别是:

• SQL保护比系统级保护更细粒度。可以为表、视图和存储过程定义特权。
• SQL权限既可以授予用户，也可以授予角色。 系统级权限只分配给角色。
• 持有SQL特权会隐式授予执行SQL操作所需的任何相关系统特权。 (相反，系统级特权并不意味着表级特权。)

InterSystems SQL在InterSystems IRIS数据平台上对ODBC、JDBC、Dynamic SQL和SQL Shell接口进行权限检查。 嵌入式SQL语句不执行特权检查; 假定使用嵌入式SQL的应用程序在使用嵌入式SQL语句之前会检查特权。

SQL权限和系统权限

要通过特定于SQL的机制操作表或其他SQL实体，用户必须具有适当的SQL权限。 系统级权限不足。 用户可以直接被授予SQL权限，也可以属于具有SQL权限的角色。

注意:角色是由SQL和系统级安全共享的:单个角色可以包括系统和SQ权限。

下面的例子，以Windows机器上的InterSystems IRIS为例:

• 在用户名称空间中有一个名为User.MyPerson的持久化类。 这个类被投影到SQL中作为SQLUser.

Message Router的功能是什么？Message Router可以监视task schedule里面的定时执行任务吗？求帮助

请教一下，如何在消息查看器打开”显示查询“这个按钮的显示开关

好消息， InterSystems 容器镜像仓库Docker桌面扩展已正式发布供大家 下载 .

大家可以在Docker桌面版的marketplace 下载.下载后需要重启 Docker Desktop to 

把数据库添加进Mirror

以往的经验里， 用户在把数据库添加到镜像时遇到过各种各样的问题，以致必须请求外部帮助才能解决。除了步骤本身比较繁琐，很大的原因是阅读文档不细致。还有一个，就是对英文水平不太高的用户，有些英文句式并不是很好懂，比如说，文档中有这一句其实非常关键：

If you attempt to add a new database to the mirror on a nonprimary member that was not created as a mirrored database on the primary, but rather added to the mirror after it was created, an error message notes this and you cannot complete the operation.

我用最好的翻译器DeepL翻译后的中文是：

如果你试图在一个非主要成员上向镜像添加一个新的数据库，而这个数据库并不是在主要成员上作为镜像数据库创建的，而是在创建后添加到镜像中的，那么就会出现错误信息提示，你无法完成操作。

Mirror的配置

这里详细介绍了主成员(Primary)和备用成员(Backup)的设置过程。 虽然也包括了异步成员配置的章节，其实我没有真的操作，我认为应该没有特别需要注意的。

配置Mirror应该有这么几步：

1. 启动Mirror服务

进入系统管理界面，选择系统管理>配置>镜像设置>启动镜像服务，勾选服务已启动， 保存退出。这是可以看到菜单栏的创建镜像条目已经从灰色变成正常的白色，表示您已经可以创建镜像。

仅仅是打开服务，并没有修改Journal文件

2. 创建镜像，添加主成员

在管理界面进入“系统>配置>镜像设置>创建镜像”，从这里开始镜像的创建工作。创建镜像的同时，这一步还包括把本机做为第一个镜像成员加入到镜像。第一个镜像成员被加入后会成为主镜像成员， 菜单里的英文是“Primary Failover Member"。

Warning: 如果本机的ISCAgent没有启动, 您会得到提示“错误 #2118: ISCAgent不在本地系统中启动”。另外，特殊情况下，您还可能会碰到错误提示：“错误 #2136: 实例的版本高于ISCAgent的版本”。

镜像的设置

如下面的截图，创建镜像需要提供这些配置信息：

• 镜像名称：可以是任意的名称, 和各个服务器/成员的名称无关。

• 需要SSL/TLS：如果您不勾选此选项，会得到“强烈建议使用SSL/TLS"的提示信息。

因为篇幅太长， 我把它分为3篇贴在社区

配置前的准备

配置Mirror前要准备三件事儿：

1. 规划网络连接。
2. 在所有的服务器中启动ISCAgent服务。
3. 准备服务器的SSL/TLS证书。可选， 但非常推荐。

我假设您在动手前一定已经对Mirror的原理和架构已经不陌生了，对镜像成员，DR(灾备)成员, Arbiter, ISCAgent等术语已经自动切换的概念有大概的认识。如果不是这样，请先阅读在线文档，或者这篇文章。

规划网络连接

Mirror应该配置两个网段：一个用于IRIS和外部的通信；另一个用于两个Mirror成员间的内部通信，也就是数据的同步。 尽管不是必须的，但Mirror作为一个高可用方案，为了保证服务器之间的内部通信不受和外部连接的干扰，把内部通信放在单独的网段是通常的做法，尤其是在生产环境。

下图来自IRIS的在线文档：其中绿色所示的是IRIS提供服务的网段，IRIS到所有外部系统的连接，ECP应用服务器，和Arbiter在工作在这个网段。紫色的“Data Center Private LAN for Mirror Communication"用于内部通信，准确的说， 用于journal的同步。为了方便， 我会在后面的步骤中简单的把这两个网段简单的称为外网网段和内网网段。

也是来自在线文档，上图的IP地址配置像这个样子。

InterSystems IRIS是一个伟大的数据平台，它满足了当前市场所需的功能。在这篇文章中，你可以看到我心目中的前10大功能:

Spring Boot 是最常用来创建 REST API 和微服务的 Java 框架。 它可用于部署 Web 应用程序、可执行 Web 应用程序或桌面自包含应用程序，其中应用程序和其他依赖项打包在一起。 Spring Boot 允许执行许多功能，请参见：

注：要了解有关 SpringBoot 的信息，请参见官方网站 - https://spring.io/quickstart

要创建具有一个或多个微服务的 Web api 应用程序，可以使用 Spring IDE for Eclipse/VSCode，并使用向导配置上述将在应用程序中使用的技术，请参见：

您可以选择技术并创建项目。 所有技术都将通过 maven 导入。 它就像一个可视化的 zpm。

所创建的项目有一个类用于为应用程序提供支持，其中包含所有所需内容（Web 和应用程序服务器，以及所有依赖项、微服务概念）。

此项目的完整源代码在以下 open exchange 项目中： https://openexchange.intersystems.com/package/springboot-iris-crud。

首先要配置 IRIS JDBC 驱动程序和 IRIS Hibernate 支持，为此，请将 jar 文件复制到 resources 文件夹，请参见：

打开 pom.

关于微服务架构（MSA）的IRIS定位的初学者指南。MSA在企业级Java世界中的能见度越来越高，因此，了解这股热潮背后的内容是至关重要的。我尝试着写下我的观点并与大家分享。

背景

首先，我必须承认。今年初夏，我的同事要求我收集一些关于匈牙利开发的医疗产品的信息。当我从相关公司得到反馈时，发现该产品是一个模块化系统，基于微服务架构（MSA）。好的。什么是MSA？在网上做了简短的研究，阅读了一些WIKI网页后，我得出结论：啊哈，又是一个 "架构"。我们可以用IRIS在 "架构层面 "遵守 "任何架构"--至少 "在某种程度上"。但也有一些恼人的地方。这让我对MSA有了更多的了解。到目前为止还不错，但是REST不是这篇文章的主要话题吗？MSA和REST之间的关系是什么？我访问的几乎每个网站都在例子中使用了RESTful网络服务。这让我有点怀疑。但总的来说，我赞同对MSA的一般总结：它是SOAP但做得很好。特别是因为有一些关于 "内聚 "和 "耦合 "的句子，我完全不明白。那么，如果MSA只是 "SOAP做得好"，为什么我没有看到SOAP的例子？为什么这些例子（几乎）都是RESTful？

在这个问题之前，对我来说，"REST "是一个使用JSON序列化数据交换的网络服务，通过HTTP传输。但是在那个时候，我脑子里有太多的问题，因此我开始阅读REST文献。很快我就找到了起源。

如果你读了我之前介绍QEWD微服务的文章，希望你会渴望了解如何使用它们。  所以在这篇文章中，我将解释你需要知道的东西，以便开始使用。

如果你在QEWD资源库中，你会发现目录: 

  https://github.com/robtweed/qewd/blob/master/example/jwt

在我之前关于JSON网络令牌（JWTs）和QEWD的文章中，我用这个示例应用程序来解释如何使用JWTs。  这个示例应用程序还演示了如何设置一个简单的微服务，在这种情况下是一个处理用户认证的服务。  所以，现在让我深入了解一下这个例子应用程序的这方面内容。

如果你想使用QEWD微服务，你也必须使用JWTs--它们提供了一种方法，用户的认证和会话可以被多个独立的QEWD服务器交叉通信和处理。  因此，请看一下启动文件:

   https://github.com/robtweed/qewd/blob/master/example/jwt/startup_file/q….

Globals是InterSystems IRIS的数据持久性的核心。它很灵活，允许存储JSON文档、关系数据、面向对象的数据、OLAP立方体和自定义数据模型，例如思维导图。要了解如何使用globals来存储、删除和获取思维导图数据，请遵循以下步骤:

1. 把repo Clone/git到任意本地目录

$ git clone https://github.com/yurimarx/global-mindmap.git

2. 在该目录下打开Docker 终端并执行:

$ docker-compose build

3. 启动 IRIS 容器:

$ docker-compose up -d

4. 访问 http://localhost:3000 来使用思维导图的前端并创建类似以上的思维导图

本例子的源代码

存储数据 (更多请访问: https://www.npmjs.

Hi 我在线部署了一个demo演示:

https://production-monitor.demo.community.intersystems.com/csp/user/EnsPortal.ProductionConfig.zen?PRODUCTION=dc.Demo.Production#

我更新了几个设置（文件路径和URL），并将调度类切换到dc.rest.GenericService。

我从文件服务重新发送了消息。我看到授权Auth和API服务都收到了消息。

API进程（还）没有返回所需的响应。更多内容请继续关注...

  大家都用过IRIS的消息查看器吧，其实这个页面有一个隐藏的功能，就是显示【显示查询】，如图所示：

那么这个东西是如何打开的呢？如果一句话概括就是: Terminal下输入: Set ^Ens.Debug("UtilEnsMessages","sql")=1，这个也是打开这个功能的思路，下面是详细的说明。

开启功能的步骤：

    1、进入Terminal，输入用户名\密码；

  2、进入需要打开显示查询的命名空间：如 zn "BKIP"

  3、执行 【Set ^Ens.Debug("UtilEnsMessages","sql")=1】打开显示查询。

打开消息查看器页面刷新：

成功！！！ 

他有什么作用呢？举个栗子，当我修改基本条件为会话开始，点击【搜索】然后再点击【显示查询】

可以看到刚才在页面点击的操作生成了SQL并且显示在新的弹框里面了 すごい（四个一）。

基于此我们能做什么呢？

任何技术总是有些自己独特的术语，尤其是一些英文术语，对于新的用户来说往往即陌生又迷惑。这里整理了一下常听到的InterSystems术语，帮助大家尽快进入InterSystems技术圈子。

原文可见 这里，原作者 Robert Cemper

我们在SQL中的经常被提到视图VIEW，基本上是一段预先设计好的SQL语句，它也像任何其他SQL查询语句一样执行和组装。

而物化视图MATERIALIZED VIEW意味着查询的内容是预先收集的，这些数据可以相当快地进行检索。

我第一次看到这个概念是和我最喜欢的竞争对手O* 一起的，他们对此功能发出了很多的声音。

然而在Caché/IRIS中，这种功能几乎是一早就存在的，我们认为这是很正常的普通功能。只是我们大多数开发人员只是没有意识到这一点，只要稍加润色，它就可以作为一个优秀的特性呈现出来。 此外，任何更新和维护都是作为内置的能力进行的，无需开发人员任何额外的工作。

看下面的例子：

在我们的Sample.Person类中，我们可以定义一个索引

/// Define an index for <property>Name</property>.
Index NameIDX On Name [ Data = (Name, Home.State, SSN) ];

正如我们预想的那样，在执行下面的查询时，它会非常的快

SELECT ID, Name, Home_State, SSN   from Sample.Person

因为这个查询所涉及到的内容都来来自索引global ^Sample.

在我们开始谈论数据库和现有的不同数据模型之前，我们最好先谈谈什么是数据库以及如何使用它。

一个数据库是以电子方式存储和访问的有组织的数据集合。 它用于存储和检索通常与主题或活动相关的结构化、半结构化或原始数据。
每个数据库的核心至少存在一个用于描述其数据的模型。 并且根据它所基于的模型，一个数据库可能具有略微不同的特征并存储不同数据类型。

要写入、检索、修改、排序、转换或打印数据库中的信息，需要使用称为数据库管理系统 (DBMS) 的软件。

数据库及其各自的数据库管理系统的大小、容量和性能增加了几个数量级。 各个领域的技术进步使之成为可能，例如处理器、计算机内存、计算机存储和计算机网络。 一般来说，数据库技术的发展根据数据模型或结构分为四代：导航型、关系型、对象型和后关系型。

与以特定数据模型为特征的前三代不同，第四代包括许多基于不同模型的不同数据库。 它们包括列、图、文档、组件、多维、键值、内存等。所有这些数据库都由一个单一的名称 NoSQL 联合起来（没有 SQL，或者现在更准确地说不仅仅是 SQL）。

而且，现在出现了一个新的类，叫做NewSQL。 这些是现代关系数据库，旨在为在线事务处理工作负载（读写）提供与 NoSQL 系统相同的可扩展性能，同时使用 SQL 和维护 ACID。

顺便说一下，在这些第四代数据库中，有那些支持上述提及的多种数据模型的数据库。 它们被称为多模型数据库。

我很高兴与大家分享我第一次使用docker容器版本的IRIS for Health的经验，以探索你对使用或试用的兴趣，利用docker容器的优势，它是轻量级的，易于部署。本文将通过使用Renan Lourenco编写的名为ENSDEMO的GitHub仓库的实施步骤。

设置IRIS for Health社区版docker容器环境的步骤：

1. 启动运行Docker
2. 下载docker 镜像image

docker pull containers.intersystems.com/intersystems/irishealth-community:2022.2.0.304.0

3. 从GitHub 克隆源repository

git clone https://github.com/OneLastTry/irishealth-ensdemo

4. 改一下文件目录.
5. 从docker-compose.yml建立容器镜像

docker-compose build

6. 运行你的容器

docker-compose up -d

在我最初的尝试中，我无法下载irishealth community:2022.2.0.304.0的确切版本，因为它在ENSDEMO的最初发布中已经发生了变化。修复方法是，当试图从InterSystems容器注册表拉出docker镜像时，在注册表中拉出最新的可用标签。

各位开发者, 

新的视频已经发布在BiliBili平台：

⏯ 在InterSystmes IRIS 使用 Business Process Designer（业务流程设计器）

Hi 大家好!

我经常会看到CSP 应用提示一些没有什么意义的错误信息，比如：

InterSystems 有解析log文件的工具或者API吗？

我需要在当前命名空间下创建一系列的只读类，并限制除_system之外的所有用户都只有读取权限，无法在studio中编译，请问我应该如何操作呢？
我的目的是可以在工程的项目分支中管理这些类，并通过发布方式持续升级这部分类文件。
但是这些类的内部逻辑有可能会需要维护人员能够知晓其中的功能和实现方式，所以不能通过MakeDeployed来解决这个问题
我现在知道可以通过设置database的读写属性来解决这个问题，但是这样就需要额外新建一个database并maping到当前命名空间下。采取这种方式处理时有一个重大的缺点，即在执行代码发布过程中，需要停库，并且停库时间可能会在半个小时左右，这个我无法接受。

亲爱的开发者们！

到了展示互操作性技术的时候了！来参加我们最新的竞赛吧！

🏆 InterSystems开发者大赛：以互操作性技术为可持续发展构建解决方案 🏆

时间: 8月29日-9月19日（北京时间）

奖金更高: $13,500 – 请留意，奖金分配跟以往有所不同！

第五章 配置系统信息

IRIS 将系统范围的配置信息存储在称为配置参数文件 (CPF) 的文件中。该文件是一个重要工具，因为它包含IRIS 实例的大部分可配置设置。每个实例都部署了一个默认 CPF，它位于安装目录中。可以直接在文本编辑器中修改 CPF，也可以从管理门户或终端间接修改。在 UNIX® 和 Linux 上，还可以通过指定配置合并文件在部署期间自定义 CPF IRIS 使用该文件在实例首次启动之前更新默认 CPF。

对于任何新安装的实例，必须更改几个启动设置，以及应该查看的其他设置。本节讨论最初要考虑的这些设置：

内存和启动设置

当第一次安装 IRIS 时，应该查看和调整内存分配以及其他配置设置。在确定 IRIS 实例使用内存的方式时，必须采取三个主要操作，如下所示：

• 使用内存和启动页面（系统管理 > 配置 > 系统配置 > 内存和启动）为数据库和例程缓存分配内存。

• 设置 IRIS 进程可以使用的最大内存

• 配置通用内存堆（也称为共享内存堆）的大小，这决定了 IRIS 可用于例程和数据库缓存之外的其他用途的内存；

重要提示：首次安装 IRIS 时，数据库和例程缓存内存分配设置为自动，在此情况下， IRIS 为数据库缓存（全局缓冲区）分配总物理内存的 25%。

此设置不适用于生产用途。