陷入困境

直到今年年初，我几乎没怎么做过编程工作——我已经厌倦了它。

在担任多年一线软件工程师和数据科学家后，我在2015年左右陷入了职业倦怠。我转而从事以“外部创新”为主的业务拓展角色，并于2019年加入InterSystems担任产品经理。我怀念编程的创造性，但并不怀念其中的枯燥乏味。无休止的样板代码编写、调试和上下文切换让我创意枯竭。就像电影《好好先生》（Yes Man)中金·凯瑞饰演的角色一样，我发现自己对新项目总是说“不”——以至于我换了职业！

然后，AI编程助手出现了。而我，成了对机器人说“好”的“好好先生”。

第一幕：狂热（“对一切都说好！”）

当我刚开始使用AI编程助手（先是Windsurf，然后是Cline，接着是Roo Code，现在是Claude Code，还尝试过opencode）时，感觉就像变魔术一样。自然语言 → 可运行的代码。我对每个建议、每个重构、几乎每个疯狂的想法都说“好”。

我第一个主要的AI辅助项目是几个月前启动的一个内部项目——为IRIS开发的一系列Python脚本和管道。我兴奋不已，让机器人尽情发挥： “添加这个功能！”——好！“重构那个模块！”——好！“让它可配置！”——好！“添加更多集成！”——好！

创意的能量回来了。代码如泉涌。我又感到自己高效了起来。

然后，我的实习生——一名软件工程专业的学生——查看了代码库。

他并不满意。

目录

1. 导言
2. 版本控制
3. 导出类
4. 导出 BI 分析类
5. 导出globals

简介。

本文将介绍如何通过 InterSystems 开发人员社区快速入门 Git 开发，以及使用 IRIS InterSystems 时的版本控制实践。我们将介绍需要导出互操作性类、global和分析元素（如立方体和仪表盘）的情况。这些场景包括 IRIS 的关键版本控制实践。

要开始学习，您需要

1. 注册并登录GitHub
2. 成为 Git 上intersystems-community组织的成员

开始使用 IRIS InterSystems 非常简单！

InterSystems 常见问题

如果您尝试从顶级节点删除在子脚本级别映射的全局变量，您将收到一个<SLMSPAN>错误，并且它不会被删除。这是因为用于子脚本级别映射全局变量的kill命令不能跨映射使用。

// Suppose subscript-mapped globals exist in different databases, as shown below:
^TEST(A*～K*) -> database A
^TEST(L*～Z*) -> database B

// Trying to kill from the top level will result in a <SLMSPAN> error.
NAMESPACE>Kill ^TEST
<SLMSPAN> <- This error is output.

要只删除当前命名空间（数据库）中的全局，请使用以下命令：

NAMESPACE>Kill ^["^^."]TEST

在子脚本级别映射的全局变量必须移动到数据库并直接删除。

要切换到数据库，请使用以下命令：

zn "^^c:\intersystems\iris\mgr\user"
or
set $namespace="^^c:\intersystems\iris\mgr\user"

使用 $System.OBJ.

在上一篇文章中，我们介绍了IrisOASTestGen——一个基于OpenAPI 2.0规范为InterSystems IRIS生成REST API测试代码的工具。该文章展示了如何使用OpenAPI Generator附带的默认模板来搭建测试用例。本文将聚焦于接下来的自然步骤**：自定义生成的测试代码**。通过使用Mustache模板扩展代码生成逻辑，我们可以表达更丰富的语义、实现CRUD感知测试，并创建更有意义的测试套件。本文的示例将修改IrisOASTestGen，为createPerson操作生成测试，包括遍历所有预期响应。这将展示如何使用OpenAPI规范中的自定义字段来驱动Mustache模板内的条件渲染。

OpenAPI扩展以支持CRUD操作

为了使代码生成支持CRUD操作，OpenAPI规范可以在vendorExtensions中包含自定义字段。这些自定义字段作为标志，Mustache模板可以检测到它们。

大家好！ 👋
欢迎来到IRIS IO 工具系列的第二部分。这个扩展是我提交给InterSystems 2025 年 "将想法变为现实 "竞赛的作品，它为您提供了一个直观而强大的界面，可直接在 VS 代码中导入和导出数据。

• 您可以在我的 GitHub 页面找到该扩展：pietrodileo/iris_io_utility。
• 在 VSCode 上安装扩展的 VSIX 文件可在相关发布页面找到：releaseases: iris-io-utility

如果你觉得这个扩展有用，请考虑在竞赛中为我投票！

在上一篇文章中，我们介绍了

• 扩展概述
• ODBC 驱动程序配置
• 导出功能

现在是时候深入了解导入引擎(Import Engin)了_它旨在支持

• CSV
• TXT（任意分隔符）
• JSON
• XLSX

该扩展具有智能推理层，可分析输入文件并自动建议最佳的 IRIS 表格数据格式，提供有指导的辅助数据建模。

导入模式--两种不同的工作流程

该扩展支持两种不同的方案：

• 创建新表
• 加载到现有表格

选项 A - 导入新表

在以下情况下，这是理想的选择

• 加载新数据集
• 您希望从头开始，使用全新的表和模式
• 处于原型设计或探索阶段

会发生什么？

数据库表中索引的力量

在使用数据库时，大多数开发人员都了解索引的概念以及使用索引的原因：加快数据检索速度。但是，索引的真正影响往往只有在比较有索引和没有索引的情况时才会显现出来。

你知道没有索引会发生什么吗？
试想一个有三列的表：姓名、年龄和手机号码。

现在，考虑一下这个查询：

如果年龄列没有索引，数据库引擎会

• 检查 WHERE 条件字段是否有索引。
• 如果没有，它将扫描整个表（全表扫描）。
• 对于每一行，它会检查年龄值并返回匹配结果。

这意味着引擎会遍历整个数据结构，这对于大型表来说非常耗时。

索引会发生什么情况？
现在，如果年龄列有索引，流程就会发生巨大变化：

• 引擎会直接进入索引结构。
• 它会找到 Age = 26 的节点。
• 索引指向主表中相应的记录 ID。
• 结果几乎是瞬间获取的。

这就是为什么索引是如此强大的优化工具。

现实生活中的一课
最近，我们遇到了一个有趣的情况，凸显了索引的重要性。
我们的表有 5 条记录，而年龄列是有索引的。然后，我们错误地从索引结构（而不是主表）中删除了两个条目。这两个条目对应的是 ID X001 和 X005，它们的年龄都是 26 岁。

当我们运行
SELECT ID, Age, EmpId, Mobile, NameFROM Company.Employee WHERE Age = 26
我们预计会有 3 条记录（因为主表中仍有这些记录），但只出现了 2 条记录。

为什么呢？

InterSystems 常见问题

使用 TCP 适配器的业务主机保持连接和池大小的默认设置如下：

如果网络问题导致与业务主机的连接丢失，生产端将无法检测到这一情况，也不会接受新的连接。 在这种情况下，事件日志中不会记录任何事件。 如果将 StayConnected 设置为默认值（-1），连接将不会超时，您需要重启业务主机后才能接受新的连接。 我们建议将 StayConnected 设置为大于或等于 0 的值，以避免出现这种情况。

例如，如果将其设置为 300（秒），TCP 业务主机在 300 秒或更长时间内没有收到任何新信息，就会自动断开连接并重新连接。

对于繁忙的系统，通常会将 StayConnected（保持连接）值设为一个较小的值，如 5 秒。

本文将讨论 Microsoft Visual Studio Code IDE中包含的所有调试工具 。

内容包括

• 断点
• 观察窗口
• 调用堆栈

让我们从了解调试要求开始！

前提条件

有两个插件（扩展）可用于调试 ObjectScript：

第一个是 InterSystems ObjectScript 扩展包的一部分 。第二个是 Serenji，它是一个独立的插件，提供编辑器、文件管理器和调试功能。这两个插件都可以从插件商店安装。要激活关键功能，Serenji 需要许可证。在本文中，我们将使用 InterSystems ObjectScript 扩展包来降低学习难度。在掌握基础知识后，您可以考虑购买 Serenji 的付费许可证。

Embeddedpy-bridge：嵌入式 Python 工具包

概述

嵌入式 Python改变了 InterSystems IRIS 的游戏规则，可直接在数据库中访问庞大的 Python 生态系统。但是，在 ObjectScript 和 Python 之间架起桥梁有时会让人感觉像是在两个不同的世界之间转换。

为了实现这种无缝过渡，请使用embeddedpy-bridge。

该软件包是一个以开发人员为中心的实用工具包，旨在为嵌入式 Python 提供高级 ObjectScript 封装、熟悉的语法和强大的错误处理功能。它允许开发人员使用他们已经熟悉的本地 IRIS 模式与 Python 数据结构交互。

挑战

虽然 %SYS.Python 库功能强大，但开发人员经常面临一些障碍：

1. 处理代理：使用原始代理浏览 Python 列表和字典对于 ObjectScript 来说并不 "原生"。
2. 迭代：标准 ObjectScript While 循环无法与 Python 迭代器进行本地 "对话"。
3. 命名空间管理：确保 Python 实用程序在整个系统中可用。

解决方案：embeddedpy-bridge

我的目标是创建一个 "桥梁"，让 Python 感觉像是 ObjectScript 中的一等公民。

主要功能

• py 前缀约定：%ZPython.

你好

数据迁移通常听起来像是一个简单的 "将数据从 A 转移到 B 的任务"，直到你真正去做。实际上，这是一个融合了规划、验证、测试和技术精度的复杂过程。

我曾在多个项目中负责将数据迁移到在 IRIS（TrakCare）上运行的 HIS 中，在这些项目中，我认识到成功来自于纪律和自动化的结合。

以下是我想强调的几个要点。

1.从定义好的数据格式开始。

在打开第一个文件之前，确保每个人，尤其是数据提供者，都清楚地了解您所期望的确切数据格式。尽早定义模板可以避免不必要的来回奔波和返工。

虽然 Excel 或 CSV 格式很常见，但我个人认为使用制表符分隔的文本文件（.txt）上传数据是最好的。它既轻便又一致，还能避免文本字段内的逗号问题。

PatID   DOB Gender  AdmDate
10001   2000-01-02  M   2025-10-01
10002   1998-01-05  F   2025-10-05
10005   1980-08-23  M   2025-10-15

确保文件中提供的日期格式正确且在整个文件中保持不变，因为所有这些文件通常都是从 Excel 文件转换而来，而 Basic excel 用户可能会在提供错误的日期格式时犯错。错误的日期格式在转换为 horolog 时会让您恼火。

在最近的竞赛中，看到更多的人在创建 VS Code 扩展程序，这令人鼓舞。不过我注意到，在三个需要使用凭据进行连接的扩展中，只有我的gj :: dataLoader 利用了历史悠久、官方支持的InterSystems Server Manager扩展来获取连接定义并安全地处理凭据。