InterSystems 常见问题

使用 %Library.Global 类的 Export() 方法导出时，如果导出格式（第四个参数：OutputFormat）设置为 7，即 "块格式（Block format）/Caché 块格式 (%GOF)"，则无法导出映射的Global项（只能导出命名空间默认Global数据库中的Global项）。要导出 "块格式/Caché 块格式 (%GOF) "的映射Global项，请在 %Library.Global.Export() 的第一个参数中指定要映射Global项的数据库目录。

执行示例如下。

如果将导出格式指定为 5（默认），即 "ISM/ObjectScript 格式（ISM/缓存格式）(*)"，则也可以导出映射Global，但输出文件会比将导出格式（第四个参数：OutputFormat）设置为 7（即 "块格式/Caché 块格式（%GOF）"）时大。

此外，如果在Global中记录了二进制数据，也无法正确输出。

更多信息，请参阅以下文档。

在使用标准 SQL 或 InterSystems IRIS 中的对象层时，元数据的一致性通常通过内置验证和类型执行来保持。但是，绕过这些层直接访问global的传统系统会带来微妙而严重的不一致性。

了解驱动程序在这些边缘情况下的行为，对于诊断遗留数据问题和确保应用可靠性至关重要。
DATATYPE_SAMPLE数据库旨在帮助分析列值不符合元数据中定义的数据类型或约束的错误情形。我们的目标是评估 InterSystems IRIS 及其驱动程序（JDBC、ODBC、.NET）和不同工具在发生此类不一致时的表现。 在本篇文章中，我将重点介绍JDBC 驱动程序。

问题出在哪里？

一些传统应用程序会直接写入globals。如果使用关系模型（通过 CREATE TABLE 创建或使用全局映射手动定义）来公开这些数据，那么映射定义 的底层值就会与每列的声明元数据一致。

当这一假设被打破时，可能会出现不同类型的问题：

1. 访问失败（Access Failure）：根本无法读取某个值，当驱动程序尝试访问该值时会抛出异常。
2. 静默损坏（Silent Corruption）：值已成功读取，但与预期的元数据不匹配。
3. 未检测到的数据变异（Undetected Mutation）：该值被读取且看似有效，但被驱动程序悄然修改以符合元数据要求，这使得这种不一致性难以被察觉。

InterSystems 发布了新的点式更新，该更新解决的缺陷问题影响以下受支持的产品线的最新先前版本 2025.1.0、2024.1.4、2023.1.6 和 2022.1.7：

• InterSystems IRIS
• InterSystems IRIS for Health
• HealthShare Health Connect

此问题可能导致在使用以下功能时出现意外的 <PROTECT> 错误或访问异常：

• 隐式命名空间
• 对数据库的混合只读/读写访问
• 用于列出例程和全局变量的管理门户页面

症状包括：

• 命名空间创建故障
• 在列出例程时，间歇性出现“访问被拒”错误
• 对于具有只读权限的用户，全局显示页面不返回数据

虽然这些问题并不影响访问控制或用户权限，但它们会在多种场景下影响预期的系统行为。

问题得到解决的版本

以下点式版本中修复了该问题：

• 2025.1.0.230.2
• 2024.1.4.516.1
• 2023.1.6.810.1
• 2022.1.7.116.1

建议使用受影响版本的客户应用相关更新，以确保系统正常运行。

如果您有任何问题或需要支持，请联系 InterSystems 全球响应中心 (WRC)。

摘要

第十一章 F - H 开头的术语

文件流 (file stream)

对象（Objects）

文件流提供了一个接口，用于在外部文件中操作和存储大量基于文本或二进制的数据。IRIS 的流接口可以在 ObjectScript、SQL 和 中用于操作文件流。

最终类 (final class)

对象（Objects）

不能被扩展或子类化的类。

最终方法 (final method)

对象（Objects）

不能被重写的方法。

最终属性 (final property)

对象（Objects）

不能被重写的属性。

外键 (foreign key)

InterSystems SQL

外键约束表中的一列指向另一表中的另一列。为第一列提供的值必须存在于第二列中。

基础 (foundation)

医疗保健（Health care）

在 InterSystems IRIS for Health™ 和 中，启用了医疗保健互操作性的命名空间。

以 G 开头的术语

全局 (global)

系统

多维存储结构。全局在 数据库中使用平衡树技术实现。

全局数据库 (globals database)

系统

的基础逻辑和物理数据存储结构，其中所有数据都存储在称为“全局”的多重下标数组系统中。

全局目录 (global directory)

系统

包含全局数据库的目录。

前言 {#1}

ensemble里边实现分页比较麻烦，毕竟对于sql的书写比较麻烦，单表的查询相对简单，对于多表的关联查询单纯的sql不好查询，我们使用sql进行先查询出主表满足条件的rowId,在根据根据满足条件的rowid进行遍历取值。

思路

我们先取对比一下其他数据库实现的原理。

1. Mysql的实现原理 总数：SELECT COUNT(*) AS total FROM person WHERE (name LIKE ?) 分页：SELECT id,name,age,email FROM person WHERE (name LIKE ?) LIMIT ?,?

2. ORACLE的实现原理 rownum 总数：SELECT COUNT() AS total FROM person WHERE (name LIKE ?) 分页：SELECT * FROM ( SELECT TMP., ROWNUM ROW_ID FROM ( SELECT id,name,age,email FROM person WHERE (name LIKE ?) ) TMP WHERE ROWNUM <=?) WHERE ROW_ID > ?

3. 由于cache没有limit关键字，看看有没有和oracle里边rownum一样的原理。

这是Java 编程比赛的相关文章。
我决定推出一个基于 IRIS Native API for Java 的 CRUD++  Global编辑器。
++因为它不仅仅是C reate、 R ead、 U pdate、 D elete
Global可视化对于立即查看结果始终很重要。

• 为此，我使用模仿 ZWrite 的树查看器扩展了 API，并且还允许检查子树。
• $Query Style Navigator 正向和反向操作可轻松找到感兴趣的全局节点。
• 最后，ZKill 添加了一个选项，可以删除全局节点的内容而不删除下面的子树。

这需要在服务器端有一个小的帮助器类作为默认 API 的扩展

我的策略是拥有一个可从命令行使用的相当适度的界面
就像在 Docker 控制台或终端上一样，并使其尽可能简单。
花哨的图形界面只会分散示例的基本内容。

如果有任何默认值或先前的值，则会在输入提示中显示。
在 Docker 容器中，编辑器已经可以使用了。

• docker-compose exec iris java gedi docker-compose exec iris java gedi

您首先连接到服务器

欢迎使用 IRIS NativeAPI 全局编辑器

>>> 服务器IP [127.0.0.1]:
>>> 服务器端口 [1972]：
>>> 命名空间 [用户]:
>>> 用户名 [_SYSTEM]:
>>> 密码[SYS]:

        连接到服务器 127.0.0.1:1972 上的命名空间 USER

iris 是数据平台，更是一种数据库。对于熟悉SQL语句的人来说，会认为“既然是数据库，数据应该就能使用sql语句来查询”。这是对的，但是因为有global这个概念，保存的数据可能在global里面，而没有对应的表，也可能保存在类的参数定义里面。这些数据，不能使用sql直接查询。要查询iris数据库的数据，通常有几种方式：1.直接查询表的数据。2.查询视图。3.调用存储过程(call 命令)。其中要查询“只存于global里面或者类参数里定义的数据”，只有使用存储过程。但是存储过程有个问题，就是程序如果迁移到低版本的cache数据库后，数据类型的定义会有问题，且不再支持使用select的方式，只能使用call。这对于第三方熟悉sql的人员来说很不友好。因此结合global和表的关系，介绍一种我称为“进程表”的表。进程表，指数据只存于该进程中，global的样式为"^||global名“。通常按照默认存储新加一个持久类(对应会生成一个表)，然后手动的把global改成进程global，也就是加上”||“。然后写个方法，把需要查询出来的数据写入进程global。这样就能查询出来 了。调用形式为 SELECT * FROM People WHERE People_GLB()=1。

示例如下：

Class User.

前言

对于第三方接口进行交互的时候，往往需要大量的进行参数合法性校验。以前的方法就是对每个参数进行验证。如下截图：

上图的会存在大量的if else if else..,如果字段很多，那导致一个方法存在大量的验证的代码，那我们考虑是否可以进行统一的验证参数的合法性。

思路

平时建立类的时候我们可以写参数MAXLEN=100，TRUNCATE=1 是否截取等，那找找这些参数的定义地方。如截图：

那我们想要定义自己的参数，该如何定义呢？根据面向对象设计原则之一：

里氏替换原则(Liskov Substitution Principle，LSP)：子类型必须能够替换掉他们的基类型。即，在任何父类可以出现的地方，都可以用子类的实例来赋值给父类型的引用。当一个子类的实例应该能够替换任何其超类的实例时，它们之间才具有是一个 (is-a) 关系

那我们可以自定义数据类型，继承%Library.String，这样子类继续使用父类的参数，还可以自定义自己的参数。此处以字符串为例，其他的数据类型一样的原理。 自定义类型就为String.

实现

1. 自定义数据类型

`

/// 自定义数据类型实现继承的String
Class Design.DataType.String Extends %Library.String
{

/// 是否为空 1 必填 0 可以为空
Parameter NOTBLANK = 0;

/// 代码值，写取global的表达式? $XECUTE 执行？
Parameter DICCODE;

/// 不为空的错误消息
Parameter MESSAGE;

/// 错误码值错误
Parameter CODEERRMESSAGE;

/// 类型 INT,STRING,FLOAT,NUMBER,DATE,DATETIME
Parameter TYPE = "STRING";

/// 是否时间类型
Parameter ISDATE = 0;

/// 时间格式:yyyy-MM-dd=>3  yyyyMMdd=8 dd/MM/yyyy=1	默认
Parameter DATEFORMAT = 3;

/// 条件取值验证
Parameter CONDITION;

/// 是否需要在当前时间之后，比如预约时间
Parameter ISAFTER;

/// 是否在当前直接之前 比如出生日期
Parameter ISBEFORE;

}

受到@Evgeny Shvarov 的问题和@Ashok Kumar Thangavel 的回复的启发
我已经创建了一个用于把Global下载成 XML 文件的基础

如何使用：
只需调用 http://<your_server>/csp/samples2/dc.Gdown.cls ?GBL=global_name之类的页面
gbl-name 不带首字母 ^（插入符号）
输出具有默认名称 <global_name>.XML 您可以选择。

已知限制：

• 你必须将它安装在你的源服务器上
• 它没有经过测试/跨命名空间工作
• 没有部分下载
• 错误处理只是基本或缺失

个人还有提升空间。
就是这样：

 ClassExtends%CSP.Page

InterSystems IRIS 目前将类限制为 999 个属性。

但是，如果您需要为每个对象存储更多数据该怎么办？

本文将回答这个问题（附加了社区 Python 网关的客串以及如何将广泛的数据集传输到 Python 中）。

答案其实很简单 - InterSystems IRIS 目前将类限制为 999 个属性，但不限制 999 个基元(primitives)。 InterSystems IRIS 中的属性可以是具有 999 个属性的对象等等 - 该限制很容易被忽略。

InterSystems IRIS 2022.2 具有适用于 Python 的原生 SDK (https://docs.intersystems.com/iris20222/csp/docbook/Doc.View.cls?KEY=PA…)。

我们知道如何使用 IRIS Object Script $Order 函数遍历Global数据结构。

 SET""FOR

如何使用 IRIS Native SDK 从 Python 执行相同的操作？这里有一个代码示例：

 '127.0.0.1'

尽管作为一个没有资金支持的医科专业学生，Case Western Reserve大学的Jane Hinkle最近在不到一周的时间里利用EHR供应商Epic的去识别化病人数据库Cosmos进行了临床研究，还得了奖。

Cosmos是一个HIPAA限定的数据集，整合了超过1.22亿名患者的Epic EHR数据。

"我们围绕Cosmos建立的概念就是我们所说的自助分析，这意味着Cosmos中的大数据被设置为Cosmos的任何用户都可以访问，"Epic的临床信息学家Dave Little博士在采访中告诉EHRIntelligence。"在简的案例中，我们看到一个医科学生能够带着一个有针对性的问题，从1.22亿的患者数据中找到她所需要的数据来回答这个问题。这在研究界历来是闻所未闻的。"

Hinkle的研究发现，儿科病人从COVID-19引发心肌炎的可能性是COVID-19疫苗的三到五倍。她告诉EHRIntelligence，她最初关注的是一项使用大数据工具来分析阻塞性睡眠呼吸暂停的研究。然而，当关于心肌炎是否是COVID-19疫苗接种的不良反应的问题出现时，Hinkle和她的研究导师、公共卫生硕士、医学博士、MetroHealth 公司的首席医疗信息官David Kaelber转移了他们的重点。

动机

这个项目是在我考虑如何通过Embedded Python让Python代码自然地处理IRIS globals所提供的可扩展的存储和高效的检索机制时想到的。

我最初的想法是使用globals创建一种Python字典的实现，但很快我就意识到，我应该首先处理对象的抽象问题。

所以，我开始创建一些可以包装Python对象的Python类，在globals中存储和检索它们的数据，也就是说，在IRIS globals中序列化和反序列化Python对象。

它是如何工作的?

像 ObjectScript 的%DispatchGetProperty(), %DispatchSetProperty() 和%DispatchMethod()一样, Python 有委托对象的属性和方法调用的方式。

当你设置或获取一个对象属性时，Python 解释器让你通过方式  和 来截获这个操作。

请看这个相当基本的例子。

>>> class Test:
...         def __init(self, prop1):
...                 self.prop1 = prop1
...         def __setattr__(self, name, value):
...                 print(f"setting property {name} to value {value}")
...         def __getattr__(self, name):
...                 print(f"getting property {name}")
... 
>>> obj = Test()
>>> obj.prop1 = "test"
setting property prop1 to value test
>>> obj.prop1
getting property prop1
>>> obj.prop2
getting property prop2
>>> obj.prop2
getting property prop2
>>> 

是否存在返回Global行数量的命令？

例如：

^test(1)="aa"
^test(2)="aa"
^test(3)="aa"
^test(4)="aa"
总行数 = 4

国务院于2022年12月19日发布了《中共中央 国务院关于构建数据基础制度更好发挥数据要素作用的意见》（后简称《数据二十条》），如何有效利用数据已经成为下一步的趋势。另一方面，无论是基于数据中台还是数据编织理念，两者也都对如何利用数据提出了构想。因此医疗行业数字化建设的目标已不能再局限于如何收集数据，建立医疗行业数据的流通机制将会是为越来越普遍的需求。

时钟拨回几年前，数据中台概念开始火爆。人们对数据中台的定义、诠释尽管有诸多差异，通过数据中台降低数据共享和利用的成本则是共同的期望。但经过这几年的探索之后，中台已死的观点也在涌现。究其原因，除去中台概念在技术上的不确定，数据流通过程中的责权益的不清晰也是严重的制约因素。毕竟，数据中台自身作为一套技术框架并不能代替法律法规与市场自动将数据转变为商品从而创造出流通价值。

那么，如何能够使数据的流通合规合法，使数据能够如货币和商品一般自由流动，则是我们需要思考和探索的主题，这次《数据二十条》的出现，无疑为医疗信息技术工作者提供了一个明确的思考方向。

Globals是InterSystems IRIS的数据持久性的核心。它很灵活，允许存储JSON文档、关系数据、面向对象的数据、OLAP立方体和自定义数据模型，例如思维导图。要了解如何使用globals来存储、删除和获取思维导图数据，请遵循以下步骤:

1. 把repo Clone/git到任意本地目录

$ git clone https://github.com/yurimarx/global-mindmap.git

2. 在该目录下打开Docker 终端并执行:

$ docker-compose build

3. 启动 IRIS 容器:

4. 访问 http://localhost:3000 来使用思维导图的前端并创建类似以上的思维导图

本例子的源代码

存储数据 (更多请访问: https://www.npmjs.

在这篇文章中，你可以访问InterSystems开发者社区中与学习InterSystems IRIS最相关主题的文章库。找到按机器学习、嵌入式Python、JSON、API和REST应用、管理和配置InterSystems环境、Docker和云、VSCode、SQL、分析/BI、全局、安全、DevOps、互操作性、Native API排列的顶级发表的文章。快来享受学习的乐趣吧!

机器学习

机器学习是建立先进的数据分析和自动化人工活动的一种必要的技术，具有很好的效率。它可以创建认知模型，从现有的数据中学习，并根据其自我调整的算法进行预测、概率计算、分类、识别和 "非创造性 "的人类活动的自动化。

在所有情况下，InterSystems IRIS作为一个数据平台和环境来创建、执行、提供和使用这些机器学习模型。IRIS能够从SQL命令（IntegratedML）中使用ML，使用嵌入式Python和PMML（预测模型标记语言）来执行ML。你可以在以下文章中查看它的功能:

从Terminal 访问 global 内容，答案见英文社区：

https://community.intersystems.com/post/view-globals-terminal
 

开始 - 请拉到页面底部查看该系列文章第一部分 .

3. 使用globals时结构的变体
 

一个结构，比如说一个有序排列的“树”，有各种特殊的情况。让我们来看看那些对使用globals有实际价值的情况。

3.1 特殊情况1. 一个没有分支的节点

如题：

绕过ODBC使用ObjectScript访问远程系统

这是一个在 IRIS 2020.1 和 Caché 2018.1.3 上工作的代码示例
不会与新版本保持同步
也不会获得 InterSystems 提供的支持服务！   

我们经常会遇到这样的情况，由于各种原因ODBC是访问一个远程系统的唯一选择。如果你只需要检查或改变表，这就足够了。但你不能直接执行一些命令或改变一些Global。

特别感谢@Anna Golitsyna 启发我发表此文。

这个例子提供了3种 SQLprocedure 方法来实现访问远程系统这个目的，如果其他的访问方式被阻止，通常是被一些防火墙阻止。

• SQLprocedure Ping() 返回 Server::Namespace::$ZV 并允许检查连接
• SQLprocedure Xcmd(<commandline>,<resultvar>)  执行你提交的命令行，并返回一个存放在你命名的变量中的结果。
• SQLprocedure Gset(<global>,<subscript>,<value>,<$data>)  允许你设置或删除一个Global节点 。参数<global> 是远程命名空间中的GlobalName，包括前导符；例如'^MyGlobal'  (注意：sql 用单引号!) 。

开发者们好！

各位开发者们好, 

InterSystems IRIS 数据平台的最大特点之一是它允许您创建自己的自定义，您可以使用InterSystems IRIS 中支持的所有其他模型，例如对象和关系结构，而无需创建任何自定义结构。

⏯  InterSystems Globals与灵活的数据建模 Globals

Hi开发者们，

我们非常高兴地向大家宣布此次 InterSystems Globals开发者竞赛的获奖者！

第19届编程大赛的优胜者名单如下：

我想介绍一下我参加Globals竞赛的新项目。一个非常新的Globals浏览器视图

Hey 开发者们，

投票周开始了！

来为你最欣赏的应用投上一票吧！InterSystems开发者竞赛：Globals!

🔥 为你最欣赏的应用投票： 点此投票 🔥

如何投票？请看以下细节。

亲爱的社区开发者们，大家好！

欢迎积极参与新一轮InterSystems开发者竞赛！

🏆 InterSystems开发者竞赛：Globals 🏆

竞赛时间: 2022年3月21日-4月10日

奖金总额: $10,000