第十三章 将XML文档表示为DOM

%XML.Document类和%XML.Node类使可以将任意XML文档表示为DOM(文档对象模型)。然后，可以导航此对象并对其进行修改。还可以创建一个新的DOM并将其添加到其中。

注意：使用的任何XML文档的XML声明都应该指明该文档的字符编码，并且文档应该按照声明的方式进行编码。如果未声明字符编码，InterSystems IRIS将使用本书前面的“输入和输出的字符编码”中描述的默认值。如果这些默认值不正确，请修改XML声明，使其指定实际使用的字符集。

将XML文档作为DOM打开

要打开现有XML文档以用作DOM，请执行以下操作：

1. 创建%XML.Reader的实例。
2. 也可以指定此实例的Format属性，以指定要导入的文件的格式。

默认情况下， IRIS假定XML文件为文字格式。如果文件是SOAP编码格式，则必须指明这一点，以便可以正确读取该文件。

让我们假设我们已经将一个数据源连接到Adaptive Analytics，创建了一个项目并在那里添加了表。

现在我们来准备Adaptive Analytics的工作。首先，我们需要从表中选择数据，使其可用于未来的报告。要做到这一点，我们需要从表的列中创建维度。创建维度通常是为了将我们的数据分解成不同的类别，例如用户住在哪个城市，或者购买是在哪个月进行的。然而，没有什么可以阻止我们从数字数据中创建维度，这样我们就可以在Intersystems Reports Designer中对它们应用函数。

创建维度的工具位于界面的右侧，如下图所示。要创建一个新的维度，右击位于 "过滤器 "（Filter)行右侧的汉堡包按钮，选择 "创建维度 "（Create Dimension)，如图所示。

将出现以下窗口：

听IRIS 专家聊IRIS，学技术，练英语听力，尽在Intersystems 系联在线培训广播电台
https://datapoints.intersystems.com.

21. Embedded Python — Released February 3, 2022

第五章 参数定义

描述参数定义的结构。

介绍

参数定义定义了一个给定类的所有对象都可用的常数值。创建类定义时(或在编译前的任何时候)，可以设置其类参数的值。默认情况下，每个参数的值都是空字符串，但是可以在参数定义中指定一个非空值。在编译时，为类的所有实例建立参数值。除了极少数例外，该值不能在运行时更改。

详解

参数定义具有以下结构:

cache2016开始提供了支持JSON的系统类，%DynamicAbstractObject %DynamicArray %DynamicObject，
不知是否可将这些系统类导入到之前的版本（如cache2012）， 从而实现支持JSON操作，或者是有何其他简单的解决办法

问题背景

目前不论开发和项目的数据库版本大部分是2016+，且广泛使用JSON，但当偶尔向低版本用户部署程序时，会遇到对JSON支持的问题

通过持续进行云投资，InterSystems能够提供礼宾级的云服务。

第四十二章 管理镜像 - 监控镜像

本章涵盖与管理和维护可操作的 IRIS 镜像相关的主题。

监控镜像

可以使用以下两种方法之一监视现有镜像的操作：

• 管理门户的镜像监控页面
• ^MIRROR 例程的状态监视器选项

这两种方法都显示有关镜像及其成员的操作状态和传入日志传输率的信息，以及有关镜像数据库状态的信息。此外，镜像监视器还允许您对镜像数据库执行多项操作。

监控镜像通信进程描述了在镜像成员上运行的镜像通信进程。

注意：基本镜像成员信息，包括指向镜像监视器的链接，也会出现在管理门户主页消息窗格中（请参阅系统管理指南的“使用管理门户”一章中的管理门户消息窗格。

许多与数据库和镜像相关的操作，例如安装或卸载数据库以及将数据库添加到镜像或从镜像中删除数据库，都记录在消息日志中。

使用镜像监视器

要显示镜像监视器，请导航到任何镜像成员上的“系统操作”>“镜像监视器”页面。

在故障转移成员上，镜像监视器包含以下按钮和部分：

此文章也是对问题 在不重建的情况下插入索引Inserting an index without reconstruction 的一种解释

在使用SQL语言对 InterSystems IRIS 中的表进行查询时，有时候会发现返回的结果与实际有出入，特别是使用count() 函数，或者select 查询时，返回的结果少于实际应返回的值。
这种情况往往是由于数据表格的索引值出了问题。

索引出问题的主要原因可能是：

• 表中先有数据，后创建的索引定义，并且定义之后没有重新生成索引。
• 对保存数据的global直接操作。如果是使用对象或者sql的方式操作数据，相应的索引都会自动更新，但是如果直接对global操作，则不会自动更新索引。
• 对保存索引的global直接操作。

要解决或者要检查是不是索引引发的问题，可以使用%ValidateIndices()函数，它有两种方式使用

第十九章 SQL函数 ASIN

一个标量数值函数，返回角的正弦的反正弦(以弧度为单位)。

大纲

{fn ASIN(numeric-expression)}

参数

• numeric-expression - 数值在-1到1之间的数值表达式。
  这是这个角的正弦值。

ASIN返回NUMERIC或DOUBLE数据类型。
如果数值表达式是数据类型DOUBLE, ASIN返回DOUBLE;
否则，返回NUMERIC。

SQL查询优化器一般情况下能给出最好的查询计划，但不是所有情况都这样，所以InterSystems SQL还提供了一个方式， 也就是在查询语句里加入optimize-option keyword（优化关键字）, 用来人工的修改查询计划。

比如下面的查询：

SELECT AVG(SaleAmt) FROM %PARALLEL User.AllSales GROUP BY Region

其中的%PARALLEL, 就是最常用的优化关键字， 它强制SQL优化器使用多进程并行处理这个SQL。

您可以这样理解： 如果查询优化器足够聪明，那么绝大多数情况下，根本就不需要优化关键字来人工干预。因此，您也一定不奇怪在不同的IRIS/Caché版本中， 关键字的表现可能不一样。越新的版本，应该是越少用到。比如上面的%PARALLEL， 在Caché的大多数版本中， 在查询中加上它一般都能提高查询速度，而在IRIS中，尤其是2023版本以后， 同样的SQL查询语句，很大的可能查询优化器已经自动使用多进程并行查询了，不再需要用户人工干预了。

因此，先总结有关优化关键字的要点：

第三十五章 配置镜像 - 配置与镜像的应用程序服务器连接

当使用镜像的自动部署方法中描述的方法之一部署具有镜像数据服务器的分布式缓存集群时，所有需要的配置都是自动的。当使用Management Portal 部署集群时，必须在将数据服务器添加到每个应用程序服务器时指明该数据服务器是一个镜像。当数据服务器通过任何方法配置为镜像连接时，每个应用程序服务器定期从主服务器收集有关镜像的更新信息，自动检测故障转移并根据需要将连接重定向到新的主服务器。

有关使用自动部署方法配置镜像数据服务器的信息，请参阅镜像的自动部署方法中列出的文档。要手动将镜像配置为分布式缓存集群中的数据服务器，请使用以下过程：

第十八章 使用系统监视器 - 设置系统监视器选项

设置系统监视器选项

要更改全局系统监视器设置或将它们恢复为默认值，请停止系统监视器（如果它正在运行），然后在主菜单中输入 2：

1) Set Sample Interval
2) Set Debugging Level
3) Reset Defaults
4) Manage Debug Data
5) Exit

输入 1 设置系统监视器调用每个配置的传感器类的时间间隔；默认值为 30 秒。

输入 2 设置调试级别。默认值为 0（基本），它将系统监视器和运行状况监视器状态和错误消息写入系统监视器日志，并且不保存传感器读数。调试级别 1（记录所有传感器）将传感器读数与消息一起写入系统监视器日志并保存传感器读数，然后可以使用“查看系统数据”菜单的“查看传感器数据”选项查看这些读数。

输入 3 将采样间隔、调试级别和传感器读数的保存重置为其默认值。

第二十章 使用工作队列管理器（三）

管理类别

一个类别是一个独立的worker jobs池。当初始化一组worker jobs时，可以指定提供worker的类别。如果集合中的任何worker jobs在执行work项时请求额外的worker jobs，则新的worker jobs来自同一类别。

例如，假设系统提供的 SQL 类别分配了最多 8 个worker。然后，假设与BusinessIntelligence相关的流程创建了一个类别，并将最多四个worker分配给该类别。如果 SQL 池中的所有worker在给定时间都参与了工作，则 BusinessIntelligence 类别中的worker可能仍然可以立即处理工作项。

系统包括两个不能删除的类别：SQL 和 Default。 SQL 类别适用于系统执行的任何 SQL 处理，包括查询的并行处理。当在未指定类别的情况下初始化一组worker jobs时，默认类别提worker jobs。

每个类别都具有影响该类别中每个工作队列的行为的属性。这些属性是：