第161章 SQL函数 YEAR
返回日期表达式的年份的日期函数。
大纲
YEAR(date-expression)
{fn YEAR(date-expression)}
参数
date-expression - 计算结果为 日期整数、ODBC 日期字符串或时间戳的表达式。此表达式可以是列名、另一个标量函数的结果或日期或时间戳字面量。
描述
YEAR 将日期整数($HOROLOG 日期)、ODBC 格式日期字符串或时间戳作为输入。 YEAR 以整数形式返回相应的年份。
日期表达式时间戳可以是数据类型 %Library.PosixTime(编码的 64 位有符号整数),也可以是数据类型 %Library.TimeStamp (yyyy-mm-dd hh:mm:ss.fff)。
InterSystems IRIS 程序员可以在这里学习、分享、了解最新动态、成长,以及收获快乐!
InterSystems Kubernetes Operation(IKO)3.3版现已通过WRC下载页面和InterSystems容器注册中心提供。
IKO通过提供一个易于使用的irisCluster资源定义,简化了在Kubernetes中使用InterSystems IRIS或InterSystems IRIS for Health的工作。完整的功能清单见IKO文档,包括轻松的分片、镜像和ECP的配置。
IKO 3.3 亮点:
- 支持InterSystems IRIS和InterSystems IRIS for Health 2021.2 以及 2022.1版本
- 支持 Kuberentes 1.21
- 将常见的系统警报和监控(SAM)配置作为
irisCluster的一部分进行部署
- InterSystems API Manager(IAM)现在也可以作为
irisCluster的一部分进行部署和管理
- 自动标记Mirror对的活跃端,因此服务可以始终指向激活的镜像成员
第十三章 SQL谓词 IS JSON
确定数据值是否为JSON格式。
注意:IRIS版本可用。其他不行。
大纲
scalar-expression IS [NOT] JSON [keyword]
参数
scalar-expression - 正在检查JSON格式的标量表达式。
keyword - 可选—可选值、标量、数组或对象。
默认为VALUE。
描述
IS JSON谓词确定数据值是否为JSON格式。
下面的示例确定谓词是否是格式化正确的JSON字符串,是JSON对象还是JSON数组:
第七章 SQL谓词 %FIND
使用位图块迭代将一个值匹配到一组生成的值。
第四十五章 外键关键字 - SqlName
为外键指定一个SQL别名。
用法
要覆盖此外键的默认SQL名称,请使用以下语法:
ForeignKey keyname(key_props) References pkg.class(ref_index) [ SqlName = alternate_name ];
其中备用名是一个SQL标识符。
详解
此关键字允许在通过SQL引用时定义此外键的替代名称。
默认
如果省略此关键字,外键的SQL名称就是外键定义中指定的keyname。
第四十六章 索引关键字 - Abstract
指定索引是抽象的。
用法
要指定索引是抽象的,请使用以下语法:
第十五章 XML检查属性
检查属性的基本方法
可以使用%XML.Node的以下方法。以检查当前节点的属性。
- AttributeDefined() 如果当前元素具有具有给定名称的属性,则返回非零(TRUE)。
- FirstAttributeName() 返回当前元素的第一个属性的属性名称。
- GetAttributeValue() 返回给定属性的值。如果元素没有该属性,则该方法返回NULL。
- GetNumberAttributes() 返回当前元素的属性数。
- LastAttributeName() 返回当前元素的最后一个属性的属性名称。
- NextAttributeName() 在给定属性名称的情况下,无论指定的属性是否有效,此方法都会按排序顺序返回下一个属性的名称。
- PreviousAttributeName() 在给定属性名称的情况下,无论指定的属性是否有效,此方法都会按排序顺序返回上一个属性的名称。
第五章 管理全局变量(二)
在全局变量中查找值
“查找全局变量字符串”页使可以在下标或选定全局变量的值中查找给定的字符串。
要访问和使用此页,请执行以下操作:
- 显示“全局变量”页。
- 选择要使用的全局变量。为此,请参阅“全局页简介”一节中的步骤2和3。
- 单击查找按钮。
- 对于查找内容,输入要搜索的字符串。
- (可选)清除大小写匹配。默认情况下,搜索区分大小写。
- 单击Find First或Find All。
然后,页面显示选定全局变量中下标或值包含给定字符串的第一个节点或所有节点。该表左侧显示了节点下标,右侧显示了相应的值。
- 如果使用的是Find First,请根据需要单击Find Next以查看下一个节点。
- 完成后,单击关闭窗口。
执行批量更换
注意:在进行任何编辑之前,请确保知道IRIS使用哪个全局系统,以及应用程序使用哪个全局系统;参见“一般建议”此选项会永久更改数据。不建议在生产系统中使用。
第三章 使用多维存储(全局变量)(一)
本章描述了使用多维存储(全局变量)可以执行的各种操作。
以全局变量存储数据
在全局节点中存储数据很简单:像对待任何其他变量一样对待全局变量。
区别在于对全局变量的操作是自动写入数据库的。
创建全局变量
创建新的全局变量不需要设置工作;只需将数据设置为全局变量即可隐式创建新的全局结构。可以创建全局变量(或全局变量下标)并通过单个操作将数据放入其中,也可以创建全局变量(或下标)并通过将其设置为空字符串将其保留为空。在ObjectScript中,这些操作是使用SET命令完成的。
下面的例子定义了一个名为Color(如果还不存在)的全局变量,并将值“Red”与之关联。
如果已经存在一个名为Color的全局变量,那么这些示例将其修改为包含新信息。
在ObjectScript中:
尊敬的HealthShare用户:
本帖是HealthShare HS2021-03提醒沟通流程的一部分,同样的信息也会以以下渠道分发:
第四十四章 Caché 变量大全 $ZTRAP 变量
包含当前错误陷阱处理程序的名称。
大纲
$ZTRAP
$ZT
描述
$ZTRAP包含当前错误陷阱处理程序的行标签名和/或例程名。有三种方法可以设置$ZTRAP:
SET $ZTRAP=“location”
SET $ZTRAP=“*location”
SET $ZTRAP=“^%ET” or “^%ETN”
在这里,位置可以指定为标签(当前例程中的行标签)、^routine(指定外部例程的开始)或label^routine(指定外部例程中的指定标签)。
第十六章 L - M 开头的术语
锁表 (lock table)
系统
IRIS 内部的表,存储所有由进程发出的 LOCK 命令。你可以使用系统查看器查看此表。
日志文件 (log files)
系统
系统管理员目录中的文件,包含关于系统操作、错误和指标的消息。这些包括消息日志(messages.log)、系统监视器日志(SystemMonitor.log)、警报日志(alerts.log)、初始化日志(iboot.log)和日志历史记录日志(journal.log)。有关这些日志文件的信息,请参见“监控日志文件”。
逻辑格式 (logical format)
对象(Objects)
对象属性的逻辑格式是在内存中使用的格式。所有的比较和计算都是基于这种格式进行的。
第五十一章 File 输入 输出 - 文件路径名工具
文件路径名工具
如果当前设备是顺序文件,则$ZIO包含该文件的完整路径名。
可以使用$ZSEARCH返回指定文件或目录的完整文件规范(路径名和文件名)。文件名可能包含通配符, $ZSEARCH使用通配符返回一系列满足通配符的完全限定路径名。
%Library.File 类包含许多提供文件系统服务的方法。这些包括:
第一章 I/O 输入/输出简介
本页概括地描述了如何在 IRIS 数据平台应用程序中以及在 IRIS 提示符下使用 I/O 设备。
介绍
IRIS 数据平台为多种不同类型的逻辑和物理设备提供支持。支持的逻辑设备包括:
- 主要装置
- 文件
- 管道
- TCP连接
- 作业间通信 (IJC) 设备用于在 IRIS 进程之间进行通信
- 假脱机程序
支持的物理设备包括
I/O 命令概述
I/O 命令允许拥有、使用、读取、写入和关闭设备。要将 I/O 操作定向到设备,请首先发出以下命令:
请问一下,活动量仪表盘这个界面怎么激活,实例怎么展现?我的服务器展开没有数据,但是是有消息记录的。
在 OEX 最近一次编程竞赛之后,我有一些令人惊讶的发现。
几乎所有的应用程序都是基于人工智能与预制 Python 模块的结合。
但深入研究后发现,所有示例都使用了 IRIS 的相同技术组件。
从 IRIS 的角度来看,无论是搜索文本还是搜索图像或其他模式都是一样的。 其底层基本都是一样的。
这让我想起了我家里的情况。我的妻子和女儿对家里的大量裙子、衬衫和其他衣服的信息进行了整理。
但无论如何进行整理、分类、归档,我依然通过和我的妻子和女儿说话,来确定我的穿着。
无论怎样包装,其结果都是如此。
回到这次竞赛比赛:
同样的 IRIS 技术内容,却有很多花哨的包装。
每个人都在同一条高速公路上奔跑。没有人提到它有什么限制。
于是我试着深入挖掘,找出新数据类型 VECTOR 的使用限制。
所有向量都有两个基本参数
- 静态 DATATYPE:"整型integer"(或 "int")、"double"、"十进制decimal"、"字符串 "和 "时间戳"。
- 半动态 LEN(gth): > 0 通常也称为 POSITION;纯整数。
SUTA培训是InterSystems专为SUTA有效期客户提供的原厂产品技术服务,具体包括产品的基础管理、编程管理、高级管理和开发培训等。2023 SUTA培训报名现已启动,汇聚技术专家,与新老客户一起探讨提升InterSystems数据平台基础管理运维的技能和知识:
第五章 ObjectScript
方法和例程都可以用 ObjectScript 编写,但大多数现代代码都是使用方法编写的。方法包含在类中,这允许将类似的方法分组在一起,在类参考中自动生成文档,以及使用 IRIS 的面向对象功能。
这并不意味着routines 不重要。许多有用的系统实用程序都是作为例程编写的,并且在编译类时会生成例程。
示例类
下面显示了一个名为 User.DemoClass 的示例类,其中包含用 ObjectScript 编写的方法。此示例使我们有机会了解一些常见的 ObjectScript 命令、运算符和函数,并了解代码在方法内的组织方式。
第三十章 开发Productions - ObjectScript Productions - 定义业务操作 - 调用适配器方法
调用适配器方法
最常见的是,业务操作不包含用于与外部系统通信的逻辑。相反,业务操作使用处理此逻辑的出站适配器。一旦业务操作与出站适配器相关联,它就会调用适配器的方法来发送和接收数据。有关调用适配器方法的详细信息,请参阅从业务主机访问属性和方法。
向生产中的目标发送请求
尽管业务操作主要负责向特定的外部应用程序传递请求,但它也可以根据需要向其他业务操作或业务流程发送消息。要将消息发送到生产中的目标,请调用 SendRequestSync()、SendRequestAsync() 或 SendDeferredResponse()。
Ens.BusinessOperation 定义了一个可以使用的附加方法:DeferResponse()。
第四十六章 管理镜像 - 更新镜像成员网络地址
当必须更新一个或多个镜像成员(包括主要成员)的一个或多个网络地址时,如编辑或删除故障转移成员中所述,通常会在主要成员上更改此信息。当您保存更改时,主节点将它们传播到所有连接的镜像成员(并在它们重新连接时传播到断开连接的成员)。不能更改连接的备份或异步成员上的任何镜像成员网络地址,因为镜像成员必须从主成员接收所有此类信息。但是,一般情况下有一些例外情况,如下所示:
- 由于
IRIS 实例的超级服务器端口是其常规配置的一部分,因此必须在本地进行更改。因此,镜像成员的超级服务器端口是唯一始终在成员本身上更新的镜像网络信息。要更改主服务器的超级服务器端口,请转到主服务器的“编辑镜像”页面,要更改备份的,请转到备份的“编辑镜像”页面,依此类推。
注意:当在“编辑网络地址”对话框中单击本地成员超级服务器端口的“编辑端口”链接时,将出现一个包含管理门户内存和启动页面的对话框,以便更改端口号。但是,不要直接转到此页面来更改镜像成员的超级服务器端口;始终使用“编辑镜像”或“编辑异步配置”页面和“编辑网络地址”对话框来进行此更改。
第二十四章 SQL函数 CEILING
数值函数,返回大于或等于给定数值表达式的最小整数。
大纲
CEILING(numeric-expression)
{fn CEILING(numeric-expression)}
参数
numeric-expression - 要计算其上限的数字。
CELING返回与NUMERIC-EXPRESSION相同的数据类型。
描述
CELING返回大于或等于NUMERIC-EXPRESSION的最接近的整数值。返回值的小数位数为0。当numeric-expression为NULL值、空字符串(‘’)或任何非数字字符串时,CELING返回NULL。
第十章 SQL谓词 IN
将值匹配到以逗号分隔的非结构化列表中的项。
大纲
scalar-expression IN (item1,item2[,...])
scalar-expression IN (subquery)
参数
scalar-expression - 标量表达式(最常见的是数据列),将其值与以逗号分隔的值列表或子查询生成的结果集进行比较。
item - 一个或多个文本值、输入主机变量或解析为文本值的表达式。
以任何顺序列出,以逗号分隔。
subquery - 一个用括号括起来的子查询,它从单个列返回一个结果集,用于与标量表达式进行比较。
描述
IN谓词用于将值匹配到非结构化的项系列。
通常,它将列数据值与以逗号分隔的值列表进行比较。
IN可以执行相等比较和子查询比较。
第三十七章 SQL命令 DROP ROLE
删除角色
大纲
DROP ROLE role-name
参数
role-name - 要删除的角色的名称。名称是一个标识符。角色名称不区分大小写。
描述
DROP ROLE语句删除角色。删除角色时, IRIS会将其从已授予该角色的所有用户和角色中撤消,并将其从数据库中删除。
可以通过调用$SYSTEM.SQL.Security.RoleExists()方法来确定角色是否存在。如果尝试删除不存在(或已被删除)的角色,则DROP ROLE将发出SQLCODE-118错误。
第八章 SQL命令 CREATE METHOD(一)
在类中创建方法。
第101章 属性关键字 - InitialExpression
指定此属性的初始值。
用法
要指定此属性的初始值,请使用以下语法:
Property name As classname [ InitialExpression = initialexpression ];
其中,initialexpression是用大括号括起来的常量或ObjectScript表达式。
详解
此关键字指定属性的初始值。该值是在创建新实例时由类的%New()方法分配的。(如果属性是瞬态的的,则其初始值由创建实例时%New()调用的代码或实例从磁盘加载到内存时%OpenId()调用的代码确定。)
初始表达式的值必须适合给定的属性类型。
表达式可以是任意复杂的,有以下限制:
第十七章 类关键字 - DependsOn
指定此类应在编译器使其他(指定的)类可运行后编译。
用法
要指示类编译器应该在其他类可运行后编译此类,请使用以下语法:
Class MyApp.MyClass [ DependsOn = classlist ]
{ //class members }
其中classlist是下列之一:
[ DependsOn = MyApp.Class1 ]
[ DependsOn = (MyApp.Class1,MyApp.Class2,...) ]
详情
此关键字指定类编译器应该在使指定的类可运行后编译此类。
如果此类的编译使用方法生成器逻辑中的这些其他类,则此关键字非常有用。如果类包含调用其他类的初始表达式,这也很有用。
第五章 管理全局变量(二)
在全局变量中查找值
“查找全局变量字符串”页使可以在下标或选定全局变量的值中查找给定的字符串。
要访问和使用此页,请执行以下操作:
- 显示“全局变量”页。
- 选择要使用的全局变量。为此,请参阅“全局页简介”一节中的步骤2和3。
- 单击查找按钮。
- 对于查找内容,输入要搜索的字符串。
- (可选)清除大小写匹配。默认情况下,搜索区分大小写。
- 单击Find First或Find All。
然后,页面显示选定全局变量中下标或值包含给定字符串的第一个节点或所有节点。该表左侧显示了节点下标,右侧显示了相应的值。
- 如果使用的是Find First,请根据需要单击Find Next以查看下一个节点。
- 完成后,单击关闭窗口。
执行批量更换
注意:在进行任何编辑之前,请确保知道IRIS使用哪个全局系统,以及应用程序使用哪个全局系统;参见“一般建议”此选项会永久更改数据。不建议在生产系统中使用。
第二十二章 P - R 开头的术语
程序员模式 (programmer mode)
系统
所有程序开发活动进行的模式。在程序员模式下,你从 IRIS 提示符启动程序,并且每个运行的程序结束后提示符会重新出现。程序员模式涵盖了 IRIS 环境及其所有可调用的程序,包括 SQL 开发环境。在程序员模式下,你可以创建用户随后在应用程序模式下运行的应用程序。
项目 (project)
系统
用户定义的相关源文档(如例程或类定义)列表。Visual Studio Code 使用项目来帮助组织应用程序开发。
属性 (property)
对象(Objects)
表示与类相关联的特定特性的一个数据元素。该类的每个对象包含属性的字面值或指向表示数据的另一个对象的引用。一个类的所有属性共同表示其状态。
属性排序 (property collation)
对象(Objects)
第十一章 本地进程间通信(管道) - OPEN 命令管道示例
OPEN 命令管道示例
以下是有效的命令管道OPEN语句。每个示例指定 10 秒的超时:
第五十二章 开发Productions - ObjectScript Productions - 不常见的任务 - 在目标是动态的情况下渲染连接
在目标是动态的情况下渲染连接
当用户选择业务主机时,管理门户会自动显示与给定业务主机之间的连接。例如:
为此,IRIS 读取业务主机的配置设置并使用它们。
但是,如果业务服务在运行时动态托管其目标, IRIS 将无法自动显示此类连接。在这种情况下,要显示此类连接,请实施 OnGetConnections() 回调方法。 IRIS 在呈现配置图时自动调用此方法(默认情况下不执行任何操作)。
OnGetConnections() 具有以下签名:
ClassMethod OnGetConnections(Output pArray As %String, item As Ens.Config.Item) [ CodeMode = generator ]
其中参数如下:
第六十七章 使用 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 获得: