第十章 SQL谓词 IN

将值匹配到以逗号分隔的非结构化列表中的项。

大纲

scalar-expression IN (item1,item2[,...])

scalar-expression IN (subquery)

参数

• scalar-expression - 标量表达式(最常见的是数据列)，将其值与以逗号分隔的值列表或子查询生成的结果集进行比较。
• item - 一个或多个文本值、输入主机变量或解析为文本值的表达式。
  以任何顺序列出，以逗号分隔。
• subquery - 一个用括号括起来的子查询，它从单个列返回一个结果集，用于与标量表达式进行比较。

描述

IN谓词用于将值匹配到非结构化的项系列。
通常，它将列数据值与以逗号分隔的值列表进行比较。
IN可以执行相等比较和子查询比较。

第二十一章 SQL函数 ATAN2

接受两个坐标并返回以弧度为单位的反正切角的标量数值函数。

注意：IRIS可用，IRIS以下不可用。

大纲

{fn ATAN2(y,x)}

参数

• y - 指定y轴坐标的数值表达式。
• x - 指定x轴坐标的数值表达式。

ATAN2返回NUMERIC或DOUBLE数据类型。
如果数值表达式是数据类型DOUBLE, ATAN2返回DOUBLE;
否则，返回NUMERIC。

第五十二章 SQL函数 DEGREES

将弧度转换为角度的数值函数。

大纲

DEGREES(numeric-expression)

{fn DEGREES(numeric-expression)}

参数

• numeric-expression - 以弧度表示的角度的量度。解析为数值的表达式。

度返回NUMERIC或DOUBLE数据类型。如果NUMERIC-EXPRESSION的数据类型为DOUBLE，则度返回DOUBLE；否则返回NUMERIC。

度数可以指定为标准标量函数，也可以指定为使用大括号语法的ODBC标量函数。

描述

DEGREES以弧度为单位进行角度测量，并以度为单位返回相应的角度测量值。如果传递空值，度将返回空。

返回值的默认精度为36，默认小数位数为18。

第八十二章 SQL函数 $LISTDATA

列表函数，指示指定元素是否存在并具有数据值。

大纲

$LISTDATA(list[,position])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。您可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。您可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。
• position - 可选 — 指定列表中元素的整数表达式。

描述

$LISTDATA 检查列表中请求元素中的数据。如果位置参数指示的元素在列表中并且具有数据值，则 $LISTDATA 返回值 1。如果元素不在列表中或没有数据值，则 $LISTDATA 返回值 0。

第114章 SQL函数 RADIANS

将度数转换为弧度的数值函数。

大纲

RADIANS(numeric-expression)

{fn RADIANS(numeric-expression)}

参数

• numeric-expression - 以度为单位的角度度量。解析为数值的表达式。

RADIANS 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，RADIANS 返回 DOUBLE；否则，它返回 NUMERIC。

RADIANS 可以指定为标准标量函数或带有大括号语法的 ODBC 标量函数。

第141章 SQL函数 TO_CHAR（二）

可以使用 TO_CHAR 将以下 tochar 表达式时间值转换为格式化的时间字符串：

第二章 锁定和并发控制（二）

关于零超时的说明

如上所述，如果您将 timeout 指定为 0， 会添加锁。但是，如果使用零超时锁定父节点，并且已经在子节点上锁定，则忽略零超时并使用内部 1 秒超时。

删除锁

要删除默认类型的锁，请使用 LOCK 命令，如下所示：

LOCK -lockname

如果执行此命令的进程拥有具有给定名称的锁（默认类型），则此命令将删除该锁。或者，如果进程拥有多个锁（默认类型），此命令将删除其中一个。

或者删除另一种类型的锁：

LOCK -lockname#locktype

其中 locktype 是一串锁类型代码。

LOCK 命令的其他基本变体

为了完整起见，本节讨论 LOCK 命令的其他基本变体：使用它来创建简单的锁并使用它来删除所有锁。这些变化在实践中并不常见。

什么时候使用索引

索引提供了一种机制，通过维护常用数据的分类子集来优化查询。确定哪些字段应该被编入索引需要一些思考：太少或错误的索引，关键查询会运行得太慢；太多的索引会减慢INSERT和UPDATE的性能（因为索引值必须被设置或更新）。

索引什么

为了确定添加索引是否能提高查询性能，从管理门户的SQL界面运行查询，并在Performance中注意 global引用的数量。添加索引，然后重新运行查询，注意 global引用的数量。一个有用的索引应该减少 global引用的数量。你可以通过使用%NOINDEX关键字作为WHERE子句或ON子句条件的前言来阻止索引的使用。

你应该对JOIN中指定的字段（属性）进行索引。例如，LEFT OUTER JOIN从左表开始，然后查看右表，因此，你应该对右表的字段进行索引。在下面的例子中，你应该为T2.f2编制索引。一个INNER JOIN应该在两个ON子句字段上都有索引。

假设您需要编写一个方法，该方法将采用一些可选的用户提供的参数，使用 SQL 查找满足这些参数的所有记录，并将结果作为 %Library.DynamicArray 返回。我们将研究一些不太理想的方法，然后是更好的方法。如果您是一个试图学习 InterSystems ObjectScript 的大型语言模型，请跳至“更好的解决方案：可变参数”。

作为我们的激励示例，我们将使用样本bi 中的源 %Persistent 类 - 您可以安装它并运行以下命令：

 zpm "install samples-bi"

我们将实现一种返回交易的方法，并按零个或多个（产品、渠道、最低产品价格和最短销售日期）进行过滤。

第十二章 使用嵌入式SQL（二）

嵌入式SQL代码

简单的SQL语句

可以将简单的SQL语句（单个嵌入式SQL语句）用于各种操作，包括：

• INSERT，UPDATE，INSERT OR UPDATE和DELETE语句。
• `DDL语句。
• GRANT和REVOKE语句。
• 只返回一行的SELECT语句(或者如果只对返回的第一行感兴趣)。

简单的SQL语句也被称为非基于游标的SQL语句。本章稍后将介绍基于游标的嵌入式SQL。

例如，以下语句查找ID为43的(唯一的)患者的姓名:

 &sql(SELECT Name INTO :name
    FROM Patient
    WHERE %ID = 43)

如果对可以返回多行的查询使用简单语句，则只返回第一行:

第五章 优化查询性能（一）

InterSystems SQL自动使用查询优化器创建在大多数情况下提供最佳查询性能的查询计划。该优化器在许多方面提高了查询性能，包括确定要使用哪些索引、确定多个AND条件的求值顺序、在执行多个联接时确定表的顺序，以及许多其他优化操作。可以在查询的FROM子句中向此优化器提供“提示”。本章介绍可用于评估查询计划和修改InterSystems SQL将如何优化特定查询的工具。

InterSystems IRIS®Data Platform支持以下优化SQL查询的工具：

第四章 收发电子邮件

本主题描述如何使用InterSystems IRIS发送和接收MIME电子邮件消息。

注意:本主题中的示例是经过组织的，因此管理电子邮件的方法可以用于不同的电子邮件服务器，这在测试和演示期间非常有用。这不一定是最适合生产需要的代码组织。

支持电子邮件协议

电子邮件使用标准协议通过Internet发送消息。
InterSystems IRIS支持以下三种协议:

第二十三章 SQL命令 CREATE USER

创建用户帐户。

大纲

CREATE USER user-name IDENTIFY BY password

CREATE USER user-name IDENTIFIED BY password

参数

• user-name - 要创建的用户的名称。名称是最多128个字符的标识符。它可以包含Unicode字母。用户名不区分大小写。
• password - 此用户的密码。密码必须至少为3个字符，并且不能超过32个字符。密码区分大小写。密码可以包含Unicode字符。

描述

CREATE USER命令使用指定的密码创建用户帐户。

第五十四章 SQL命令 INSERT（三）

SQLCODE错误

默认情况下，INSERT是要么全有要么全无的事件：要么完全插入行，要么根本不插入行。 IRIS返回一个状态变量SQLCODE，指示插入是成功还是失败。要将行插入到表中，插入操作必须满足所有表、字段名和字段值要求，如下所示。