第五章 数据类型（四）

Strings

%Library.String 数据类型支持的最大字符串长度为 3,641,144 个字符。通常，极长的字符串应分配为 %Stream.GlobalCharacter 数据类型之一。

因为 IRIS 支持 xDBC 协议 50 和更高版本，所以没有强制执行 ODBC 或 JDBC 字符串长度限制。如果 IRIS 实例和 ODBC 驱动程序支持不同的协议，则使用两个协议中较低的一个。实际使用的协议记录在 ODBC 日志中。

请注意，默认情况下 IRIS 建立系统范围的 ODBC VARCHAR 最大长度为 4096；此 ODBC 最大长度是可配置的。

创建表

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

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

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

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

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

 zpm "install samples-bi"

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

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

第十五章 使用管理门户SQL接口（二）

过滤模式内容

Management Portal SQL界面的左侧允许查看模式(或匹配筛选器模式的多个模式)的内容
1. 通过单击SQL interface页面顶部的Switch选项，指定希望使用的名称空间。
这将显示可用名称空间的列表，可以从中进行选择。
2. 应用筛选器或从模式下拉列表中选择模式。

可以使用Filter字段通过输入搜索模式来筛选列表。
可以在一个模式或多个模式中筛选模式，或筛选表/视图/过程名(项)。
搜索模式由模式名、点(.)和项目名组成——每个名称由文字和通配符的某种组合组成。字面值不区分大小写。
通配符是:

第三章 使用多维存储(全局变量)（三）

在全局变量中复制数据

若要将全局变量(全部或部分)的内容复制到另一个全局变量(或局部数组)中，请使用ObjectScript Merge命令。

下面的示例演示如何使用Merge命令将OldData全局变量的全部内容复制到NewData全局变量中：

 Merge ^NewData = ^OldData

如果合并命令的source参数有下标，则复制该节点及其后代中的所有数据。如果Destination参数有下标，则使用目标地址作为顶级节点复制数据。例如，以下代码：

 Merge ^NewData(1,2) = ^OldData(5,6,7)

将^OldData(5，6，7)及其下的所有数据复制到^NewData(1，2)。

第九章 SQL命令 CREATE METHOD（二）

characteristics

可用的关键字如下:

第四十一章 SQL命令 DROP VIEW

删除视图

大纲

DROP VIEW view-name [CASCADE | RESTRICT]

参数

• view-name 要删除的视图的名称。
  视图名可以是限定的(schema.viewname)，也可以是非限定的(viewname)。
  非限定视图名接受默认模式名。
• CASCADE RESTRICT - 可选-指定CASCADE关键字以删除引用view-name的任何其他视图。如果有另一个视图引用view-name，则指定RESTRITE将发出SQLCODE-321错误。默认值为限制。

描述

DROP VIEW命令删除视图，但不删除基础表或数据。

第七十二章 SQL命令 SELECT（四）

WHERE子句

WHERE子句限定或取消查询选择中的特定行。
符合条件的行是那些条件表达式为真的行。
条件表达式是逻辑测试(谓词)的列表，可以通过AND和OR逻辑操作符链接这些测试(谓词)。
这些谓词可以使用NOT一元逻辑操作符进行反转。

SQL谓词可分为以下几类:
- Comparison 谓词
- BETWEEN 谓词
- LIKE 谓词
- NULL 谓词
- IN and %INLIST 谓词
- EXISTS 谓词
- FOR SOME 谓词
- FOR SOME %ELEMENT 谓词

第十四章 SQL谓词 IS NULL

确定一个数据值是否为NULL。

大纲

scalar-expression IS [NOT] NULL

描述

IS NULL谓词检测未定义的值。
可以检测到所有空值，或所有非空值:

SELECT Name, FavoriteColors FROM Sample.Person
WHERE FavoriteColors IS NULL 

SELECT Name, FavoriteColors FROM Sample.Person
WHERE FavoriteColors IS NOT NULL

IS NULL / IS NOT NULL谓词是少数几个可以在WHERE子句中用于流字段的谓词之一。
如下面的例子所示:

第二十七章 SQL函数 CHARINDEX

一个字符串函数，它返回子字符串在字符串中的位置，具有可选的搜索起点。

大纲

CHARINDEX(substring,string[,start])

参数

• substring - 要在字符串中匹配的子字符串。
• string - 作为子字符串搜索目标的字符串表达式。
• start - 可选-子字符串搜索的起始点，指定为正整数。
  从字符串开始的字符计数，从1开始计数。
  若要从字符串的开头开始搜索，请忽略此参数或指定从0或1开始。
  负数、空字符串、NULL或非数字值被视为0。

CHARINDEX返回INTEGER数据类型。

在InterSystems IRIS和InterSystems Caché 里，是否您遇到过执行一个SQL Insert/Update语句，明明给的是正确的日期值，但被告知“值‘2022-01-01’ 校验失败”的类似情况，并感到困惑？

如果有，那么您需要了解一下InterSystems IRIS和InterSystems Caché保存和显示数据的模式。

一 数据模式

InterSystems IRIS和InterSystems Caché里，数据有3种模式，称之为SELECT MODE：
逻辑模式：这是数据被保存到InterSystems IRIS和InterSystems Cache'时的格式。例如，%Date类型的数据，在数据库里被保存为一个整数，即从1840年12月31号到这个日期的天数，而不是YYYY-MM-DD的格式。

ODBC模式：这是ODBC对数据定义的格式。在这个模式下，%Date类型的数据就会显示为YYYY-MM-DD的格式。

第八十八章 SQL函数 $LISTTOSTRING

从列表创建字符串的列表函数。

大纲

$LISTTOSTRING(list[,delimiter])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。
• delimiter - 可选 — 插入以分隔子字符串的分隔符。分隔符可以是一个或多个字符，指定为带引号的字符串。要连接不带分隔符的子字符串，请指定空字符串 ('')。如果不指定分隔符，则默认为逗号 (,) 字符。

描述

$LISTTOSTRING 采用 列表并将其转换为字符串。在结果字符串中，列表的元素由分隔符分隔。

第120章 SQL函数 ROUND

以指定位数舍入或截断数字的数值函数。

大纲

ROUND(numeric-expr,scale[,flag])

{fn ROUND(numeric-expr,scale[,flag])}

参数

• numeric-expr - 要四舍五入的数字。一个数值表达式。
• scale - 计算结果为整数的表达式，该整数指定要舍入到的位数，从小数点开始计数。可以是零、正整数或负整数。如果 scale 是小数， 会将其四舍五入为最接近的整数。
• flag - 可选 — 一个布尔标志，指定是舍入还是截断 numeric-expr：0=round, 1=truncate。默认值为 0。

ROUND 返回与 numeric-expr 相同的数据类型。

描述

此函数可用于将数字舍入或截断为指定的小数位数。