安装Arbiter

为了将自动故障转移扩展到尽可能广泛的故障情况，InterSystems建议你为每个镜像配置一个仲裁机。

要充当仲裁者，系统必须有一个正在运行的ISCAgent进程。由于ISCAgent是与InterSystems IRIS一起安装的，任何承载一个或多个InterSystems IRIS实例的系统都符合这一要求，可以被配置为仲裁者而无需进一步准备；但是，承载一个或多个故障转移或DR异步镜像成员的系统不应该被配置为该镜像的仲裁者。

没有托管InterSystems IRIS实例的系统可以通过安装Arbiter方式的作为仲裁者。请从InterSystems公司下载适合你的仲裁者系统平台的ISCAgent安装包，然后，安装ISCAgent。

注意：Arbiter的版本要和InterSystems IRIS安装版本保持一致。

在测试你的代码时，你经常会遇到需要检查对象的实际内容。无论是使用 ZWRITE 还是 $system.OBJ.Dump()，

你会得到一个简单的属性图片，"--- 属性值---"

而 "--- swizzled references ---" 更容易让人混淆

用“--- calculated references ---" 你只是被留在了后面。

第二十章 控制进程（一）

IRIS 系统运行多个进程。应用程序代码以及 IRIS 系统代码在这些进程中执行。 IRIS 进程分为三类：
- 用户进程，在用户连接到 IRIS 时创建。
- 后台进程，在用户发出 ObjectScript Job命令时创建，或者由管理门户或实用程序创建。
- IRIS 系统进程。

在本文中，“进程”一词本身指的是用户进程和后台进程。

可以使用管理门户管理和控制进程：

[toc]

第四十四章 使用多个 IRIS 实例（四）

配置多个 IRIS 实例

可以在一台机器上安装并同时运行多个 IRIS 实例。像单一安装一样安装 IRIS，为每个实例提供唯一的名称、唯一的安装目录以及用于超级服务器、Web 服务器和 Telnet 的唯一端口号。

多个实例的特殊注意事项是：

• 安装多个实例受到系统上仅存在一个的组件的限制。例如，通常系统上只有一个 Web 服务器；因此 IRIS 安装将 Web Gateway 配置为最新安装。存储在注册表中的 IRIS 客户端组件遇到了同样的问题。 IRIS 将其 ODBC 驱动程序存储在注册表中，每个驱动程序使用一个名称。目前，最后一次安装会更新这些组件以指向最后安装的实例。

努力将通用组件移动到可以在 IRIS 实例之间共享的通用目录中。

第二十章 CSP Session 管理 - 状态管理

状态管理

因为 HTTP 是无状态协议。为 Web 编写的应用程序必须使用特殊技术来管理应用程序上下文或状态。 CSP 提供了许多用于状态管理的机制。这些中的每一个都可能适用于特定情况。

请求之间的跟踪数据

Web 应用程序中状态管理的基本问题是跟踪连续 HTTP 请求之间的信息。有许多可用的技术，包括：

• 使用隐藏的表单字段或 URL 参数在单个页面上存储数据
• 将数据存储在客户端的 cookie 中
• 将数据存储在服务器上的对象中的 %CSP.Session中
• 在 Caché 数据库中存储数据

在页面中存储数据

要将状态信息存储在页面中，必须放置它以便来自该页面的后续请求包含该信息。

第三十八章 使用^%SYS.MONLBL检查例程性能

例程^%SYS.MONLBL为监视器工具提供用户界面。该实用程序提供了一种方法来诊断在例程中执行选定代码所花费的时间，从而帮助识别特别耗费资源的代码行。它是现有监视器实用程序的扩展，可通过^PerfMon和%Monitor系统程序包类访问。由于这些实用程序共享相同的内存分配，因此一次只能在IRIS实例上运行其中一个实用程序。

调用逐行监视例程

如果在调用^%SYS.MONLBL时监视器没有运行，则例程会显示一条警告消息，并提供启动监视器或检查内存要求的选项。例如：

第七十三章 使用 irisstat 实用程序监控 IRIS - 使用选项运行 irisstat

使用选项运行 irisstat

不带选项运行 irisstat 会生成基本报告。通常，运行 irisstat 以获得特定信息。要指定目标信息，可以包括或排除如下选项：

• 要包含（打开）一个选项，请指定一个标志，后跟一个 1（或其他级别）。
• 要排除（关闭）一个选项，请指定一个标志后跟一个 0。

例如，要在 irisstat 报告中包含全局文件表 (GFILETA) 部分，请使用 -m1 选项：

C:\iris-install-dir\Bin\irisstat -m1

或者，要关闭默认的基本选项，请使用 -a0 选项：

在 Caché 中处理 SOAP 请求时，有时需要通过直接访问（有时是编辑）所发送的 XML（即 SOAP 请求和随后的 SOAP 响应）来调试错误。 如果要调试 Caché Web 服务，使用 SoapUI (https://www.soapui.org/) 之类的工具手动创建和控制 SOAP 请求通常很有用，这样可以很容易地在 Caché Web 服务上看到调整的效果。

但是如果已经有 Web 服务（可能不是 Caché），并且想要调试相关的 Caché Web 客户端该怎么办？ 您可能已将 SOAP 响应 XML 保存在文件中（例如 Caché SOAP 日志），您需要一个“虚拟”Web 服务将其发送到 Caché Web 客户端，就像实际的 Web 服务一样操作。

由于我经常在技术支持的过程中需要调试客户的 Caché Web 客户端，我创建了这样一个“虚拟”的Web 服务 – 见下文：

第十二章 使用嵌入式SQL（四）

SQL游标

游标是指向数据的指针，该数据允许嵌入式SQL程序对所指向的记录执行操作。通过使用游标，Embedded SQL可以遍历结果集。嵌入式SQL可以使用游标执行查询，该查询从多个记录返回数据。嵌入式SQL还可以使用游标更新或删除多个记录。

第二章 定义和构建索引（一）

定义索引

使用带有索引的Unique、PrimaryKey和IdKey关键字

与典型的SQL一样，InterSystems IRIS支持惟一键和主键的概念。
InterSystems IRIS还能够定义IdKey，它是类实例(表中的行)的唯一记录ID。
这些特性是通过Unique、PrimaryKey和IdKey关键字实现的:
- Unique -在索引的属性列表中列出的属性上定义一个唯一的约束。
也就是说，只有这个属性(字段)的唯一数据值可以被索引。
唯一性是根据属性的排序来确定的。
例如，如果属性排序是精确的，则字母大小写不同的值是唯一的;
如果属性排序是SQLUPPER，则字母大小写不同的值不是唯一的。
但是，请注意，对于未定义的属性，不会检查索引的惟一性。
根据SQL标准，未定义的属性总是被视为唯一的。

第八章 解释SQL查询计划（一）

SQL语句

这个SQL语句列表为每个表提供了SQL查询和其他操作的记录，包括插入、更新和删除。
这些SQL语句链接到一个查询计划，该链接提供冻结该查询计划的选项。

系统为每个SQL DML操作创建一条SQL语句。
这提供了一个按表、视图或过程名称列出的SQL操作列表。
如果更改表定义，可以使用此SQL Statements列表来确定每个SQL操作的查询计划是否会受到此DDL更改的影响，以及/或是否需要修改某个SQL操作。
然后,可以:

• 确定每个SQL操作使用哪个查询计划。
  可以决定使用反映对表定义所做更改的修改后的查询计划。
  或者可以冻结当前查询计划，保留在更改表定义之前生成的查询计划。
• 根据对表定义所做的更改，确定是否对对该表执行SQL操作的例程进行代码更改。

注意:SQL语句是一个SQL例程列表，它们可能会受到表定义更改的影响。
它不应该用作表定义或表数据更改的历史记录。

创建SQL语句操作

下面的SQL操作会创建相应的SQL语句:

第三章 执行测试

示例：执行测试

现在使用%UnitTest.Manager.RunTest执行单元测试。以下是方法：

第十四章 其他InterSystems %Net工具

下面是%Net中其他一些有用类的简短列表：

%Net.URLParser

InterSystems IRIS提供了一个实用程序类%Net.URLParser，可以使用它将URL字符串解析为其组成部分。例如，当您重定向HTTP请求时，这很有用。

该类包含一个类方法Parse()，它接受一个包含URL值的字符串，并通过引用返回一个包含URL各部分的数组。例如：

第三章 处理文件和目录名

%Library.File类提供了几个可用于处理文件名和目录名的类方法。在大多数情况下，文件和目录不需要存在即可使用这些方法。

获取文件名和目录名

%Library.File类提供可用于获取部分文件名和目录名的类方法。

在给定完整路径名的情况下，使用GetDirectory()和GetFilename()分别获取目录和短文件名。对于此方法，不允许使用部分目录名。

DHC-APP>set filename = "e:\temp\config.txt"

DHC-APP>write ##class(%File).GetDirectory(filename)
E:\temp\
DHC-APP>write ##class(%File).GetFilename(filename)
config.txt

在给定文件名的情况下，使用CanonicalFilename()从根目录获取完整路径：