第四十一章 使用多个 IRIS 实例（一）

可以在单个主机系统上安装和运行多个 IRIS® 数据平台实例。每个实例都是一个独特的、独立的 IRIS 环境。

管理 IRIS 实例

有许多方法可以连接和管理 IRIS 实例，它可能是安装在给定系统上的几种方法之一。两种最常用的方法如下：

• 安装在 Windows 系统上的每个 IRIS 实例在系统托盘中都有自己的启动器，除其他选项外，还可以：

  • 通过打开管理门户、 Terminal和 Studio 开发者客户端连接到实例。
  • 启动、停止和重新启动实例。
  • 打开用户和开发人员文档。

  从启动器中，还可以管理多个远程 实例，包括但不限于运行远程备份、编辑配置设置以及创建和编译远程对象和例程。

• 在操作系统命令行上执行 iris 命令可让管理访问 实例，其中包括其他选项，可以：

  • 使用 Terminal连接到实例。
  • 启动、停止和重新启动实例。
  • 显示有关该实例以及系统上安装的其他实例的信息。

  要在远程服务器上使用 命令，请使用 或 SSH 客户端；要将它与容器化实例一起使用，请在容器内使用它，或者使用 命令从容器外部运行它。

连接到 IRIS 实例

是一个命令行，可以在 实例的任何命名空间中使用。使用命令 iris terminal instname 打开正在运行的实例的终端，其中

亲爱的社区同学们！

2022年9月5日-10月24日，我们正在举办InterSystems开发者社区中文版首届技术征文大赛！

🏆InterSystems开发者社区中文版首届技术征文大赛🏆（←点击链接进入参赛页面，浏览所有参赛文章）！

2022年9月27日（下周二）11:00-11:30，我们将进行一次针对此次征文大赛的线上宣讲，欢迎您通过腾讯会议参加，了解关于此次征文大赛的信息，针对感兴趣的问题提问。

#腾讯会议信息

会议主题：InterSystems 社区技术征文大赛宣讲&解读
会议时间：2022/09/27 11:00-11:30 (GMT+08:00) 中国标准时间 - 北京

点击链接入会，或添加至会议列表：
https://meeting.tencent.com/dm/4UEzyh467wae

#腾讯会议：493-643-076

1、使用HTTPS前，需要在系统 > 安全管理 > SSL/TLS 配置 添加客户端的凭据

2、代码

    Set##class

第四十章 连接到远程服务器（二）

使用可选的服务器字段

网络服务器 IP 地址 Web Server IP Address

如果计划使用与正在管理的 IRIS 实例不同的机器上存在的 服务器，请在此字段中输入 Web 服务器机器的 地址。如果未指定，则默认为 地址。

CSP Server Instance

如果正在配置一个 服务器以连接到多个 实例，请在 CSP 服务器实例字段中输入要连接的 实例名称。

例如，如果在 机器上安装了 服务器，并且还安装了 IRIS 的两个实例， 和 ，则默认情况下，使用作为 一部分安装的自己的私有 服务器管理每个实例.

但是，也可以通过更改 服务器端口（ 默认为 ）并在为每个实例创建服务器定义时在 服务器实例字段中指定 和 来从公共 服务器管理这两个实例。这会在公共 服务器上自动创建虚拟目录 和 ，它们指向相应的 实例。

当在 服务器实例字段中输入一个值并在此服务器的启动器上选择管理门户时，URI 形成如下：

http://<web srvr addr>:<web srvr port>/<csp srvr inst>/csp/sys/UtilHome.csp

        关注FHIR的大侠们估计都注意到了，FHIR更新了它支持的互操作范式，除了消息、文档、服务、API这4种，增加了2个：资源仓库、订阅。前面4个好理解，为什么资源仓库和订阅会成为FHIR的新的互操作范式？互操作与应用集成是什么关系？

        这里借FHIR的新互操作范式，聊聊应用集成，看看集成平台是什么？有什么样的集成方案？以及怎么评价不同的方案。

中文社区的同学们大家好！

如你所知，从2022年9月5日-10月24日（北京时间），我们正在举办🏆InterSystems开发者社区中文版首届技术征文大赛🏆（←点击链接进入参赛页面，浏览所有参赛文章）！

截至目前，我们已收获了20余篇佳作

作为此次大赛重要奖项“专家提名奖”评比的重要部分，我们的专家评审团已组建成团！

第三十九章 连接到远程服务器（一）

可以从 Telnet 会话、Windows 上 IRIS® 启动器上的远程系统访问子菜单或从 服务器和实例信息生成的 URI 控制远程实例。

要为远程实例使用远程系统访问子菜单上的实用程序：

1. 定义远程服务器连接以将服务器添加到首选服务器列表。
2. 单击 IRIS 启动器并指向远程系统访问。
3. 指向启动器实用程序，然后单击服务器名称。

还可以从 会话连接到 的远程实例：

1. 单击 IRIS 启动器并指向远程系统访问。

2. 单击 IRIS Telnet，连接到远程服务器，并使用用户名和密码登录 IRIS 系统。或者，如果服务器在首选服务器列表中，请指向终端，然后单击服务器名称。

可以从 上运行的终端或任何能够运行 的工作站客户端远程登录到任何受支持平台上的 IRIS 实例。此客户端可能只有实用程序，而没有 服务器实例。大多数情况下，客户端计算机上的 版本必须与其管理的 系统的版本相同或更高。

注意：在 macOS 平台上，还可以从 上的命令提示符使用 连接到 机器，然后使用以下命令进行连接：

还可以将 Web 服务器页面与远程 Web 服务器一起使用。这可用于使用管理门户管理 实例。

当连接到远程系统访问菜单上的管理门户或文档选项时，只要远程实例正在运行，就可以为生成的 添加书签并返回到

在数字化转型成为国家战略和国内外科技大厂的成功经验、强大的宣传攻势和推广能力联合左右下，微服务架构（Microservices Architecture，MSA）毫无疑问已经成为当今基础架构的主流话题，短短几年间席卷全行业，仿佛成了每个行业数字化转型的必由之路。

第三十八章 在 UNIX®、Linux 和 macOS 上使用 IRIS（三）

管理 IRIS

在 shell 中，具有 sysmgr 组中任何用户 ID 的用户都可以运行 ，它调用 目录中的 可执行文件和脚本.以下部分描述了如何在 实例上执行这些管理任务：

重要提示：安装的所有者拥有启动和停止实例、执行系统管理以及为该实例运行诊断程序的完全权限。

只有作为实例所有者的用户 ID 才能并且应该运行所有诊断活动。这确保创建的任何文件或资源都归实例所有者所有，而不是 root（这可能使非 用户无法访问这些资源）。因此，不建议 以任何方式管理不属于 的实例（包括启动和停止实例）。以 身份运行的用户应该只管理 拥有的实例。

启动 IRIS

要启动 IRIS，请在系统级别运行启动程序。此过程激活默认配置文件或您指定的配置文件。

注意：如果在启动 时遇到任何问题，请按照“监控指南”的“监控日志文件”部分中的说明查看 文件。

如果不在控制台机器上，请运行 Telnet 并连接到安装了 IRIS 的目标机器。在可以在 上启动 IRIS 之前，必须满足以下条件之一：

• 超级用户。
• 已以 用户身份登录。 （从另一个帐户登录时，可以接受 （超级用户）为 。）
• 组 与在 IRIS 安装期间命名的组匹配，因为它具有停止和启动系统的权限。

使用

第三十章 管理许可（三）

确定许可证容量和使用情况

如何知道已使用了多少许可证以及由谁使用？类中的 %SYSTEM.License 提供了到 IRIS 许可证应用程序编程接口 (API) 的接口，并提供了许多方法和相关查询，可以使用这些方法和相关查询来查询许可证容量和当前使用情况。

可以使用 类的 方法运行多个许可查询。例如：

USER>do ##class(%ResultSet).RunQuery("%SYSTEM.License","Summary")
 
LicenseUnitUse:Local:Distributed:
当前使用的软件许可单元 :2:2:
使用的最大软件许可单元数 :3:2:
授权的软件许可单元 :25:25:
当前连接 :2:2:
最大连接数 :6:6:

可以从管理门户的许可证使用页面（系统操作 > 许可证使用）查看这些查询的输出，详细信息如下表所示：

在虚拟化环境中使用镜像，构成镜像的InterSystems IRIS实例被安装在虚拟主机上，创造了一个混合的高可用性解决方案，将镜像的优点与虚拟化的优点结合起来。镜像通过自动故障切换对计划内或计划外的故障提供即时响应，而虚拟化HA软件在计划外的机器或操作系统故障后自动重新启动承载镜像成员的虚拟机。这允许失败的成员迅速重新加入镜像，充当备份（或在必要时作为主机）。

当镜像被配置在虚拟化环境中时，请参考以下建议：

• 故障转移成员的虚拟主机和备机不可以配置在同一台物理机上。

• 为了避免单点存储故障，故障转移成员上的InterSystems IRIS实例所使用的存储应永久隔离在不同磁盘组或存储阵列的独立数据存储中。

• 在虚拟化平台层面上进行的一些操作，如备份或迁移，可能会导致故障转移成员长时间没有反应，从而导致不需要的故障转移或不理想的警报频率。为了解决这个问题，你可以增加QoS超时设置。

• 在进行导致故障转移成员连接中断的计划性维护操作时，你可以暂时停止备份上的镜像，以避免不必要的故障转移和警报。

• 在镜像成员上必须非常谨慎地使用快照管理，因为将一个成员恢复到早期的快照，既会删除该成员的最新状态（例如，自拍摄快照以来，该成员可能已经从主机变为备机），也会删除其他成员仍然拥有的日志数据。

1. VMWare快照引起的网络中断导致非计划内主备机切换问题

1.1 问题描述

在创建虚拟机快照时，虚拟机需要短时间的冻结，这个短时间冻结通常指虚拟机静默，在静默过程中网络连接处于中断状态。由于数据库的不断增长，使用VMWare快照的方式对虚拟机进行备份的时长也会不断增加，当对虚拟机进行快照的时长长于InterSystems镜像服务质量 (QoS) 超时时间，即当主机网络中断超过QoS超时时间，仲裁机与备机观察并相互确认与主机的连接丢失后，将发起切换过程，使原备机成为主机并将虚拟IP从主机MAC地址解绑后重绑定到备机的MAC地址上。特别需要注意的是，在这种由于网络中断引起的切换中，仲裁与备机都无法得知主机的实际工作状态。因此，在主机网络连接恢复后，为了为了避免因切换期间主机还在处理数据导致主备机间数据不一致，备机主动发起请求让主机下线，关闭主机，此时主机状态显示为关闭（Down）。

1.

第三十七章 在 UNIX®、Linux 和 macOS 上使用 IRIS（二）

在 UNIX® 上启动

IRIS 实例使用以下资源来控制启动、停止和创建新进程：

• install-dir\mgr 目录中的 iris.ids 文件。
• 共享内存。

守护进程资源锁

IRIS 使用建议文件锁定来防止同一实例在不同机器上的多次启动。使用咨询文件锁定，单个锁定文件（在本例中为 目录中的文件 ilock）可用于独占锁定多个资源。控制进程、写入守护进程和日志守护进程分别锁定锁定文件的一个单独部分。如果 文件的这一部分已被锁定，则启动将终止。不同守护进程持有的锁称为守护进程资源锁。

文件锁由进程持有，直到进程终止。因此，如果持有任何锁，则表明某个节点上的某个守护进程正在运行。但是，它并不表示实例是否健康并正常运行。

iris.ids File

文件包含启动 的节点的名称。 iris.ids 文件的存在充当 实用程序和客户编写的脚本的标志，指示实例是否启动并运行。该文件在启动过程中经常被忽略。但是，如果在读取 时发生错误，则会阻止 启动。在以前版本的 中，共享内存标识符也存储在 文件中，但现在不再如此。

启动顺序

为了更好地理解启动顺序，假设实例可以从两 (2) 个不同的节点（机器），节点 和节点 运行。

请教一下，如何在消息查看器打开”显示查询“这个按钮的显示开关

开发者社区的同学们，大家好！

在 之前的公告 中，我们向大家介绍了InterSystems官方反馈门户 InterSystems Ideas! 今天想给大家介绍更多，尤其是涉及到的主题。

你可以按以下主题类别提交你的想法:

开发者社区的同学们，大家好！

我们一直以来都有一个想法——改进收集、分析和回应开发者社区成员们的产品改进请求的过程。我们知道，我们需要一个良好的用户体验，甚至更好的内部流程，来确保收集、听取和响应最好的想法。现在，这个想法终于实现了！

我们在此向您介绍 InterSystems官方反馈门户

💡 >> InterSystems Ideas << 💡

第三十六章 在 UNIX®、Linux 和 macOS 上使用 IRIS（一）

本章介绍Unix®、Linux和MacOS上的特定管理程序。

用户、组和权限

平台上的每个 IRIS® 数据平台安装都有以下用户和组：

• Root — IRIS 必须由 root 安装， 系统守护程序的某些处理以 身份运行。
• 实例所有者 — 此用户拥有大多数安装文件并完全控制实例。如果使用最小初始安全设置进行安装，则 是默认所有者；否则，在安装过程中会提示输入所有者。
• 超级服务器及其作业的有效用户——所有由超级服务器生成的用于处理传入请求的 进程都以此用户身份运行；此外，由作业服务器进程、任务管理器作业和用户定义的启动例程（例如，^%ZSTART）托管的作业也以该用户身份运行。默认情况下，此用户是 ，但可以在自定义安装期间更改用户。
• 进程的有效组——所有 进程自动作为该组运行，这允许普通用户在 IRIS 内访问他们可能没有被授予访问权限的 数据库和日志文件；这些和其他 文件的文件权限设置为允许该组具有适当的访问权限。在安全系统上，只有 超级服务器及其作业的有效用户应该是该组的成员。默认情况下，该组包含 ，但您可以在自定义安装期间更改该组。
• 允许启动和停止实例的组 — 该组、 和实例所有者可以启动和停止 。

所有日志和日志目录必须将组所有权设置为

       这是一篇笔记:

说明

       Restful是一种基于Http的网络应用程序的设计风格和开发方式，可以使用xml格式或者Json格式定义。

RESTFUL特点包括：

1、每一个URI代表1种资源；

2、客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源；

3、通过操作资源的表现形式来操作资源；

4、资源的表现形式是XML或者HTML；

5、客户端与服务端之间的交互在请求之间是无状态的，从客户端到服务端的每个请求都必须包含理解请求所必需的信息。

IRIS中实现

GET：

XData UrlMap [ XMLNamespace = "http://www.intersystems.com/urlmap"

在更新医保码库前，我们想对旧码库做个备份，以防更新过程失败，还可以还原。
oracle支持 CREATE TABLE AS ..... 的语法快速备份一张表，cache 似乎不支持这个语法，
大家平时是怎么备份一张码表的呢？

最好是像 oracle 那样一条命令搞定的那种。

第三十五章 在 Windows 上使用 IRIS（二）

IRIS 启动器

Microsoft Windows 平台上的主要IRIS 界面是 IRIS 启动器。从 启动器，可以启动所有 配置和管理工具。还可以从快捷方式或命令行调用每个启动器命令。

相应地，可以从 程序菜单中启动许多 工具，方法是指向 IRIS 文件夹，然后指向启动 以获得适当的 实例名称。

当在基于 的系统上启动 时， IRIS 启动器图标会出现在任务栏的系统托盘中。

当单击 启动器时，会出现一个菜单，其中包含使用 实用程序和编程环境的命令。

下表描述了 IRIS 启动器菜单中可用的命令。

好消息， InterSystems 容器镜像仓库Docker桌面扩展已正式发布供大家 下载 .

大家可以在Docker桌面版的marketplace 下载.下载后需要重启 Docker Desktop to 

把数据库添加进Mirror

以往的经验里， 用户在把数据库添加到镜像时遇到过各种各样的问题，以致必须请求外部帮助才能解决。除了步骤本身比较繁琐，很大的原因是阅读文档不细致。还有一个，就是对英文水平不太高的用户，有些英文句式并不是很好懂，比如说，文档中有这一句其实非常关键：

If you attempt to add a new database to the mirror on a nonprimary member that was not created as a mirrored database on the primary, but rather added to the mirror after it was created, an error message notes this and you cannot complete the operation.

我用最好的翻译器DeepL翻译后的中文是：

如果你试图在一个非主要成员上向镜像添加一个新的数据库，而这个数据库并不是在主要成员上作为镜像数据库创建的，而是在创建后添加到镜像中的，那么就会出现错误信息提示，你无法完成操作。

Mirror的配置

这里详细介绍了主成员(Primary)和备用成员(Backup)的设置过程。 虽然也包括了异步成员配置的章节，其实我没有真的操作，我认为应该没有特别需要注意的。

配置Mirror应该有这么几步：

1. 启动Mirror服务

进入系统管理界面，选择系统管理>配置>镜像设置>启动镜像服务，勾选服务已启动， 保存退出。这是可以看到菜单栏的创建镜像条目已经从灰色变成正常的白色，表示您已经可以创建镜像。

仅仅是打开服务，并没有修改Journal文件

2. 创建镜像，添加主成员

在管理界面进入“系统>配置>镜像设置>创建镜像”，从这里开始镜像的创建工作。创建镜像的同时，这一步还包括把本机做为第一个镜像成员加入到镜像。第一个镜像成员被加入后会成为主镜像成员， 菜单里的英文是“Primary Failover Member"。

Warning: 如果本机的ISCAgent没有启动, 您会得到提示“错误 #2118: ISCAgent不在本地系统中启动”。另外，特殊情况下，您还可能会碰到错误提示：“错误 #2136: 实例的版本高于ISCAgent的版本”。

镜像的设置

如下面的截图，创建镜像需要提供这些配置信息：

• 镜像名称：可以是任意的名称, 和各个服务器/成员的名称无关。

• 需要SSL/TLS：如果您不勾选此选项，会得到“强烈建议使用SSL/TLS"的提示信息。

因为篇幅太长， 我把它分为3篇贴在社区

配置前的准备

配置Mirror前要准备三件事儿：

1. 规划网络连接。
2. 在所有的服务器中启动ISCAgent服务。
3. 准备服务器的SSL/TLS证书。可选， 但非常推荐。

我假设您在动手前一定已经对Mirror的原理和架构已经不陌生了，对镜像成员，DR(灾备)成员, Arbiter, ISCAgent等术语已经自动切换的概念有大概的认识。如果不是这样，请先阅读在线文档，或者这篇文章。

规划网络连接

Mirror应该配置两个网段：一个用于IRIS和外部的通信；另一个用于两个Mirror成员间的内部通信，也就是数据的同步。 尽管不是必须的，但Mirror作为一个高可用方案，为了保证服务器之间的内部通信不受和外部连接的干扰，把内部通信放在单独的网段是通常的做法，尤其是在生产环境。

下图来自IRIS的在线文档：其中绿色所示的是IRIS提供服务的网段，IRIS到所有外部系统的连接，ECP应用服务器，和Arbiter在工作在这个网段。紫色的“Data Center Private LAN for Mirror Communication"用于内部通信，准确的说， 用于journal的同步。为了方便， 我会在后面的步骤中简单的把这两个网段简单的称为外网网段和内网网段。

也是来自在线文档，上图的IP地址配置像这个样子。

第三十四章 在 Windows 上使用 IRIS（一）

在 Microsoft Windows 平台上管理 IRIS 数据平台实例非常简单。可以使用管理门户和 IRIS 启动器执行大多数任务。还可以从命令提示符控制 实例。

本主题使用 来指代 安装目录——可以在安装指南的默认安装目录部分找到默认目录。

注意：不要对 IRIS IRIS.DAT 数据库文件使用 Windows 文件压缩。 （通过右键单击 Windows 资源管理器中的文件或文件夹并选择属性，然后选择高级，然后压缩内容以节省磁盘空间来压缩文件；压缩后，文件夹名称或文件名在 资源管理器中呈现为蓝色。）如果压缩一个 文件，它所属的实例将无法启动，并出现误导性错误。

管理对 实例的访问

InterSystems 服务

所有 IRIS job和进程都从 服务、 运行。 服务具有的权限由其关联的 用户帐户决定。当这是本地 SYSTEM 帐户时， 可以访问 系统上的所有文件和权限。为了维护一个更安全和限制性更强的环境，应该为服务选择一个仅具有所需权限和访问权限的 帐户。

在正常安装和锁定安装中， 创建两个本地用户组来授予对实例的访问权限。当为 服务指定一个 Windows 用户帐户而不是默认的本地 帐户时 将该 用户帐户添加到每个组。这些组是：

• ，它授予启动、停止和控制 IRIS

此篇文章给大家介绍一个使用pyodbc连接到 InterSystems IRIS数据库的示例，详情如下：

InterSystems IRIS 安装在Redhat 操作系统中，使用pyodbc在Mac操作系统中连接到Redhat 操作系统中InterSystems IRIS数据库。

1. 下载测试代码
2. 使用vscode打开测试代码，并在Solutions文件夹下安装pyodbc
   

   pip install pyodbc

3. 在Mac操作系统中安装ODBC驱动
   

   brew update
   brew install unixodbc

4. 安装后，查看Mac操作系统中的odbcinst.ini文件，此时odbcinst.ini文件应该是空的。
5. Mac操作系统中/usr/local/bin下使用下列命令注册驱动 或者 配置DSN
   
   • 注册ODBC驱动

   odbcinst -i -d -f   pyodbc_wheel/mac/odbcinst.ini

   • 配置本地DSN

   pyodbc_wheel/mac/odbcinst.iniodbcinst -i -s -h -f odbc.ini_unixODBCtemplate

   • 配置系统DSN

   odbcinst -i -s -l -f pyodbc_wheel/mac/odbcinst.ini

连接前准备：

1. Python 开发环境
2. DB-API驱动：irispython wheel 文件
3. Connection String

步骤：

1. 安装irispython wheel 文件
   

   pip install intersystems_irispython-3.2.0-py3-none-any.whl

2. Connection String：其中import iris 用来导入iris， connection = iris.connect是connection string。connection.close()用来断开连接。
   

   import iris
   
   def main():
      connection_string = "localhost:1972/USER"
      username = "SQLAdmin"
      password = "deployment-password"
   
      connection = iris.connect(connection_string, username, password)
   
      # when finished, use the line below to close the connection
      # connection.close()
   
   if __name__ == "__main__":
      main()

连接前准备：

1. .Net 开发环境
2. InterSystems IRIS 客户端组件:InterSystems.Data.IRISClient.dll，这个dll文件可以再IRIS安装包中找到，在IRIS/dev/dotnet/bin/version
3. Connection String

步骤：

1. 在.Net 开发环境中，配置客户端组件InterSystems.Data.IRISClient.dll作为一个dependency 
2. Connection String：其中using InterSystems.Data.IRISClient 用来导入需要使用的dll文件，string connectionString = "Server = localhost; Port = 1972; Namespace = User; User ID = SQLAdmin; Password = deployment-password"是connection string。
   

   using System;
   using InterSystems.Data.IRISClient;
   
   namespace ADODemo
   {
      internal class Program
     {
          static void Main(string[] args)
         {
              string connectionString = "Server = localhost; Port = 1972; Namespace = User; User ID = SQLAdmin; Password = deployment-password";
              IRISADOConnection connection = new IRISADOConnection(connectionString);
              connection.Open();
              // when finished, use the line below to close the connection
              // connection.Close();
         }
     }
   }

连接前准备：

1. C++ 开发环境
2. InterSystems ODBC 驱动 （ODBC 驱动会随InterSystems IRIS安装包自动安装在服务器中）
3. Connection String

步骤：

1. Connection String：其中#include 用来导入需要使用的libraries，"Driver=InterSystems IRIS ODBC35;Host=localhost;Port=1972;Database=USER;UID=SQLAdmin;PWD=deployment-password;\0";是connection string。
   

   #ifdef WIN32
   #include <windows.h>
   #endif
   #include <sqlext.h>
   #ifdef UNICODE
   #include <sqlucode.h>
   #endif
   #include <stdio.h>
   
   int main()
   {
              RETCODE rc;                                        /* Return code for ODBC functions */
              HENV henv = NULL;                  /* Environment handle */
              HDBC hdbc = NULL;                 /* Connection handle */
              unsigned char szOutConn[600];
              SQLSMALLINT *cbOutConn = 0;
              
              SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
              SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER*)SQL_OV_ODBC3, 0);
              SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);
              
              char connect_cmd[255] = "Driver=InterSystems IRIS ODBC35;Host=localhost;Port=1972;Database=USER;UID=SQLAdmin;PWD=deployment-password;\0";
              rc = SQLDriverConnect(hdbc, NULL, (SQLCHAR*) connect_cmd, SQL_NTS, szOutConn, 600, cbOutConn, SQL_DRIVER_COMPLETE);
   
              if (rc == SQL_SUCCESS)
             {
                          printf("Successfully connected!!\n");
             }
              else
             {
                          printf("Failed to connect to IRIS\n");
                          exit(1);
             }          
   
              SQLDisconnect(hdbc);
              SQLFreeHandle(SQL_HANDLE_DBC, hdbc);      /* Free connection handle */
              SQLFreeHandle(SQL_HANDLE_ENV, henv);      /* Free environment handle */
              
              return 0;
   }

连接前准备：

1. Java 开发环境
2. InterSystems JDBC 驱动
3. Connection String

步骤：

1. 配置 Classpath ：指向InterSystems JDBC 驱动 - intersystems-jdbc-3.0.0.0.jar
2. Connection String，其中import com.intersystems.jdbc*;用来导入驱动，User是命名空间名称。
   

   import com.intersystems.jdbc*;
   import java.sql.Connection;
   public class JDBCConnection{
   public static void main (String[] args) throws Exception {
   String dbUrl = "jdbc:IRIS://127.0.0.1:1972/User"; //replace
   String user = "SQLAdmin";
   String pass = "deployment-password";
   
   IRISDataSource ds = new IRISDataSource();
   ds.setURL(dbUrl);
   ds.setUser(user);
   ds.setPassword(pass);
   Connection dbconnection = ds.getConnection();
   System.out.println("Connected to InterSystems IRIS via JDBC.");
         }
   }