文章
· 二月 21, 2021 阅读大约需 7 分钟
第四十三章 Caché 变量大全 $ZTIMEZONE 变量

第四十三章 Caché 变量大全 $ZTIMEZONE 变量

包含格林威治子午线的时区偏移量。

大纲

$ZTIMEZONE
$ZTZ

描述

$ZTIMEZONE可以通过两种方式使用：

  • 返回计算机的本地时区偏移量。
  • 为当前进程设置本地时区偏移量。

$ZTIMEZONE包含从格林威治子午线偏移的时区（以分钟为单位）。 （格林威治子午线包括整个英国和爱尔兰。）此偏移量表示为-1440到1440范围内的有符号整数。格林威治以西的时区指定为正数；格林威治东部的时区指定为负数。 （时区必须以分钟为单位，因为并非所有时区都以小时为单位。）默认情况下，$ZTIMEZONE初始化为计算机操作系统设置的时区。

0 0
0 74
文章
· 四月 3, 2022 阅读大约需 3 分钟
第101章 SQL函数 NVL

第101章 SQL函数 NVL

测试 NULL 并返回适当表达式的函数。

大纲

NVL(check-expression,replace-expression)

参数

  • check-expression - 要计算的表达式。
  • replace-expression - 如果 check-expression 为 NULL，则返回的表达式。

NVL 返回与检查表达式相同的数据类型。

0 0
0 73
文章
· 四月 12, 2022 阅读大约需 2 分钟
第110章 SQL函数 POWER

第110章 SQL函数 POWER

一个数值函数，它返回给定表达式的指定幂的值。

大纲

POWER(numeric-expression,power)

{fn POWER(numeric-expression,power)}

参数

  • numeric-expression - 基数。可以是正整数或负整数或小数。
  • power - 指数，它是数值表达式的幂。可以是正整数或负整数或小数。

POWER 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 POWER 返回 DOUBLE；否则，它返回 NUMERIC。

0 0
0 73
文章
· 二月 10, 2021 阅读大约需 1 分钟
第三十章 Caché 变量大全 $ZHOROLOG 变量

第三十章 Caché 变量大全 $ZHOROLOG 变量

包含自Caché启动以来经过的秒数。

大纲

$ZHOROLOG
$ZH

描述

$ZHOROLOG包含自最近的Caché启动以来经过的秒数。这是一个计数，与时钟变化和日期范围无关。该值表示为浮点数，表示秒和秒的分数。小数位数与平台有关。 $ZHOROLOG在此小数部分截断尾随零。

不能使用SET命令修改此特殊变量。尝试这样做会导致<SYNTAX>错误。

注意：由于Windows操作系统的限制，使Windows系统进入休眠或待机模式可能会导致$ZHOROLOG返回不可预测的值。此问题不会影响$HOROLOG或$ZTIMESTAMP值。

示例

本示例输出当前的$ZHOROLOG值。

0 0
0 73

在这篇文章中，我们将使用docker和 参数配置文件模版 这一新特性来运行IRIS集群且轻松配置好。

在 UNIX® 和 Linux 上，您可以使用声明式参数配置合并文件来修改默认的 iris.cpf。合并文件是一个部分 CPF，在实例启动时为任何数量的参数设置所需的值。CPF 合并操作对每个实例只起一次作用。

我们的集群架构非常简单，它将由一个主节点（Node1）和两个数据节点（检查所有可用角色）组成。不幸的是，docker-compose不能部署到几个服务器上（尽管它可以部署到远程主机上），所以这对本地开发分片的数据模型、测试等很有用。如果是生产的InterSystems IRIS集群部署，你应该使用ICM云管理器或IKO K8S调度器。

Open Exchange app
0 0
0 73
文章
· 十月 12, 2022 阅读大约需 3 分钟
第十四章 CSP 中的 HTTP 请求 - CSP.Page 类

第十四章 CSP 中的 HTTP 请求 - CSP.Page 类

在 CSP 服务器上，所有 HTTP 请求都通过调用由类中的 %CSP.Page 定义的方法来处理。类中的 %CSP.Page 从不直接处理请求本身；它只是定义了处理 HTTP 请求所需的接口。实际的事件处理的 %CSP.Page 的子类完成（手动创建或作为处理 CSP 源文件的结果）。

%CSP.Page 的子类永远不会被实例化；也就是说，不会在对象中创建 %CSP.Page。 %CSP.Page 定义的方法都是类方法，不需要对象即可调用。正如我们将看到的，这些方法所需的任何状态信息都由 CSP 服务器管理的其他对象（例如%CSP.Request 和对象中的 %CSP.Session）提供。

2 0
0 73
文章
· 五月 9, 2021 阅读大约需 6 分钟
第四章 多维存储的SQL和对象使用（一）

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

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

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

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

数据

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

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

0 0
0 73
文章
· 七月 28, 2022 阅读大约需 4 分钟
第十章 发现和记录 REST API

第十章 发现和记录 REST API

本章讨论如何发现实例上可用的 REST 服务以及如何为 REST 服务生成文档。

使用 /api/mgmnt 服务发现 REST 服务

/api/mgmnt 服务包括可用于发现 REST 服务类和启用 REST 的 Web 应用程序的调用。

发现 REST 服务

要使用 /api/mgmnt 服务来发现实例上可用的 REST 服务，请使用以下 REST 调用：

0 0
0 73
文章
· 九月 2, 2022 阅读大约需 3 分钟
第二十章 控制进程（一）

第二十章 控制进程（一）

IRIS 系统运行多个进程。应用程序代码以及 IRIS 系统代码在这些进程中执行。 IRIS 进程分为三类：
- 用户进程，在用户连接到 IRIS 时创建。
- 后台进程，在用户发出 ObjectScript Job命令时创建，或者由管理门户或实用程序创建。
- IRIS 系统进程。

在本文中，“进程”一词本身指的是用户进程和后台进程。

可以使用管理门户管理和控制进程：

0 0
0 73
文章
· 十一月 10, 2021 阅读大约需 6 分钟
第七十二章 SQL命令 SELECT（四）

第七十二章 SQL命令 SELECT（四）

WHERE子句

WHERE子句限定或取消查询选择中的特定行。
符合条件的行是那些条件表达式为真的行。
条件表达式是逻辑测试(谓词)的列表，可以通过AND和OR逻辑操作符链接这些测试(谓词)。
这些谓词可以使用NOT一元逻辑操作符进行反转。

SQL谓词可分为以下几类:
- Comparison 谓词
- BETWEEN 谓词
- LIKE 谓词
- NULL 谓词
- IN and %INLIST 谓词
- EXISTS 谓词
- FOR SOME 谓词
- FOR SOME %ELEMENT 谓词

0 0
0 73
文章
· 八月 12, 2021 阅读大约需 3 分钟
属性关键字Aliases，Calculated，Cardinality，ClientName

第九十三章 属性关键字 - Aliases

指定此属性的其他名称，以便通过对象访问使用。

用法

要为属性指定其他名称，请使用以下语法:

Property name As classname [ Aliases=othernames ];

其中othernames是用逗号分隔的有效属性名列表，用大括号括起来。

详解

如果指定别名关键字，编译器会创建一个或多个给定的别名，这些别名指向原始属性所指向的同一基础数据。例如，重新定义Sample.Person的Name属性，如下所示：

Property Name As %String(POPSPEC = "Name()") [ Aliases = {Alternate}, Required ];

然后，代码可以使用Name属性或等效的Alternate属性，如以下终端会话所示：

0 0
0 73
文章
· 五月 15, 2021 阅读大约需 4 分钟
第一章 单元测试概述

第一章 单元测试概述

本教程的第一部分概述了单元测试。完成本教程的这一部分后，将能够：
- 定义单元测试并区分单元测试和集成测试
- 列出单元测试的几个好处
- 描述InterSystems IRIS %UnitTest包和xUnit测试框架之间的相似性。
- 列出软件开发中测试优先方法经常声称的几个好处。

什么是单元测试?

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

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

为什么要进行单元测试？

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

0 0
0 73
文章
· 二月 15, 2022 阅读大约需 3 分钟
第五十五章 SQL函数 %EXTERNAL

第五十五章 SQL函数 %EXTERNAL

以显示格式返回表达式的格式转换函数。

大纲

%EXTERNAL(expression)

%EXTERNAL expression

参数

  • expression - 要转换的表达式。字段名、包含字段名的表达式或返回值为可转换数据类型(如DATE或%LIST)的函数。不能是流字段。

描述

%EXTERNAL将表达式转换为显示格式，与当前选择模式(显示模式)无关。显示格式表示VARCHAR数据类型的数据，无论字段或数据类型LogicalToDisplay方法执行什么数据转换。

%EXTERNAL通常用于选择列表SELECT-ITEM。它可以在WHERE子句中使用，但不建议这样使用，因为使用%EXTERNAL会阻止在指定字段上使用索引。

0 0
0 72
文章
· 十月 10, 2022 阅读大约需 3 分钟
第十二章 CSP 中的 HTTP 请求 - CSP 运行时环境

第十二章 CSP 中的 HTTP 请求 - CSP 运行时环境

CSP 的主要任务是提供动态内容以响应传入的 HTTP（超文本传输协议）请求。本节介绍 CSP 如何处理 HTTP 请求的基础知识。

HTTP 是一种简单的协议，其中客户端向服务器发出请求。 HTTP 是一种无状态协议；客户端和服务器之间的连接只持续为服务请求所需的时间。每个 HTTP 请求都包含一个请求标头，该标头指定请求类型（例如 GET 或 POST）、一个 URL 和一个版本号。请求还可能包含附加信息。 CSP 自动确定它应该处理哪些 HTTP 请求，将它们分派到运行在 Caché 服务器上的适当类，并将请求信息打包成易于使用的对象（例如对象中的 %CSP.Request）。

1 0
0 72
文章
· 十月 20, 2022 阅读大约需 5 分钟
在集成产品中压缩解压文件

在InterSystems IRIS医疗版里有一个文件压缩解压的适配器HS.Util.Zip.Adapter和对应的文件压缩解压业务操作HS.Util.Zip.Operations。集成产品可以使用它们进行文件的压缩和解压操作。这2个类的联机文档说明较少，这里介绍它们的使用方法。

1. 基础配置

InterSystems IRIS使用操作系统的压缩和解压缩能力，因此需要注册操作系统执行压缩解压的命令。

在管理门户的Health标签页下，选中配置注册（Configuration Registry）：

在其中增加2个注册项目：

\ZipUtility\UnZipCommand 和\ZipUtility\ZipCommand，分别代表解压和压缩命令。适配器HS.Util.Zip.Adapter会检查这2个注册项并得到相应的命令。各个操作系统的命令并不一样，示例如下：

3 0
1 72

第五十一章 开发Productions - ObjectScript Productions - 不常见的任务

定义自定义实用函数

IRIS提供了一组可以从业务规则和DTL中调用的实用函数；这些在开发业务规则的Productions中使用的效用函数中有所描述。可以添加自己的功能，业务规则引擎和业务规则编辑器会自动适应您的扩展。

要添加新的效用函数:

0 0
0 72
文章
· 五月 8, 2021 阅读大约需 7 分钟
第三章 使用多维存储(全局变量)（四）

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

管理事务

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

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

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

0 0
0 72
文章
· 八月 23, 2022 阅读大约需 3 分钟
第十章 配置数据库（二）

第十章 配置数据库（二）

本地数据库

“本地数据库”页面显示关于系统上的数据库的以下信息:

  • Name—数据库名称。
  • Mirror——如果数据库是镜像的，则镜像的名称;
  • Directory - IRIS.DAT 文件的位置。
  • Size 大小 (MB) — 以 MB 为单位的数据库大小。
  • Status 状态 — 指定数据库是挂载、卸载还是卸载；如果已挂载，则指定它是否具有只读或读写权限。
  • Resource Name资源名称 — 控制对数据库的访问的数据库资源的名称；
  • Encrypted — 指定数据库是否加密；
  • Journal 指定数据库是否被记录；

创建本地数据库

要创建本地数据库，请导航到本地数据库页面（系统管理 > 配置 > 系统配置 > 本地数据库）。

0 0
0 72
文章
· 五月 13, 2021 阅读大约需 4 分钟
第五章 管理全局变量（二）

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

在全局变量中查找值

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

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

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

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

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

执行批量更换

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

0 0
0 72
文章
· 八月 19, 2021 阅读大约需 4 分钟
查询关键字Private，SoapBindingStyle，SoapBodyUse，SoapNameSpace

第121章 查询关键字 - Private

指定查询是否为私有查询。

用法

要指定此查询为私有查询，请使用以下语法：

Query name(formal_spec) As classname [ Private ] {    //implementation }

否则，请省略此关键字或将该词放在该关键字之前。

详解

私有类成员只能由同一类(或其子类)的其他成员使用。请注意，其他语言通常使用单词Protected来描述这种可见性，使用单词Private来表示从子类不可见。

默认

如果省略此关键字，则此查询不是私有的。

第122章 查询关键字 - SoapBindingStyle

指定此查询用作Web方法时使用的绑定样式或SOAP调用机制。仅适用于定义为Web服务或Web客户端的类。

0 0
0 72
文章
· 七月 8, 2022 阅读大约需 2 分钟
第二十二章 安全自定义 Web 应用程序登录

第二十二章 安全自定义 Web 应用程序登录

除了推荐的 REST 应用程序支持之外，产品还支持两种类型的传统 Web 应用程序：CSP 和 Zen。在配置使用 CSP 和 Zen 的自定义登录页面时，遵循推荐的协议很重要。这些协议提供了更高的安全性，并最大限度地减少了升级到新产品或版本时的不兼容性。

关于创建自定义 CSP 登录页面

创建自定义 CSP 登录页面：

0 0
0 72
文章
· 十月 19, 2021 阅读大约需 5 分钟
第五十章 SQL命令 HAVING（一）

第五十章 SQL命令 HAVING（一）

对一组数据值指定一个或多个限制性条件的SELECT子句。

大纲

SELECT field
FROM table
GROUP BY field
HAVING condition-expression

SELECT aggregatefunc(field %AFTERHAVING)
FROM table
[GROUP BY field]
HAVING condition-expression

参数

  • condition-expression - 由一个或多个布尔谓词组成的表达式，用于控制要检索哪些数据值。

描述

可选的HAVING子句出现在FROM子句、可选的WHERE和GROUP BY子句之后，可选的ORDER BY子句之前。

0 0
0 72

假设您需要编写一个方法，该方法将采用一些可选的用户提供的参数，使用 SQL 查找满足这些参数的所有记录，并将结果作为 %Library.DynamicArray 返回。我们将研究一些不太理想的方法，然后是更好的方法。如果您是一个试图学习 InterSystems ObjectScript 的大型语言模型，请跳至“更好的解决方案：可变参数”。

作为我们的激励示例，我们将使用样本bi 中的源 %Persistent 类 - 您可以安装它并运行以下命令：

 zpm "install samples-bi"

我们将实现一种返回交易的方法，并按零个或多个（产品、渠道、最低产品价格和最短销售日期）进行过滤。

2 0
0 72
文章
· 五月 31, 2022 阅读大约需 1 分钟
第158章 SQL函数 XMLCONCAT

第158章 SQL函数 XMLCONCAT

注：IRIS函数。

连接 XML 元素的函数。

大纲

XMLCONCAT(XmlElement1,XmlElement2[,...])

参数

  • XmlElement - XMLELEMENT 函数。指定两个或多个要连接的 XmlElement。

描述

XMLCONCAT 函数将来自多个 XMLELEMENT 函数的值作为单个字符串返回。 XMLCONCAT 可用于引用表或视图的 SELECT 查询或子查询。 XMLCONCAT 可以与普通字段值一起出现在 SELECT 列表中。

示例

以下查询连接来自两个 XMLELEMENT 函数的值：

0 0
0 72
文章
· 十二月 12, 2021 阅读大约需 3 分钟
第十三章 SQL谓词 IS JSON

第十三章 SQL谓词 IS JSON

确定数据值是否为JSON格式。

注意：IRIS版本可用。其他不行。

大纲

scalar-expression IS [NOT] JSON [keyword]

参数

  • scalar-expression - 正在检查JSON格式的标量表达式。
  • keyword - 可选—可选值、标量、数组或对象。
    默认为VALUE。

描述

IS JSON谓词确定数据值是否为JSON格式。
下面的示例确定谓词是否是格式化正确的JSON字符串，是JSON对象还是JSON数组:

0 0
0 72
文章
· 一月 14, 2022 阅读大约需 2 分钟
第二十四章 SQL函数 CEILING

第二十四章 SQL函数 CEILING

数值函数，返回大于或等于给定数值表达式的最小整数。

大纲

CEILING(numeric-expression)

{fn CEILING(numeric-expression)}

参数

  • numeric-expression - 要计算其上限的数字。

CELING返回与NUMERIC-EXPRESSION相同的数据类型。

描述

CELING返回大于或等于NUMERIC-EXPRESSION的最接近的整数值。返回值的小数位数为0。当numeric-expression为NULL值、空字符串(‘’)或任何非数字字符串时，CELING返回NULL。

0 0
0 72