搜索​​​​

前面介绍了通过mirroring或shadow，使用journal日志过滤器的方式，在不改动数据模型的情况下实现InterSystems IRIS/Caché上的CDC能力。但如果你可以修改InterSystems IRIS/Caché上的数据模型，也可以考虑使用DSTIME特性实现变更数据捕获。 DSTIME特性 DSTIME特性是InterSystems IRIS/Caché的嵌入式实时BI工具DeepSee用于跟踪数据变更的。InterSystems IRIS和2011版之后的Caché，都支持DSTIME特性。它会自动记录数据库中SQL表记录或持久化对象的变更，并将变更记录写入持久化的多维数组^OBJ.DSTIME中。 DSTIME特性是针对于SQL表/持久化类的，因此需要为每个需要记录变化的表/持久化类开启。当开启了DSTIME的表/持久化类，有记录插入、更新、删除时，InterSystems IRIS/Caché引擎会自动在^OBJ.DSTIME中记录这些操作。其格式为：^OBJ.DSTIME(类名,DSTIME,对象ID) = 执行的操作代码 DSTIME:当SQL表/持久化类的参数DSINTERVAL未被设置时，DSTIME=0；当SQL表/持久化类的参数DSINTERVAL被设置时，DSTIME=1840/12/31午夜12点到记录发生时的秒数。 执行的操作代码： 代码 操作 0 更新 1 插入 2 删除 例如：^OBJ.DSTIME(“Demo.Patient”,5673588714,2) = 1^OBJ.DSTIME(“Demo.Patient”,5673588735,3) = 1^OBJ.DSTIME(“Demo.Patient”,5673588784,4) = 1^OBJ.DSTIME(“Demo.Patient”,5673588791,2) = 0 因此，如果你没有使用DeepSee，就可以监控^OBJ.DSTIME即可获得IRIS/Cache’的数据变更。注：DeepSee在同步cube时，会自动查询、操作、删除^OBJ.DSTIME的数据，因此，将会对于直接使用它进行数据变更捕获产生影响。如果你的确在使用DeepSee自动同步cube，也想使用^OBJ.DSTIME实现CDC，请联系InterSystems获得解决方案。这不在本文的讨论范围。 开启DSTIME特性 InterSystems IRIS/Caché可以在SQL表建模时、对象模型上开启DSTIME特性。涉及2个类参数：DSTIME 和DSINTERVAL DSTIME 类参数设置为AUTO时，InterSystems IRIS/Caché会自动记录对应SQL表/持久化类的数据变更。DSINTERVAL类参数控制记录的数据变更如何分组。用于实现CDC时，建议设置该参数=1。 1. 通过SQL建模，新建SQL表 在使用SQL新建表时，可以增加对于类参数DSTIME 和DSINTERVAL的设置。 例如下面的SQL创建一个开启了DSTIME的表Demo.Patient： CREATE TABLE Demo.Patient ( %CLASSPARAMETER DSTIME = 'AUTO', EMPNUM INT NOT NULL, NAMELAST CHAR(30) NOT NULL, NAMEFIRST CHAR(30) NOT NULL, CONSTRAINT EMPLOYEEPK PRIMARY KEY (EMPNUM)) 其中%CLASSPARAMETER DSTIME = 'AUTO'开启表的DSTIME特性。 2. 通过面向对象建模，修改持久化的对象模型 对于对象模型，在建模时或之后修改模型，设置DSTIME类参数的方式开启：Parameter DSTIME = "AUTO";： Class Demo.Patient Extends %Persistent [ ClassType = persistent, DdlAllowed, Final, Owner = {_SYSTEM}, ProcedureBlock, SqlRowIdPrivate, SqlTableName = PATIENT ] { Property NAME As %Library.String(MAXLEN = 1) [ SqlColumnNumber = 2 ]; Property DOB As %Library.Date [ SqlColumnNumber = 3 ]; Parameter USEEXTENTSET = 1; Parameter DSTIME = "AUTO"; Parameter DSINTERVAL = 1; } 3. 对批量对象模型增加DSTIME特性 如果想对整个SQL Schema下对所有表或一个包下的所有对象类增加DSTIME，也可以定义一个持久化的纯虚基类，在基类中定义DSTIME类参数，然后让所有的类继承于这个基类。示例代码如下： 定义基类： Class Demo.Super Extends %Persistent [ Abstract, NoExtent ] { Parameter DSTIME = "AUTO"; } 注意，基类应该设置NoExtent关键字，以避免编译器生成存储模型。 修改子类，使Demo.Super成为其主父类： Class Demo.Patient Extends Demo.Super [ Language = objectscript ] { Property NAME As %Library.String(MAXLEN = 100) [ SqlColumnNumber = 2 ]; Property DOB As %Library.Date [ SqlColumnNumber = 3 ]; } 测试 开启DSTIME后，就可以使用SQL或对象操作方式，在InterSystems IRIS/Caché中执行一些插入、更新、删除操作，并观察持久化多维数组^OBJ.DSTIME的记录。 总结 通过开启DSTIME特性，让InterSystems IRIS/Caché自动记录需要追踪的SQL表或持久化类的数据变更，可以方便的通过^OBJ.DSTIME捕获这些变更，并处理数据变更或将变更记录输出到下游系统。 其它注意事项：应考虑在处理/输出完数据变更后，记录上次处理的DSTIME值，或删除^OBJ.DSTIME中已处理过的记录，以方便持续的、高效的捕获新的数据变更。 CDC系列 更多的CDC选项实现，请参考： 1. CDC系列之一 ：使用Dejournal Filter在InterSystems IRIS/Caché上通过Mirroring实现CDC功能 2. CDC系列之二 ：使用Dejournaling filter routine在Caché上通过Shadow实现CDC 3. CDC系列之三 ：建立InterSystems IRIS/Caché的Global数据变更与SQL表记录的对应关系 4. CDC系列之四：使用DSTIME特性在InterSystems IRIS/Caché上实现CDC功能

Production是开发者基于InterSystems IRIS产品家族实现互操作功能的主要技术架构。而每个Production的运行依赖于三类主要的业务组件： 业务服务(Business Service) 业务流程(Business Process) 业务操作(Business Operation) 三类组件间以消息作为信息交换的主要媒介。因此，要保障互操作业务的稳定运行，除保障软件平台有充足的软硬件资源运行外，保障Production中消息的高效传输以及三类组件的平稳、高效运行则是运维团队面临的主要目标。下面列举的若干项任务则有助于运维团队实现这些目标： 优化业务组件运行效率 Production中的业务组件都有运行池的概念，允许业务组件运行在多个进程上并发工作以提高整体性能。运行池又可以分为私有池和参与者池两类。 私有运行池 业务组件的CPU作业的数量 默认为1即可工作 通过性能测试确定最佳的池大小 拥有私有池的业务组件从私有队列中处理消息 无适配器业务服务的池大小需设置为0 需要多进程时，池大小设为1可以保证信息以先进先出（FIFO）顺序处理 整个消息流中的所有业务组件的池大小都不应大于1 参与者池 Production级的参与者池设置 用于处理公共队列中的请求的CPU作业的数量 由使用公共队列的所有业务流程共享。 业务流程和业务操作的池大小设置。 0 - 使用参与者池和公共队列 非0--使用私人队列，有指定的CPU作业数 对于FIFO，设置池大小=1 参与者池与业务流程的启停 任何一个池大小为0（仅使用公有池）的业务流程被禁用时，所有的参与者都不会启动 防止任何池大小为0的业务组件从公共队列中处理消息 要保障其他参与者正常工作 将要被禁用的组件的Pool Size改为大于0并应用 如果已经禁用，要启动其他参与者 保持组件禁用，但将其Pool Size为大于0并应用 Production的运行维护 Production本身具备一系列的运行状态管理功能，帮助运维团队在生产环境上处理Production运行的一系列任务，包括 Production运行维护 – 自动启动 Ensemble > 管理 自动启动Production > 选择要自动启动的Production 在Ensemble启动时自动启动Production 如果需要的话，会自动调用RecoverProduction()方法，恢复Production状态 系统级启用开关 系统管理 > 配置 > 其他设置 > 启动 > EnsembleAutoStart 默认情况下为 "真"。 在排除故障时，可能需要禁用。 Production运行维护 – 强制关闭 如果Production关闭得太慢 等待关闭超时 显示强制关闭按钮 Production运行维护 – 更新 运行的组件与它的底层类代码不同步，需要Production来更新 业务组件进程因错误而意外关闭，需要重新启动 设置的改变需要业务组件重新启动 更新按钮出现在Production配置页面。 Production运行维护 – 恢复 在非正常关机和一些错误之后出现 如果需要，自动启动Production将在启动前自动恢复 Production运行维护 – 中断 在配置页面上显示 Production被关闭时如果满足如下条件之一： 有同步消息在等待响应。 或者，队列非空，意味着Production还没处理完消息 或者，消息仍在被组件处理 或者，有级别较高的告警请求 Production中断后的选项 重新启动Production以完成消息的处理 如果启动后消息仍然被组件不断重试（提示故障未排除） 修复导致重试的问题 挂起消息 中断消息 在测试系统中（决不能是生产系统），如果你决定必须完全清除所有队列，请调用Ens.Director类的CleanProduction()方法 do ##class(Ens.Director).CleanProduction() Production的配置 Production本身是基于InterSystems的大量预制组件经开发或直接部署产生的软件包，因此将包含大量不需要在代码中固定写好的配置项，例如远程连接的地址，扫描数据表使用的SQL等。运维团队的工作之一，就是在外部环境发生变化，例如第三方系统部署地址发生变化时，通过调整Production的设置来应对变化，而无需更改已部署的代码。 凭据 用于登录远程系统。 在出站适配器的凭据设置中指定 在Ensemble > 配置 > 凭据中设置 Production配置数据的来源 导出Production 配置页 > Production设置 > 操作选项卡 > 导出 创建与类/部件相关的XML文件 验证是否需要额外的类 可用于 部署到另一个实例中 部署到另一个命名空间 保存Production 部署Production Ensemble à 管理 à 部署变化 à 部署 会创建回滚文件及部署日志 导出与部署的当前限制 除业务组件外，组件配置、规则、DT等组件运行依赖的部件不会自动被识别，需要人工选取并导出 DSN, 凭据等含安全信息的配置不会被导出（实例级配置，非Production级配置），需要手动在部署端配置。产品化研发中需要考虑通过自定义任务定期同步到备机或其他实例。 清除Production数据 当Production在生产中运行较长时间后，往往会累积大量的告警，事件日志和互操作消息等运行数据。用户可选择定期删除一部分不再需要的数据，保证磁盘空间的充裕。 直接执行 Ensemble > 管理 > 清除管理数据 直接执行清除任务受限于浏览器进程超时设置，如在清除过程中触发超时，将导致清除进程失效退出，中断消息清除过程。 对于大量消息累积的场景，请使用后台任务周期性执行确保清除效果。由于删除数据时也将产生大量的journal，删除前应在journal所在存储上保留充裕的空间。 后台任务 系统操作 > 任务管理器 > 新任务 空闲超时设置 组件被标记为不活动，如果 组件在给定的#秒内没有活动 黄色表示不活动的组件 Production监控 配置页面 Production运行监控 IRIS平台为用户提供了一系列工具展现组件的运行状态。运维团队需要频繁地使用这些工具用于定位和诊断故障，识别性能瓶颈等。 Production监视器 一页式监控业务服务、业务操作、队列和错误。 点击单个组件了解详情 提供对队列和事件日志的访问 事件日志 检索、过滤和清除日志 联合使用事件日志和可视化追踪 错误、警报和警告事件日志条目显示在可视化追踪中 点击图标可以查看事件日志详情 业务规则日志 Ensemble > 查看 > 业务规则日志 每次尝试匹配规则时的条目 空原因表示没有匹配的规则 日志内容 I/O 记录 组件配置 除了Production信息外，还对输入和输出数据进行存档 TCP输入输出 文件输入输出 输入和输出数据显示在可视化跟踪窗口中 组件状态指示器 状态指示器提供业务组件健康状况的可视化 绿色 – 正常 黄色 – 不活动（项目空闲时间超过其空闲超时设置） 红色 - 错误。 灰色 - 禁用。 暗绿色或暗灰色 -- Production目前没有运行 紫色 - 遇到失败但在重试的信息 消息队列 要查看队列 Ensemble > 监视器 > 队列 > 在队列中点击消息查看详情 Production配置页 > 选择组件 > 队列Tab 组件在给定的#秒内没有活动 可以查看、挂起和中断整个队列的消息处理 消息队列与性能调优 消息队列的变化常常可以用于评估组件性能及识别性能瓶颈，运维团队可以根据瓶颈所在位置和上下游组件队列的变化情况调整Pool Size获得优化性能。 忽然暴增的队列 如果发生在业务操作 通常由外部系统导致 连接中断 暴增的业务高峰 如果发生在业务流程 业务流程可能出现错误，导致它以某种方式 "卡住” 长期堆积的队列 如果发生在业务操作 可能是在向外部应用程序发送消息时出现持续延迟 看看外部系统的性能问题是否能得到解决。 如果不能，考虑增加池子的大小设置（除非需要FIFO） 如果发生在业务流程 考虑增加池（私有池或参与者池）大小的设置（除非需要FIFO） 可能有算法缺陷，考虑优化 多个队列长期堆积 潜在的原因 主机容量不够（内存/CPU/IO） Ensemble需要更多的资源(内存、CPU) 底层的Caché实例可能需要调整（内存、IO） 永远不要低估低速存储的影响 作业 提供关于CPU作业运行配置项的信息 Job # = 操作系统进程ID 状态 Dequeuing - 等待信息被处理(最常看到的) Running - 工作，重试或无限循环 Quiescent - 生产关闭期间的状态 Error 能够按照日程周期运行的作业非常适合用于执行系统运维任务 周期性清除过期Production数据 按照备份策略周期性执行全量、累积和增量备份 定期清除过期的数据库journal 定期对数据库进行一执行检查 定期对数据库执行压缩截断释放空间（慎用） 定期将无法通过mirror同步的配置推送到备机（例如DSN、凭据等） 活动量监控 活动量和持续时间监视器显示每个接口的统计数据 Ensemble > 监视器 > 活动量和持续时间。 按时间段过滤（分钟、小时、天、周、月、年） 可以根据需要建立自己的仪表盘来显示所需数据 也可通过SQL查询 启用活动量收集 将Ens.Activity.Operation.Local Business Operation添加到Production中 为统计数据指定存储命名空间 为Production启用统计数据收集 do ##class(Ens.Util.Statistics).EnableStatsForProduction() 为命名空间的Web应用程序启用DeepSee 系统管理 > 安全 > 应用程序 > Web应用程序 使用PurgeActivityData任务进行清理。 使用作业控制周期任务

在互操作功能运行过程中，IRIS可以识别异常情况的发生，自动生成告警事件并通过预制的互操作组件将告警转发给干系人；另外，IRIS也内建了告警工作台，可供运维团队基于工作流实现对告警的管理。 告警设置与转发 Production告警设置 在Production级别可以设置对连接异常的告警设置，及告警组件设置 组件告警设置 控制何时触发警报。 队列计数警报。 队列中的信息数量 队列等待警报。 消息在队列中停留的秒数 不活动超时。 业务组件不活动的秒数 在v2012.1之前，不会触发告警 警报宽限期 与外部连接有关的错误可以有宽限期设置 设置重新建立连接的时间，超时且连接不成功才会发出告警 业务服务 警报宽限期 业务操作 再次发出警报宽限期 转发告警 EnsLib.EMail.AlertOperation 内置告警转发组件 通过Email转发 路由到其他接口转发 REST - 短信 REST - 钉钉 用户需要执行的规划 什么样的告警需要即时通知 告警的通知是否应该成为一个应用 包含告警组件的Production 包含告警组件与业务组件的Production形态如下 其中，用于告警的业务组件包括 告警托管 在互操作功能中产生的告警可以选择转发到第三方系统触发告警运维工作流，也可以在IRIS中进行托管，通过IRIS提供的较为简单的工作流定义实现对告警的统一存储及管理。 工作原理 告警管理BP 决定是否产生新的托管告警 可以设置告警的所有者 通知管理BP 决定如何发送告警 决定谁将收到通知 将告警通知发送到指定组件 告警监视BS（可选组件） 可以将过期告警升级 决定是否发出提醒 典型的告警数据流如下 其中，告警数据产生后经过平台自动丰富，最终形成可供运维人员操作的托管告警 托管告警流程 告警处理流程可能的选择： 告警仅写入日志文件，没有自动通知。 一个简单的告警通知系统，所有告警都通过Email发给用户 根据告警类型和生成告警的组件，将选定告警通过路由发送给不同的用户 实现告警管理框架，用于发送告警通知、升级未解决的告警，并记录当前状态和为解决告警而采取的操作的历史记录 告警路由规则 在告警管理器中可以应用规则，通过路由规则来定义告警的流向。 来源 允许根据不同的故障组件采取不同的行动 消息类 Ens.AlertRequest或无 目标 其他消息路由，用于进一步的路由 业务操作作为最终目标 可以通过数据转换根据传递目标定制告警 托管告警管理 通过Ensemble > 监视器 > 我的托管警报可进入告警管理页 该功能基于IRIS自身的用户设置。告警责任人的分配、告警级别管理、后续操作时限等，都可以在该页上进行操作。 也可通过SQL查询和操作已产生的告警 对于需要自定义工作流的用户，也可以考虑在此基础上实现流程。 祝老师您好，请问系统级别的告警如何推送，就像系统日志中告警级别为2的日志。 Hi， 有两个办法： 1. 自己写代码扫描messages.log获得这些告警 2. 扩展平台内置的告警通知类，可以自定义传感器、消息订阅器和通知分发器，参见 https://docs.intersystems.com/irisforhealth20223/csp/docbook/DocBook.UI.Page.cls?KEY=GCM_healthmon#GCM_healthmon_sysmon_userdefined 感谢祝老师的答复，第一种方法已经实现，我研究下第二种方法。

# 第五十章 使用 ^SystemPerformance 监视性能 - Microsoft Windows 平台的 InterSystems IRIS 性能数据报告 #### Microsoft Windows 平台的 IRIS 性能数据报告 - `%SS` - 使用 `ALL^%SS` 命令在运行过程中采集了四个样本。 - `Configuration *` - 来自服务器的 `IRIS` 实例名称和主机名、完整的 `IRIS` 版本字符串、许可客户名称和许可订单号。 - `cpf file *` - 当前活动配置文件的副本。 - `irisstat -c` - 使用命令 `.\bin\irisstat -s -p-1 -c-1 -e1 -m8 -n2 -N127` 在运行过程中以均匀间隔采集四个样本。以下是对每个参数的简要说明： - `-p-1`: 对进程表进行采样以包括进程和全局状态信息。 - `-c-1`: 对共享内存的计数器部分进行采样以显示日志、锁、磁盘和资源使用统计信息。 - `-e1`: `SYSLOG` 错误表。 - `-m8`: 文件表，其中包括所有 `IRIS.DAT` 文件及其属性。 - `-n2`: 网络结构表，包括本地到远程数据库的映射。 - `-N127`: 客户端和服务器连接的 `ECP` 统计信息。 - `irisstat -D` - 使用命令 `irisstat cache --f1 -D10,100` 在运行过程中以均匀的间隔采集八个样本。以下是对每个参数的简要说明： - `-fl`: 基本标志。 - `-D10,100`: 在 `10` 秒的总采样周期内，每 `100` 毫秒对块碰撞进行采样。 - `license *` - 使用 `Decode^%LICENSE` 和 `counts^%LICENSE` 的 `IRIS` 许可使用信息。 - `mgstat` - 使用 `^mgstat` 实用程序在运行过程中获取 `IRIS` 特定数据。 - `perfmon` - `Microsoft Windows perfmon` 实用程序的输出。 `Microsoft Windows perfmon` 数据的默认呈现方式是原始格式。可以将格式切换为已处理，这会删除重复的服务器名称并将日期时间列拆分为单独的列，以提高可读性。以下函数允许查询和更新确定 `perfmon` 数据是否被操作的标志：`set rc=$$setperfmonpostproc^SystemPerformance(`) 其中 `onoroff` 可以是 `1`（开）或 `0`（关），或者不区分大小写的单词`“on”`或`“off”`。返回码 `1` 表示标志更新成功，`0` 表示更新失败，`-1` 表示非 `Windows` 平台。要确定当前格式（原始格式或已处理格式）：`set status=$$getperfmonpostproc^SystemPerformance()` 返回代码 `1` 表示已处理格式，`0` 表示原始格式。此外，在 `^SystemPerformance` 的交互式运行中，在配置文件菜单显示之前报告标志的当前状态。默认情况下，`perfmon` 监视默认 `pbctrs.txt` 文件中指定的计数器定义。要监视先前定义的性能计数器，请使用以下命令将定义导入 `^SystemPerformance`：写入 `$$importctrs^SystemPerformance(WindowsCtrName [,SystemPerformanceCtrName [,SystemPerformanceFileName]])` 返回代码 `0` 表示成功，负数后跟原因字符串表示失败.不允许重复的 `SystemPerformance` 计数器名称。如有必要，`^SystemPerformance` 会生成内部计数器名称和文件名。要将默认的 `SystemPerformance` 计数器定义更改为现有定义，请使用：`write $$setctrddefault(SystemPerformanceCtrName)` 返回代码 `1` 表示成功，后跟原因字符串的 `0` 表示失败。如果指定了无效计数器，则会设置内置默认值。要重置默认的 `SystemPerformance` 计数器定义，请使用：`do clrctrdefault^SystemPerformance()` 要将特定的 `SystemPerformance` 计数器定义与现有配置文件相关联，请使用：`write $$addctrtoprofile(ProfileName,SystemPerformanceCtrName)` 返回码 `1` 表示成功，`0` 后跟一个原因字符串表示失败。如果配置文件或计数器定义不存在，则不会运行该命令。 - `Profile *` - 有关创建此日志的 `^SystemPerformance` 配置文件的信息。 - `tasklist` - `tasklist -V` 命令的四个输出，在运行过程中以均匀的间隔获取。 `tasklist -V` 命令提供系统上运行的所有进程的列表。 - `Windows info *` - `systeminfo` 命令的输出，包括 `Windows` 版本（不包括修补程序信息）和硬件信息；例如，处理器数量、安装的内存和使用的内存。

照顾好我们的客户并打造伟大的产品。这是我们InterSystems自从1978年成立以来的座右铭。40多年很快过去，这始终驱动着我们前进。过去是，未来也将一直是我们的基因。 追求卓越和持续提升的价值观是我们的“客户至上”方法取得成功的关键。这也是过去三年我们一直积极参与Gartner及其Peer Insights项目的原因，该项目主要征求最终用户的反馈意见和对厂商的打分。InterSystems连续两年荣膺Peer Insights运营数据库管理系统（ODBMS）客户选择奖，而且是该类别评分最高的供应商之一。 此外，InterSystems还入选Gartner目前推出的Gartner“客户至上”计划，并获得相应标识（上图），这一计划认可了我们为客户提供的坦诚分享、公正反馈的环境，根据用户反馈，我们不断改善产品和服务，从而最大程度地满足不断变化的客户需求。简言之，我们没有人为影响客户在Gartner网站上对我们的评价。这体现了我们对客户的承诺以及开放沟通渠道的重要性。InterSystems IRIS®数据平台是Gartner最新的云数据库管理系统魔力象限（Cloud Database Management Systems Magic Quadrant）中唯一获得此标识的产品，我们对此深感自豪。 以客户为中心的基因DNA 在我尚未加入InterSystems前，作为一家医学实验室的IT人员，我曾体验到InterSystems的“客户至上”。当时，我们还与另一家供应商合作，但他们的支持服务并不理想——我们需要等待很长时间；需要向很多人重复说明问题，而这些人并不能解决问题；我们还需要不断进行身份验证。他们的服务与其说是提供帮助，不如说是让人筋疲力尽，我认为他们从未将我的利益放在心上。 而InterSystems提供了天壤之别的客户体验。我第一次遇到问题呼叫InterSystems支持中心时，一位名叫Terry的人立刻接通了电话。他没有让我验证身份，而是让我解释了一下问题，并一直在线提供支持直到问题得到解决。当时我并不知道这位Terry居然就是InterSystems的创始人兼首席执行官（现在仍是）。显然，对InterSystems来说，最重要的事情是解决问题、让客户满意。尽管现在许多事情已经发生了改变（我们现在有不同人员负责处理服务请求了），但我们依然坚持这一理念。（注明：作者在1984年加入Intersystems 公司，这段故事发生在将近40年前公司刚刚成立的时候） 每周一上午，InterSystems总部都会召开高管例会，然而会议重点并非是公司的销售指标或收入，而是探讨如何通过改善产品、业务模式和支持服务来增强客户的成功。会议至少有一半的时间是在讨论客户支持服务——哪位客户提出了问题、我们是如何解决的、客户是否满意等等。 我们将客户支持作为我们的一大亮点，因为它能够彰显我们帮助客户成功的热情。如果我们能够助力客户实现自身目标，这比签署了一笔大单更有价值。这能够培育不可复制的客户信任。我们现在的客户留存率在99%以上，结果不言自明。 “如果你不清楚应该帮助客户还是帮助公司，那么请选择帮助客户。”——Terry Ragon，InterSystems CEO 未来之路 我们对获得Gartner的“客户至上”标识深感自豪。对我们而言，这不仅是又一次的认可，更是一个信号——我们正沿着正确的方向为用户提供卓越客户服务，其结果和客户口碑能说明一切。 借助Gartner的帮助，我们希望继续努力提供尽可能最佳的客户支持，我们的员工配备也反映了这一目标。我们授予支持团队与工程师和开发人员同等重要的权利，这样他们就可以为客户做出重要决定，而不必来回请示。对InterSystems而言，这不仅是客户支持的未来之路，也是我们提供最佳产品和服务的前进方向。 注：作者John Paladino是InterSystems负责客户服务的全球副总裁。自1984年加入InterSystems以来，他帮助开发了自动化支持跟踪系统和针对所有InterSystems软件产品的客户培训项目，制定并实施了旨在改善响应性、提高客户满意度的服务标准，并主导多个国内外团队建设计划。在加入InterSystems之前，他曾在New England Pathology担任三年的系统工程经理，负责获取、实施和管理各类信息技术。Paladino曾在伍斯特理工学院和马萨诸塞大学卢维尔分校攻读电机工程专业。 博客原文：How Can Putting the Customer First Drive Excellence and Innovation? 微信公众号原文：深深植根于InterSystems的DNA中，客户至上理念如何推动卓越与创新？ 欢迎大家参与评审给我们提供宝贵意见：参与gartner-peer-insights同业评审，赢取价值25美元的礼品卡

在这篇文章中，我们将使用docker和 参数配置文件模版 这一新特性来运行IRIS集群且轻松配置好。 在 UNIX® 和 Linux 上，您可以使用声明式参数配置合并文件来修改默认的 iris.cpf。合并文件是一个部分 CPF，在实例启动时为任何数量的参数设置所需的值。CPF 合并操作对每个实例只起一次作用。 我们的集群架构非常简单，它将由一个主节点（Node1）和两个数据节点（检查所有可用角色）组成。不幸的是，docker-compose不能部署到几个服务器上（尽管它可以部署到远程主机上），所以这对本地开发分片的数据模型、测试等很有用。如果是生产的InterSystems IRIS集群部署，你应该使用ICM云管理器或IKO K8S调度器。 Docker-compose.yml 我们从docker-compose 配置开始: docker-compose.yml version: '3.7' services: iris1: image: containers.intersystems.com/intersystems/iris:2020.3.0.221.0 init: true command: --key /ISC/iris.key hostname: iris1 environment: - ISC_DATA_DIRECTORY=/ISC/iris.sys.d/sys1 - ISC_CPF_MERGE_FILE=/ISC/CPF2merge-master-instance.conf volumes: - ./:/ISC:delegated ports: - 9011:1972 - 9012:52773 iris2: image: containers.intersystems.com/intersystems/iris:2020.3.0.221.0 command: --key /ISC/iris.key --before 'sleep 60' init: true hostname: iris2 environment: - ISC_DATA_DIRECTORY=/ISC/iris.sys.d/sys2 - ISC_CPF_MERGE_FILE=/ISC/CPF2merge-data-instance.conf volumes: - ./:/ISC:delegated depends_on: - iris1 ports: - 9021:1972 - 9022:52773 iris3: image: containers.intersystems.com/intersystems/iris:2020.3.0.221.0 command: --key /ISC/iris.key --before 'sleep 60' init: true hostname: iris3 environment: - ISC_DATA_DIRECTORY=/ISC/iris.sys.d/sys3 - ISC_CPF_MERGE_FILE=/ISC/CPF2merge-data-instance.conf volumes: - ./:/ISC:delegated depends_on: - iris1 ports: - 9031:1972 - 9032:52773 正如你所看到的，我们正在运行一个默认的intersystems/iris:2020.3.0.221.0镜像，提供License Key（必须支持Sharding），使用持久化的%SYS特性持久化数据，并提供ISC_CPF_MERGE_FILE，指向我们的合并文件（主节点和数据节点的文件不同）。此外，数据节点的启动晚了一分钟来让主节点先启动，这是个非常保守的估计，在一个正常的硬件上，启动时间最多几秒钟。 集群配置在CPF合并文件中，让我们来看看 Cluster configuration happens at CPF merge files, let's check them out CPF2merge-data-instance.conf [Startup] PasswordHash=FBFE8593AEFA510C27FD184738D6E865A441DE98,u4ocm4qh ShardRole=node1 [config] MaxServerConn=64 MaxServers=64 globals=0,0,400,0,0,0 errlog=1000 routines=32 gmheap=256000 locksiz=1179648 发生了什么情况？ 在[Startup] 部分，我们通过为我们的集群分配主节点角色来启用分片。在[config]中，我们将服务器扩大一些，允许更多的缓存和连接。就这么简单! CPF2merge-data-instance.conf [Startup] ShardClusterURL=IRIS://iris1:1972/IRISCLUSTER ShardRole=DATA 针对数据节点, 我们需要提供主节点和节点角色的URL. 试一下 试试这个repository 或者运行这段代码: git clone https://github.com/intersystems-ru/iris-container-recipes.git cd iris-container-recipes cd cluster // copy iris.key in cluster folder docker-compose up -d 启动InterSystems IRIS集群后你可以从 浏览器 访问. 用户名/密码 is: _SYSTEM/SYS. 结论 合并CPF文件 是一个很好用而简单的工具来配置InterSystems IRIS的实例。 感谢@Luca.Ravazzolo提供的代码并回答了我所有的问题。

本文档将向您展示如何开发 REST 接口。您可以将这些 REST 接口与 UI 工具（如 Angular）一起使用，以提供对数据库和互操作性产品的访问。您也可以使用它们支持外部系统访问 InterSystems IRIS®数据平台应用程序。要浏览所有的技术概要（First Look），包括可以在 InterSystems IRIS 免费的评估实例上执行的那些，请参见 InterSystems First Looks（《InterSystems 技术概要》）。 1 为什么提供 REST 接口如果您需要从外部系统访问 InterSystems IRIS 数据库中的数据，或者想为这些数据提供用户界面，您可以通过定义 REST 接口来实现。REST——REpresentational State Transfer——是一种使用公开的 URL 从另一个系统检索、添加、更新或删除数据的方法。REST 基于 HTTP，并使用 HTTP 动词 POST、GET、PUT 和 DELETE 映射到数据库应用程序常见的创建、读取、更新和删除 （CRUD）功能。您还可以在 REST 中使用其他 HTTP 动词，如 HEAD、PATCH 和 OPTIONS。REST 是在应用程序之间共享数据的众多方式之一，因此，如果您选择直接使用其他协议，如 TCP、SOAP 或 FTP 进行通信，则您可能并不总是需要设置 REST 服务。但是使用 REST 有以下优点：• REST 通常只有一个很小的开销（overhead）。它通常使用 JSON，这是一个轻量级的数据包装器。JSON 使用标签标识数据，但标签未在正式模式定义中指定，也没有显式的数据类型。REST 通常比 SOAP 更易于使用，SOAP 使用 XML 且开销（overhead）更大。• 通过在 REST 中定义一个接口，可以很容易地将客户端和数据库服务器之间的依赖关系降到最低。这使您可以在不影响数据库实现的情况下更新用户界面。您还可以在不影响用户界面或访问 REST API 任何外部应用程序的情况下更新数据库实现（database implementation）。 2 对 InterSystems IRIS 的 REST 调用 在定义 REST 接口之前，您应该了解 REST 调用如何流经 InterSystems IRIS。首先，考虑 REST 调用的部分，如：GET http://localhost:52773/rest/coffeemakerapp/coffeemakers 这由以下部分组成：• GET——这是 http 动词。• http：——这指定了通信协议。• //localhost:52773——这指定了托管 REST 接口的 InterSystems IRIS 实例的服务器和端口号。 如何在 InterSystems IRIS 中定义 REST 接口 • /rest/coffeemakerapp/coffeemakers——这是 URL 的主要部分，标识了 REST 调用所指向的资源。在下面的讨论中，URL 指的是 REST 调用的这一部分。 注意： 尽管这个技术概要（First Look）使用安装了 InterSystems IRIS 的 Web 服务器（在本例中是在本地系统的端口 52773 上），但对于部署的任何代码，您都应该使用一个商业 Web 服务器来替换它。安装 InterSystems IRIS 的 web 服务器仅供开发代码时临时使用，并不具备商业 web 服务器的强大功能。 当客户端应用程序进行 REST 调用时：1. InterSystems IRIS 将它指向与 URL 对应的 web 应用程序。例如，以 /coffeemakerapp 开头的 URL 将被发送到处理咖啡机的应用程序，以 /api/docdb 开头的 URL 将被发送到处理文档数据模型（Document Data Model）的 web 应用程序。2. Web 应用程序根据 HTTP 动词（verb）和 URL 中标识 web 应用程序的部分之后的任何部分，将调用指向一个方法。它通过将动词（verb）和 URL 与称为 URLMap 的结构进行比较来实现这一点。3. 该方法使用 URL 来标识 REST 调用所指定的资源，并根据动词（verb）来执行操作。例如，如果动词（verb）是 GET，该方法返回关于资源的一些信息；如果动词（verb）是 POST，该方法创建一个新的资源实例；如果动词（verb）是 DELETE，该方法删除指定资源。对于 POST 和 PUT 动词（verb），通常有一个提供更多信息的数据包。4. 该方法执行所请求的操作，并向客户端应用程序返回一个响应信息。 REST 调用需要执行方法和访问数据所需的任何权限。用户或 web 应用程序都可以拥有这些权限。您可以把这些权限分配给角色，然后把角色分配给用户或 web 应用程序。在这个示例中，%All 角色被分配给 web 应用程序。这允许未知用户（未经身份认证）访问 coffeemakerapp 数据。如果您没有把这个角色分配给 web 应用程序，未知用户将收到 401 未经授权的错误。您必须在 REST 身份认证调用中指定一个有足够权限的用户。详情请参见 "Securing REST Services（《确保 REST 服务》）"。 3 如何在 InterSystems IRIS 中定义 REST 接口在 InterSystems IRIS 中，有两种方法来定义 REST 接口：• 定义 OpenAPI 2.0 规范，然后使用 API 管理（API Management）工具来生成 REST 接口的代码。• 手动编码 REST 接口，然后在管理门户（Management Portal）中定义一个 web 应用程序。 本技术概要（First Look） 展示了如何手动编码 REST 接口，包括开发一个调度类（dispatch class）。如果您更喜欢使用规范优先的方法，这些调度类（dispatch class）是自动生成的，不应该被编辑。使用规范优先定义的优点包括能够从规范自动生成文档和客户端代码，但您可以使用任何一种方式来定义 REST 接口。有关使用规范定义 REST 接口的更多信息，请参见 Creating Rest Services（《创建 REST 服务》）。 4 手动编码 REST 接口 手动编码 REST 接口包括以下步骤：• 创建 %CSP.REST 的子类并定义 UrlMap。 手动编码 REST 接口 • 对处理 REST 调用的方法进行编码。• 定义 web 应用程序——您通常使用管理门户（Management Portal）来执行此操作。 本技术概要（First Look）使用了一个访问咖啡机数据库的示例应用程序 coffeemakerapp 来演示如何手动编码 REST 接口。Coffeemakerapp 提供 REST 接口来获取咖啡机的信息、在数据库中创建新的记录、更新现有的记录或删除记录。以下几节通过注释探讨了此示例应用程序的类定义和一些方法，以增强您对代码的理解。您将在完成本技术概要（First Look） 的练习部分后，从 GitHub 下载整个应用程序的代码。 4.1 创建 %CSP.REST 的子类并定义 URLMap 这是 demo.CoffeeMakerRESTServer 类定义的第一部分。它扩展了 %CSP.REST 类。 Class Demo.CoffeeMakerRESTServer Extends %CSP.REST{Parameter HandleCorsRequest = 1;XData UrlMap [ XMLNamespace = "http://www.intersystems.com/urlmap" ]{<Routes><Route Url="/test" Method="GET" Call="test"/><Route Url="/coffeemakers" Method="GET" Call="GetAll" /><Route Url="/coffeemaker/:id" Method="GET" Call="GetCoffeeMakerInfo" /><Route Url="/newcoffeemaker" Method="POST" Call="NewMaker" /><Route Url="/coffeemaker/:id" Method="PUT" Call="EditMaker" /><Route Url="/coffeemaker/:id" Method="DELETE" Call="RemoveCoffeemaker"/></Routes>} 查看路由（Route）要素。每个都有三个属性：• Url——这标识了可由该路由（Route）处理的 REST URL。由于 IRIS 指向以 /rest/coffeemakerapp 开头的 URL，因此这个属性指定了紧随其后的 URL 部分。如果 Url 属性是 /cof- feemakers，则此路由（ Route）处理以 /rest/coffeemakerapp/coffeemakers 开头的 URL。• Method（方法）——这标识了路由（Route）处理的动词。请注意，最后两行的 Url 值相同，/coffeemaker/:id。有 PUT 方法的路由（Route）将处理以 /rest/coffeemaker- app/coffeemaker/:id 开头的 URL 的 PUT 动词，有 DELETE 方法的路由（Route）将处理具有相同开头的 URL 的 DELETE 动词。• Call（调用）——指定要调用的方法来处理这个 REST 调用。该方法会被传递完整的 URL 和任何数据，以便它可以根据 URL 做出响应。 Url 值中以 : 开头的部分表示通配符。也就是说，/coffeemaker/:id 将匹配 /coffeemaker/5，/coffeemaker/200，甚至是 /coffeemaker/XYZ。被调用的方法将在参数中获得 :id 的值。在这种情况下，它标识了要更新（使用 PUT）或删除的咖啡机的 ID。Url 值有额外的选项，允许您将 REST URL 转发到 %CSP.REST 子类的另一个实例，但您不需要在这个技术概要（First Look）中处理它。HandleCorsRequest 参数指定浏览器是否应该允许跨源资源共享（Cross-origin Resource Sharing，CORS），即在一个域中运行的脚本试图访问在另一个域中运行的 REST 服务，但这也是一个高级主题。 4.2 编码方法 GetAll 方法检索有关所有咖啡机的信息。以下是其代码： 手动编码 REST 接口 ClassMethod GetAll() As %Status{Set tArr = []Set rs = ##class(%SQL.Statement).%ExecDirect(,"SELECT * FROM demo.coffeemaker") While rs.%Next() {Do tArr.%Push({"img": (rs.%Get("Img")), "coffeemakerID": (rs.%Get("CoffeemakerID")), "name": (rs.%Get("Name")),"brand": (rs.%Get("Brand")),"color": (rs.%Get("Color")),"numcups": (rs.%Get("NumCups")),"price": (rs.%Get("Price"))})}Write tArr.%ToJSON() Quit $$$OK} 此方法的注意事项：• 没有任何参数。每当这个方法被调用时，它就会执行一个 SQL 语句，从 demo.coffeemaker 数据库中选择所有记录。• 对于数据库中的每条记录，它都会将这些值作为名称、值对附加到数组中。• 它将数组转换为 JSON，并通过将 JSON 编写到 stdout 来将 JSON 返回给调用的应用程序。• 最后，它成功退出。 NewMaker() 方法没有参数，但有一个 JSON 有效负荷，用于指定要创建的咖啡机。以下是其代码：ClassMethod NewMaker() As %Status{If '..GetJSONFromRequest(.obj) {Set %response.Status = ..#HTTP400BADREQUEST Set error = {"errormessage": "JSON not found"} Write error.%ToJSON()Quit $$$OK}If '..ValidateJSON(obj,.error) {Set %response.Status = ..#HTTP400BADREQUEST Write error.%ToJSON()Quit $$$OK}Set cm = ##class(demo.coffeemaker).%New() Do ..CopyToCoffeemakerFromJSON(.cm,obj)Set sc = cm.%Save() Set result={}do result.%Set("Status",$s($$$ISERR(sc):$system.Status.GetOneErrorText(sc),1:"OK")) write result.%ToJSON()Quit sc} 此方法的注意事项：• 首先，它通过调用类中稍后定义的 GetJSONFromRequest() 和 ValidateJSON() 方法，测试有效负荷是否包含有效的 JSON 对象。• 然后它使用 JSON 对象创建一个新的 demo.coffeemaker，将记录保存在数据库中。• 它通过将状态写入 stdout 来返回状态。 最后，RemoveCoffeemaker() 方法展示了 Url 的:id部分是如何作为参数传递给该方法的： 为自己定义 REST 接口 ClassMethod RemoveCoffeemaker(id As %String) As %Status{Set result={}Set sc=0if id'="",##class(demo.coffeemaker).%ExistsId(id) { Set sc=##class(demo.coffeemaker).%DeleteId(id)do result.%Set("Status",$s($$$ISERR(sc):$system.Status.GetOneErrorText(sc),1:"OK"))}else {do result.%Set("Status","")}write result.%ToJSON() quit sc} 总之，由路由调用（Route Call）属性指定的方法通过以下方式处理 REST 调用：• 获得任何参数作为调用参数。• 通过 obj 值访问有效负荷。• 通过将响应写入 stdout，将其返回给客户端应用程序。 5 为自己定义 REST 接口本节逐步向您展示如何使用咖啡机应用程序来处理 REST 调用。与其让您编写 REST 接口的代码，不如从 GitHub 下载完成的应用程序。构建应用程序后，您将定义 Web 应用程序，然后通过 REST 调用测试应用程序。 5.1 用前须知要使用这个程序，您需要在一个系统上工作，安装一个 REST API 应用程序（如 Postman、Chrome 高级 REST 客户端（Chrome Advanced REST Client）或 cURL），并连接一个正在运行的 InterSystems IRIS 实例。您对 InterSystems IRIS 的选择包括多种类型的已授权的和免费的评估实例；该实例不需要由您正在工作的 系统托管（尽管它们必须相互具有网络访问权限）。关于如何部署每种类型的实例的信息（如果您还没有可使用的实例），请参见 InterSystems IRIS Basics: Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中的 Deploying InterSystems IRIS（部署 InterSystems IRIS）。有关将 REST API 应用程序连接到您的 InterSystems IRIS 实例所需的信息，请参见同一文档中的 InterSystems IRIS Connection Information（InterSystems IRIS 连接信息）。 5.2 下载示例应用程序通过克隆或下载已完成的 coffeemakerapp 应用程序来开始这个练习，该应用程序包括测试对 InterSystems IRIS 的 REST 调用所需的所有 REST 接口。这个技术概要-REST（FirstLook-REST）示例代码可以在以下网站获得：https://github.com/intersystems/FirstLook-REST。从 GitHub 下载的内容必须能从您的 InterSystems IRIS 实例访问。下载文件的程序取决于您所使用的实例类型，如下所示：• 如果您使用的是 ICM 部署的实例：1. 使用带有 -machine 和 -interactive 选项的 icm ssh 命令，在托管实例的节点上打开默认 shell，例如：icm ssh -machine MYIRIS-AM-TEST-0004 -interactive 为自己定义 REST 接口 2. 在 Linux 命令行上，使用以下命令之一将 repo 克隆到实例的数据存储卷（data storage volume）。例如，对于部署在 Azure 上的配置，数据卷的默认挂载点（default mount point）是 /dev/sdd，因此您可以使用如下命令： $ git clone https://github.com/intersystems/FirstLook-REST /dev/sdd/FirstLook-REST OR$ wget -qO- https://github.com/intersystems/FirstLook-REST/archive/master.tar.gz | tar xvz -C/dev/sdd 这些文件现在对容器文件系统上 /irissys/data/FirstLook-REST 中的 InterSystems IRIS 可用。 • 如果您正在使用通过其他方式部署的容器化实例（授权版或社区版（Community Edition））：1. 在主机上打开 Linux 命令行。(如果您在云节点上使用社区版（Community Edition），请使用 SSH 连接该节点，如在 Deploy and Explore InterSystems IRIS（《部署和探索 InterSystems IRIS》） 中所述。)2. 在 Linux 命令行上，使用 git clone 或 wget 命令，如上所述，将 repo 克隆到容器中挂载为卷的存储位置。– 对于社区版（Community Edition）实例，您可以克隆到实例的持久化 %SYS 目录 （存储指定于实例的配置数据的目录）。在 Linux 文件系统中，这个目录是 /opt/ISC/dur。这使得文件对容器文件系统上 /ISC/dur/FirstLook-REST 中的 InterSystems IRIS 可用。 – 对于已授权的容器化实例（containerized instance），选择容器中作为卷挂载的任何存储位置(如果使用它，包括持久化 %SYS 目录）。例如， 如果您的 docker run 命令包含选项 -v /home/user1:/external，并且您将 repo 克隆到 /home/user1，则文件对容器文件系统上 /external/FirstLook-REST 中的 InterSystems IRIS 可用。 • 如果您使用的是 InterSystems 学习实验室（Learning Labs）实例：1. 在集成 IDE 中打开命令行终端。2. 将目录更改为 /home/project/shared 并使用 git clone 命令克隆 repo： $ git clone https://github.com/intersystems/FirstLook-REST 该文件夹被添加到左边资源管理器（Explorer）面板的 Shared （共享）下，并且该目录对 /home/project/shared 中的 InterSystems IRIS 可用。• 如果您使用的是已安装的实例：– 如果实例的主机是安装了 GitHub 桌面（GitHub Desktop）和 GitHub 大文件存储（GitHub Large File Storage）的 Windows 系统：1. 在主机的 web 浏览器中进入 https://github.com/intersystems/FirstLook-REST。2. 选择 Clone or download（克隆或下载） 然后选择 Open in Desktop（在桌面上打开）。 这些文件对您的 GitHub 目录中的 InterSystems IRIS 可用，例如在 C:\Users\User1\Documents\GitHub\FirstLook-REST 中。– 如果主机是 Linux 系统，只需在 Linux 命令行上使用 git clone 命令或 wget 命令，就可以将 repo 克隆到您所选择的位置。 5.3 创建一个支持互操作性的命名空间如果您已经有了一个互操作性命名空间，就可以使用它。否则，创建一个命名空间：1. 使用 InterSystems IRIS Basics:Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中为您的实例描述的 URL，在浏览器中打开您的实例的管理门户（Management Portal）。 为自己定义 REST 接口 2. 通过导航到命名空间（Namespaces）页面(System Administration（系统管理） > Configuration（配置） > System Configuration（系统配置） > Namespaces（命名空间）)， 并按照 System Administration Guide（《系统管理指南》）的“Configuring InterSystems IRIS（《配置 InterSystems IRIS》）”一章中创建/修改命名空间中的使用新命名空间（New Namespace）页面的说明，点击 Create New Namespace（创建新命名空间）按钮，创建一个支持互操作性的命名空间。 5.4 构建示例代码 要构建示例代码，请按照以下步骤操作1. 使用 InterSystems IRIS Basics：Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中为您的实例描述的程序，打开 InterSystems 终端（Terminal）。2. 将命名空间设置为您将使用的互操作性命名空间。输入以下命令，替换 <Namespace-name> 与您所使用的命名空间。set $namespace = "<namespace-name>" 3. 输入以下命令，替换 <path> 与您下载示例的路径。 该目录包含许可证（License）和 Readme 文件以及 buildsample 目录：do $system.OBJ.Load("<path>/buildsample/Build.RESTSample.cls","ck") do ##class(Build.RESTSample).Build()4. 当出现提示时，输入下载此示例的目录的完整路径。然后，该方法加载和编译代码，并执行其他需要的设置步骤。注意： FirstLook-REST / README.md 文件包含这些说明的一个版本。5.5 定义一个 web 应用程序 现在您已经使用 REST 接口构建了示例应用程序，您需要定义一个 web 应用程序：1. 使用 InterSystems IRIS Basics:Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中为您的实例描述的 URL，在浏览器中打开您的实例的管理门户（Management Portal）。2. 选择 System Administration（系统管理） > Security（安全） > Applications（应用程序） > Web Applications（web 应用程序）。3. 选择 Create New Web Application（创建新的 web 应用程序） 并输入以下设置• Name（名称）: /Rest/coffeemakerapp——它指定了将由这个 web 应用程序处理的 URL。InterSystems IRIS 会将所有以 /rest/coffeemakerapp 开头的 URL 定向到这个 web 应用程序。• Namespace（命名空间）: 您创建的支持互操作性的名称空间的名称。• Enable（支持）: 选择 REST。• Dispatch Class（调度类）: Demo.CoffeeMakerRESTServer——这是定义了 URLMap 的类。• Security Settings/Allowed Authentication Methods（安全设置/允许的身份认证方法）: 同时选择 Unauthenticated（未经身份认证） 和 Password（密码） 复选框。4. 选择 Save（保存）。5. 要允许此示例的未经身份认证的访问，必须赋予 web 应用程序 %All 角色。要执行此操作：a. 选择 Save（保存）后，选择 Application Roles（应用程序角色）标签。b. 从 Available（可用的）角色中选择 %All 角色。c. 点击右箭头（选择）按钮，将 %All 角色移动到 Selected（选定的） 角色。 为自己定义 REST 接口 d. 点击 Assign（分配） 按钮。e. %All 角色现在被列为 Application Role（应用程序角色）。这确保了来自未经身份认证用户的 REST 调用将拥有访问 coffeemakerapp 数据所需的权限。如果没有这个角色，REST 调用将必须为拥有足够权限的用户指定身份认证。 5.6 访问 REST 接口 CoffeeMaker REST 应用程序现在可以工作了。您将输入 REST 命令来访问咖啡机数据库。在您的 REST API 工具（如 Postman）中，按照以下步骤操作：1. 指定 REST POST 请求来添加新的咖啡机，必要时使用您的 InterSystems IRIS 实例的指定信息• HTTP 操作： POST• URL: http://server:port/rest/coffeemakerapp/newcoffeemaker，其中服务器和端口是您的实例的主机标识符和 web 服务器端口。• 您的实例的登录凭证。• 输入数据： {"img":"img/coffee3.png","coffeemakerID":"99","name":"Double Dip","brand":"Coffee+", "color":"Blue","numcups":2,"price":71.73} 尽管数据包含一个 coffeemakerID 的值，但这是一个计算字段，并且在添加记录时会分配一个新值。该调用返回成功状态：{"Status":"OK"} 2. 重复上一步骤两次，添加以下两个咖啡机： {"img":"img/coffee4.png","coffeemakerID":"99","name":"French Press","brand":"Coffee For You", "color":"Blue","numcups":4,"price":50.00}{"img":"img/coffee9.png","coffeemakerID":"99","name":"XPress","brand":"Shiny Appliances", "color":"Green","numcups":1,"price":95.00} 3. 使用相同的实例指定信息，指定一个 REST GET 请求，以获得数据库中的咖啡机列表：• HTTP 操作： GET• URL: http://server:port/rest/coffeemakerapp/coffeemakers• 您的实例的登录凭证。 该调用返回一个咖啡机列表，如： [{"img":"img/coffee3.png","coffeemakerID":"1","name":"Double Dip","brand":"Coffee+", "color":"Blue","numcups":2,"price":71.73},{"img":"img/coffee4.png","coffeemakerID":"2","name":"French Press","brand":"Coffee For You", "color":"Blue","numcups":4,"price":50},{"img":"img/coffee9.png","coffeemakerID":"3","name":"XPress","brand":"shiny Appliances", "color":"Green","numcups":1,"price":95}] 4. 指定以下 REST 调用，删除 ID=2 的咖啡机：• HTTP 操作：DELETE• URL: http://server:port/rest/coffeemakerapp/coffeemaker/2• 您的实例的登录凭证。 为自己定义 REST 接口 该调用返回成功状态： {"Status":"OK"} 5. 重复 REST GET 请求。该调用返回一个咖啡机列表，如： [{"img":"img/coffee3.png","coffeemakerID":"1","name":"Double Dip","brand":"Coffee+", "color":"Blue","numcups":2,"price":71.73},{"img":"img/coffee9.png","coffeemakerID":"3","name":"XPress","brand":"Shiny Appliances", "color":"Green","numcups":1,"price":95}] 5.7 记录 REST 接口 当您向开发者提供 REST 接口时，您应该提供文档，以便他们知道如何调用接口。您可以使用 Open API Spec 来记录 REST 接口，并使用工具，如 Swagger 来编辑和格式化文档。InterSystems 正在开发一项功能来支持这个文档。这个版本包含了 API 管理（API Management）中的一个功能，它可以为您的 REST API 生成文档框架。您仍然需要编辑生成的文档，以添加注释和额外的信息，例如参数和 HTTP 返回值的内容。要为 CoffeeMakerApp REST 示例生成文档，请输入以下 REST 调用，使用您的 InterSystems IRIS 实例的指定信息和您创建的命名空间的名称：• HTTP 操作：GET• URL: http://server:port/api/mgmnt/v1/namespace/spec/rest/coffeemakerapp/• 您的 InterSystems IRIS 实例的登录凭证。 您可以把这个调用的输出粘贴到 swagger 编辑器中。它将 JSON 转换为 YAML（另一种标记语言（Yet Another Markup Language））并显示文档。您可以使用 swagger 编辑器向文档中添加更多信息。Swagger 编辑器显示的文档如下所示： 有关 InterSystems IRIS 和 REST 的更多信息 6 有关 InterSystems IRIS 和 REST 的更多信息 有关在 InterSystems IRIS 中创建 REST 服务的更多信息，请参见以下内容：• Setting Up RESTful Services（设置 RESTful 服务） 是 InterSystems 的在线课程，它使用与本文档相同的咖啡机应用程序，但更详细。 您需要登录 learning.intersystems.com 才能参加这个课程。如果您没有账户，可以创建一个。• Creating REST Services（《创建 REST 服务》）• Using REST Services and Operations in Productions（《在产品中使用 REST 服务和操作》）

嗨，开发者们！ 秋高气爽之际，我们很高兴地宣布启动🏆InterSystems开发者社区中文版首届技术征文大赛 🏆（←点击链接进入参赛页面，浏览所有参赛文章）！ 从2022年9月5日-10月24日（北京时间），欢迎热爱InterSystems技术的你来投稿，撰写与InterSystems技术相关的文章。 🎁参与奖 我们为每一位成功参赛的作者准备了礼品！ 🏆优秀文章大奖 Apple iPad; Beats Fit Pro; HUAWEI WATCH; Logitech键盘; WD固态硬盘；KEEP智能手环 奖品设置 1. 专家提名奖：活动期间发布文章且成功参赛后，由InterSystems专家评选得出 🥇一等奖1名，Apple iPad 🥈二等奖2名，Beats Fit Pro 🥉三等奖3名，WD 固态硬盘 2. 开发者社区奖：活动期间发布文章且成功参赛后，由社区成员点赞评选得出，点赞前五名获得以下奖品 🥇第一名，HUAWEI WATCH 3智能手表 🥈第二名，罗技（Logitech）ERGO键盘 🥉第三名-第五名，KEEP 运动智能手环 3. 入围奖：在征文大赛期间，所有在InterSystems开发者中文社区发布文章且成功参赛的其余用户都将获得特别奖励。 请注意： 每位作者只可以获得一个奖项（即：您只可以获得一次专家提名奖/开发者社区奖/入围奖）； 当出现票数相当的平手情况时，将以专家评选投票数作为最终票数高低的判断标准。 谁可以参加？ 任何开发者社区成员，除了InterSystems的员工。创建一个账户！ 关键时间节点 📝 2022年9月5日-10月23日（北京时间），文章发布与点赞收集！在社区发布文章，呼朋引伴来点赞。越早发布文章，就越有时间收集更多点赞（这是您获得“开发者社区奖”的关键）。 🎉 2022年10月24日（北京时间），公布获奖名单。 参赛要求 ❗️ 征文期间，发布在中文社区的文章只要满足以下要求，将自动参加比赛，无需额外提交： 文章必须与InterSystems技术有关 文章必须以中文撰写 文章必须是100%的原创文章（可以是现有文章的延续） 文章应在InterSystems开发者中文社区首发，严禁从其他社区进行搬运 文章严禁抄袭或翻译社区现有文章 社区成员可以发布多篇文章参赛 文章字数应不少于800字，写作时请关注编辑器右下角的计数器 额外奖励 您可以自由选择任何与InterSystems技术相关的主题，如果您提交的文章中符合以下要求，将获得额外奖励票数。 资源助力 ➡️ 文章样例：同一主题系列文章 数据平台与三级等保第一篇 精华文章-基于docker的一体化集成ai环境中部署机器学习深度学习模型 数据平台互操作功能运行维护管理基础-互操作消息管理 互操作进阶-第二篇：规则引擎-（第一部分） 精华文章-webgateway系列1-web-gateway介绍 ➡️ 文章样例：独立主题文章 精华文章-从软件架构发展谈业务集成技术演进与展望 精华翻译文章：什么是智慧医院数字孪生？ 在intersystems-iris医疗行业版的fhir服务器上测试和开发smart-fhir应用 ➡️ 操作指导：首次加入社区，如何发帖？ 如何发帖以及其他常见问题解答 如何在开发者社区上发布包含代码的帖子？ 如何从 Word 或 Google Docs 发布文章 如何在帖子中突出显示 ObjectScript？ 如何在其他开发者社区翻译并发布帖子 ➡️ 操作指导：更多开发者社区技能学习 【精华置顶帖】一文了解关于InterSystems开发者社区的各种积分福利！ 快乐分享技术，期待您的大作！✨ 🏆InterSystems开发者社区中文版首届技术征文大赛 🏆（←点击链接进入参赛页面，浏览所有参赛文章） 如果有疑问/高见，欢迎跟帖留言！

Hi！大家好！ 截至11月3日中午，我们的开发者社区会员共495人！我们准备了一份惊喜礼品，准备送给第500名开发者社区会员！ 那么，谁是第500名幸运的开发者社区成员呢？我们拭目以待！(*^▽^*)

连接前准备： .Net 开发环境 InterSystems IRIS 客户端组件:InterSystems.Data.IRISClient.dll，这个dll文件可以再IRIS安装包中找到，在IRIS/dev/dotnet/bin/version Connection String 步骤： 在.Net 开发环境中，配置客户端组件InterSystems.Data.IRISClient.dll作为一个dependency Connection String：其中using InterSystems.Data.IRISClient 用来导入需要使用的dll文件，string connectionString = "Server = localhost; Port = 1972; Namespace = User; User ID = SQLAdmin; Password = deployment-password"是connection string。 using System; using InterSystems.Data.IRISClient; namespace ADODemo { internal class Program { static void Main(string[] args) { string connectionString = "Server = localhost; Port = 1972; Namespace = User; User ID = SQLAdmin; Password = deployment-password"; IRISADOConnection connection = new IRISADOConnection(connectionString); connection.Open(); // when finished, use the line below to close the connection // connection.Close(); } } }

嗨，开发者们！ 秋高气爽之际，我们很高兴地宣布启动🏆InterSystems开发者社区中文版第二届技术征文大赛 🏆（←点击链接进入参赛页面，浏览所有参赛文章）！ 从2023年9月19日-11月24日（北京时间），欢迎热爱InterSystems技术的你来投稿，撰写与InterSystems技术相关的文章。 🎁参与奖 我们为每一位成功参赛的作者准备了礼品！ 🏆优秀文章大奖 Apple AirPods Pro; Osprey Proxima Backpack; Home Office Pro Lap Desk; Sound Machine with Wireless Charger; JBL Pulse 5 Bluetooth Speaker; Sound Machine with Wireless Charger; Hammock InterSystems; Light Up Your Logo Charging Pad; InterSystems Developer Community Blanket 奖品设置 1. 专家提名奖：活动期间发布文章且成功参赛后，由InterSystems专家评选得出 🥇第一名，Apple AirPods Pro(2nd Generation w Active Noise Cancellation) 🥈第二名，Osprey Proxima Backpack 🥉第三名，Home Office Pro Lap Desk 🏆第四名-第六名，Sound Machine with Wireless Charger 2. 开发者社区奖：活动期间发布文章且成功参赛后，由社区成员点赞评选得出，点赞前五名获得以下奖品 🥇第一名，JBL Pulse 5 Bluetooth Speaker 🥈第二名，Sound Machine with Wireless Charger 🥉第三名，Hammock InterSystems 🏆第四名，Light Up InterSystems Charging Pad 🏆第五名，InterSystems Developer Community Blanket 3. 入围奖：在征文大赛期间，所有在InterSystems开发者中文社区发布文章且成功参赛的其余用户都将获得特别奖励。 请注意： 每位作者只可以获得一个奖项（即：您只可以获得一次专家提名奖/开发者社区奖/入围奖）； 在“开发者社区奖”的评选过程中，当出现票数相当的平手情况时，将以专家评选投票数作为最终票数高低的判断标准。 谁可以参加？ 任何开发者社区成员，除了InterSystems的员工。创建一个账户！ 关键时间节点 📝 2023年9月19日-11月23日（北京时间），文章发布与点赞收集！在社区发布文章后即可开始为您的文章收集点赞。越早发布文章，就越有时间收集更多点赞（这是您获得“开发者社区奖”的关键）。 📝 2023年11月23日（北京时间），专家打分截止（专家提名奖）。在此期间，用户可继续为文章收集点赞，赢得“开发者社区奖”。 🎉 2023年11月24日（北京时间），公布获奖名单。 参赛要求 ❗️ 征文期间，发布在中文社区的文章只要满足以下要求，将自动参加比赛，无需额外提交： 文章必须与InterSystems技术有关 文章必须以中文撰写 文章必须是100%的原创文章（可以是现有文章的延续） 文章应在InterSystems开发者中文社区首发，严禁从其他社区进行搬运 文章严禁抄袭或翻译社区现有文章 社区成员可以发布多篇文章参赛 文章字数应不少于800字，写作时请关注编辑器右下角的计数器 额外奖励 您可以自由选择任何与InterSystems技术相关的主题，如果您提交的文章中符合以下要求，将获得额外奖励票数。 资源助力 ➡️ 文章样例：FHIR 在InterSystems IRIS医疗行业版的FHIR服务器上测试和开发SMART on FHIR应用 ➡️ 文章样例：互操作 IRIS如何进行CRUD操作 ➡️ 文章样例：API 使用规范优先的方式开发REST API ➡️ 文章样例：应用 FHIR创新应用示例：使用 FHIR Cloud Server 和 IRIS for Health 对妊娠糖尿病进行连续血糖监测 ➡️ 文章样例：同一主题系列文章 数据平台与三级等保第一篇 精华文章-基于docker的一体化集成ai环境中部署机器学习深度学习模型 数据平台互操作功能运行维护管理基础-互操作消息管理 互操作进阶-第二篇：规则引擎-（第一部分） 精华文章-webgateway系列1-web-gateway介绍 ➡️ 文章样例：独立主题文章 精华文章-从软件架构发展谈业务集成技术演进与展望 精华翻译文章：什么是智慧医院数字孪生？ 在intersystems-iris医疗行业版的fhir服务器上测试和开发smart-fhir应用 ➡️ 操作指导：首次加入社区，如何发帖？ 如何发帖以及其他常见问题解答 如何在开发者社区上发布包含代码的帖子？ 如何从 Word 或 Google Docs 发布文章 如何在帖子中突出显示 ObjectScript？ 如何在其他开发者社区翻译并发布帖子 ➡️ 操作指导：更多开发者社区技能学习 【精华置顶帖】一文了解关于InterSystems开发者社区的各种积分福利！ ➡️ 一起来欣赏首届技术征文大赛的文章！ 专家提名奖 @Zhe Wang 获奖作品：IRIS如何进行CRUD操作 @姚 鑫 获奖作品：IRIS与Caché的23种设计模式 @聆严 周 获奖作品：使用Prometheus监控Cache集群 @John Pan 获奖作品：如何调用Ensemble/IRIS内置的HL7 V2 webservice - Java，PB9，Delphi7样例 @he hf 获奖作品：10分钟快速开发一个连接到InterSystems IRIS数据库的C#应用 @sun yao 获奖作品：前端操作自动生成BS、BP、BO 开发者社区奖 @Meng Cao 获奖作品：Caché数据库私有apache版本升级 @lizw lizw 获奖作品：关于%Dictionary.CompiledClass类在实际业务中的一些应用 @Chang Liu 获奖作品：在国产系统上安装Healthconnect2021 @shaosheng shengshao 获奖作品：HEALTHSHARE2018版如何实现AES(CBC)的HEX输出,并可以实现加密和解密 @Guangliang Zhang 获奖作品：基于cconsole.log的cache数据库的实时监控 入围奖 @water huang 获奖作品：对 %XML.PropertyParameters类的探索 @zhanglianzhu zhanglianzhu 获奖作品：Cache死循环检测和申明式事务 @li wang 获奖作品：HealthConnect访问HTTPS开头地址 @bai hongtao 获奖作品：第三方HA软件结合MIRROR使用方法探讨 @Liu Tangh 获奖作品：在Cache系统中使用负载均衡服务的探讨 @yaoguai wan 获奖作品：IRIS架构的浅显理解以及windows10、docker安装IRIS Health详解流程及部分问题浅析 @li dong 获奖作品：实现Cache/IRIS中zip文件的下载、解压及读取 @Yuxiang Niu 获奖作品：Cache中不同类型锁的理解与分析 @Vincent Wu 获奖作品：TrakCare Lab之延伸应用-护理站自动采检备管系统（NSAD）之开发 快乐分享技术，期待您的大作！✨ 🏆InterSystems开发者社区中文版第二届技术征文大赛 🏆（←点击链接进入参赛页面，浏览所有参赛文章） 如果有疑问/高见，欢迎跟帖留言！ 试发

InterSystems 常见问题FAQ 要编译包含映射修饰符的类rountine，请指定编译器修饰符“/mapped=1”或“/mapped”。例如，执行以下操作： [示例 1] 获取类列表并编译 do $System.OBJ.GetClassList(.list,"/mapped") // build your classes starting from .list do $System.OBJ.Compile(.list) [示例 2] 编译所有类 do $system.OBJ.CompileAll("/mapped")

VSCode中安装InterSystems Language Server后，EXPLORER资源树使用Ctrl+F可以打开文件检索框，快速检索文件。 不知是VSCode版本更新不支持了，还是InterSystems Language Server更新，导致在EXPLORER资源树无法快速检索文件 如果直接连接服务器进行服务器端代码搜索的话，需要使用proposed api，可以参考 vscode 插件里的这一段 如果直接连接服务器进行服务器端代码搜索的话，需要使用proposed api，可以参考 vscode 插件里的这一段

嗨社区！ 想与您分享我在Telegram中使用GPT创建“我自己的”聊天的练习。 这个应用需要用到 Open Exchange 上的两个组件：@Nikolay.Soloviev 的Telegram Adapter和@Francisco.López1549的IRIS Open-AI 因此，通过此示例，您可以在 Telegram 中使用 ChatGPT 设置自己的聊天。 让我们看看如何让它发挥作用！ 前提条件 使用@BotFather 帐户创建一个机器人并获取机器人令牌。然后将机器人添加到电报聊天或频道中并赋予其管理员权限。在https://core.telegram.org/bots/api了解更多信息 在https://platform.openai.com/上打开（如果没有，请创建）一个帐户，并获取您的Open AI API Key和Organization id 。 确保您的 InterSystems IRIS 中安装了 IPM。如果没有，这里有一个要安装的衬垫： USER> s r = ##class ( %Net.HttpRequest ). %New (), r .Server= "pm.community.intersystems.com" , r .SSLConfiguration= "ISC.FeatureTracker.SSL.Config" d r .Get( "/packages/zpm/latest/installer" ), $system .OBJ.LoadStream( r .HttpResponse.Data, "c" ) 或者您可以像这样使用带有 IPM 的社区 docker 图像： 安装 在启用互操作性的命名空间中安装 IPM 包。 USER>zpm“安装 Telegram-gpt” 用法 打开Production 将机器人的 Telegram Token 放入 Telegram business service 和 Telegram Business operation 中： 同时使用您的聊天 GPT API 密钥和组织 ID 初始化 St.OpenAi.BO.Api.Connect 操作： 启动Production。 在Telegram聊天中提出任何问题。您将通过 Chat GPT 获得答案。尽情享受吧！ 在可视化追中： 细节 本示例使用 3.5 版本的 Chat GPT Open AI。它可以在模型参数的数据转换规则中更改。