第九章 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 FUNCTION，CREATE METHOD或CREATE PROCEDURE语句创建SQL函数。

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

第九章 SQL查询数据库

查询类型

查询是执行数据检索并生成结果集的语句。查询可以包含以下任意项：

• 一个简单的SELECT语句，用于访问指定表或视图中的数据。
• 具有JOIN语法的SELECT语句，用于访问多个表或视图中的数据。
• 合并多个SELECT语句的结果的UNION语句。
• 使用SELECT语句为封闭的SELECT查询提供单个数据项的子查询。
• 在嵌入式SQL中，这是一个使用SQL游标通过FETCH语句访问多行数据的SELECT语句。

使用SELECT语句

SELECT语句从一个或多个表或视图中选择一行或多行数据。下面的示例显示了一个简单的SELECT：

SELECT Name,DOB FROM Sample.Person WHERE Name %STARTSWITH 'A' ORDER BY DOB

在此的示例Name和DOB是Sample.Person表中的列（数据字段）。

在SELECT语句中必须指定子句的顺序是：SELECT DISTINCT TOP ...选择项INTO ... FROM ... WHERE ... GROUP BY ... HAVING ... ORDER BY。这是命令语法顺序。所有这些子句都是可选的，但SELECT选择项除外。

SELECT子句的执行顺序

原文在这里。

原作者YURI MARX GOME

我正在参加 Joel Solon 讲授的“使用 InterSystems Objects 和 SQL 进行开发”课程。 课程非常好，我将在这里分享一些从培训中总结的提示。

亲爱的社区开发者们，

我很高兴地向大家介绍一位我们的新版主@姚鑫

亲爱的社区开发者们，

北京时间3月19日下午14:00-16:00，我们将举办一次线上直播，聚焦InterSystems 数据平台与WRC服务，为您答疑解惑！今天隆重向大家介绍此次直播的主讲人！

亲爱的社区开发者们，

我们的社区正在日渐壮大！我们现在已经有了英语、西语、葡语、日语和中文社区，不论你在哪个社区发帖或评论，都可以获得Global Master倡导中心的积分，而最重要的是，在中文社区，你会获得更高积分！

用 2019 版IRIS怎么实现大数据量表的分页查询？比如表里有200万条数据。

第八章 SQL修改数据库

可以对现有的表使用SQL语句，也可以对相应的持久化类使用ObjectScript操作来修改InterSystems IRIS®数据平台数据库的内容。 不能修改定义为只读的持久类(表)。

使用SQL命令为维护数据的完整性提供了自动支持。 SQL命令是一个原子操作(全部或没有)。 如果表上定义了索引，SQL将自动更新它们以反映更改。 如果定义了任何数据或引用完整性约束，SQL将自动执行它们。 如果有任何已定义的触发器，执行这些操作将拉动相应的触发器。

插入数据

可以使用SQL语句或设置和保存持久化类属性将数据插入表中。

使用SQL插入数据

INSERT语句将一条新记录插入SQL表中。 可以插入一条记录或多条记录。

下面的示例插入一条记录。 它是插入单个记录的几种可用语法形式之一:

 INSERT INTO MyApp.Person
    (Name,HairColor) 
    VALUES ('Fred Rogers','Black')

以下示例通过查询现有表中的数据插入多条记录:

 INSERT INTO MyApp.Person
    (Name,HairColor) 
     SELECT Name,Haircolor FROM Sample.Person WHERE Haircolor IS NOT NULL

新冠肺炎疫情大流行史无前例地推动着医疗数字化发展，这一进程不仅影响了医疗服务的提供方式，更带来深刻的行业服务模式变革。经济学人邀请了来自数据技术提供商InterSystems、初级医疗服务提供商Babylon、咨询服务提供商埃森哲、数字化医疗解决方案提供商Kaiser Permanente的专家，从各自的领域和观察出发解读多个热点话题。

亲爱的社区用户，您好！

我们在 Global Masters上推出了商业服务奖励计划，这是一个绝佳的契机，您可以在开发者社区和我们的社交媒体上宣传贵公司的应用、解决方案和服务，甚至为您的 OEX 应用兑换 Google AdWords 推广！

大家好！InterSystems Global Masters 倡导中心与开发者社区紧密联系并不是秘密。 为开发者社区做出任何贡献都会带来 Global Masters 积分。 所以， 我们准备了一份关于如何在 Global Masters 以最佳方式获得积分的简短指南。

参考文章： https://community.intersystems.com/post/creating-pdf-text-file

软件及代码：https://openexchange.intersystems.com/package/iris-pdf-generator

亲爱的社区开发者，

我们诚挚邀请您参加 InterSystems编程大奖赛获奖成员线上见面会!

时间: 周五（2021年3月12日）-22：00（北京时间）

在此次线上见面会，您可以：

• 了解获胜者的个人履历
• 观看获奖应用的简短demo
• 针对此次大奖赛使用到的技术、奖金和各类疑问，您可以畅所欲言，各抒己见，为下一次竞赛做准备！

线上见面会参与成员:

• @Dmitriy Maslennikov, CaretDev Corp联合创始人、首席技术官和开发者倡导者，
• @José Roberto Pereira, Shift Consultoria e Sistemas Ltda BI开发者
• @Henrique Dias Dias, Sao Paulo Federal Court 系统管理专家/数据库管理员
• @Botai Zhang, 中国开发者
• @Weiwei Yang, 中国开发者
• @Evgeny Shvarov, InterSystems 开发者生态系统经理

您还将有机会在一个特别的网络研讨会上向我们的开发人员提出任何问题。

欢迎您参加线上见面会！

现在就来报名吧！

第七章 SQL表之间的关系

要在表之间强制执行引用完整性，可以定义外键。修改包含外键约束的表时，将检查外键约束。

定义外键

有几种方法可以在InterSystems SQL中定义外键：

• 可以定义两个类之间的关系。定义关系会自动将外键约束投影到SQL。
• 可以在类定义中添加显式外键定义（对于关系未涵盖的情况）。
• 可以使用CREATE TABLE或ALTER TABLE命令添加外键。可以使用ALTER TABLE命令删除外键。

用作外键引用的RowID字段必须是公共的。引用隐藏的RowID？有关如何使用公用（或专用）RowID字段定义表的信息。

一个表（类）的外键最大数目为400。

外键引用完整性检查

外键约束可以指定更新或删除时的引用操作。 在CREATE TABLE reference action子句中描述了使用DDL定义这个引用操作。 在类定义引用的OnDelete和OnUpdate外键关键字中定义了一个持久化类来定义这个引用操作，该类投射到一个表。 在创建分片表时，这些引用操作必须设置为无操作。

默认情况下，InterSystemsIRIS®数据平台对INSERT，UPDATE和DELETE操作执行外键引用完整性检查。如果该操作将违反参照完整性，则不会执行；该操作将发出SQLCODE -121，-122，-123或-124错误。参照完整性检查失败会生成如下错误：

https://www.surveymonkey.com/r/KVRDF7K

亲爱的开发者，

最近我们收到很多类似“如何成为一个活跃（Active）、有贡献值的成员”的问题。

条件很简单！

第六章 SQL定义和使用视图

视图是一种虚拟表，由执行时通过SELECT语句或几个SELECT语句的UNION从一个或多个物理表中检索到的数据组成。 SELECT可以通过指定表或其他视图的任意组合来访问数据。因此，存储了视图的视图提供了物理表的所有灵活性和安全性特权。

InterSystemsIRIS®数据平台上的InterSystems SQL支持在视图上定义和执行查询的功能。

注意：不能对以只读方式安装的数据库中存储的数据创建视图。 无法在通过ODBC或JDBC网关连接链接的Informix表中存储的数据上创建视图。这是因为InterSystems IRIS查询转换对这种类型的查询使用FROM子句中的子查询。 Informix不支持FROM子句子查询。

创建一个视图

可以通过几种方式定义视图：

• 使用SQL CREATE VIEW命令（在DDL脚本中或通过JDBC或ODBC）。
• 使用管理门户的“创建视图”界面。

视图名称:不合格的视图名称是一个简单的标识符：MyView。合格的视图名称由两个简单的标识符组成，即模式名称和视图名称，以句点分隔：MySchema.MyView。视图名称和表名称遵循相同的命名约定，并对不合格的名称执行相同的架构名称解析。同一模式中的视图和表不能具有相同的名称。

支持HL7 转FHIR，CDA 转FHIR，FHIR转HL7的云服务

亲爱的社区开发者们，

 InterSystems 编程大奖赛 圆满结束！这是一场令人难以置信的竞赛，参与的应用程序和开发者数量创下了记录!

谢谢大家的参与！现在是时候宣布获奖者了！

让我们把掌声送给这些开发者们！

InterSystems编程大奖赛取得圆满成功，来自中文社区的两位参赛者获得项目奖励，项目简介如下。

第五章 SQL定义表（三）

使用DDL定义表

可以使用标准DDL命令在InterSystems SQL中定义表：

InterSystems SQL中可用的DDL命令

• ALTER命令 ALTER TABLE，ALTER VIEW
• CREATE 命令 CREATE TABLE，CREATE VIEW，CREATE INDEX，CREATE TRIGGER
• DROP 命令 DROP TABLE，DROP VIEW，DROP INDEX，DROP TRIGGER

可以通过多种方式执行DDL命令，包括：

• 使用动态SQL。
• 使用嵌入式SQL。
• 使用DDL脚本文件。
• 使用ODBC调用。
• 使用JDBC调用。

在嵌入式SQL中使用DDL

在ObjectScript方法或例程中，可以使用嵌入式SQL来调用DDL命令。

例如，以下方法创建一个Sample.Employee表：

Hi, my password is forgotten, but when I retrieve the password, the mailbox cannot receive the email, what should I do, I am anxious to log in, please reply as soon as possible, thanks!

第五章 SQL定义表（二）

主键

InterSystems IRIS提供了两种方法来唯一标识表中的行：RowID和主键。

可选的主键是一个有意义的值，应用程序可以使用该值唯一地标识表中的行（例如，联接中的行）。主键可以是用户指定的数据字段，也可以是多个数据字段的组合。主键值必须是唯一的，但不必是整数值。 RowID是一个内部用于标识表中行的整数值。通常，主键是由应用程序生成的值，而RowID是由InterSystems IRIS生成的唯一整数值。

系统会自动创建一个主map，以使用RowID字段访问数据行。如果定义主键字段，系统将自动创建并维护主键索引。

显然，具有两个不同的字段和索引来标识行的双重性不一定是一件好事。可以通过以下两种方式之一解析为单个行标识符和索引：

第五章 SQL定义表

表名称和架构名称

可以通过定义表（使用CREATE TABLE）或通过定义投影到表的持久类来创建表：

• DDL：InterSystemsIRIS®数据平台使用CREATE TABLE中指定的表名来生成相应的持久类名，并使用指定的架构名来生成相应的包名。
• 类定义：InterSystemsIRIS®数据平台使用持久类名称来生成对应的表名，并使用包名称来生成对应的模式名。

由于以下原因，这两个名字之间的对应关系可能不相同:

• 持久化类和SQL表遵循不同的命名约定。 适用不同的有效字符和长度要求。 模式和表名不区分大小写; 包名和类名区分大小写。 系统自动将有效提供的名称转换为有效的对应名称，以确保生成的名称是惟一的。
• 持久化类名与对应的SQL表名之间的匹配是默认的。 可以使用SqlTableName类关键字来提供不同的SQL表名。
• 默认模式名可能与默认包名不匹配。 如果指定一个非限定的SQL表名或持久类名，系统将提供一个默认的模式名或包名。 初始的默认模式名是SQLUser; 初始默认包名为“User”。

模式名称

表、视图或存储过程名称可以是限定的(schema.name)，也可以是限定的(name)。

第三章 SQL语言元素（二）

算术运算符和函数

InterSystems SQL支持以下算术运算符:

• + 加法操作符。 例如，17+7 = 24。

• – 减法运算符。 例如，17-7等于10。 注意，这些字符中的一对是InterSystems SQL注释指示器。 因此，要指定两个或多个减法操作符或负号，必须使用空格或圆括号。 例如，17- -7或17-(-7)等于24。

第一章 InterSystems SQL简介

InterSystems SQL提供对InterSystems IRIS®Data Platform数据库中存储的数据的无懈可击的标准关系访问。

InterSystems SQL提供以下优势：

• 高性能和可扩展性-InterSystems SQL提供优于其他关系数据库产品的性能和可扩展性。此外，InterSystems SQL可以在各种硬件和操作系统上运行；从笔记本电脑到高端多CPU系统。
• 与InterSystems IRIS对象技术集成-InterSystems SQL与InterSystems IRIS Object技术紧密集成。可以混合使用关系访问和对象访问数据，而不会牺牲任何一种方法的性能。
• 维护成本低-与其他关系数据库不同，InterSystems IRIS应用程序不需要在已部署的应用程序中重建索引和压缩表格。
• 支持标准SQL查询-InterSystems SQL支持SQL-92标准语法和命令。在大多数情况下，可以毫不费力地将现有关系应用程序迁移到InterSystems IRIS，并自动利用InterSystems IRIS更高的性能和对象功能。

可以将InterSystems SQL用于多种目的，包括：

第四十九章 Caché 变量大全 ^$ROUTINE 变量

提供例程信息。

大纲

^$|nspace|ROUTINE(routine_name)
^$|nspace|R(routine_name)

参数

• |nspace|或[nspace] 可选-扩展SSVN引用，可以是显式名称空间名称，也可以是隐含名称空间。必须计算为带引号的字符串，该字符串括在方括号([“nspace”])或竖线(|“nspace”|)中。命名空间名称不区分大小写；它们以大写字母存储和显示。
• routine_name 计算结果为包含例程名称的字符串的表达式。

描述

可以将^$ROUTINE结构化系统变量用作$DATA、$ORDER和$QUERY函数的参数，以从当前命名空间(默认)或指定命名空间返回例程信息。^$ROUTINE返回有关例程的OBJ代码版本的例程信息。

在InterSystems ObjectScript中，一个例程有三个代码版本：MAC(用户编写的代码，可能包括宏预处理器语句)、INT(编译的MAC代码，用于执行宏预处理)和OBJ(可执行目标代码)。可以使用^$ROUTINE global返回关于int代码版本的信息。可以使用^$ROUTINE返回有关OBJ代码版本的信息。

参数

nspace

第四章 标识符

标识符

标识符是SQL实体的名称，例如表、视图、列(字段)、模式、表别名、列别名、索引、存储过程、触发器或其他SQL实体。 标识符名称在其上下文中必须是唯一的; 例如，同一模式中的两个表或同一表中的两个字段不能具有相同的名称。 但是，不同模式中的两个表或不同表中的两个字段可以具有相同的名称。 在大多数情况下，相同的标识符名称可以用于不同类型的SQL实体; 例如，一个模式、该模式中的表以及该表中的字段都可以具有相同的名称，而不会产生冲突。 但是，同一个模式中的表和视图不能具有相同的名称。

InterSystems IRIS®数据平台SQL标识符遵循一组命名约定，根据标识符的使用，这可能会受到进一步的限制。 标识符不区分大小写。

标识符可以是简单标识符，也可以是分隔符。 InterSystems SQL默认支持简单标识符和分隔标识符。

简单标识符

简单标识符有以下语法:

simple-identifier ::= identifier-start { identifier-part }
      identifier-start ::= letter | % | _ 
      identifier-part ::=  letter | number | _ | @ | # | $

命名约定

标识符start是SQL标识符的第一个字符。 它必须是下列之一:

上一篇： IRIS中的权限管理

在上一篇文章中，我们介绍了IRIS中的权限控制体系。在本文中我们将以一个常见的实施需求为例介绍如何使用IRIS的权限配置出一个只能使用SQL的用户。

需求的分解

和所有用户需求一样，当用户提出一个需求时，除其语义显式的含义之外，还需分析其是否具有没有明确说明的含义。 对于一个只能使用SQL的用户这样一个需求，即应当结合平台的特征分解成为功能需求： 具有一个合法，可通过用户名和密码使用IRIS的用户 该用户的数据库权限

• 确认项：可以使用SQL访问所有数据库还是某几个特定的数据库？ 该用户的SQL权限
• 确认项：对于特定的数据库，是否可以执行所有的DDL？
• 确认项：对于特定的数据库，是否对每一张表都可以执行Select、Update等所有的DML 该用户的程序权限
• 确认项：用户是否可以通过Portal登录并管理IRIS？

本周进入 InterSystems 编程大奖赛 的投票时间！ 此次中国有多位参赛者，我们将其项目罗列在此，欢迎投票！