第五十九章 使用 ^PERFSAMPLE 监控进程 - 收集样本

本主题介绍 ^PERFSAMPLE 实用程序，这是一种用于分析 IRIS® 数据平台流程的工具。该实用程序处理实时系统上的活动，并呈现采样活动的易于导航的细分，这可以提供对系统的洞察力。例如，可以通过检查 ECP 请求来发现应用程序瓶颈，或者通过查看等待事件的类型来识别整个系统的瓶颈。

要开始，请从感兴趣的 IRIS 实例上的 %SYS 命名空间运行 ^PERFSAMPLE：

USER>set $namespace = "%SYS"

%SYS>do ^PERFSAMPLE

Collecting Samples

运行^PERFSAMPLE后，立即显示以下消息：

第五十二章 SQL函数 DEGREES

将弧度转换为角度的数值函数。

大纲

DEGREES(numeric-expression)

{fn DEGREES(numeric-expression)}

参数

• numeric-expression - 以弧度表示的角度的量度。解析为数值的表达式。

度返回NUMERIC或DOUBLE数据类型。如果NUMERIC-EXPRESSION的数据类型为DOUBLE，则度返回DOUBLE；否则返回NUMERIC。

度数可以指定为标准标量函数，也可以指定为使用大括号语法的ODBC标量函数。

描述

DEGREES以弧度为单位进行角度测量，并以度为单位返回相应的角度测量值。如果传递空值，度将返回空。

返回值的默认精度为36，默认小数位数为18。

InterSystems编程大奖赛取得圆满成功，来自中文社区的两位参赛者获得项目奖励，项目简介如下。

在这一系列文章中，我想向大家介绍并探讨使用 InterSystems 技术和 GitLab 进行软件开发可以采用的几种方式。 我将介绍以下主题：

• Git 101
• Git 流程（开发流程）
• GitLab 安装
• GitLab 工作流
• 持续交付
• GitLab 安装和配置
• GitLab CI/CD

在上一篇文章中，我们介绍了 Git 基础知识、深度理解 Git 概念对现代软件开发至关重要的原因，以及如何使用 Git 开发软件。 我们的侧重点仍是软件开发的实现部分，但本部分会介绍：

• GitLab 工作流 - 从想法到用户反馈的完整软件生命周期流程
• 持续交付 – 软件工程方式，团队通过这种方式在短周期内制作软件，从而确保软件可以随时实现可靠发布。 它的目的是更快速、更频繁地构建、测试和发布软件。

昨天，我在一个客户网站提供从 Studio 迁移到 VS Code 的定制咨询时，就遇到了这种情况。

该站点的服务器已配置为使用delegated authentication，但尚未针对 /api/atelier Web 应用程序设置“delegated”复选框，而 InterSystems ObjectScript 扩展包的成员正是使用该复选框进行连接的。

一旦我们的应用程序设置了其复选框并单击了服务器管理器刷新按钮，就可以在服务器上枚举命名空间。

Message Router的功能是什么？Message Router可以监视task schedule里面的定时执行任务吗？求帮助

REST是一种架构风格，而不是一种格式。尽管REST经常使用HTTP来传输消息，使用JSON来传递数据，但你也可以用XML或纯文本来传递数据。REST利用了现有的网络标准，如HTTP、URL、XML和JSON。

虽然它可以使用XML来描述数据，但它更常使用JSON，这是一个轻量级的数据封装器。

InterSystems REST服务

InterSystems REST服务由以下组件组成：

规范类（%REST.Spec的一个子类）：这个类包含了REST服务的OpenAPI 2.0规范（Swagger）。InterSystems支持几个扩展属性，你可以在规范中使用。

调度类（%CSP.REST的一个子类）：这个类负责接收HTTP请求并在实现类中调用合适的方法。

第十八章 添加时间戳和用户名令牌

本主题讨论时间戳和用户令牌。

概述

时间戳是 WS-Security 标头中的 <Timestamp> 安全元素。严格来说，时间戳不是安全元素。但是，可以使用它来避免重放攻击。时间戳对于自定义日志记录也很有用。

用户名令牌是 WS-Security 标头中的 <UsernameToken> 安全元素；它带有用户名。它还可以带有相应的密码（可选为摘要形式）。通常使用它进行身份验证，即允许 IRIS Web 客户端使用需要密码的 Web 服务。

注意：默认情况下，WS-Security 标头元素以明文形式发送。要保护 <UsernameToken> 中的密码，应该使用 SSL/TLS、加密 <UsernameToken>（如其他地方所述），或者使用这些技术的某种组合。

第四章 IRIS 编程简介 - Macros

Macros

ObjectScript 还支持定义替换的宏。定义可以是一个值、整行代码或（使用 ##continue 指令）多行。使用宏来确保一致性。例如：

#define StringMacro "Hello, World!"

write $$$StringMacro

Include Files

可以在例程中定义宏，并稍后在同一例程中使用它们。更常见的是，在中心位置定义它们。为此，需要创建并使用包含文件。包含文件定义宏并且可以包含其他包含文件。

第二十三章 使用系统监视器 - 通知规则

通知规则

如果一段时间内传感器的三个连续读数大于传感器最大阈值，Health Monitor 将生成警报（严重性 2 的通知），如果一段时间内传感器的五个连续读数大于传感器最大阈值，则健康监视器将生成警告（严重性 1 的通知）大于传感器警告阈值。最大值和警告阈值取决于传感器对象中的设置以及适用的图表是由 Health Monitor 生成还是由用户创建，如下表所示。

另请注意：
- 当传感器对象设置了最大值和警告值时，不需要图表，因此不会生成图表，即使禁用 Health Monitor 也会生成通知。
- 当传感器对象设置了最大乘数和警告乘数，或者只有基数时，需要图表；在分析模式下收集到足够的样本以生成图表之前，不会生成任何通知。
- 当存在用户创建的图表时，传感器对象设置是什么并不重要。

现在有一个需求。想将intersystems系统产生的alerts.log文件的内容保存到一个表中。有什么工具或者API 能自动格式化log文件到DB吗，还是需要手动解析log文件然后在存储到DB中。

第七章 SQL命令 CREATE INDEX（二）

UNIQUE关键字

使用UNIQUE关键字，可以指定索引中的每条记录都有一个唯一的值。
更具体地说，这确保了索引(以及包含索引的表)中的两条记录不能具有相同的排序值。
默认情况下，大多数索引使用大写字符串排序(使搜索不区分大小写)。
在本例中，值“Smith”和“SMITH”被认为是相等的，而不是唯一的。
CREATE INDEX不能指定非默认索引字符串排序规则。
通过在类定义中定义索引，可以为各个索引指定不同的字符串排序规则。

可以更改名称空间的默认排序规则，使字段/属性在默认情况下区分大小写。
更改此选项需要重新编译命名空间中的所有类并重新构建所有索引。
转到Management Portal，选择Classes选项，为存储的查询选择名称空间，并使用Compile选项重新编译相应的类。
然后重建所有指数。
它们将区分大小写。

注意:当表的数据被其他用户访问时，不要重建索引。
这样做可能会导致不准确的查询结果。

第五章 生成XML元素

生成XML元素

如果使用RootElement()启动文档的根元素，则负责生成该根元素内的每个元素。有三个选择：

将对象生成为元素

可以从InterSystems IRIS对象生成输出作为元素。在本例中，使用object()方法，该方法写入支持XML的对象。输出包括该对象中包含的所有对象引用。可以指定此元素的名称，也可以使用在对象中定义的默认值。

只能在RootElement()和EndRootElement()方法之间使用object()方法。

此示例为给定启用XML的类的所有已保存实例生成输出：