SqlDbx是我们常用的数据库查询与操作工具，因其轻量且无须安装而无处不在，然而习惯了在Intersystems的CACHE和ENSEMBLE版本下使用SqlDbx在升级到IRIS版本后却无法使用了，为此进行了一系列尝试，并最终获得成功，形成本文攻略，分享给大家。

1、在SqlDbx的连接登录窗口，从DBMS Type中直接选择 “InterSystems CACHE”连接IRIS会报错，提示“通过IRISconnect失败”，说明“InterSystems CACHE”不再适用于IRIS。

2、考虑IRIS的ODBC支持，为此换一种思路，采用ODBC方式连接，此方式需要在ODBC中建立DSN。

3、从Intersystems官网https://intersystems-community.github.io/iris-driver-distribution/或github网站https://github.com/intersystems-community/iris-driver-distribution/tree/...下载InterSystems IRIS ODBC 32位驱动，注意一定要下载32位驱动（注：SqlDbx现只支持32位的ODBC）。

第十四章 SQL窗口函数概述（一）

指定用于计算聚合和排名的每行“窗口框架”的函数。

窗口函数和聚合函数

在应用WHERE、GROUP by和HAVING子句之后，窗口函数对查询选择的行进行操作。

窗口函数将一组行中的一个(或多个)字段的值组合在一起，并在结果集中为生成的列中的每一行返回一个值。

虽然窗口函数与聚合函数类似，因为它们将多行结果组合在一起，但它们与聚合函数的不同之处在于，它们本身并不组合行。

窗函数的语法

窗口函数被指定为查询中的选择项。 窗口函数也可以在查询的子句中指定。

窗口函数执行与由子句、子句和ROWS子句指定的逐行窗口相关的任务，并为每一行返回一个值。 这三个子句都是可选的，但是如果指定了，必须按照以下语法中的顺序指定:

window-function() OVER (
                      [ PARTITION BY partfield ]
                      [ ORDER BY orderfield ]
                      [ ROWS framestart ] | [ ROWS BETWEEN framestart AND frameend ]
                      )

        安装InterSystems IRIS数据库的ODBC驱动，在Windows系统中配置数据源后，可以使用Microsoft Visual Studio 开发工具 中的服务器资源管理器很方便地连接到InterSystems IRIS数据库服务器，利用数据库连接的可视化视图，可以非常方便快捷地进行连接到InterSystems IRIS数据库的应用开发。本文将展示一个利用以上方式实现的例子，开发工具为Microsoft Visual Studio 2019，开发语言为C#，10分钟快速开发实现一个连接到InterSystems IRIS数据库的C#应用，在本例子中，可以通过选择日期和科室，查询指定日期和科室的就诊日志。

1、在成功安装InterSystems IRIS数据库的ODBC驱动后，从Windows的“控制面板”中选择“管理工具”，在“管理工具”中选择“ODBC数据源”。

2、在ODBC数据源管理的“用户DSN”标签下，选择“添加”，在随后弹出的“创建新数据源”窗口中选择“InterSystems ODBC”，点击“完成”进入下一步。

3、在弹出的“InterSystems ODBC数据源设置”窗口中，为数据源命名，填写连接数据库的信息，访问用户名和密码，点击“测试连接”，成功后点击“OK”保存。

背景

Cache起源于没有SQL的1970时代，当时各种高级计算机语言才刚刚诞生，其中M语言较为独特，它的诞生就是为了在没有操作系统的机器上，进行数据存储。别忘了，Unix在1971年才发布。M语言别具一格地采用了Global多维数组，统一了复杂的内存操作和文件读写，使之成为了1970年代数据库的事实标准，特别是在医疗行业。而后Intersystems在1978年接过M语言的旗帜，在M语言上添加了SQL兼容层和ObjectScript层，前者顺应了时代的潮流，后者不仅为M语言提供了强大的OOP和各种便捷的语法糖，还让数据能以对象形式进行访问，让数据和代码更加紧密。

本文将简述多维数组、SQL、对象这3种数据操作方式，提供实例代码片段，并在运行效率、开发效率、管理效率、实用性方面讨论它们的优缺点。 为方便讨论，以学校与学生为例。对每种操作方法，都列举3种典型的用例，分别为，访问某特定ID的学生（即数据库ID索引）、访问某特定studentID的学生（即遍历唯一索引）、和访问某学校的所有人（即遍历非唯一索引）。

第二十章 SQL命令 CREATE TABLE AS SELECT

将现有表中的列定义和列数据复制到新表中。

大纲

CREATE TABLE table-name AS query [shard-key] [WITH table-option]

参数

• table-name 要创建的表的名称，指定为有效标识符。表名可以是限定的(schema.table)，也可以是非限定的(Table)。未限定的表名采用缺省模式名。
• 为新表提供列定义和列数据的查询。此查询可以指定表、视图或多个联接的表。
• shard-key - 可选-切片键定义，由切片键本身或后跟附加切片键定义语法组成。
• - 可选-一个或多个表选项的逗号分隔列表，如%CLASSPARAMETER关键字后跟名称和关联的文字，或STORAGETYPE=ROW或。

描述

命令通过复制查询中指定的现有表(或多个表)中的列定义和列数据来创建新表。查询可以指定表或视图的任意组合。

注：现有表定义。使用命令指定新的表定义。

还可以使用QueryToTable()方法调用复制表操作:

复制数据定义

• 从查询表复制列定义。要重命名复制的列，请在查询中指定列别名。

如果查询指定联接的表，可以从多个表复制列定义。

• 始终将RowID定义为隐藏。
  • 如果源表具有隐藏的RowID，则CREATE TABLE AS SELECT

在使用xDBC连接到字符集为US7ASCII的Oracle数据库时，大家可能遇到过中文的乱码问题，尤其是使用Oracle自己的xDBC驱动的时候。

字符集为US7ASCII的Oracle数据库虽然可以保存中文数据，但给客户端带来了很多麻烦，需要对获取和提交的数据进行转码。

在Ensemble/Health Connect/InterSystems IRIS 中使用SQL适配器连接到这样的Oracle数据库时，可以使用$ZCVT函数进行转码。

1. $ZCVT函数

$ZCVT函数是广泛使用的字符串转换函数，可以做大小写转换、编码转换、URL 和 URI 转换等。我们用其编码转换能力来解决字符集转码问题。

2. 获取的SQL结果集数据有中文时

这时，Oracle的驱动返回的中文数据通常是GB码，而不是Unicode或UTF码。可以通过$ZCVT函数对GB码的数据进行转码，转换为Unicode：

Set tCorrectData = $ZCVT(tOriginalData,"I","GB18030")

其中$ZCVT函数的第一个参数tOriginalData是获取到到结果集字段值；第二个参数“I”说明tOriginalData是输入字符串；第三个参数“GB18030”是说明输入字符串的字符集编码是GB18030。

最近我一直在发布对 JSON 功能的一些更新，我很高兴许多人提供了反馈。 今天，我想将重点放在另一个方面：使用 SQL 查询生成 JSON。

第十四章 使用SQL Shell界面（一）

执行SQL的其他方式

可以使用$SYSTEM.SQL.Execute() 方法从Terminal命令行执行一行SQL代码，而无需调用SQL Shell。以下示例显示如何在终端提示下使用此方法：

DHC-APP>SET result=$SYSTEM.SQL.Execute("SELECT TOP 5 name,dob,ssn FROM Sample.Person")
 
DHC-APP>DO result.%Display()
Name    DOB     SSN
yaoxin  54536   111-11-1117
xiaoli          111-11-1111
姚鑫    63189   111-11-1112
姚鑫    63189   111-11-1113
姚鑫    50066   111-11-1114
 
5 Rows(s) Affected

如果SQL语句包含错误，则Execute（）方法成功完成；否则，该方法无效。 ％Display（）方法返回错误信息，例如：

USER>DO result.%Display()

[SQLCODE: <-29>:<Field not found in the applicable tables>]
[%msg: < Field 'GAME' not found in the applicable tables^ SELECT TOP ? game ,>]
0 Rows Affected
USER>

1.Caché数据库有没有办法配置然后用sql读取数据库实时变化的数据，类似于mssql那样？我看了可以写类去读取global获取journal的值，但是怎么用sql读呢？

2.不行的话，那用什么方式可以读取到journal日志文件，并输出日志文件的内容？

先谢谢大家了！！！

第十八章 定义和使用存储过程

本章介绍如何在IntersystemsIRIS®数据平台上定义和使用Intersystems SQL中的存储过程。它讨论了以下内容：

• 存储过程类型的概述
• 如何定义存储过程
• 如何使用存储过程如
• 何列出存储过程及其参数。

概述

SQL例程是可执行的代码单元，可以由SQL查询处理器调用。 SQL例程有两种类型：功能和存储过程。从支持FunctionName（）语法的任何SQL语句中调用函数。存储过程只能由CALL语句调用。函数接受某些输入定向参数并返回单个结果值。存储过程接受某些输入，输入输出和输出参数。存储过程可以是用户定义的函数，返回单个值。 CALL语句也可以调用函数。

与大多数关系数据库系统一样，Intersystems Iris允许创建SQL存储过程。存储过程（SP）提供存储在数据库中的可调用可调用的程序，并且可以在SQL上下文中调用（例如，通过使用呼叫语句或通过ODBC或JDBC）。

与关系数据库不同，Intersystems Iris使可以将存储过程定义为类的方法。实际上，存储过程只不过是SQL可用的类方法。在存储过程中，可以使用基于对象的全系列Intersystems的功能。

• 可以通过查询数据库将存储过程定义为返回单个结果集数据集的查询。
• 可以将存储过程定义为可以用作用户定义函数的函数过程，返回单个值。

[toc]

第四十三章 SQL函数 DATEDIFF

日期/时间函数，返回两个日期之间指定日期部分的整数差。

大纲

DATEDIFF(datepart,startdate,enddate)

参数

• datepart - 日期或时间部分的名称(或缩写)。这个名称可以用大写或小写来指定，有或没有引号。datepart可以指定为文字或主机变量。
• startdate - 间隔的开始日期/时间。可以是各种标准格式的日期、时间或日期时间。
• - 间隔的结束日期/时间。可以是各种标准格式的日期、时间或日期时间。从enddate中减去startdate，以确定两个日期之间的日期部分间隔。

描述

函数返回两个指定日期之间指定日期部分差的整数。日期范围从开始日期开始，到结束日期结束。(如果早于，将返回一个负整数值。)

返回和enddate之间指定单位的总数。例如，两个日期时间值之间的分钟数计算日期部分和时间部分，并为每一天的差异增加分钟。返回开始日期和结束日期之间跨越的指定日期部分边界的计数。例如，指定连续年份的任意两个日期(例如和)返回的年份为1，而不管这两个日期之间的实际持续时间是大于还是小于天。同样，和之间的分钟数是1，尽管实际上只有秒将两个值分开。

请注意，是为Sybase和Microsoft SQL Server兼容性而提供的。使用标量函数可以执行类似的时间/日期比较操作。

也可以使用

自 Caché 2017 以后，SQL 引擎包含了一些新的统计信息。 这些统计信息记录了执行查询的次数以及运行查询所花费的时间。

对于想要对包含许多 SQL 语句的应用程序的性能进行监控和尝试优化的人来说，这是一座宝库，但访问数据并不像一些人希望的那么容易。

本文和相关的示例代码说明了如何使用这些信息，以及如何例行提取每日统计信息的摘要，并保存应用程序的 SQL 性能的历史记录。

记录了什么？

每次执行 SQL 语句时，都记录花费的时间。 这是非常轻量的操作，无法关闭。 为了最大程度地降低开销，统计信息保留在内存中并定期写入磁盘。 数据包括一天中执行查询的次数以及所花费的平均时间和总时间。

数据不会立即写入磁盘，并且在写入之后，统计信息将由“更新 SQL 查询统计信息”任务更新，该任务通常计划为每小时运行一次。 该任务可以手动触发，但是如果你希望在测试查询时实时查看统计信息，则整个过程需要一点耐心。

警告：在 InterSystems IRIS 2019 及更早版本中，不会针对已使用 %Studio.Project:Deploy 机制部署的类或例程中的嵌入式 SQL 收集这些统计信息。 示例代码不会有任何中断，但这可能会使你产生误导（我被误导过），让你以为一切正常，因为没有查询显示为高开销。

如何查看信息？

你可以在管理门户中查看查询列表。

    大家应该都已经很熟悉 InterSystems Ensemble（一个集成和应用程序开发平台），每个人都知道 Ensemble Workflow 子系统是什么以及它对于自动化人类交互的作用。 对于那些不了解 Ensemble Workflow 的人，我将简要介绍它的功能（已经熟悉的朋友可以直接跳过这一部分并学习如何使用 Angular.js 中的 Workflow 接口）。

InterSystems Ensemble

  InterSystems Ensemble 是一个集成和应用程序开发平台，旨在集成异构系统、自动化业务流程和创建新的复杂应用程序，这些应用程序通过新的业务逻辑或新的用户界面增强集成应用程序的功能：EAI、SOA、BPM、BAM 甚至 BI （感谢 InterSystems DeepSee：一种用于开发分析应用程序的内置技术）。

    Ensemble 具有以下关键功能：

    适配器：与应用程序、技术和数据源交互的组件。 Ensemble 提供技术和应用程序集成适配器（Web 和 REST 服务、文件、FTP、电子邮件、SQL、EDI、HL7、SAP、Siebel、1S Enterprise 等）。 您可以使用适配器 SDK 创建自己的适配器。

    业务服务：将来自外部系统的数据转换为 Ensemble 消息并启动业务流程和/或业务运营的组件。

本文概述了InterSystems SQL的特点，特别是那些没有被SQL标准所涵盖或与InterSystems IRIS 数据平台的统一数据架构有关的特点。假定你已有SQL的知识，本文不是SQL概念或语法的介绍。

表

在InterSystems SQL中，数据是在表内呈现的。每个表都被定义为包含若干列。一个表可以包含零个或多个数据值的行。以下术语大致上是等同的。

schema

SQL schema提供了一种将相关表、视图、存储过程和缓存查询分组的方法。模式的使用有助于防止在表一级的命名冲突，因为一个表、视图或存储过程的名称必须只在其schema内是唯一的。一个应用程序可以在多个schema中指定表。

SQL schema对应于IRIS中持久化的类包。

第三章 SQL聚合函数 COUNT（一）

返回表或指定列中的行数的聚合函数。

大纲

COUNT(*)

COUNT([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

参数

• * - 指定应计算所有行以返回指定表中的总行数。 COUNT(*)不接受其他参数，不能与ALL或关键字一起使用。 不接受表达式参数，也不使用任何特定列的信息。 返回指定表或视图中的行数，但不消除重复项。 它分别计数每一行，包括包含值的行。
• - 可选-指定返回表达式中所有值的计数。 如果没有指定关键字，这是默认值。
• DISTINCT - 可选-一个子句，指定COUNT返回表达式的不同(唯一)值的计数。 不能与流字段一起使用。 可以指定子句，其中可以是单个列名，也可以是用逗号分隔的列名列表。
• - 任何有效的表达式。 通常是包含要计算的数据值的列的名称。
• - 可选-列名或以逗号分隔的列名列表。
• %AFTERHAVING - 可选-应用在子句中的条件。

返回数据类型。

描述

聚合函数有两种形式:

• 以整数形式返回表达式中值的数目的计数。 通常，表达式是查询返回的多行中字段的名称(或包含一个或多个字段名称的表达式)。 不计算值。 它可以选择计数或不计数重复的字段值。 总是返回数据类型 长度为，精度为，刻度为。

大家好，

我想知道是否有可能获取自身的值来运行查询。

我想创建一些查询以在％Persistent类中找到一个值，但是每个查询都使用不同的值。

Class Kurro.MyClass Extends %Persistent
{

/// Key of process
Property KeyProcess As %String(MAXLEN = "");

/// Specialist
Property CodeSpecialist As %String;

/// Provider
Property CodeProvider As %String;

/// Center
Property CodeCenter As %String;

/// Date
Property Date As %TimeStamp;

/// IdList
Property IdList As %String;

/// IdProcess
Property IdProcess As %String;

/// Duration
Property Duration As %String;

Query GetInfo(pObject AS Kurro.MyClass) As %SQLQuery(CONTAINID = 1, ROWSPEC = "IdList:%String,IdProcess:%String,Duration:%String")
{
    SELECT IdList, IdProcess, Duration
    FROM Kurro.MyClass
    WHERE KeyProcess = :pObject.KeyProcess
    AND CodeSpecialist = :pObject.CodeSpecialist
    AND CodeProvider = :pObject.CodeProvider
    AND CodeCenter = :pObject.CodeCenter
    AND Date = :pObject.Date
}

}

在最近的项目里，多方同时连接同一个数据库并执行增删改查等各项数据操作。研发人员不时发现一些数据在不合规的情况下被新增甚至删除。因此，在实际工作中会有监控数据操作以便识别和处理异常操作的需求。本文将以监控和识别删除操作为例，介绍如何通过IRIS的审计功能实现对数据操作的监控和查询。

注意事项

在应用审计功能之前，必须注意的是：

1. 开启审计功能会事无巨细地记录每一条对应的操作（如被执行的SQL），因此对于存储空间的需求将急剧增加。举例而言，仅开启对XDBCStatement的监控后，对于一张只由5个简单（整型，VARCHAR型）字段构成的表中插入100万条记录，在Audit数据库中将占用300～400MB的空间。在因业务所需确实需要开启审计功能时，必须预先分配更多磁盘空间给IRIS Audit数据库，并在审计功能开启期间定时巡检磁盘空间，避免因日志占满磁盘导致其他数据无法写入引发系统挂起的故障。
2. 在研发环境中多人、多单位需要连接数据库时，应为不同的开发者和数据来源分配独立的数据库账户和权限，避免多人共用超级账户，导致数据异常时难以追踪异常操作究竟从何而来。也就意味着为不同角色的开发、测试、用户等参与者开启独立的用户，分配各自所需的的数据库权限以及管理数据库账户这样一系列项目正常运行所依赖的实践并不能被审计功能所替代。

第十三章 使用动态SQL（一）

动态SQL简介

动态SQL是指在运行时准备并执行的SQL语句。在动态SQL中，准备和执行SQL命令是单独的操作。通过动态SQL，可以以类似于ODBC或JDBC应用程序的方式在InterSystems IRIS中进行编程（除了要在与数据库引擎相同的进程上下文中执行SQL语句）。动态SQL是从ObjectScript程序调用的。

动态SQL查询是在程序执行时准备的，而不是在编译时准备的。这意味着编译器无法在编译时检查错误，并且不能在Dynamic SQL中使用预处理器宏。这也意味着执行程序可以响应用户或其他输入而创建专门的Dynamic SQL查询。

动态SQL可用于执行SQL查询。它也可以用于发出其他SQL语句。本章中的示例执行SELECT查询。

动态SQL用于执行InterSystems IRIS SQL Shell，InterSystems IRIS管理门户网站“执行查询”界面，SQL代码导入方法以及“数据导入和导出实用程序”。

在Dynamic SQL（和使用它的应用程序）中，行的最大大小为3,641,144个字符。

动态SQL与嵌入式SQL

动态SQL与嵌入式SQL在以下方面有所不同：

• 动态SQL查询的初始执行效率比嵌入式SQL稍低，因为它不会生成查询的内联代码。但是，动态SQL和嵌入式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

应用：

应用程序根据Globals的键值对、访问速度快的特性。

根据日期范围查询的SQL性能让你失望？  我有一个比较特别的技巧，可能会帮助你解决这个问题! (SQL开发人员讨厌这个!)*

如果你有一个类，在添加数据时记录时间戳，那么这些数据将与你的IDKEY值保持顺序--也就是说，当且仅当ID1<ID2时，表内所有ID和时间戳值的TimeStamp1<TimeStamp2--那么你可以利用这一知识来提高对时间戳范围的查询性能。  考虑一下下面这个表:

Class User.TSOrder extends %Persistent 
{ 

Property TS as %TimeStamp;

Property Data as %String (MAXLEN=100, MINLEN=200);

Index TSIdx on TS;

Index Extent [type=bitmap, extent];

}

用过去30天内的30,000,000条随机行来填充，每天将得到1,000,000条行。 现在，如果我们想查询某一天的信息，你可以这样写：

SELECT ID, TS, Data 
FROM TSOrder
WHERE 
     TS >= '2016-07-01 00:00:00.00000' AND 
     TS <= '2016-07-01 23:59:59.999999'

我想知道是否有更好的方法来使用动态SQL对数据集进行分页，而不是我下面使用的方法。问题是，当潜在的数据池变大时，这段代码就会变慢，以至于无法使用。在分析下面的每一行代码时，似乎速度变慢与最初的rset.%Next()迭代有关。 有没有什么不需要子查询/%VID的可用方法，比如简单的LIMIT/OFFSET？

我的代码类似于:

s sql=##class(%SQL.Statement).%New()

s query="SELECT *,%VID FROM (SELECT prop FROM table WHERE prop=x) WHERE %VID BETWEEN 1 AND 100"             

s sc=sql.%Prepare(query)

s rset=sql.%Execute()

while rset.%Next() {.....

本文是 SqlDatabaseChain 的简单快速入门（我所做的）。

希望大家会感兴趣。

非常感谢：

sqlalchemy-iris 作者@Dmitry Konnov Maslennikov

您的项目使我的试验变得可能。

文章脚本使用 openai API，因此请注意不要在外部共享您不打算共享的表信息和记录。

如果需要，可以插入本地模型。

创建一个新的虚拟环境

mkdir chainsql

cd chainsql

python -m venv .

scripts\activate

pip install langchain

pip install wget

# Need to connect to IRIS so installing a fresh python driver
python -c "import wget;url='https://raw.githubusercontent.com/intersystems-community/iris-driver-distribution/main/DB-API/intersystems_irispython-3.2.0-py3-none-any.whl';wget.download(url)"

# And for more magic
pip install sqlalchemy-iris

pip install openai

set OPENAI_API_KEY=[ Your OpenAI Key ]

python

第二十九章 SQL命令 DISTINCT

指定仅返回不同值的SELECT子句。

大纲

SELECT [DISTINCT [BY (item {,item2})] ]  |  [ALL]
  select-item {,select-item2}

参数

• DISTINCT - 可选-返回组合选择项值唯一的行。
• DISTINCT BY (item {,item2}) - 可选-返回按(项)值唯一的行的选择项值。
• ALL - 可选-返回结果集中的所有行。默认设置。

描述

可选子句出现在关键字之后、可选TOP子句和第一个之前。

子句应用于语句的结果集。它将每个不同(唯一)值返回的行数限制为一个任意行。如果未指定子句，则默认情况下显示满足选择条件的所有行。子句与不指定子句相同；如果指定，将返回表中满足选择条件的所有行。

从句有两种形式：

• SELECT DISTINCT：为选择项值的每个唯一组合返回一行。可以指定一个或多个选择项。例如，以下查询返回一行，其中包含Home_State和值的每个唯一组合的和值：

• ：为项目值的每个唯一组合返回一行。可以指定单个项目或逗号分隔的项目列表。指定的项目或项目列表必须用括号括起来。可以在by关键字和圆括号之间指定或省略空格。选择项列表可以(但不一定)包括指定的项。例如，以下查询返回一行，其中包含和Age值的每个唯一组合的和值：

SELECT DISTINCT BY (Home_State,Age) Name,Age FROM Sample.Person

第八章 SQL聚合函数 MAX

返回指定列中最大数据值的聚合函数。

大纲

MAX([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

参数

• ALL - 可选-将聚合函数应用于所有值。 ALL对MAX返回的值没有影响。 它提供了兼容性。
• - 可选-一个子句，指定考虑每个惟一值。 DISTINCT对返回的值没有影响。 它提供了兼容性。
• - 任何有效的表达式。 通常是包含要返回的最大值的值的列的名称。
• - 可选-列名或以逗号分隔的列名列表。
• %AFTERHAVING - 可选-应用在HAVING子句中的条件。

返回与表达式相同的数据类型。

描述

聚合函数返回表达式的最大值。 通常，表达式是查询返回的多行中字段的名称(或包含一个或多个字段名称的表达式)。

可以在引用表或视图的SELECT查询或子查询中使用。 MAX可以在列表或子句中与普通字段值一起出现。

不能在子句中使用。 不能在的子句中使用，除非是子查询。

与大多数其他聚合函数一样，不能应用于流字段。 尝试这样做会产生一个错误。

与大多数其他聚合函数不同，ALL和关键字，包括，在中不执行任何操作。 它们是为了的兼容性而提供的。

数据值

使用的指定字段可以是数字或非数字。 对于数字数据类型字段，

第九章 SQL查询数据库（二）

调用用户定义函数的查询

InterSystems SQL允许您在SQL查询中调用类方法。这为扩展SQL语法提供了强大的机制。

若要创建用户定义的函数，请在持久性InterSystems IRIS类中定义一个类方法。该方法必须具有文字（非对象）返回值。这必须是一个类方法，因为在SQL查询中将没有对象实例可以在其上调用实例方法。还必须将其定义为SQL存储过程。

例如，我们可以在MyApp.Person类中定义一个Cube（）方法：

Class MyApp.Person Extends %Persistent [DdlAllowed]
{
/// Find the Cube of a number
ClassMethod Cube(val As %Integer) As %Integer [SqlProc]
  {
    RETURN val * val * val
  }
}

可以使用，CREATE METHOD或CREATE PROCEDURE语句创建SQL函数。

要调用SQL函数，请指定SQL过程的名称。可以在可能指定标量表达式的任何地方以SQL代码调用SQL函数。函数名称可以使用其架构名称进行限定，也可以不限定。不合格的函数名称采用用户提供的模式搜索路径或系统范围内的默认模式名称。函数名称可以是定界标识符。

创建表

可以通过以下方式定义表：

1. 通过DDL定义表
   
   • 使用任意数据库管理工具执行DDL（使用ODBC，JDBC连接）

   MyApp.Person表可以使用DDL CREATE TABLE语句来定义，指定SQL schema.table名称。成功执行这个SQL语句会生成一个相应的持久化类，包名MyApp，类名Person。当使用DDL命令定义一个表时，你不需要指定USEEXTENTSET或创建一个位图范围索引。InterSystems SQL会自动应用这些设置，并将它们包含在预测的持久化类中。默认情况下，CREATE TABLE在相应的类定义中指定了Final类的关键字，表示它不能有子类。

   CREATE TABLE MyApp.Person (
     Name VARCHAR(50) NOT NULL,
     SSN VARCHAR(15) DEFAULT 'Unknown',
     DateOfBirth DATE,
     Sex VARCHAR(1)
   )

   • 使用Objectscript执行DDL
     
     • 在ObjectScript中使用 Embedded SQL.
       

       ClassMethod CreateTable() As %String
       {
        &sql(CREATE TABLE Sample.Employee (
          EMPNUM              INT NOT NULL,
          NAMELAST            CHAR (30) NOT NULL,
          NAMEFIRST           CHAR (30) NOT NULL,
          STARTDATE           TIMESTAMP,
          SALARY              MONEY,
          ACCRUEDVACATION     INT,
          ACCRUEDSICKLEAVE    INT,
          CONSTRAINT EMPLOYEEPK PRIMARY KEY (EMPNUM)))
        IF SQLCODE=0{ WRITE "Table created" RETURN "Success"}
        ELSEIF SQLCODE=-201 { WRITE "Table already exists"  RETURN SQLCODE}
        ELSE { WRITE "Serious SQL Error, returing SQLCODE " RETURN SQLCODE_" "_%msg}
       }

第三十七章 SQL函数 CURRENT_TIMESTAMP

日期/时间函数，返回当前本地日期和时间。

大纲

CURRENT_TIMESTAMP
CURRENT_TIMESTAMP(precision)

参数

• precision - 一个正整数，它将时间精度指定为小数秒的位数。 默认值是0(没有小数秒); 这个默认值是可配置的。

CURRENT_TIMESTAMP返回TIMESTAMP数据类型。

描述

要么不接受参数，要么接受精度参数。 不允许使用空参数括号。

返回当前时区的本地日期和时间; 它会根据当地的时间变化进行调整，例如日光节约时间。

CURRENT_TIMESTAMP可以返回%timestamp数据类型格式(或数据类型格式(编码的位带符号整数)的时间戳。 以下规则决定返回哪种时间戳格式:

1. 如果将当前时间戳提供给数据类型为%PosixTime的字段，则当前时间戳值将以PosixTime数据类型格式返回。 例如，WHERE PosixField=CURRENT_TIMESTAMP or INSERT INTO MyTable (PosixField) VALUES (CURRENT_TIMESTAMP).

2. 如果将当前的时间戳提供给数据类型为的字段，则以数据类型格式返回当前的时间戳值。 例如.

3. 如果没有上下文提供当前时间戳，则以

第十章 SQL排序

排序规则指定值的排序和比较方式，并且是InterSystems SQL和InterSystemsIRIS®数据平台对象的一部分。有两种基本排序规则：数字和字符串。

• 数值排序规则按以下顺序基于完整数字对数字进行排序：null，然后是负数，从最大到最小，零，然后是正数，从最小到最大。这将创建如下序列：–210，–185，–54，–34，-.02、0、1、2、10、17、100、120。
• 字符串归类通过对每个顺序字符进行归类来对字符串进行排序。这将创建以下顺序：null，A，AA，AA，AAA，AAB，AB，B。对于数字，这将创建以下顺序：。

默认的字符串排序规则是SQLUPPER；为每个名称空间设置此默认值。 排序规则将所有字母都转换为大写（出于排序的目的），并在字符串的开头附加一个空格字符。此转换仅用于整理目的；在InterSystems中，无论所应用的排序规则如何，SQL字符串通常以大写和小写字母显示，并且字符串的长度不包括附加的空格字符。

时间戳记是一个字符串，因此遵循当前的字符串排序规则。但是，由于时间戳是ODBC格式，因此如果指定了前导零，则字符串排序规则与时间顺序相同。

• 字符串表达式（例如使用标量字符串函数LEFT或的表达式）使其结果归类为。
• 两个文字的任何比较都使用

第六十八章 SQL函数 JSON_ARRAY

以JSON数组形式返回数据的转换函数。

大纲

JSON_ARRAY(expression [,expression][,...] [NULL ON NULL | ABSENT ON NULL])

参数

• expression - 表达式或逗号分隔的表达式列表。这些表达式可以包括列名、聚合函数、算术表达式、文字和文字NULL。
• ABSENT ON NULL - 可选-指定如何在返回的JSON数组中表示空值的关键字短语。(缺省值)表示带有单词(未引号)的(缺少)数据。在上不存在将从数组中省略空数据；它不会保留占位符逗号。此关键字短语对空字符串值没有影响。

描述

接受表达式或(更常见的)逗号分隔的表达式列表，并返回包含这些值的数组。可以在语句中与其他类型的结合使用。可以在可以使用SQL函数的其他位置指定，例如在子句中。

返回的数组格式如下：

[ element1 , element2 , element3 ]

Json_array以字符串(用双引号括起来)或数字形式返回每个数组元素值。数字以规范格式返回。数字字符串以文字形式返回，用双引号括起来。所有其他数据类型(例如，或)都作为字符串返回。

不支持将星号()语法作为指定表中所有字段的方式。它支持COUNT(*)聚合函数。

返回的数组列被标记为表达式(默认情况下)；可以为指定列别名。

介绍

在最近几篇文章中的一些文章中，我谈到了 IRIS 和 Python 之间的类型，很明显，从一侧到另一侧访问对象并不是那么容易。

幸运的是，已经完成了创建SQLAlchemy-iris 的工作（点击链接在 Open Exchange 上查看它），这使得 Python 访问 IRIS 对象的一切变得更加容易，我将展示它的启动器。

谢谢@Dmitry Maslennikov ！

安装中

要安装，只需打开具有管理员权限的终端并输入

pip install sqlalchemy-iris

如果需要，这还将为您安装先决条件。

用法

现在，在 python 文件上，您可以导入模块、连接到数据库并以任何您想要的方式使用 sqlalchemy。如果你觉得舒服，你可以按照以下步骤操作：

• 从 sqlalchemy 导入“create_engine”并使用字符串“iris://username:password@IP:port/namespace”创建引擎。当然，您可以导入整个模块，但“create_engine”会创建一个 Engine 实例（sqlalchemy.engine，有关更多信息，请单击此处）具有我在这里展示的所有必要子类。