InterSystems Caché 是一个多模型 DBMS 和应用服务器。
查看此处提供的更多详细信息。
文档。
嗨，大家好
在本文中，我列出了 5 个有用的 SQL 函数，并附有解释和查询示例👇🏻
这5个功能是
- COALESCE合并
- RANK排序
- DENSE_RANK密集排序
- ROW_NUMBER行号
- SUM()获取运行总计的函数
那么让我们从 COALESCE 函数开始
示例：在Caché的代码中执行shell命令“free -m |grep -i mem”
方法一：使用%Net.Remote.Utility类中的RunCommandViaZF方法
Set tSC = ##class(%Net.Remote.Utility).RunCommandViaZF("free -m |grep -i mem",.tTempFileName,,,0)
set file=##class(%FileCharacterStream).%New()
s file.Filename=tTempFileName获得文件流后，再读取文件流中内容即可。
此方法本质是执行$ZF(-1)方法，由于$ZF(-1)在ENSEBLE2016.2后续的版本中不支持，导致后续版本可能会报错。
方法二：使用$ZF(-100)方法
# 第七十章 使用 REST API 监控 IRIS - 互操作性指标
除了上一节中描述的指标外， IRIS 实例还可以记录有关活动互操作性产品的指标，并将它们包含在 `/metrics` 端点的输出中。默认情况下禁用这些互操作性指标的记录。要启用它，必须为要监控的每个互操作性产品执行以下步骤：
1. 为运行要监控的生产的 `IRIS` 实例打开一个终端会话。如有必要，通过执行以下命令切换到与生产关联的命名空间：
```
set $namespace = "[interopNS]"
```
其中 `[interopNS]` 是命名空间名称。
2. 在终端中，执行以下命令以启用当前命名空间内活动生产的指标收集（`SAM` 指的是系统警报和监控， 监控解决方案）：
```
do ##class(Ens.Util.Statistics).EnableSAMForNamespace()
```
注意：如果为命名空间启用了指标记录但相应的生产未激活，则 `/metrics` 端点不会返回任何指标。
`Ens.Util.Statistics` 类提供了自定义 `/metrics` 端点输出的方法。例如，调用方法 `DisableSAMIncludeHostLabel` 将为整个生产提供聚合指标，而不是为每个主机单独提供它们。
完成此步骤后可用的指标在下面的基本互操作性指标表中进行了描述。
# 第六十九章 使用 REST API 监控 IRIS
每个 `IRIS®` 数据平台实例都包含一个提供实例统计信息的 `REST` 接口。 `REST API` 提供了一种从多台运行 `IRIS` 的机器收集信息的方法，使能够详细监控构成您的应用程序的所有实例。
本附录描述了 `/api/monitor` 服务提供的指标。这些指标与开源监控和警报工具 `Prometheus` 兼容。配置 `Prometheus` 以抓取多个连接的 `IRIS` 实例提供了整个系统的内聚视图，从而更容易评估系统是否正常有效地运行。
注意：有关创建和使用 REST 接口的介绍，请参阅第一眼：使用 产品开发 `Rest` 接口。
# /api/monitor Service
`/api/monitor` 服务提供有关运行它的 `IRIS` 实例的信息。默认情况下，`/api/monitor Web` 应用程序启用了“未经身份验证”的访问权限。有关为此服务设置身份验证的信息，请参阅创建 `REST` 服务中的保护 REST 服务一章。
此 API 具有以下两个端点：
- `/metrics Endpoint`,，它返回所有实例指标，并且可以配置为返回特定的应用程序指标。
- `/alerts Endpoint`，它返回自上次抓取端点以来发布的所有系统警报。
第六十八章 使用 Web 服务监控 IRIS - 监控网络客户端
SYS.WSMon.Client 类和相关类是一个 IRIS 网络服务客户端，可以在同一个 IRIS 实例或另一个 IRIS 实例中调用 SYS.WSMon.Server 网络服务的方法。
此 Web 客户端类使用以下 LOCATION 参数：
Parameter LOCATION = "http://server:port/csp/sys/SYS.WSMon.Service.cls"
其中，服务器是运行 IRIS 的服务器，端口是 IRIS Web 服务服务器使用的端口。
以与使用其他 IRIS 网络服务客户端相同的方式使用此网络客户端：
- 创建
Web客户端类的实例。 - 如果需要，设置其
Location属性。
如果要使用的 SYS.WSMon.Server Web 服务与客户端位于不同的计算机上，或者如果它使用 52773 以外的端口，则这是必需的。
- 如果需要，设置其他属性。
- 调用网络方法。
- 检查
web方法返回的值。
详细信息取决于调用的 Web 方法；请参阅“监视 Web 服务的 Web 方法”部分并查看返回类型的类参考。
下面显示了一个示例终端会话：
第六十七章 使用 Web 服务监控 IRIS - 监控 Web 服务的 URL
对于给定的 IRIS 实例，日志监控 Web 服务可从以下 URL 获得：
http://server:port/csp/sys/SYS.WSMon.Service.cls
其中，服务器是运行 IRIS 的服务器，端口是 IRIS Web 服务服务器使用的端口。例如：
http://localhost:52773/csp/sys/SYS.WSMon.Service.cls
同样，此 Web 服务的 WSDL 可从以下 URL 获得：
http://server:port/csp/sys/SYS.WSMon.Service.cls?WSDL=1
监控 Web 服务的 Web 方法
类中的 SYS.WSMon.Service提供以下 Web 方法：
EnumBuffer()
method EnumBuffer() as %XML.DataSet
在枚举所有缓冲区大小的统计信息中返回 %XML.DataSet的实例。对于此实例，数据集使用类中 SYS.Stats.Buffer的 Sample() 类查询。
EnumDatabase()
method EnumDatabase() as %XML.DataSet
第六十六章 使用 Web 服务监控 IRIS - IRIS 对 WS-Monitoring 的支持概述
本附录介绍并简要描述了如何使用 IRIS® 数据平台支持 WS-Management 规范，它使能够通过 SOAP 远程监控 IRIS 实例。
IRIS 对 WS-Monitoring 的支持概述
按照 WS-Management 规范，SYS.WSMon 包提供了一个 Web 服务，可以使用它来远程监控 IRIS 实例。它在功能上类似于 SNMP 接口（请参阅本指南的“使用 SNMP 监控 IRIS”附录），但使用内置的 IRIS 网络服务支持。
对 WS-Management 的支持包括以下元素：
- 提供返回有关
IRIS实例信息的方法的日志监控Web服务（SYS.WSMon.Service）。 - 一个
IRIS Web服务客户端（SYS.WSMon.Client），可以调用此监控Web服务或另一个IRIS实例的监控Web服务中的方法。
可以创建自己的 Web 客户端，而不是使用此 Web 客户端，可能使用第三方技术。
此 Web 服务和客户端使用几个启用 XML 的类来表示监视信息。
这些类包括 SYS.WSMon.wsEvent，它可以表示事件。
第六十五章 使用 SNMP 监控 IRIS - 用户定义的 SNMP 监视器类示例
本节介绍如何定义可通过 SNMP 查询的用户应用程序监视器类的示例。应用程序监视器仅包括 SNMP 数据中具有 %Monitor 数据类型的属性。
Example Sample Class
以下是此示例的示例类：
目的
这两个工具（RanRead 和 RanWrite）用于在数据库（或一对数据库）内生成随机读写事件，以测试每秒输入/输出的操作数 (IOPS)。它们可以一起使用或分开单独使用，以测试 IO 硬件容量、验证目标 IOPS 并确保系统拥有可接受的磁盘响应时间。从 IO 测试中收集的结果将因配置而异，具体取决于 IO 子系统。在运行这些测试之前，请确保相应的操作系统监控和存储级别监控已配置，这些捕获的 IO 性能指标可以为以后的分析提供帮助。我们推荐使用 IRIS 中捆绑的系统性能工具，例如^SystemPerformance。
请注意，这里使用的工具是对先前版本的更新。之前的版本可在这里找到。
第六十四章 使用 SNMP 监控 IRIS - 扩展 IRIS MIB
应用程序员可以添加托管对象定义并扩展 IRIS 子代理为其提供数据的 MIB。这不是一个完整的 MIB 编辑器或 SNMP 工具包；相反，它是一种添加简单应用程序指标的方法，可以通过 SNMP 浏览或查询这些指标。
注意：对象必须遵循基本的 IRIS SNMP 结构，对 SNMP 表结构的支持有限（仅支持整数值索引），并且不会创建 SNMP 陷阱（请参阅新选项卡类中的 %Monitor.AlertOpens） 对管理信息的 SNMP 结构有一个基本的了解是很有帮助的。
要创建这些对象，请执行以下操作：
- 在继承
%Monitor.Adaptor的类中创建IRIS对象定义。 - 执行
SNMP类方法以在SNMP中启用这些被管理对象，并创建MIB定义文件供管理应用程序使用。实现此目的的方法是MonitorTools.SNMP.CreateMIB()。
该方法为 %Monitor 数据库中定义的特定应用程序创建私有企业 MIB 树的一个分支。除了为应用程序创建实际的 MIB 文件之外，该方法还创建了 MIB 树的内部轮廓。 IRIS 子代理使用它来注册 MIB 子树，为 GETNEXT 请求遍历树，并引用特定对象方法以在 GET 请求中收集实例数据。
第六十三章 使用 SNMP 监控 IRIS - SNMP 故障排除
SNMP 故障排除
IRIS 子代理（运行 ^SNMP 例程）取决于操作系统提供的 SNMP 主代理的正确安装和配置。正如 IRIS 作为子代理中所述，^SNMP 例程与此主代理通信有两种主要方式：
^SNMP主要在TCP端口705上使用AgentX协议。- 在
Windows上，^SNMP使用安装为iscsnmp.dll的Windows扩展代理DLL。
操作系统应该提供配置 SNMP 代理的详细说明，系统管理员应该花一些时间来了解如何执行此操作。如果在使 IRIS 与 SNMP 代理通信时遇到问题，以下是一些基本的故障排除指南和提示。
所有系统
第六十二章 使用 SNMP 监控 IRIS
本附录描述了 IRIS 数据平台和 SNMP（简单网络管理协议）之间的接口。 SNMP 是一种通信协议，作为一种管理 TCP/IP 网络（包括单个网络设备和一般计算机设备）的方法已获得广泛接受。它的流行扩大了它作为许多企业管理工具的底层结构和协议的用途。这是它对 IRIS 的主要重要性：一种向各种管理工具提供管理和监控信息的标准方法。
SNMP 既是一种标准消息格式，也是管理对象的一组标准定义。它还提供用于添加自定义管理对象的标准结构，这是 IRIS 用来定义其管理信息以供其他应用程序使用的功能。
将 SNMP 与 IRIS 结合使用
SNMP 定义了客户端-服务器关系，其中客户端（网络管理应用程序）连接到在远程网络设备或计算机系统上执行的服务器程序（称为 SNMP 代理）。客户端请求并从该代理接收信息。有四种基本类型的 SNMP 消息：
GET– 获取特定托管对象的数据GETNEXT– 获取分层树中下一个管理对象的数据，允许系统管理员遍历设备的所有数据SET——为特定的管理对象设置值TRAP——被管理设备或系统发送的异步警报
第六十章 使用 ^PERFSAMPLE 监控进程 - 预定义分析示例
预定义分析示例
以下是从过程状态维度开始的分析示例。
在此示例中，^PERFSAMPLE 在 319994 个样本中找到了 76755 个处于可样本状态的进程样本（如果选择了忽略空闲的选项，则为非空闲）：
第五十九章 使用 ^PERFSAMPLE 监控进程 - 收集样本
本主题介绍 ^PERFSAMPLE 实用程序，这是一种用于分析 IRIS® 数据平台流程的工具。该实用程序处理实时系统上的活动，并呈现采样活动的易于导航的细分，这可以提供对系统的洞察力。例如，可以通过检查 ECP 请求来发现应用程序瓶颈，或者通过查看等待事件的类型来识别整个系统的瓶颈。
要开始，请从感兴趣的 IRIS 实例上的 %SYS 命名空间运行 ^PERFSAMPLE：
USER>set $namespace = "%SYS"
%SYS>do ^PERFSAMPLE
Collecting Samples
运行^PERFSAMPLE后，立即显示以下消息：
第五十八章 使用 ^BLKCOL 监视块冲突
当一个进程被迫等待访问一个块时，就会发生块冲突。过多的块冲突会降低应用程序性能。
Using ^BLKCOL
在 IRIS® 数据平台中，^BLKCOL 实用程序对指定时间段（默认为 10 秒）内的块碰撞进行采样，记录这段时间内指定时间间隔（默认为 10 毫秒）内的最新块碰撞。对于每个记录的冲突，^BLKCOL 不仅标识块，还标识涉及的全局及其在块中的第一个和最后一个引用，以及创建试图访问块的进程的例程和行。
注意：irisstat -D 选项，如本指南附录“使用 irisstat 实用程序监视 IRIS”中的使用选项运行 irisstat 中所述，也对块冲突进行采样，但仅识别涉及的块。
irisstat -D 的输出包含在 ^SystemPerformance 实用程序生成的报告中，如本指南的使用 ^SystemPerformance 监控性能一章所述。
运行 ^BLKCOL 时，可以指定以下内容：
第五十七章 历史监视器 - 汇总
汇总
Application Monitor 执行的 %Monitor.System.HistoryPerf 和 %Monitor.System.HistorySys 类也在每天结束时创建每小时和每天的摘要。摘要被定义为持久类 SYS.History.Hourly 和 SYS.History.Daily；它们包括所有四个基类作为嵌入对象。
对于每个度量属性，系统可以计算每小时和全天的平均值、最大值（高水位线）、标准差、最小值、中值或总数。对于每个基类（SYS.History.PerformanceO、SYS.History.WriteDaemon、SYS.History.SystemUsage 或 SYS.History .Database) 和每个汇总期间类，使用每个基类的 SetSummary() 方法。默认情况下，History Monitor 计算每小时和每日摘要的每个类的平均值、最大值和标准偏差。
注意：SYS.History.Performance 的计数器属性已标准化为这些计算的每秒速率（Total 除外）。
第五十六章 历史监视器
History Monitor 维护性能和系统使用指标的历史数据库。其主要目的是：
- 提供性能基准并帮助分析性能问题。
- 帮助分析一段时间内的系统使用情况以进行容量规划。
该数据库在 SYS.History 类包中定义并保存在 %SYS 命名空间中。数据库结构的所有细节都在那里发布，并且可以通过 SQL 或正常的持久对象访问访问数据。 SYS.History 中的类文档还包含对所有可用的单个属性、方法和查询的描述。
数据通常分为性能（请参阅 SYS.History.Performance）和系统使用情况（请参阅 SYS.History.SystemUsage）数据。性能指标旨在以较短的时间间隔（默认情况下为 30 秒）进行采样，系统使用数据以较长的时间间隔（默认情况下为 5 分钟）进行采样。在每天开始时，将各个时间间隔样本作为平均值、最大值、最小值、标准偏差、中值和总计汇总到每小时和每天的表格中。可以选择为每个度量类保留哪些汇总函数（如果有）。间隔和每小时数据可能会在定义的天数（默认分别为七 (7) 天和 60 天）后自动清除；每日摘要用于长期分析，可以手动清除。
基本指标
第五十五章 使用 ^mgstat 监控性能 - Seizes、ASeizes 和 NSeizes
第五十四章 使用 ^mgstat 监控性能
本章介绍 ^mgstat 实用程序，它是一种用于收集基本性能数据的工具。
注意：此实用程序可能会在不同版本之间更新。 ftp://ftp.intersys.com/pub/performance/下载 newmgstat.xml 的信息。
必须从 %SYS 命名空间调用 ^mgstat，并且可以使用以下位置参数：
第五十三章 使用 ^SystemPerformance 监视性能 - InterSystems IRIS Linux 平台性能数据报告
第五十二章 使用 ^SystemPerformance 监视性能 - IBM AIX® 平台的 InterSystems IRIS 性能数据报告
在上一篇文章中，我们看到了最常用的HL7消息类型之一--ADT（入院、出院、转院）的结构，以及ADT^A04的例子和它所有字段的描述。现在让我们来看看另一个数据流，它与测试订单的订购和履行有关。我说的是ORM（从2.5版本开始，你应该使用特定的消息来订购测试，如OMG、OML、OMD、OMS、OMN、OMI和OMP），ORL和ORU消息。在一个非常简化的情况下，数据的交换可能看起来像这样。
让我们更详细地看一下这些消息。
第五十章 使用 ^SystemPerformance 监视性能 - Microsoft Windows 平台的 InterSystems IRIS 性能数据报告
Microsoft Windows 平台的 IRIS 性能数据报告
第四十九章 使用 ^SystemPerformance 监视性能 - 复制配置文件
复制配置文件
可以使用以下 API 命令将现有配置文件复制到具有不同名称的文件：
set rc=$$copyprofile^SystemPerformance("sourceprofilename","targetprofilename")
必须指定：
sourceprofilename- 现有配置文件的名称targetprofilename- 要创建的配置文件的名称。这必须用双引号引起来。
如果成功，该函数返回 1。如果不成功，它返回一个 0 后跟一个 carat 和任何错误的原因。
其中 sourceprofilename 是现有配置文件的名称，targetprofilename 必须是唯一的并且不能包含空格或空白字符。
例如，要复制 2minrun 配置文件，请输入以下内容：
set rc=$$copyprofile^SystemPerformance("2minrun","5minrun")
下次运行 ^SystemPerformance 实用程序时，配置文件列表包括以下配置文件名称和说明：
2minrun A 2-minute run sampling every 30 seconds
5minrun A 2-minute run sampling every 30 seconds
第四十五章 使用 ^SystemPerformance 监视性能 - Abort ^SystemPerformance
Abort ^SystemPerformance
如果要停止正在运行的配置文件，可以中止数据收集，并可选择使用 $$Stop^SystemPerformance(runid) 命令删除配置文件的所有 .log 文件。例如，要中止由 runid20111220_1327_12hours 标识的报告的数据收集并删除到目前为止写入的所有 .log 文件，请在终端的 %SYS 命名空间中输入以下命令：
do Stop^SystemPerformance("20111220_1327_12hours")
要在不删除日志文件的情况下停止作业并从这些日志文件生成 HTML 性能报告，请输入：
do Stop^SystemPerformance("20111220_1327_12hours",0)
有关此命令的更多信息，请参阅以编程方式运行 ^SystemPerformance 小节中的 $$Stop^SystemPerformance("runid")。
注意：必须有权停止jobs和删除文件。
以编程方式运行 ^SystemPerformance。
可以使用启动、收集、预览和停止功能的入口点以编程方式运行 ^SystemPerformance 实用程序，如下表所述：
我很高兴地宣布 ObjectScript 包管理器 ZPM 的生命周期中的一个里程碑。包管理器使开发人员能够以一种方便的方式巧妙地打包 ObjectScript 代码和部署配置设置以及版本信息。在过去的几年里，它已经发展成为许多开发工作流程中不可或缺的一部分。
事实证明，InterSystems 决定使用它来打包我们自己的组件非常重要，这促使我们决定将 GitHub 存储库从社区移至我们的公司存储库，并将其重命名为InterSystems Package Manager (IPM) 。 IPM 仍将是开源的。社区成员将能够审查代码并提交拉取请求。但这种变化使我们能够以非员工能够直接对代码库进行更改的方式确保软件的安全性。更高级别的安全性和信任对于可以将代码与您的数据一起安装的软件来说至关重要。
所以请和我一起庆祝 ZPM 的生命，欢迎 IPM 的诞生，并感谢贡献者——尤其是 Nikolay Soloviev 和@Dmitry Maslennikov，他们再次展示了对开发人员需求的惊人洞察力，以及技能和奉献精神构建出色的软件！
---
第四十一章 使用^%SYS.MONLBL检查例程性能 - 逐行监控报告示例
本节包含 ^%SYS.MONLBL 例程生成的各种报告的示例：
Line-by-line Detail Report
Line-by-line Summary Report
Line-by-line Delimited Output Report
Line-by-line Procedure Level Report
Line-by-line Detail Report
以下是报告所选期刊实用程序的最小指标详细信息的示例，包括覆盖率分析。报告被发送到 monlbl_JRN_dtl.txt 文件，其中显示了一部分。
我们刚刚发布了包管理器的一个小更新，如我们11 月宣布，我们已经将 ZPM 重命名为 IPM。现在这个是一个错误修复版本，正确解释 ROBOCOPY 返回代码并修复阻止安装某些包的回归。
在这里获取：
是否存在返回Global行数量的命令？
例如：
^test(1)="aa"
^test(2)="aa"
^test(3)="aa"
^test(4)="aa"
总行数 = 4