第二十六章 使用任务管理器（四）
导入任务
导入任务页面（系统操作 > 任务管理器 > 导入任务）允许通过浏览到先前导出的任务文件，然后单击立即执行操作来导入和运行任务。
注意：任务只能从运行相同版本的 IRIS 的实例导入或导出。
使用 ^TASKMGR
^TASKMGR 例程允许使用终端配置任务管理器。除非另有说明，^TASKMGR 和管理门户包含用于配置任务的相同选。
- 打开终端。
- 输入
set $namespace = "%SYS" 以更改为 %SYS 命名空间。
- 输入
do ^TASKMGR。
具体类 %SYS.Task
InterSystems IRIS 程序员可以在这里学习、分享、了解最新动态、成长，以及收获快乐！
第十七章 源代码文件 REST API 教程（二）
获取在命名空间中定义的源代码文件
要获取有关命名空间中源代码文件的信息：
- 首先，使用 GetDocNames 方法获取文件的名称。
- 然后用GetDoc 方法获取一个文件的内容，也可以用GetDocs 方法获取多个文件的内容。
- 如果要提高应用程序的网络效率，可以保留源代码文件的名称和内容的本地缓存，并使用 GetModifiedDocNames 方法仅获取内容发生变化的源代码文件的名称或使用带有 If-None-Match HTTP 标头的 GetDoc 方法。
GetDocNames 方法返回映射到命名空间的所有数据库中的所有源代码文件的名称。
[toc]
第108章 SQL函数 %PLUS
将数字转换为规范排序格式的排序函数。
大纲
%PLUS(expression)
%PLUS expression
参数
expression - 表达式，它可以是列的名称、数字或字符串字面值、算术表达式或另一个函数的结果，其中基础数据类型可以表示为任何字符类型。
描述
%PLUS将数字或数字字符串转换为规范形式，然后以数字排序顺序返回这些表达式值。
数字可以包含前导和后导零、多个前导加减号、单个小数点指示符(.)和E指数指示符。
在标准形式中，将执行所有算术运算，展开指数，将符号解析为一个前导减号或无符号，并剥离前导和后导零。
第七十章 SQL函数 $JUSTIFY
在指定宽度内右对齐值的函数，可以选择舍入到指定的小数位数。
大纲
$JUSTIFY(expression,width[,decimal])
参数
expression - 要右对齐的值。它可以是数字值、字符串文字或解析为数字或字符串的表达式。width - 表达式要在其中右对齐的字符数。正整数或计算结果为正整数的表达式。decimal - 可选-小数位数。正整数或计算结果为正整数的表达式。将表达式中的小数位数四舍五入或填充到此值。如果指定DECIMAL，会将表达式视为数字。
描述
$JUSTIFY返回在指定宽度内右对齐的表达式指定的值。可以包括小数参数以在宽度内小数对齐数字。
第四十八章 SQL函数 DAYOFMONTH
返回日期表达式的月份日期的日期函数。
大纲
{fn DAYOFMONTH(date-expression)}
参数
date-expression - 要从中返回月值日期的日期或时间戳表达式。作为列名、另一个标量函数的结果或日期或时间戳文字的表达式。
描述
DAYOFMONTH以1到31之间的整数形式返回每月的第几天。日期表达式可以是日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式的日期字符串或时间戳。
日期表达式时间戳可以是数据类型%Library.PosiTime(编码的64位有符号整数)或数据类型%Library.TimeStamp(yyyy-mm-dd hh：mm：ss.fff)。
第五章 SQL命令 BUILD INDEX
用数据填充一个或多个索引。
大纲
BUILD INDEX [%NOLOCK] [%NOJOURN] FOR TABLE table-name [INDEX index-name [,index-name]]
BUILD INDEX [%NOLOCK] [%NOJOURN] FOR SCHEMA schema-name
BUILD INDEX [%NOLOCK] [%NOJOURN] FOR ALL
参数
FOR TABLE table-name - 已存在表的名称。
表名可以是限定的(schema.table)，也可以是非限定的(table)。
非限定表名接受默认模式名。
🚨 计划维护公告 🚨
由于计划中的维护，开发者社区网站可能会在2025年1月20日（星期一）期间出现短暂的停机现象。
对于由此可能带来的不便，我们深表歉意，并感谢您的理解。感谢您耐心等待，我们将努力提升我们的平台！
InterSystems 团队本周末将前往麻省理工学院最大的黑客马拉松，届时我们将为黑客们带来一项技术挑战。
我们为黑客们提供在他们的项目中使用 IntegratedML 或 InterSystems Supply Chain Orchestrator 的机会，以便争夺一些非常酷的奖品！
如果您在波士顿并且有兴趣成为活动中的 InterSystems 导师，请给我们写信。
第十八章 ObjectScript - 使用例程
例程
可以将例程视为 ObjectScript 程序。例程可以从头开始编写，也可以在编译类时自动生成。
Procedures, Functions, and Subroutines 过程、函数和子程序
在 ObjectScript 例程中，标签定义以下代码单元之一的起点：
Procedures过程（可选地返回一个值）。过程中定义的变量是该过程私有的，这意味着它们不可用于其他代码。对于函数和子例程来说，情况并非如此。
过程也称为过程块。
建议使用过程Procedures，因为这可以简化控制变量范围的任务。然而，在现有代码中，可能还会看到函数和子例程，并且能够识别它们非常有用。以下列表显示了所有这些形式的代码的外观。
第七章 准备创建Productions - 使用 Productions 的路线图
以下部分概述了可能希望从中着手的文档资源，具体取决于角色。
IRIS 生产开发人员
如果是准备使用 IRIS 产品的开发人员，请参阅以下资源：
-
Introducing Interoperability Productions 概述了 IRIS 互操作性和可能希望包含在productions中的选项，并提供了指向更详细信息的指针。
-
创建作品的最佳实践描述了设计、开发和维护作品的最佳实践。
Developing Productions，反过来，它会向指出应用程序开发集中的特定主题：创建Productions和其他指南。- 配置
Productions描述了在作品中配置项目的详细信息。
IRIS 管理员
如果是准备使用产品的管理员，请参阅以下资源：
第五十四章 镜像中断程序
由于计划维护或计划外问题，镜像中一个或两个故障转移成员上的 IRIS 实例可能变得不可用。当故障转移成员的 IRIS 实例不可用时，其 ISCAgent 可能继续可用（如果主机系统仍在运行），也可能不可用（如主机系统关闭时）。本节提供了处理各种计划内和计划外中断场景的过程，这些场景涉及实例中断或一个或两个故障转移成员的全部中断。
如自动故障转移机制中所述，从主要故障转移成员到备份故障转移成员的安全和成功故障转移有两个要求：
- 确认主实例确实已关闭，并且没有被临时网络问题隔离。
- 确认备份具有来自主数据库的最新日志数据，因为它在主数据库发生故障时处于活动状态（请参阅镜像同步）或因为它已被手动捕获（请参阅主数据库的计划外中断而没有自动故障转移）。
在阅读和使用本材料时，可能需要参考自动故障转移规则来查看管理自动故障转移的规则。
有关使用镜像监视器确定备份故障转移成员是否处于活动状态或 DR 异步是否被赶上的信息，请参阅镜像成员日志传输和取消日志状态和监控镜像。
# 第十一章 配置数据库（三）
## 编辑本地数据库的属性
显示的信息取决于数据库是否被镜像。本节确定以下字段：
### 部分编辑非镜像本地数据库属性
单击非镜像数据库的名称可查看以下数据库属性并更改其中一些属性。 （“创建本地数据库”部分描述了其中的许多字段。）
第十章 发现和记录 REST API
本章讨论如何发现实例上可用的 REST 服务以及如何为 REST 服务生成文档。
使用 /api/mgmnt 服务发现 REST 服务
/api/mgmnt 服务包括可用于发现 REST 服务类和启用 REST 的 Web 应用程序的调用。
发现 REST 服务
要使用 /api/mgmnt 服务来发现实例上可用的 REST 服务，请使用以下 REST 调用：
第三章 数据类型（二）
SQL 系统数据类型映射
上表中为 DDL 和 IRIS 数据类型表达式显示的语法是为 SQL.SystemDataTypes 配置的默认映射。对于提供的系统数据类型和用户数据类型，有单独的映射表可用。
要查看和修改当前数据类型映射，请转到管理门户，选择系统管理、配置、SQL 和对象设置、系统 DDL 映射。
了解 DDL 数据类型映射
将数据类型从 DDL 映射到 IRIS 时，常规参数和函数参数遵循以下规则：
- 常规参数 - 这些在 DDL 数据类型和 IRIS 数据类型中以
%# 格式标识。例如：
VARCHAR(%1)
映射到：
%String(MAXLEN=%1)
因此，DDL 数据类型为：
VARCHAR(10)
映射到：
[toc]
第151章 SQL函数 %TRUNCATE
将字符串截断为指定长度并应用 EXACT 排序规则的排序规则函数。
大纲
%TRUNCATE(expression[,length])
参数
expression - 字符串表达式，可以是列名、字符串文字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR2）。表达式可以是子查询。length - 可选 — 截断长度，指定为整数。返回表达式的初始长度字符。如果省略长度，则 %TRUNCATE 排序规则与 %EXACT 排序规则相同。可以用双括号将长度括起来以抑制文字替换：((length))。
描述
%TRUNCATE 将表达式截断为指定的长度，然后在 EXACT 排序规则序列中返回它。
第八十六章 SQL命令 USE DATABASE
设置当前名称空间和数据库。
大纲
USE [DATABASE] dbname
参数
dbname - 当前进程将使用的名称空间和相应的数据库作为当前名称空间。
描述
USE DATABASE命令将当前进程切换到指定的名称空间及其关联的数据库。
这允许在SQL中更改名称空间。
DATABASE关键字是可选的。
指定的dbname是所需的命名空间和包含数据库文件的对应目录的名称。
指定dbname作为标识符。
命名空间名称不区分大小写。
由于USER是SQL保留字，因此必须使用分隔标识符来指定用户命名空间，如下面的SQL Shell示例所示：
第七十二章 SQL命令 SELECT（四）
WHERE子句
WHERE子句限定或取消查询选择中的特定行。
符合条件的行是那些条件表达式为真的行。
条件表达式是逻辑测试(谓词)的列表，可以通过AND和OR逻辑操作符链接这些测试(谓词)。
这些谓词可以使用NOT一元逻辑操作符进行反转。
SQL谓词可分为以下几类:
- Comparison 谓词
- BETWEEN 谓词
- LIKE 谓词
- NULL 谓词
- IN and %INLIST 谓词
- EXISTS 谓词
- FOR SOME 谓词
- FOR SOME %ELEMENT 谓词
第一章 单元测试概述
本教程的第一部分概述了单元测试。完成本教程的这一部分后，将能够：
- 定义单元测试并区分单元测试和集成测试
- 列出单元测试的几个好处
- 描述InterSystems IRIS %UnitTest包和xUnit测试框架之间的相似性。
- 列出软件开发中测试优先方法经常声称的几个好处。
什么是单元测试?
单元测试是对单个代码模块的正确性的测试，例如，方法或类的测试。通常，开发人员在开发代码时为其代码创建单元测试。典型的单元测试是一种执行方法的方法，该方法测试并验证该方法是否为给定的一组输入生成了正确的输出。
单元测试不同于集成测试。集成测试验证了一组代码模块交互的正确性。单元测试仅单独验证代码模块的正确性。一组代码模块的集成测试可能会失败，即使每个模块都通过了单元测试。
为什么要进行单元测试？
单元测试提供了许多好处，包括：
第二十二章 Caché 变量大全 $X 变量
包含光标的当前水平位置。
大纲
$X
描述
$X包含光标的当前水平位置。将字符写入设备时，Caché会更新$X以反映水平光标位置。
输出的每个可打印字符将$X加1。回车符(ASCII 13)或换页符(ASCII 12)将$X重置为0(零)。
$X是16位无符号整数。
第六十八章 打印机 - 在 UNIX® 上指定打印机
要在 UNIX 设备名称为 /dev/tty06 的终端上打开 I/O 设备，请输入以下命令
OPEN "/dev/tty06"
在 UNIX 系统上，打印机由 OPEN 命令上的名称标识，并在 tty 设备上作为“字符特殊”文件处理。因此，支持的 OPEN 和 USE 命令参数与终端 I/O 相同， 而不是顺序文件 I/O 的参数。
在 UNIX 上，OPEN 支持大多数终端 I/O 关键字参数，如终端 I/O 中所述。
演示程序
使用向量搜索在 IRIS for Health 上运行的病人相似性比较演示。
使用向量搜索计算相似度，在向量基础上比较不同病人之间的个人属性，如姓名、出生日期、地址等。得分越高，被比较的病人越有可能是同一个人。
本演示程序使用 sentence-transformers model 将文本转换为向量，然后使用 IRIS 向量函数来存储、读取和比较向量。
流程原理
第四十九章 开发Productions - ObjectScript Productions - 使用复杂记录映射器 - 复杂的记录映射类结构
复杂的记录映射类结构
有两个类以类似于描述记录映射的两个类的方式描述复杂的记录映射。描述复杂记录映射的两个类是：
- 复杂记录映射，描述复杂记录的外部结构并实现复杂记录解析器和编写器。
- 生成的复杂记录类定义了包含数据的对象的结构。该对象允许在数据转换和路由规则条件中引用数据。
一个复杂的记录映射业务服务读取并解析传入的数据并创建一条消息，该消息是生成的记录类的一个实例。业务流程可以读取、修改或生成生成的复杂记录类的实例。最后，复杂记录映射业务操作使用实例中的数据，使用复杂记录映射作为格式化模板写入输出数据。复杂记录映射类和生成的复杂记录类都具有描述数据的层次结构。复杂记录映射类和生成的复杂记录类具有并行结构。这与 RecordMap 类不同，其中生成的记录类可以具有不同的层次结构。
第二十五章 使用任务管理器（三）
任务计划
任务计划页面（系统操作 > 任务管理器 > 任务计划）列出了所有计划任务。可以通过单击任何列标题对表中的信息进行排序。可以通过单击适当的选项查看详细信息或历史记录以及运行计划任务：
- 任务名称 — 让查看有关任务的详细信息并对其执行操作。
- 历史 — 显示任务的历史。
- 运行 — 让运行任务。运行任务向导显示任务名称和
ID，以及任务运行的日期和时间；单击立即执行操作以确认信息并安排任务。
任务详情
要显示有关计划任务的详细信息并对其执行多项操作之一，请单击任务名称列中的任务名称。任务详细信息页面显示有关所选任务的信息和执行详细信息。可以通过单击相应的按钮对任务执行以下操作之一：
第七章 操作位和位串（三）
操作位串
要创建新的位串，请使用 $bit 函数将所需位设置为 1：
kill bitstring
set $bit(bitstring, 3) = 1
set $bit(bitstring, 6) = 1
set $bit(bitstring, 11) = 1
使用 $bit 将现有位串中的位设置为 1：
set $bit(bitstring, 5) = 1
使用 $bit 将现有位串中的位设置为 0：
set $bit(bitstring, 5) = 0
由于位串中的第一位是位 1，因此尝试设置位 0 会返回错误：
第118章 SQL函数 REVERSE
标量字符串函数，它以相反的字符顺序返回一个字符串。
大纲
REVERSE(string-expression)
参数
string-expression - 要反转的字符串表达式。表达式可以是列名、字符串文字、数字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。
描述
REVERSE 返回字符顺序颠倒的字符串表达式。例如 'Hello World!' 返回为 '!dlroW olleH'。这是一个简单的字符串顺序反转，没有额外的处理。
返回的字符串是数据类型 VARCHAR，与输入值的数据类型无关。数字转换为规范形式，数字字符串在反转之前不会转换为规范形式。
前导和尾随空白不受反转的影响。
反转 NULL 值会导致 NULL。
如果想快速查看锁表空间的使用情况，可以通过GetLockSpaceInfo()方法来获得。
%SYS>w ##class(SYS.Lock).GetLockSpaceInfo()
4717392,4712512,1200
返回值是 "AvailableSpace,UsableSpace,UsedSpace"，每个值的单位都是Byte。
AvailableSpace：锁表的总空间减去已用空间的大小（UsedSpace）。
UsableSpace：预估的可用空间。AvailableSpace里有一些空间是系统内部保留的，所以UsableSpace比AvailableSpace要小。UsableSpace是用户在锁表中可用的自由空间的数量。
UsedSpace：已经使用的空间。
全部时间
Open Exchange app