第二章 使用%UnitTest进行单元测试

本教程的第二部分介绍了如何使用%UnitTest包对InterSystems IRIS代码进行单元测试。完成本教程的这一部分后，将能够：

• 解释%UnitTest包中三个主要类的角色。
• 列出基于%UnitTest包的单元测试类和方法的要求。
• 创建并执行方法的单元测试。
• 浏览%UnitTest.Manager创建的测试报告。
• 执行单元测试时，使用%UnitTest.TestCase方法初始化和还原数据库数据。

什么是%UnitTest？

%UnitTest包是一组为IRIS提供测试框架的类。在结构上，它类似于xUnit测试框架。%UnitTest为创建和执行以下各项的单元测试提供类和工具：

• 类和方法
• ObjectScript例程(routines)
• InterSystems SQL脚本
• Productions

创建和执行单元测试套件

以下是创建和执行一套单元测试的基本步骤：

1. 创建一个(或多个)包含要测试的方法的类。
2. 创建扩展%UnitTest.TestCase的测试类(或多个测试类)。
3. 将方法添加到将测试方法输出的测试类。在每个方法中至少使用一个断言(AssertX宏)。每个测试方法名称都以Test开头。
4. 将测试类导出到文件。
5. 打开终端并切换到包含要测试的类的名称空间。

第一章 单元测试概述

本教程的第一部分概述了单元测试。完成本教程的这一部分后，将能够：

• 定义单元测试并区分单元测试和集成测试
• 列出单元测试的几个好处
• 描述InterSystems IRIS %UnitTest包和xUnit测试框架之间的相似性。
• 列出软件开发中测试优先方法经常声称的几个好处。

什么是单元测试?

单元测试是对单个代码模块的正确性的测试，例如，方法或类的测试。通常，开发人员在开发代码时为其代码创建单元测试。典型的单元测试是一种执行方法的方法，该方法测试并验证该方法是否为给定的一组输入生成了正确的输出。

单元测试不同于集成测试。集成测试验证了一组代码模块交互的正确性。单元测试仅单独验证代码模块的正确性。一组代码模块的集成测试可能会失败，即使每个模块都通过了单元测试。

为什么要进行单元测试？

单元测试提供了许多好处，包括：

• 提供代码模块是否正确的验证。这是单元测试的主要原因。
• 提供自动回归测试。更改代码模块后，应重新运行单元测试，以确保代码模块仍然正确。也就是说，应该使用单元测试来确保更改没有破坏代码模块。理想情况下，所有代码模块的单元测试都应该在更改任何一个模块之后运行。
• 提供文档。通常，代码模块的单元测试与代码模块一起交付。检查单元测试提供了大量有关代码模块如何工作的信息。

XUnit测试框架

单元测试框架是为开发和执行单元测试提供支持的类包。

Caché Global

第一章 简介global☆☆☆☆☆

第二章 全局变量结构（一）☆☆☆☆☆

第二章 全局变量结构（二）☆☆☆☆☆

第三章 使用多维存储(全局变量)（一）☆☆☆☆☆

第三章 使用多维存储(全局变量)（二）☆☆☆☆☆

第三章 使用多维存储(全局变量)（三）☆☆☆☆☆

第三章 使用多维存储(全局变量)（四）☆☆☆☆☆

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

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

第五章 管理全局变量（一）☆☆☆☆☆

第五章 管理全局变量（二）☆☆☆☆☆

第六章 临时全局变量和IRISTEMP数据库☆☆☆☆☆

前言

经过快一个月的连载 《Caché Global》 共12篇。对于刚接触M的语言的同学，由浅入深帮助你快速进步，对于老手，丰富更多的细节

涵盖以下主题：

• “简介”概述了全局变量的功能和用途。
• “全局变量结构”描述了全局变量是如何存储在磁盘上的，它们是如何命名和引用的，以及它们的结构。
• “使用多维存储(全局)”介绍如何以编程方式使用全局变量。
• “多维存储的SQL和对象使用”描述了对象和SQL引擎如何使用全局变量存储数据。
• “管理全局变量”介绍了主要从管理门户管理全局的工具。
• “临时全局变量和TEMP数据库”描述了如何使用临时全局变量来帮助进行复杂的处理。

第六章 临时全局变量和IRISTEMP数据库

对于某些操作，可能需要全局变量的功能，而不需要无限期保存数据。例如，可能希望使用全局对某些不需要存储到磁盘的数据进行排序。对于这些操作，InterSystems IRIS提供了临时全局机制。该机制的工作方式如下：

• 对于应用程序名称空间，可以定义一个全局映射，以便将具有特定命名约定的全局变量映射到IRISTEMP数据库，该数据库是一个特殊的数据库，如下所述。

例如，可以定义一个全局映射，以便将名称为^AcmeTemp*的所有全局变量映射到IRISTEMP数据库。

• 当代码需要临时存储数据并再次读取它时，代码将向使用该命名约定的全局变量写入数据，并从全局变量读取数据。

例如，要保存值，代码可能会执行以下操作：

 set ^AcmeTempOrderApp("sortedarray")=some value

然后，稍后代码可能会执行以下操作：

 set somevariable = ^AcmeTempOrderApp("sortedarray")

通过使用临时全局变量，可以利用IRISTEMP数据库没有日志记录这一事实。因为数据库没有日记记录，所以使用该数据库的操作不会产生日记文件。日志文件可能会变得很大，并可能导致空间问题。但是，请注意以下几点：

不能回滚修改IRISTEMP数据库中的全局变量的任何事务；此行为特定于IRISTEMP。

第五章 管理全局变量（二）

在全局变量中查找值

“查找全局变量字符串”页使可以在下标或选定全局变量的值中查找给定的字符串。

要访问和使用此页，请执行以下操作：

1. 显示“全局变量”页。
2. 选择要使用的全局变量。为此，请参阅“全局页简介”一节中的步骤2和3。
3. 单击查找按钮。
4. 对于查找内容，输入要搜索的字符串。
5. (可选)清除大小写匹配。默认情况下，搜索区分大小写。
6. 单击Find First或Find All。

然后，页面显示选定全局变量中下标或值包含给定字符串的第一个节点或所有节点。该表左侧显示了节点下标，右侧显示了相应的值。

7. 如果使用的是Find First，请根据需要单击Find Next以查看下一个节点。
8. 完成后，单击关闭窗口。

执行批量更换

注意:在进行任何编辑之前，请确保知道IRIS使用哪个全局系统，以及应用程序使用哪个全局系统；参见“一般建议”此选项会永久更改数据。不建议在生产系统中使用。

出于开发目的，“查找全局字符串”页面还提供了对全局节点中的值进行整体更改的选项。要使用此选项:

1. 显示“全局”页面。
2. 选择要使用的全局。为此，请参见“全球页面简介”一节中的步骤2和3
3. 单击替换按钮。
4. 使用此页面查找上一节中描述的值。
5. 为“替换为”指定一个值。
6. 单击全部替换。
7. 单击确定确认此操作。然后，页面会显示变更的预览。
8. 如果结果可以接受，请单击保存。
9. 单击确定确认此操作。

第五章 管理全局变量（二）

在全局变量中查找值

“查找全局变量字符串”页使可以在下标或选定全局变量的值中查找给定的字符串。

要访问和使用此页，请执行以下操作：

1. 显示“全局变量”页。
2. 选择要使用的全局变量。为此，请参阅“全局页简介”一节中的步骤2和3。
3. 单击查找按钮。
4. 对于查找内容，输入要搜索的字符串。
5. (可选)清除大小写匹配。默认情况下，搜索区分大小写。
6. 单击Find First或Find All。

然后，页面显示选定全局变量中下标或值包含给定字符串的第一个节点或所有节点。该表左侧显示了节点下标，右侧显示了相应的值。

7. 如果使用的是Find First，请根据需要单击Find Next以查看下一个节点。
8. 完成后，单击关闭窗口。

执行批量更换

注意:在进行任何编辑之前，请确保知道IRIS使用哪个全局系统，以及应用程序使用哪个全局系统；参见“一般建议”此选项会永久更改数据。不建议在生产系统中使用。

出于开发目的，“查找全局字符串”页面还提供了对全局节点中的值进行整体更改的选项。要使用此选项:

1. 显示“全局”页面。
2. 选择要使用的全局。为此，请参见“全球页面简介”一节中的步骤2和3
3. 单击替换按钮。
4. 使用此页面查找上一节中描述的值。
5. 为“替换为”指定一个值。
6. 单击全部替换。
7. 单击确定确认此操作。然后，页面会显示变更的预览。
8. 如果结果可以接受，请单击保存。
9. 单击确定确认此操作。

本贴提供了在 VMware ESXi 5.5 及更高版本的环境中部署 Caché 2015 及更高版本时，关于配置、系统规模调整和容量规划等方面的指南。

我假定您已经了解 VMware vSphere 虚拟化平台，所以直接给出推荐。 本指南中的推荐不特定于任何具体硬件或站点特定的实现，也不应作为规划和配置 vSphere 部署的全面指南，而是一份您可以做出选择的最佳实践配置清单。 我希望您的 VMware 专家实施团队能针对具体站点对这些推荐进行评估。

这里是 InterSystems 数据平台和性能系列的其他帖子的列表。

_注：_本帖更新于 2017 年 1 月 3 日，强调必须为生产数据库实例设置虚拟机内存预留，以保证 Caché 有足够内存可用，并且不会出现内存交换或膨胀而对数据库性能产生负面影响。 更多详细信息，请参见下面的内存部分。

在本帖中，我将展示使用_外部备份_来备份 Caché 的策略，以及与基于快照的解决方案集成的示例。 如今，大多数解决方案部署在基于 VMware 的 Linux 上，因此许多帖子都以展示解决方案如何集成 VMware 快照技术为例。

Caché 备份 - 包括电池？

Caché 安装后即包含 Caché 在线备份，可提供不间断的 Caché 数据库备份。 但随着系统规模的扩大，您应该考虑更高效的备份解决方案。 集成了快照技术的_外部备份_是推荐的系统（包括 Caché 数据库）备份解决方案。

外部备份有特殊注意事项吗？

外部备份的在线文档包含了全部详细信息。 一个关键考虑事项是：

“为确保快照的完整性，Caché 提供了在创建快照时冻结数据库写操作的方法。 在创建快照期间，只冻结对数据库文件的物理写入，从而允许用户进程继续在内存中不间断地执行更新。”

还需要注意的是，虚拟化系统上的部分快照过程会导致正在备份的虚拟机短暂暂停，这段时间通常称为关闭时间。 该时间通常不到一秒，因此不会被用户注意到，也不会影响系统运行，但在某些情况下，关闭时间可能较长。 如果关闭时间长于 Caché 数据库镜像的 QoS 超时时间，那么备份节点将认为主节点出现故障，并将进行故障转移。 在本帖的后面部分，我将说明在需要对镜像 QoS 超时时间进行更改时如何查看关闭时间。

部分 在上个帖子中，我们安排了使用 pButtons 进行 24 小时的性能指标收集。 在本帖中，我们将研究几个收集到的关键指标，以及它们与底层系统硬件的关系。 我们还将开始探索 Caché（或任一 InterSystems 数据平台）指标与系统指标之间的关系。 以及如何使用这些指标来了解系统的每日节拍率并诊断性能问题。

本周，我将关注 CPU - 主要硬件食物群之一 :) 一位客户请我就以下情况提供建议：他们的生产服务器已接近使用寿命终止，是时候更新硬件了。 他们还考虑通过虚拟化来整合服务器，并希望适当调整裸机或虚拟机的容量规模。 今天我们将关注 CPU，在后面的帖子中，我将介绍适当调整其他主要食物群（内存和 IO）规模的方法。

所以问题是：

• 如何将五年多以前对处理器的应用要求转换成针对当今的处理器？
• 目前的处理器有哪些是合适的？
• 虚拟化如何影响 CPU 容量计划？

本帖将展示为 InterSystems 数据平台上运行的数据库应用调整共享内存需求（包括 global 和例程缓冲区、gmheap 以及 locksize）的方法，以及在配置服务器和虚拟化 Caché 应用程序时应考虑的一些性能提示。 和以往一样，当我谈到 Caché 时，我指的是所有数据平台（Ensemble、HealthShare、iKnow 和 Caché）。

[本系列其他帖子的列表](https://cn.community.intersystems.com/post/intersystems-数据平台的容量规划和性能系列文章)

当我最初开始使用 Caché 时，大多数客户的操作系统是 32 位的，Caché 应用程序的内存有限且昂贵。 通常部署的英特尔服务器只有几个核心，唯一的扩展方式是选择大型服务器，或者使用 ECP 横向扩展。 现在，即使是基本的生产级服务器也具有多个处理器、几十个核心，并且最小内存为 128 或 256 GB，可能达到 TB。 对于大多数数据库安装，ECP 已被遗忘，我们现在可以在单台服务器上大幅提高应用事务处理速率。

关键字：深度学习，Grad-CAM，X 射线，Covid-19，HealthShare，IRIS

目的

在复活节周末，我谈到了一些针对 Covid-19 肺的深度学习分类器。  演示结果还算不错，似乎与当时有关该主题的一些学术研究刊物相吻合。 但它真的足够“好”吗？ 

最近，我偶然收听了一个关于“机器学习中的可解释性”的在线午餐网络讲座，Don 在演讲的最后谈到了这个分类结果：

上图也出现在 “Why Should I Trust You?” Explaining the Predictions of Any Classifier 这篇研究论文中。   我们可以看到，分类器实际上经过训练，以背景像素（如雪等野生环境）作为主要输入，对宠物狗和野狼进行分类。 

这关乎我过去的兴趣，现在也激起一些好奇：

• 我们如何“观察”这些通常以“黑盒”形式表示的 Covid-19 分类器，了解哪些像素实际上促成了“Covid-19 肺”结果？
• 在这种情况下，我们可以利用的最简单的形式或工具是什么？ 

这也是篇简单的 10 分钟笔记。 最后，我会谈到为什么它也与我们即将推出的全新 IRIS 和 HealthShare 功能有关。

范围

幸运的是，过去几年中，各种 CNN 衍生分类器都有了方便的工具：

• CAM（类激活图）：其应用在这里和这里得到了充分解释。

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

索引

持久化类可以定义一个或多个索引；其他数据结构用于提高操作(如排序或条件搜索)的效率。InterSystems SQL在执行查询时使用这些索引。InterSystems IRIS对象和SQL在执行INSERT、UPDATE和DELETE操作时自动维护索引内的正确值。

标准索引的存储结构

标准索引将一个或多个属性值的有序集与包含属性的对象的对象ID值相关联。

例如，假设我们定义了一个简单的持久化MyApp.Person类，该类具有两个文本属性和一个关于其Name属性的索引：

Class MyApp.Person Extends %Persistent
{
Index NameIdx On Name;

Property Name As %String;
Property Age As %Integer;
}

如果我们创建并保存此Person类的多个实例，则生成的数据和索引全局变量类似于：

 // data global
 ^MyApp.PersonD = 3  // counter node
 ^MyApp.PersonD(1) = $LB("",34,"Jones")
 ^MyApp.PersonD(2) = $LB("",22,"Smith")
 ^MyApp.

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

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

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

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

数据

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

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

默认结构

用于存储持久对象的默认结构非常简单：

• 数据存储在名称以完整类名(包括包名)开头的全局变量中。附加“D”以形成全局数据的名称，而附加“I”作为全局索引。
• 每个实例的数据都存储在全局数据的单个节点中，所有非瞬态属性都放在$list结构中。
• 数据全局变量中的每个节点都以对象ID值作为下标。默认情况下，对象ID值是通过调用存储在全局变量数据根(没有下标)的计数器节点上的$Increment函数提供的整数。

例如，假设我们定义了一个简单的持久化类MyApp.Person，它有两个文本属性：

Class MyApp.

第三章 使用多维存储(全局变量)（四）

管理事务

InterSystems IRIS提供了使用全局变量实现完整事务处理所需的基本操作。 InterSystems IRIS对象和SQL自动利用这些特性。 如果直接将事务性数据写入全局变量，则可以使用这些操作。

事务命令是TSTART，它定义事务的开始; TCOMMIT，它提交当前事务; 和TROLLBACK，它将中止当前事务，并撤消自事务开始以来对全局变量所做的任何更改。

例如，下面的ObjectScript代码定义了事务的开始，设置了一些全局变量节点，然后根据ok的值提交或回滚事务:

/// w ##class(PHA.TEST.Global).GlobalTro(0)
ClassMethod GlobalTro(ok)
{

	TSTART

	Set ^Data(1) = "Apple1"
	Set ^Data(2) = "Berry1"

	If (ok) {
		TCOMMIT
	}
	Else {
	 	TROLLBACK
	}
	zw ^Data
	q ""
}

TSTART在InterSystems IRIS日志文件中写入事务开始标记。 这定义了事务的起始边界。 在上面的示例中，如果变量ok为true(非零)，则TCOMMIT命令标记事务成功结束，并将事务完成标记写入日志文件。

亲爱的社区开发者们，大家好！

欢迎积极参与新一轮InterSystems开发者竞赛！

🏆 InterSystems 编程大赛：FHIR 加速器 🏆

提交在AWS上使用InterSystems的IRIS FHIR-as-a-service的应用程序，或帮助使用InterSystems IRIS FHIR加速器开发的解决方案。点击这篇文章，了解如何在AWS上申请应用InterSystems IRIS FHIR 加速器服务 (FHIRaaS) 。

时间：2021年5月10日-6月6日

奖金总额: $8,750 

👉  点击登录活动页面 👈

第三章 使用多维存储(全局变量)（三）

在全局变量中复制数据

若要将全局变量(全部或部分)的内容复制到另一个全局变量(或局部数组)中，请使用ObjectScript Merge命令。

下面的示例演示如何使用Merge命令将OldData全局变量的全部内容复制到NewData全局变量中：

 Merge ^NewData = ^OldData

如果合并命令的source参数有下标，则复制该节点及其后代中的所有数据。如果Destination参数有下标，则使用目标地址作为顶级节点复制数据。例如，以下代码：

 Merge ^NewData(1,2) = ^OldData(5,6,7)

将^OldData(5，6，7)及其下的所有数据复制到^NewData(1，2)。

维护全局变量内的共享计数器

大规模事务处理应用程序的一个主要并发瓶颈可能是创建唯一标识符值。例如，考虑一个订单处理应用程序，在该应用程序中，必须为每一张新发票指定一个唯一的标识号。传统的方法是维护某种计数器表。每个创建新发票的进程都会等待获取此计数器上的锁，递增其值，然后将其解锁。这可能会导致对此单个记录的激烈资源争用。

为了解决此问题，InterSystems IRIS提供了ObjectScript $INCREMENT函数。$INCREMENT自动递增全局节点的值(如果该节点没有值，则设置为1)。

第三章 使用多维存储(全局变量)（二）

遍历全局变量中的数据

有许多方法可以遍历(迭代)存储在全局变量中的数据。

$ORDER(下一个/上一个)函数

ObjectScript $Order函数允许顺序访问全局中的每个节点。

$ORDER函数返回给定级别(下标编号)的下一个下标的值。例如，假设定义了以下全局设置：

 Set ^Data(1) = ""
 Set ^Data(1,1) = ""
 Set ^Data(1,2) = ""
 Set ^Data(2) = ""
 Set ^Data(2,1) = ""
 Set ^Data(2,2) = ""
 Set ^Data(5,1,2) = ""

要查找第一个第一级下标，我们可以使用：

 SET key = $ORDER(^Data(""))

这将返回空字符串(“”)之后的第一个第一级下标。(空字符串用于表示第一个条目之前的下标值；作为返回值，它用于指示没有后续的下标值。)。在本例中，key现在将包含值1。

我们可以通过在$ORDER表达式中使用1或键来查找下一个第一级下标：

 SET key = $ORDER(^Data(key))

如果key的初始值为1，则此语句将其设置为2(因为^Data(2)是下一个第一级下标)。再次执行此语句会将key设置为5，因为这是下一个第一级下标。请注意，即使没有直接存储在^Data(5)中的数据，也会返回5。

第三章 使用多维存储(全局变量)（一）

本章描述了使用多维存储(全局变量)可以执行的各种操作。

以全局变量存储数据

在全局节点中存储数据很简单:像对待任何其他变量一样对待全局变量。 区别在于对全局变量的操作是自动写入数据库的。

创建全局变量

创建新的全局变量不需要设置工作；只需将数据设置为全局变量即可隐式创建新的全局结构。可以创建全局变量(或全局变量下标)并通过单个操作将数据放入其中，也可以创建全局变量(或下标)并通过将其设置为空字符串将其保留为空。在ObjectScript中，这些操作是使用SET命令完成的。

下面的例子定义了一个名为Color(如果还不存在)的全局变量，并将值“Red”与之关联。 如果已经存在一个名为Color的全局变量，那么这些示例将其修改为包含新信息。

在ObjectScript中：

 SET ^Color = "Red"

注意：在应用程序中使用直接全局访变量问时，应制定并遵守命名约定，以防止应用程序的不同部分相互“遍历”；这类似于为类、方法和其他变量开发命名约定。

在全局变量节点中存储数据

要在全局下标节点中存储值，只需像设置任何其他变量数组一样设置全局节点的值。如果指定的节点以前不存在，则会创建该节点。如果它确实存在，则其内容将替换为新值。

可以通过表达式(称为全局引用)指定全局内的节点。全局引用由脱字符(^)、全局名称和(如果需要)一个或多个下标值组成。

第二章 全局变量结构（二）

全局变量物理结构

全局变量使用高度优化的结构存储在物理文件中。管理此数据结构的代码也针对运行InterSystems IRIS的每个平台进行了高度优化。这些优化确保全局操作具有高吞吐量(每单位时间的操作数)、高并发性(并发用户总数)、缓存的高效使用，并且不需要与性能相关的持续维护(例如频繁的重建、重新索引或压缩)。

用于存储全局变量的物理结构是完全封装的；应用程序不会以任何方式担心物理数据结构。

全局变量存储在磁盘上的一系列数据块中；每个块的大小(通常为8KB)是在创建物理数据库时确定的。为了提供对数据的高效访问，InterSystems IRIS维护了一种复杂的B树状结构，该结构使用一组指针块将相关数据块链接在一起。InterSystems IRIS维护一个缓冲池-经常引用的块的内存缓存-以降低从磁盘获取块的成本。

虽然许多数据库技术使用类似B树的结构来存储数据，但InterSystems IRIS在许多方面都是独一无二的：

• 存储机构通过安全、易于使用的接口显露出来。
• 压缩下标和数据以节省磁盘空间和宝贵的内存缓存空间。
• 存储引擎针对事务处理操作进行了优化：插入、更新和删除都很快。与关系系统不同，InterSystems IRIS从不需要重建索引或数据来恢复性能。
• 存储引擎针对最大并发访问进行了优化。
• 数据会自动群集，以实现高效检索。

第二章 全局变量结构（一）

本章描述全局变量的逻辑视图，并概述全局变量是如何在磁盘上物理存储的。

全局变量的逻辑结构

全局变量是存储在物理InterSystems IRIS®数据库中的命名多维数组。 在应用程序中，全局变量到物理数据库的映射基于当前名称空间——名称空间提供一个或多个物理数据库的逻辑统一视图。

全局命名约定和限制

全局名称指定其目标和用途。有两种类型的全局变量和一组单独的变量，称为“进程私有全局变量”：

• 全局变量 - 这就是所谓的标准全局变量；通常，这些变量被简称为全局变量。它是驻留在当前命名空间中的永久性多维数组。
• 扩展全局引用-这是位于当前命名空间以外的命名空间中的全局引用。
• 进程私有全局变量-这是一个数组变量，只有创建它的进程才能访问。

全局变量的命名约定如下：

• 全局变量名称以脱字符(^)前缀开头。这个插入符号区分全局变量和局部变量。
• 全局变量名称中脱字符(^)前缀后的第一个字符可以是：
  • 字母或百分号字符(%)-仅适用于标准全局变量。对于全局变量名称，字母被定义为ASCII 65到ASCII 255范围内的字母字符。如果全局名称以“%”开头(但不是“%Z”或“%z”)，则此全局名称供InterSystems IRIS系统使用。%GLOBAL通常存储在IRISSYS或IRISLIB数据库中。
  • 竖线(|)或左方括号([)-表示扩展全局引用或进程专用全局变量。

第一章 简介global

InterSystems IRIS®的核心功能之一是其多维存储引擎。此功能允许应用程序以紧凑、高效的多维稀疏数组存储数据。这些数组称为全局数组。

本章介绍：

• 什么是全局变量(globals )，以及可以对其执行的操作。
• 全局变量的逻辑和物理结构，包括在分布式数据库体系结构中使用全局变量。
• 如何使用全局变量在应用程序中存储和检索数据。
• 如何使用全局变量。

特点

全局变量提供了一种在持久的多维数组中存储数据的易于使用的方法。

例如，可以使用名为^Settings的全局变量将值“Red”与键“Color”相关联：

SET ^Settings("Color")="Red"

可以利用全局变量的多维特性来定义更复杂的结构：

 SET ^Settings("Auto1","Properties","Color") = "Red"
 SET ^Settings("Auto1","Properties","Model") = "SUV"
 SET ^Settings("Auto2","Owner") = "Mo"
 SET ^Settings("Auto2","Properties","Color") = "Green"

全局变量具有以下功能：

• 简单易用-全局变量和其他编程语言变量一样易于使用。
• 多维-可以使用任意数量的下标指定全局内节点的地址。

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

SQL语句的详细信息

有两种方式显示SQL语句的详细信息:

• 在SQL Statements选项卡中，通过单击左侧列中的Table/View/Procedure Name链接选择一个SQL Statement。 这将在单独的选项卡中显示SQL语句详细信息。 该界面允许打开多个选项卡进行比较。 它还提供了一个Query Test按钮，用于显示SQL Runtime Statistics页面。
• 从表的Catalog Details选项卡(或SQL Statements选项卡)中，通过单击右边列中的Statement Text链接选择一个SQL语句。 这将在弹出窗口中显示SQL语句详细信息。

可以使用“SQL语句详细信息”显示来查看查询计划，并冻结或解冻查询计划。

“SQL语句详细信息”提供冻结或解冻查询计划的按钮。 它还提供了一个Clear SQL Statistics按钮来清除性能统计，一个Export按钮来将一个或多个SQL语句导出到一个文件，以及一个Refresh和Close页面按钮。

SQL语句详细信息显示包含以下部分。

第九章 冻结计划

大多数SQL语句都有一个关联的查询计划。查询计划是在准备SQL语句时创建的。默认情况下，添加索引和重新编译类等操作会清除此查询计划。下次调用查询时，将重新准备查询并创建新的查询计划。冻结计划使可以跨编译保留(冻结)现有查询计划。查询执行使用冻结的计划，而不是执行新的优化并生成新的查询计划。

对系统软件的更改也可能导致不同的查询计划。通常，这些升级会带来更好的查询性能，但软件升级可能会降低特定查询的性能。冻结计划使可以保留(冻结)查询计划，以便查询性能不会因系统软件升级而改变(降级或提高)。

如何使用冷冻计划

使用冻结计划有两种策略-乐观策略和悲观策略：

• 乐观：如果假设更改系统软件或类定义会提高性能，请使用此策略。运行查询并冻结计划。导出(备份)冻结的计划。解冻该计划。更改软件。重新运行查询。这会产生一个新的计划。比较这两个查询的性能。如果新计划没有提高性能，可以从备份文件中导入先前冻结的计划。
• 悲观：如果假设系统软件或类定义的更改可能不会提高特定查询的性能，请使用此策略。运行查询并冻结计划。更改软件。使用%NOFPLAN关键字重新运行查询(这会导致冻结的计划被忽略)。比较这两个查询的性能。如果忽略冻结的计划没有提高性能，请保持冻结该计划并从查询中删除%NOFPLAN。

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

SQL语句

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

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

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

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

创建SQL语句操作

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

数据管理(DML)操作包括对表的查询、插入、更新和删除操作。 每个数据管理(DML)操作(动态SQL和嵌入式SQL)在执行时都会创建一个SQL语句。

• 动态SQL SELECT命令在准备查询时创建SQL语句。 此外，在管理门户缓存查询列表中创建了一个条目。

第七章 解释SQL查询计划

本章介绍由ShowPlan生成的InterSystems SQL查询访问计划中使用的语言和术语。

存储在映射中的表

SQL表存储为一组映射。 每个表都有一个包含表中所有数据的主映射; 表还可以有其他的映射，如索引映射和位图。 每个映射可以被描绘成一个多维全局，其中一些字段的数据在一个或多个下标中，其余字段存储在节点值中。 下标控制要访问的数据。

• 对于主映射，RowID或IDKEY字段通常用作映射下标。
• 对于索引映射，通常将其他字段用作前导下标，将RowID/IDKEY字段用作附加的较低级别的下标。
• 对于位图，可以将位图层视为附加的RowID下标级别。但是，位图只能用于为正整数的RowID。

发展计划

编译SQL查询会生成一组指令来访问和返回查询指定的数据。 这些指令表示为. int例程中的ObjectScript代码。

指令及其执行顺序受到SQL编译器中有关查询中涉及的表的结构和内容的数据的影响。 编译器尝试使用表大小和可用索引等信息，以使指令集尽可能高效。

查询访问计划(ShowPlan)是对结果指令集的可读翻译。 查询的作者可以使用这个查询访问计划来查看将如何访问数据。 虽然SQL编译器试图最有效地利用查询指定的数据，但有时查询的作者对存储的数据的某些方面的了解要比编译器清楚得多。

第六章 SQL性能分析工具包

本章介绍可用于主动分析特定SQL语句的分析工具。这些工具收集有关这些SQL语句执行的详细信息。使用这些信息，开发人员可以采取措施提高低效SQL语句的性能。

根据请求的详细程度，此活动分析可能会显著增加服务器上的负载。因此，SQL性能分析工具包旨在进行协调一致的代码分析工作。它不是用来连续监视执行代码的。

分析工具界面

SQL性能分析工具包为开发人员和支持专家提供了分析特定SQL语句或语句组的能力。通过在执行特定SQL语句期间使用这些工具，它们可以收集详细信息，这些信息可用于单独或跨活动工作负载分析有问题的语句。

要记录的细节级别是可配置的，最细粒度的设置在模块级别收集信息，为语句的查询计划中的不同“步骤”提供信息。

• %SYSTEM.SQL.PTools类方法。

第五章 优化查询性能（四）

注释选项

可以在SELECT、INSERT、UPDATE、DELETE或TRUNCATE表命令中为查询优化器指定一个或多个注释选项。 注释选项指定查询优化器在编译SQL查询期间使用的选项。 通常，注释选项用于覆盖特定查询的系统范围默认配置。

语法

语法/*#OPTIONS */(在/*和#之间没有空格)指定了一个注释选项。 注释选项不是注释; 它为查询优化器指定一个值。 注释选项使用JSON语法指定，通常是“key:value”对，例如: /*#OPTIONS {"optionName":value} */。 支持更复杂的JSON语法，比如嵌套值。

注释选项不是注释; 除了JSON语法之外，它可能不包含任何文本。 包含非json文本在/* ... */分隔符导致SQLCODE -153错误。 InterSystems SQL不验证JSON字符串的内容。

#OPTIONS关键字必须用大写字母指定。 JSON的大括号语法中不应该使用空格。 如果SQL代码用引号括起来，比如动态SQL语句，JSON语法中的引号应该是双引号。 例如:myquery="SELECT Name FROM Sample.

InterSystems IRIS、IRIS for Health和HealthShare Health Connect的2021.1版本的预览版现已发布。

由于这是一个预览版，我们希望在下个月的通用版本发布之前了解您对这个新版本的体验。请通过开发者社区分享您的反馈，以便我们能够共同打造一个更好的产品。

InterSystems IRIS数据平台2021.1是一个扩展维护（EM）版本。自2020.1（上一个EM版本）以来，在持续交付（CD）版本中增加了许多重要的新功能和改进。请参考2020.2、2020.3和2020.4的发布说明，了解这些内容的概况。

这个版本的增强功能为开发人员提供了更大的自由度，可以用他们选择的语言构建快速和强大的应用程序，并使用户能够通过新的和更快的分析功能更有效地处理大量的信息。

通过InterSystems IRIS 2021.1，客户可以部署InterSystems IRIS Adaptive Analytics，这是一个附加产品，它扩展了InterSystems IRIS，为分析终端用户提供了更强大的易用性、灵活性、可扩展性以及效率，而不管他们选择何种商业智能（BI）工具。它能够定义一个利于分析的业务模型，并通过在后台自主构建和维护临时数据结构，透明地加速针对该模型运行分析查询时的工作负载。

第五章 优化查询性能（二）

使用索引

索引通过维护常见请求数据的排序子集，提供了一种优化查询的机制。 确定哪些字段应该被索引需要一些思考:太少或错误的索引和关键查询将运行太慢; 太多的索引会降低插入和更新性能(因为必须设置或更新索引值)。

什么索引

要确定添加索引是否会提高查询性能，请从管理门户SQL接口运行查询，并在性能中注意全局引用的数量。 添加索引，然后重新运行查询，注意全局引用的数量。 一个有用的索引应该减少全局引用的数量。 可以通过在WHERE子句或ON子句条件前使用%NOINDEX关键字来防止使用索引。

应该为联接中指定的字段(属性)编制索引。左外部联接从左表开始，然后查看右表；因此，应该为右表中的字段建立索引。在下面的示例中，应该为T2.f2编制索引：

   FROM Table1 AS T1 LEFT OUTER JOIN Table2 AS T2 ON T1.f1 = T2.f2

内部联接应该在两个ON子句字段上都有索引。

执行“显示计划”，然后找到第一张map。 如果查询计划中的第一个项目是“Read master map”，或者查询计划调用的模块的第一个项目是“Read master map”，则查询的第一个映射是主映射，而不是索引映射。 因为主映射读取数据本身，而不是数据索引，这总是表明查询计划效率低下。