技术文档 — Quarkus IRIS Monitor System

1. 目的与范围

此模块支持在基于 Quarkus 的 Java 应用程序与 InterSystems IRIS 的原生性能监控功能之间进行集成。
它使开发者可以通过 @PerfmonReport 对方法添加注释，这样可以在执行方法时自动触发 IRIS 的 ^PERFMON 例程，以生成性能报告，而无需人工干预。

2. 系统组件

2.1 注释：@PerfmonReport

• 定义为 CDI InterceptorBinding。
• 可应用于方法或类。
• 指示使用 IRIS 监控逻辑包装方法执行的框架。

2.2 拦截器：PerfmonReportInterceptor

• 拦截对带注释的方法的调用。

• 执行流程：

  1. 记录启动事件 (LOG.infof("INIT: …"))
  2. 调用 monitorSystem.startPerfmon()
  3. 继续执行 context.proceed()
  4. 在 finally 块中：
     • 调用 monitorSystem.generateReportPerfmon(...)
     • 调用 monitorSystem.stopPerfmon()
     • 记录结束事件及执行时间

• 确保即使抛出异常，监控也始终结束。

2.3 DAO Bean：MonitorSystem

提示：本文包含在Java中通过JDBC Driver对Caché/IRIS数据库进行查询的示例代码。

近期有客户反应使用Java从老版本Caché中读取数据时，如果数据中包含long varchar, Caché数据库中与之对应的属性类型为%Stream.GlobalCharacter，即使实际上该流数据长度非常小，也会成十几倍的降低性能。

大家先来看一段代码, 

第二十七章 S 开头的术语

存储接口 (storage interface)

对象（Objects）

使用自定义存储或编写自己的存储类时必须实现的一组方法。

存储策略 (storage strategy)

对象（Objects）

类使用的存储策略在编译时评估为存储定义，决定数据的存储方式。

存储过程 (stored procedure)

SQL

存储过程允许你从 ODBC 或 JDBC 执行查询或类方法。

流接口 (stream interface)

对象（Objects）

IRIS 流接口用于在 ObjectScript、SQL 和 Java 中操作流。

流 (stream)

对象（Objects）

流提供了一个接口，用于操作和存储大量数据。IRIS 流接口可在 ObjectScript、SQL 和 Java 中用于操作流。

超级服务器 (superserver)

系统

监听指定端口的服务器，用于接收对 IRIS 的传入连接并将其分发到适当的子系统。默认的超级服务器端口是 1972；如果 1972 不可用，超级服务器将从 51773 开始监听下一个可用端口。要设置超级服务器端口号，请使用管理门户（系统管理 > 配置 > 系统配置 > 内存和启动）中的内存和启动页面的超级服务器端口号字段。

滑动 (swizzling)

对象（Objects）

当嵌入和持久对象被引用时，自动将其拉入内存的过程。也称为懒加载。

IRIS通过JDBC连接第三方数据库汉字查询乱码，第三方反馈需要设置字符集，不知字符集该如何设置

如今，关于大语言模型、人工智能等的消息不绝于耳。向量数据库是其中的一部分，并且已经有非IRIS的技术实现了向量数据库。

为什么是向量？

• 相似性搜索：向量可以进行高效的相似性搜索，例如在数据集中查找最相似的项目或文档。传统的关系数据库是为精确匹配搜索而设计的，不适合图像或文本相似性搜索等任务。
• 灵活性：向量表示形式用途广泛，可以从各种数据类型派生，例如文本（通过 Word2Vec、BERT 等嵌入）、图像（通过深度学习模型）等。
• 跨模态搜索：向量可以跨不同数据模态进行搜索。例如，给定图像的向量表示，人们可以在多模式数据库中搜索相似的图像或相关文本。

还有许多其他原因。

因此，对于这次 pyhon 竞赛，我决定尝试实现这种支持。不幸的是我没能及时完成它，下面我将解释原因。

WIN SQL是大多数用户使用的普通编辑器。但是我们不能使用winsql下载大量数据。所以我写了一个教程如何连接一个新的基于 Java 的编辑器，叫做 Squirrel SQL，它可以很容易地下载或导出 excel 或任何其他格式的数据。我还包括一个 Java JCBC 连接程序来连接 IRIS 数据库，尤其是镜像/故障转移服务器。

基于 SQL Java 的编辑器导出大量数据和用于 IRIS 连接的 Java JDBC 程序

基于 SQL Java 的编辑器导出大量数据

WinSql 是通常用于从 Iris 数据库中提取数据的编辑器，但是，如果没有许可的 winsql，则无法导出大量数据。

解决方案是使用基于 java 的编辑器，称为 Squirrel SQL。这是一个基于 java 的编辑器，您可以在从 IRIS 数据库执行 fetch 从编辑器中导出大量数据。这是用 Java 构建的开源 SQL 客户端，它使用 JDBC 连接到 IRIS 数据库。

Squirrel SQL 的特点

• Java 19 兼容性
• 多个插入符/光标编辑
• 全局首选项和新会话属性搜索
• Saved Sessions 的多项改进（用于保存和恢复 Session 的所有 SQL 编辑器的特性）
• 可配置的鼠标右键菜单
• 重新设计的添加/编辑 JDBC 驱动程序对话框

安装 Squirrel SQL 的步骤

SSH框架是Java一个的比较有代表性的框架，是多年前比较流行的一个。有struts+spring+hibernate和springMVC+spring+hibernate两种，当然我大学时候使用的是第二种。倘使我能把IRIS作为一个库，联结到Hibernate那么理论上是不是也代表IRIS也可以使用SSH框架开发呢？

工具及环境

JDK 1.8

       Maven

       Hibernate 5.X.X

       IRISHealth-2022.1.3

       intellij idea

       Windows 10 64位

1、创建数据库

       用代码的方式创建几个表

如图所示：

2、创建一个Spring的项目

       File—New—Project....

next

给项目起名，选择jdk版本

Next

本篇文章使用的InterSystems IRIS for Windows (x86-64) 2021.1 (Build 215U) Wed Jun 9 2021 09:39:22 EDT

Mysql ODBC 和 JDBC 驱动版本：8.0.28

使用ODBC 网关连接mysql

连接前准备：

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

步骤：

Production是指Ensemble/HealthShare Health Connect/IRIS/IRIS for Health产品中提供的互操作功能模块，更多关于Production介绍，可参见在线文档，
https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=AFL_productions#AFL_productions_quicklook

Production中访问外部数据库常用的适配器Adapter有两个，一个是用于Business Service中的Enslib.SQL.InboundAdapter，另一个是用于Business Operation中的Enslib.SQL.OutboundAdapter,
更多关于这两个Adapter的使用说明可以参见在线文档"Using SQL Adapters in Productions",

本文主要涵盖以下内容

1. 基本配置步骤（仅涉及与JDBC连接相关配置）
2. JDBC Gateway和Java Gateway Service的区别
3. 常见的问题类型
4. 常用基本故障排查

基本配置步骤

问题： 通过JDBC连接Oracle19C数据报错 "ORA-28040: No matching authentication protocal"

解决 : 1、在数据库服务器上找到sqlnet.ora文件，一般在oracle安装目录app/oracle/product/19.0.0.0/db_1/network/admin/sqlnet.ora

2、如果有进行修改，没有直接创建

3、slqnet.ora文件新增或修改以下 SQLNET.ALLOWED_LOGON_VERSION_SERVER=8 SQLNET.ALLOWED_LOGON_VERSION_CLIENT=8

4、注意事项： ① 如果没有sqlnet.ora文件可以直接创建 vi sqlnet.ora ② 如果有不能直接vi 需要使sed -a 命令追加，否则会导致ora文件乱码 ③ 添加参数后新无需重启数据库或者监听，但是需要修改用户密码，否则会报错

5、修改用户名密码

sqlplus / as sysdba

alter user 用户名 identified by 新密码;

主要问题： 默认安装后，有没有默认用户名，密码？远程jdbc连接报错，麻烦解答一下，谢谢 [InterSystems IRIS JDBC] Communication link failure: Access Denied [08S01][461] Access Denied

创建用户： addgroup iris useradd -g iris -d "/home/iris" -m -s "/bin/bash" iris passwd iris

安装过程： root@baec-ThinkPad-E480:/data/IRIS_Community-2021.2.0.651.0-lnxubuntu1804x64# ./irisinstall

Your system type is 'Ubuntu LTS (x64)'.

Enter instance name <IRIS>: IRIS

Enter a destination directory for the new instance. Directory: /data

Everyone

There is a setQueryTimeout method in the% Net.Remote.Java.JDBCGateway class of IRIS, how to use Ensemble2016 to achieve this function?

我使用例如select $ZVERSION sql语句在浏览器的sql查询中可以查到版本信息，但是放到jdbc程序中查询显示查询结果为0,不知道什么原因，要怎么才能查到这些信息呢，最好是通过java程序的方式

请问有没有第三方java库能够调用类似 ##class(%SYSTEM.Version).GetVersion()这种方法，或者通过sql语句能够调用这种类方法吗

利用Intersystems IRIS医疗版数据平台内置多模型整合

医院信息查询业务解决方案

概述：

随着医院信息化建设的逐步完善，医院子系统越来越多，系统间接口越来越多，同时接口费用不断增加，管理工作变得越来越复杂。其中，查询类业务接口根据业务类型分化，数量也是逐步递增，带来接口量大、开发工作繁重、代码冗余、维护困难等等问题。针对这一困境，我们利用Intersystems IRIS数据平台内置多模型整合医院信息查询业务解决方案。该应用程序可通过内置模型应用完成查询业务，大大缩小开发、维护、实施等项目关键运转周期。

应用链接：HealthInfoQueryLayer           

关键应用：IRIS for Health、REST API、ObjectScript、Globals 、SQL、DATA LOOKUP TABLES

应用程序采用模型及应用介绍：

1.采用模型

1.1. Globals (key-value)

Globals是可以在IRIS数据库中存储和管理的稀疏多维数组。您可以使用ObjectScript和本机API处理Globals。

工具:

https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=GGBL_MANAGING

应用：

关键字：Python，JDBC，SQL，IRIS，Jupyter Notebook，Pandas，Numpy ，机器学习 

1. 目的

这是一个用于演示的 5 分钟快速笔记，通过 Jupyter Notebook 中的 Python 3 调用 IRIS JDBC 驱动程序，以经由 SQL 语法从 IRIS 数据库实例读取数据和向 IRIS 数据库实例写入数据。 

去年，我发表了关于将 Python 绑定到 Cache 数据库的简要笔记（第 4.7 节）。 如何使用 Python 挂入 IRIS 数据库以将其数据读入 Pandas 数据框和 NumPy 数组进行常规分析，然后再将一些经过预处理或标准化的数据写回 IRIS 中，准备进一步用于 ML/DL 管道，现在可能是时候回顾一些选项和讨论了。

一些立即浮现的快速选项：

1.    ODBC：Python 3 和原生 SQL 的 PyODBC？
2.    JDBC：Pyhton 3 和原生 SQL 的 JayDeBeApi？
3.    Spark：PySpark 和 SQL？
4.    Python Native API for IRIS：超越先前的 Python Binding for Cache？
5.   ** IPtyhon Magic SQL %%sql**?  它可以支持 IRIS 了吗？

 这里有漏掉其他选项吗？  我有兴趣尝试任何选项。 

2. 范围 

使用SQLServer2008进行网关连接，驱动名，URL和jar包地址都正确，出现服务器版本不支持的问题

JDBC 兼容性状态 **这是一篇  [InterSystems 常见问题解答网站](https://faq.intersystems.co.jp/)文章。   

版本 2009.1 及更高版本与 JDBC 4.0 API 兼容。 有关详细信息，请查阅以下文档。 [关于 JDBC 支持](First Look: JDBC and InterSystems Databases - InterSystems IRIS Data Platform 2020.3
)

跨行业用例大多要求具备每秒接收数千或数百万条记录的能力，同时能够支持实时同步查询，例如：股票交易处理、欺诈检测、物联网应用（包括异常检测和实时OEE监控）等。Gartner将这种能力称为“HTAP”（混合事务分析处理）。Forrester等其他公司将其称为Translytics。InterSystems IRIS是功能强大、可扩展、高性能、资源高效的事务分析型数据平台，同时具备内存数据库的高性能以及传统数据库的一致性、可用性、可靠性以及低成本的特性。