第二章 使用 /api/mgmnt/ 服务

本章介绍如何使用 /api/mgmnt 服务来创建、更新和删除 REST 服务。

/api/mgmnt 服务还提供了可用于发现和记录 Web 服务的选项，如本书后面所述。

使用 /api/mgmnt 服务创建 REST 服务

创建 REST 服务的推荐方法是为 REST 服务创建 OpenAPI 2.0（也称为 Swagger）描述，并使用它来生成 REST 服务类。如果您正在实现由第三方定义的 REST 服务，他们可能会提供此 OpenAPI 2.0 描述。有关 OpenAPI 2.0 描述格式的详细信息，请参阅 OpenAPI 2.0 规范。以下主题描述了如何使用 /api/mgmnt 服务来执行此操作。

第四章 多维存储的SQL和对象使用（一）

本章介绍InterSystems IRIS®对象和SQL引擎如何利用多维存储(全局变量)来存储持久对象、关系表和索引。

尽管InterSystems IRIS对象和SQL引擎会自动提供和管理数据存储结构，但了解其工作原理的详细信息还是很有用的。

数据的对象视图和关系视图使用的存储结构是相同的。为简单起见，本章仅从对象角度介绍存储。

数据

每个使用%Storage.Persistent存储类(默认)的持久化类都可以使用多维存储(全局变量)的一个或多个节点在InterSystems IRIS数据库中存储其自身的实例。

每个持久化类都有一个存储定义，用于定义其属性如何存储在全局变量节点中。这个存储定义(称为“默认结构”)由类编译器自动管理。

“一根筷子易折断，十根筷子抱成团”，这句话在青岛大学附属医院（以下简称“青大附院”）的医院信息系统升级换代中得到了淋漓尽致的体现。

在InterSystems，我们致力于为您提供最优质的服务，包括我们的Global Master项目。

Global Master项目平台的供应商已经被另一家公司收购，不幸的是，我们无法继续在这个平台上托管我们Global Master项目。我们目前正在评估新的平台供应商，以推动Global Masters Advocate Hub的平稳过渡。

自2024年4月26日起，我们将暂停Global Master项目，以期平稳过度到新平台上。

FAQ:

大家好！

我们的第二届 InterSystems Idea-A-Thon创意马拉松顺利结束，产生了29 个与竞赛主题相关的精彩创意：

💡使用 InterSystems IRIS 快速、安全、绿色地运行解决方案💡

感谢大家的想法、评论和投票！

现在是时候宣布获奖者了！

第五十九章 镜像中断程序 - 灾难恢复程序

灾难恢复程序

如异步镜像成员中所述，灾难恢复 (DR) 异步成员维护镜像数据库的只读副本，从而可以在需要时将 DR 异步提升为故障转移成员。将 DR 异步成员提升为故障转移成员中描述了提升 DR 异步的过程。本节讨论三种可以使用 DR 异步提升的场景：

• 在灾难期间手动故障转移到提升的 DR 异步
• 计划故障转移到提升的 DR 异步
• 使用提升的 DR 异步临时替换故障转移成员

在本节的过程中， IRIS A 是原始的主要故障转移成员， IRIS B 是原始备份，而 IRIS C 是要提升的 DR 异步。

1. VMWare快照引起的网络中断导致非计划内主备机切换问题

1.1 问题描述

在创建虚拟机快照时，虚拟机需要短时间的冻结，这个短时间冻结通常指虚拟机静默，在静默过程中网络连接处于中断状态。由于数据库的不断增长，使用VMWare快照的方式对虚拟机进行备份的时长也会不断增加，当对虚拟机进行快照的时长长于InterSystems镜像服务质量 (QoS) 超时时间，即当主机网络中断超过QoS超时时间，仲裁机与备机观察并相互确认与主机的连接丢失后，将发起切换过程，使原备机成为主机并将虚拟IP从主机MAC地址解绑后重绑定到备机的MAC地址上。特别需要注意的是，在这种由于网络中断引起的切换中，仲裁与备机都无法得知主机的实际工作状态。因此，在主机网络连接恢复后，为了为了避免因切换期间主机还在处理数据导致主备机间数据不一致，备机主动发起请求让主机下线，关闭主机，此时主机状态显示为关闭（Down）。

第七章 操作位和位串（三）

操作位串

要创建新的位串，请使用 $bit 函数将所需位设置为 1：

kill bitstring

set $bit(bitstring, 3) = 1

set $bit(bitstring, 6) = 1

set $bit(bitstring, 11) = 1

使用 $bit 将现有位串中的位设置为 1：

set $bit(bitstring, 5) = 1

使用 $bit 将现有位串中的位设置为 0：

set $bit(bitstring, 5) = 0

由于位串中的第一位是位 1，因此尝试设置位 0 会返回错误：

第八十九章 SQL函数 LOG

返回给定数值表达式的自然对数的标量数值函数。

大纲

{fn LOG(expression)}

参数

• expression - 数值表达式。

LOG 返回 NUMERIC 或 DOUBLE 数据类型。如果表达式为 DOUBLE 数据类型，则 LOG 返回 DOUBLE；否则，它返回 NUMERIC。

描述

LOG 返回表达式的自然对数（以 e 为底）。 LOG 返回一个精度为 21、小数位数为 18 的值。

LOG 只能用作 ODBC 标量函数（使用大括号语法）。

示例

以下示例返回整数的自然对数：

第十三章 SQL命令 CREATE ROLE

创建角色

大纲

CREATE ROLE role-name

参数

• role-name - 要创建的角色的名称，它是一个标识符。角色名称不区分大小写。

描述

CREATE ROLE命令可创建角色。角色是可以分配给多个用户的一组命名权限。一个角色可以分配给多个用户，一个用户可以分配多个角色。角色在系统范围内可用，它不限于特定的命名空间。

第四十一章 外键关键字 - Internal

指定此外键定义是否为内部定义(不显示在类文档中)。

用法

要将此外键定义标记为内部，请使用以下语法:

ForeignKey keyname(key_props) References pkg.class(ref_index) [ Internal ];

否则，省略此关键字或将单词Not放在关键字的前面。

详解

内部类成员不会显示在类文档中。如果想让用户看到一个类，但不看到它的所有成员，这个关键字很有用。

默认

如果省略此关键字，此外键定义将显示在类文档中。

第四十二章 外键关键字 - NoCheck

指定是否应该检查这个外键约束。

用法

要防止检查该外键定义的约束，请使用以下语法:

第四十三章 Caché 变量大全 $ZTIMEZONE 变量

包含格林威治子午线的时区偏移量。

大纲

$ZTIMEZONE
$ZTZ

描述

$ZTIMEZONE可以通过两种方式使用：

• 返回计算机的本地时区偏移量。
• 为当前进程设置本地时区偏移量。

$ZTIMEZONE包含从格林威治子午线偏移的时区（以分钟为单位）。 （格林威治子午线包括整个英国和爱尔兰。）此偏移量表示为-1440到1440范围内的有符号整数。格林威治以西的时区指定为正数；格林威治东部的时区指定为负数。 （时区必须以分钟为单位，因为并非所有时区都以小时为单位。）默认情况下，$ZTIMEZONE初始化为计算机操作系统设置的时区。

第九章 Productions最佳实践 - Productions开发的最佳实践

Productions开发的最佳实践

本章是一个总体概述，旨在帮助团队成员为从事生产项目做好准备。它概述了开发任务并确定了有关 数据平台和企业集成的信息来源。本章中的信息适用于所有类型的生产项目。

项目目标

任何Productions开发项目的目标都是连接两个或多个系统。Productions是专门的软件和文档包，可为企业客户解决特定的集成问题。有关概述，请参阅互操作性产品简介。

本节从应用程序开发人员必须创建和配置以提供解决方案的软件元素的角度描述 IRIS。下一节“项目交付”总结了 IRIS 开发项目的顺序和结果。

项目交付

IRIS 产品架构支持向企业交付的各种风格：

这是InterSystems 2022年全球峰会上来自客户 Cognetivity Neuroscience 的分享。InterSystems IRIS 数据平台助力 Cognetivity Neurosciences 打造脑健康管理评估工具CognlCA。CognlCA 能够在正确的时间将数据提供给正确的人，推动脑健康评估、筛查和管理的节点前置，从而促进脑健康管理的普惠化。