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

用％ObjectSelectMode = 1 Swizzling字段名称属性

下面的示例使用％ObjectSelectMode = 1进行准备，当使用字段名称属性返回值时，其类型类别为可Swizzle类型的字段（持久性类，序列类或流类）将自动发生Swizzle。转换字段值的结果是相应的对象参考（oref）。使用％Get（）或％GetData（）方法访问字段时，InterSystems IRIS不会执行此筛选操作。在此示例中，处于Swizzle状态，而引用同一字段的处于not swizzled状态：

/// d ##class(PHA.TEST.SQL).PropSQL2()
ClassMethod PropSQL2()
{
	SET myquery = "SELECT TOP 5 Name,Home FROM Sample.Person"
	SET tStatement = ##class(%SQL.Statement).%New(0)
	SET tStatement.%ObjectSelectMode=1
	WRITE !,"set ObjectSelectMode=",tStatement.%ObjectSelectMode,!
	SET qStatus = tStatement.%Prepare(myquery)
	IF qStatus'=1 {
		WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT
	}
	SET rset = tStatement.%Execute()
	WHILE rset.%Next() {
		WRITE "Row count ",rset.%ROWCOUNT,!
		WRITE rset.Name
		WRITE " ",rset.Home,!
		WRITE rset.%GetData(1)
		WRITE " ",$LISTTOSTRING(rset.%GetData(2)),!!
	}
	WRITE !,"End of data"
	WRITE !,"Total row count=",rset.%ROWCOUNT
}

InterSystems IRIS 目前将类限制为 999 个属性。

但是，如果您需要为每个对象存储更多数据该怎么办？

本文将回答这个问题（附加了社区 Python 网关的客串以及如何将广泛的数据集传输到 Python 中）。

答案其实很简单 - InterSystems IRIS 目前将类限制为 999 个属性，但不限制 999 个基元(primitives)。 InterSystems IRIS 中的属性可以是具有 999 个属性的对象等等 - 该限制很容易被忽略。

第四十七章 SQL命令 GRANT（一）

向用户或角色授予特权。

大纲

GRANT admin-privilege TO grantee [WITH ADMIN OPTION]

GRANT role TO grantee [WITH ADMIN OPTION] 

GRANT object-privilege ON object-list TO grantee [WITH GRANT OPTION]

GRANT SELECT ON CUBE[S] object-list TO grantee [WITH GRANT OPTION]

GRANT column-privilege (column-list) ON table TO grantee  [WITH GRANT OPTION]  

参数

• grantee - 一个或多个用户或角色的逗号分隔列表。 有效值是用户列表、角色列表、“*”或_PUBLIC。 星号()指定当前定义的所有没有% all角色的用户。 键字指定所有当前定义的和尚未定义的用户。
• - 被授予的管理级别特权或以逗号分隔的管理级别特权列表。 该列表可由下列一项或多项按任何顺序组成: ，

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

持久类方法中的嵌入式SQL

下面的示例显示了一个持久类，其中包含一个类方法和一个实例方法，两者都包含嵌入式SQL：

Class Sample.MyClass Extends %Persistent [DdlAllowed]
 { 
 ClassMethod NameInitial(Myval As %String) As %String [SqlProc]
  {
     &sql(SELECT Name INTO :n FROM Sample.Stuff WHERE Name %STARTSWITH :Myval)
        IF SQLCODE<0 {WRITE "SQLCODE error ",SQLCODE  RETURN %msg}
        ELSEIF SQLCODE=100 {WRITE "Query returns no results"  RETURN}
   WRITE "Hello "  RETURN n
  }
 Method CountRows() As %Integer
  {
   &sql(SELECT COUNT(*) INTO :count FROM Sample.Stuff)
        IF SQLCODE<0 {WRITE "SQLCODE error ",SQLCODE  RETURN %msg}
        ELSEIF SQLCODE=100 {WRITE "Query returns no results"  RETURN}
   WRITE "Number of rows is "  RETURN count
  }
 }

第八章 解释SQL查询计划（二）

SQL语句的详细信息

有两种方式显示SQL语句的详细信息:

• 在SQL Statements选项卡中，通过单击左侧列中的Table/View/Procedure Name链接选择一个SQL Statement。 这将在单独的选项卡中显示SQL语句详细信息。 该界面允许打开多个选项卡进行比较。 它还提供了一个Query Test按钮，用于显示SQL Runtime Statistics页面。
• 从表的Catalog Details选项卡(或SQL Statements选项卡)中，通过单击右边列中的Statement Text链接选择一个SQL语句。 这将在弹出窗口中显示SQL语句详细信息。

可以使用“SQL语句详细信息”显示来查看查询计划，并冻结或解冻查询计划。

“SQL语句详细信息”提供冻结或解冻查询计划的按钮。 它还提供了一个Clear SQL Statistics按钮来清除性能统计，一个Export按钮来将一个或多个SQL语句导出到一个文件，以及一个Refresh和Close页面按钮。

SQL语句详细信息显示包含以下部分。

第九章 创建、编写和阅读MIME邮件

Iris提供了一个可以用于创建MultiPart Mime消息（％Net.MimePart）的类。创建要添加到SOAP消息的附件时，请使用此类;请参阅创建Web服务和Web客户端。因为是一个常见的标准，所以有许多其他可能的应用程序，例如电子邮件处理和HTTP Multipart Post。

MIME消息概述

MIME格式的文档被称为MIME部分。每个MIME部件都有标题，包含邮件正文（文本或二进制）或包含额外的MIME部件。具有MIME版本标题的MIME部分可以用作顶级文档，称为MIME消息。下图显示了示例：

在该示例中，E和F具有未显示的附加子部分。

要表示MIME部件，请使用 类，该类提供用于设置零件的标题和内容的属性。

创建MIME部分

要创建一个MIME部件，执行以下步骤:

1. 创建%Net.MIMEPart的实例。
2. 做以下其中一项:

• 添加文本或二进制正文。为此，请创建流(文本或二进制)的实例，并将MIME部分的Body属性设置为等于该流。使用标准流接口将数据写入此流。不要为属性指定值。
• 添加MIME部件列表。为此，请按此处所述创建MIME部件，并将属性设置为等于这些部件的列表。不要为属性指定值。

3. 可以选择按照“设置和获取MIME部件标头”中的说明设置标头。

设置和获取MIME部件标头

可以设置和获取标头的值。

低代码挑战

想象一下那个场景。您正在 Widgets Direct 愉快地工作，这是互联网上首屈一指的小部件和小部件配件零售商。您的老板有一些毁灭性的消息，一些客户可能对他们的小部件不太满意，我们需要一个帮助台应用程序来跟踪这些投诉。为了让事情变得有趣，他希望代码占用非常小，并挑战您使用 InterSystems IRIS 以少于 150 行代码交付应用程序。这可能吗？

免责声明：本文记录了一个非常基本的应用程序的构建，为了简洁起见，省略了安全性和错误处理等细节。该应用程序仅供参考，不得用于任何生产应用。本文使用IRIS 2023.1作为数据平台，并非所描述的所有功能在早期版本中都可用

第 1 步 - 定义数据模型

我们首先定义一个新的干净的命名空间 - 带有代码和数据数据库。虽然所有内容都可以位于 1 个数据库中，但将它们拆分以便于数据刷新。

我们的帮助台系统需要 3 个基本类：一个 Ticket 对象，它可以包含用于记录员工顾问 UserAccount 和客户联系人 UserAccount 之间交互的操作。让我们用一些基本属性来定义它们：

19 行代码，我们就有了完整的数据模型！我们将 2 个类设置为 Persistent，以便将它们保存到数据库中，并且还继承自 %JSON.Adapter，这使我们能够非常轻松地以 JSON 格式导入和导出对象。

第十一章 SQL命令 CREATE PROCEDURE（二）

characteristics

用于创建方法的特征与用于创建查询的特征不同。

如果指定的特征无效，系统将生成SQLCODE -47错误。 指定重复的特征将导致SQLCODE -44错误。

可用的方法特征关键字如下:

第141章 SQL函数 TO_CHAR（二）

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

• $HOROLOG 时间整数（$HOROLOG 的时间部分）。 tochar-expression 的值必须是有效的逻辑时间（ 到 范围内的整数）。不要提供包含日期和时间组件的完整 值（例如 ）； 时间转换会错误地将 的第一个（日期）组件转换为格式化的时间字符串，并忽略第二个（时间）组件。
• 逻辑时间戳值。 的值必须是 数据类型（不是字符串数据类型），格式为 。时间戳的日期部分被忽略，时间部分被转换。例如， 是一个逻辑时间戳。
• 标准 ODBC 时间格式的时间值。 的值必须采用 格式，并且可以是字符串。
• 本地时间格式的时间值（使用当前 NLS 区域设置）。例如，如果 NLS TimeSeparator 设置为，则 的值可以采用 格式，并且可以是字符串。

在所有这些情况下，格式的值必须是一个只包含时间格式代码的字符串：

第一章 聚合函数概述

计算列的所有值并返回单个聚合值的函数。

支持聚合函数

聚合函数执行与单个列中的一个或多个值相关的任务，并返回单个值。 支持的功能有:

• SUM - 返回指定列的值的和。
• AVG - 返回指定列值的平均值。
• COUNT - 返回表中的行数，或指定列中非空值的个数。
• MAX - 返回指定列中使用的最大值。
• MIN - 返回指定列中使用的最小值。
• VARIANCE，, - 返回指定列的值的统计方差。
• , , - 返回指定列值的统计标准偏差。
• - 以逗号分隔的列表形式返回指定列中使用的所有值。
• - 返回指定列中使用的所有值，作为 IRIS列表结构中的元素。
• - 将指定列中使用的所有值作为连接字符串返回。
• - 返回指定列中使用的所有值作为JSON格式数组。

可以使用命令定义其他用户定义的聚合函数。

聚合函数忽略为的字段。 例如，LIST和%DLIST不包含指定字段为的行的元素。 只计算指定字段的非空值。

聚合函数(除外)不能应用于流字段。 这样做会产生一个错误。 可以使用COUNT来计数流字段值，但有一些限制。

注意:聚合函数类似于窗口函数。 但是，聚合函数从一组行中获取列的值，并将结果作为单个值返回。 窗口函数从一组行中获取一列的值，并为每一行返回一个值。 聚合函数可以在窗口函数中指定。 不能在聚合函数中指定窗口函数。 既可以用作聚合函数，也可以用作窗口函数。

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

避免死锁

增量锁定具有潜在危险，因为它可能导致称为死锁的情况。当两个进程各自对已被另一个进程锁定的变量断言增量锁定时，就会出现这种情况。因为尝试的锁是增量的，所以现有的锁不会被释放。结果，每个进程在等待另一个进程释放现有锁的同时挂起。

举个例子：

1. 进程 A 发出此命令：lock + ^MyGlobal(15)
2. 进程 B 发出此命令：
3. 进程 A 发出此命令：

此 LOCK 命令不返回；进程被阻塞，直到进程 释放这个锁。

4. 进程 B 发出此命令：lock + ^MyGlobal(15)

此 LOCK 命令不返回；进程被阻塞，直到进程 释放这个锁。但是，进程 A 被阻塞，无法释放锁。现在这些进程都在等待对方。

有几种方法可以防止死锁：

• 始终包含 timeout 参数。
• 对于发出增量 命令的顺序，请遵循严格的协议。只要所有进程都遵循相同的锁名称顺序，就不会发生死锁。一个简单的协议是按排序顺序添加锁。
• 使用简单锁定而不是增量锁定；也就是说，不要使用 运算符。如前所述，对于简单锁定， 命令首先释放进程持有的所有先前锁定。 （然而，在实践中，简单的锁定并不经常使用。）

如果发生死锁，可以使用管理门户或

锁的实际用途

本节介绍在实践中使用锁的基本方法。

控制对应用程序数据的访问

当我向技术人员介绍InterSystems IRIS时，我一般会先讲其核心是一个多模型DBMS。

我认为这是其主要优势（在DBMS方面）。数据仅存储一次。您只需访问您想用的API。

• 您想要数据的概要？用SQL！
• 您想用一份记录做更多事情？用对象！
• 想要访问或设置一个值，并且您知道键？用Globals！

乍一看挺好的，简明扼要，又传达了信息，但当人们真正开始使用InterSystems IRIS时，问题就来了。类、表和Globals是如何关联的？它们之间有什么关系？数据是如何存储的？

本文我将尝试回答这些问题，并解释这些到底是怎么回事。

第一部分 模型偏见

处理数据的人往往对他们使用的模型有偏见。

开发者们把数据视为对象。对他们而言，数据库和表都是通过CRUD（增查改删，最好是基于ORM）交互的盒子，但底层的概念模型都是对象（当然这对于我们大多数使用面向对象编程语言的开发者来说没错）。

而DBA大部分时间都在搞关系型DBMS，他们把数据视为表。对象只是行的封装器。

对于InterSystems IRIS，持久类也是一个表，将数据存储在Global中，因此需要进行一些澄清。

第二部分 举例

假设您创建了类Point：

Class try.Point Extends %Persistent [DDLAllowed]
{
    Property X;
    Property Y;
}

第五十三章 SQL函数 %EXACT

排序规则函数，可将字符转换为精确的排序规则格式。

大纲

%EXACT(expression)

%EXACT expression

参数

• expression - 字符串表达式，可以是列名、字符串文字、数字或另一个函数的结果，其中底层数据类型可以表示为任何字符类型(如CHAR或VARCHAR2)。

描述

%Exact返回精确排序规则序列中的表达式。此归类序列按如下方式对值进行排序：

1. 排序在所有实际值之前。对空值没有影响。这与默认排序规则相同。
2. 规范数值(无论输入为数字还是字符串)在字符串值之前按数字顺序排序。
3. 字符串值按区分大小写的字符串顺序排序。字符串的精确排序顺序与ANSI标准的ASCII排序顺序相同：数字在大写字母字符之前排序，大写字母字符在小写字母字符之前排序。标点符号出现在序列中的多个位置。

这将导致如下所示的序列：

NULL
-2        /* 规范数排序 */
0
1
2
10
22
88
''         /* 空字符串 */
#          /* 逐个字符的字符串排序 */
-00        /* 非规范数字排序为字符串 */
0 Elm St.  /* 逐个字符的字符串排序 */
022        /* 非规范数字排序为字符串 */
1 Elm St.  
19 Elm St.
19 elm St. /* 字符串排序规则区分大小写 */
19Elm St.
2 Elm St.
201 Elm St.
21 Elm St.
Elm St.

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

为什么是向量？

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

还有许多其他原因。

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

第七章 SQL表之间的关系

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

定义外键

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

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

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

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

外键引用完整性检查

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

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

错误＃5540：SQLCODE：-124消息：表'HealthLanguage.FKey2'中至少存在1行，该行引用键NewIndex1-外键约束'NewForeignKey1'（字段'Pointer1'）的NO ACTION引用操作失败[Execute + 5 ^ IRISSql16：USER]

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

存储和调用SQL语句

通过数据回调

SQL Shell自动将在终端会话期间发出的每个成功的SQL语句存储在本地缓存中，并为其分配一个顺序号。这些数字用于在当前Terminal过程中重新调用以前的SQL语句。 SQL Shell仅将数字分配给成功的SQL语句。如果在准备SQL语句期间发生错误，则不会分配任何编号。这些数字分配不是特定于名称空间的。以下是可用的数字调用命令：

• ＃：可以使用＃列出所有先前缓存的SQL语句及其分配的编号。
• #n：可以通过在SQL Shell提示符下指定#n来调用并执行先前的SQL语句，其中n是SQL Shell分配给该语句的整数。
• ＃0：可以通过在SQL Shell提示符下指定来调用并执行最近准备的SQL语句。 ＃0调用最近准备的SQL语句，而不必调用最近执行的SQL语句。因此，调用和执行SQL语句对＃0调用哪个SQL语句没有影响。

通过数字调用SQL语句不会为该语句分配新的数字。 SQL Shell在终端会话的持续时间内顺序分配数字；退出并重新进入SQL Shell或更改名称空间不会影响数字分配或先前分配的数字的有效性。

要删除所有号码分配，请使用并在显示的提示符下确认此操作。这将删除所有先前的号码分配，并从1重新开始号码分配。

通过名字回调

可以选择为SQL语句分配名称，然后按名称重新调用该语句。

本章介绍了如何将SQL code从文本文件导入InterSystems SQL。当你导入SQL code时，InterSystems IRIS 数据平台使用动态SQL准备并执行每一行的SQL。如果遇到无法解析的SQL code行，SQL导入会跳过该行code，继续准备和执行后续的code行，直到到达文件的末端。所有的SQL code导入操作都会导入到当前的命名空间。

SQL导入主要用于导入数据定义语言（DDL）命令，如CREATE TABLE，并使用INSERT、UPDATE和DELETE命令来填充表。SQL导入可以准备和执行SELECT查询，但不创建结果集。

SQL导入可以用来导入InterSystems的SQL code。它也可以用于code迁移，从其他供应商（FDBMS、Informix、InterBase、MSSQLServer、MySQL、Oracle、Sybase）导入SQL。来自其他供应商的code被转换为InterSystems的SQL并执行。SQL导入不能将所有的SQL命令导入到InterSystems SQL中。它导入的是那些与InterSystems IRIS实现的SQL标准兼容的命令和条款。不兼容的特征通常会被解析，但会被忽略。

SQL导入可以成功地准备一个SQL查询--在适当的时候创建一个相应的缓存查询--但它不会执行查询。

你通过调用%SYSTEM.SQL.

第五章 SQL定义表（二）

主键

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

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

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

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

• 使用应用程序生成的主键值作为IDKEY。 可以通过使用关键字PrimaryKey和在类定义中标识主键索引来实现这一点(如果为此目的设置了标志，也可以在DDL中实现这一点)。 这使得主键索引成为表的主映射。 因此，主键将被用作行的主要内部地址。 如果主键包含多个字段，或者主键值不是整数，那么这种方法的效率会较低。
• 不要使用应用程序生成的主键值，而应在应用程序中使用系统生成的整数作为应用程序使用的主键（例如，在中）。这样做的好处是，整数RowID

第136章 SQL函数 SUBSTRING

字符串函数，它从任何数据类型的数据（包括流数据）中返回一个子字符串。

大纲

SUBSTRING(string-expression,start[,length])

SUBSTRING(string-expression FROM start [FOR length])

{fn SUBSTRING(string-expression,start[,length])}

参数

• string-expression - 要从中派生子字符串的字符串表达式。表达式，可以是列名、字符串文字或另一个标量函数的结果。字段可以是任何数据类型：字符串（例如 CHAR 或 VARCHAR）、数字或数据类型为 或 的数据流字段。
• - 一个整数，它指定 中开始子字符串的位置。 string-expression 中的第一个字符位于位置 。如果起始位置高于字符串的长度，则 返回一个空字符串 。如果起始位置小于 （零或负数），则子字符串从位置 开始，但子字符串的长度会减少起始位置。
• - 可选 — 一个整数，指定要返回的子字符串的长度。如果未指定长度，则默认返回字符串的其余部分。

描述

接受任何数据类型的数据并将该数据的子字符串作为数据类型 返回。当然，子字符串可以是作为字符串返回的完整数据值。

的值控制子字符串的起点：

• 如果 为 1

第五十六章 SQL函数 $EXTRACT

按位置从字符串中提取字符的字符串函数。

大纲

$EXTRACT(string[,from[,to]])

参数

• string - 要从中提取子字符串的目标字符串。
• from - 可选-单个字符在目标字符串中的位置，或要提取的字符范围(包括)的开头。 指定为从1开始计数的正整数。
• to - 可选-要提取的字符范围的结束位置(包括)。 指定为从开始计数的正整数。

描述

返回字符串中指定位置的子字符串。 返回的子字符串的性质取决于所使用的参数。

• $EXTRACT(string)提取字符串中的第一个字符。
• 从from指定的位置提取字符。 例如，如果变量包含字符串，下面的命令提取(第二个字符):

• 提取以置开始，以to位置结束的字符范围。 例如，下面的命令从字符串中提取字符串(即从位置到位置的所有字符，包括在内):

这个函数返回VARCHAR类型的数据。

参数

string

字符串值可以是变量名、数字值、字符串字面值或任何有效表达式。

from

from值必须是正整数(但是，请参见注释)。 如果是小数，则截断该小数部分，只使用整数部分。

如果值大于字符串中的字符数，返回一个空字符串。

如果指定了而没有指定参数，则提取指定的单个字符。

如果与参数一起使用，它标识要提取的范围的开始，并且必须小于的值。 如果， 返回指定位置的单个字符。 如果大， 返回一个空字符串。

to

绕过ODBC使用ObjectScript访问远程系统

这是一个在 IRIS 2020.1 和 Caché 2018.1.3 上工作的代码示例
不会与新版本保持同步
也不会获得 InterSystems 提供的支持服务！   

我们经常会遇到这样的情况，由于各种原因ODBC是访问一个远程系统的唯一选择。如果你只需要检查或改变表，这就足够了。但你不能直接执行一些命令或改变一些Global。

特别感谢@Anna Golitsyna 启发我发表此文。

这个例子提供了3种 SQLprocedure 方法来实现访问远程系统这个目的，如果其他的访问方式被阻止，通常是被一些防火墙阻止。

• SQLprocedure Ping() 返回 Server::Namespace::$ZV 并允许检查连接
• SQLprocedure Xcmd(<commandline>,<resultvar>)  执行你提交的命令行，并返回一个存放在你命名的变量中的结果。
• SQLprocedure Gset(<global>,<subscript>,<value>,<$data>)  允许你设置或删除一个Global节点 。参数<global> 是远程命名空间中的GlobalName，包括前导符；例如'^MyGlobal'  (注意：sql 用单引号!) 。

为什么要读Query Plan, 在线文档中有句话是这么说的：

While the SQL compiler tries to make the most efficient use of data as specified by the query, sometimes the author of the query knows more about some aspect of the stored data than is evident to the compiler. In this case, the author can make use of the query plan to modify the original query to provide more information or more guidance to the query compiler.

翻译一下是这样：系统给你的查询计划并不总是最好的，如果您能对查询计划，可以人工做更精细的优化。

我们先看看读Query Plan的几个基本知识：

MAP

An SQL table is stored as a set of maps. 您有看到3种map: Master map, index map, bitmap.

# 回表读主数据，
- Read master map DWBC.CT_Dept.IDKEY, using the given idkey value.

# 读普通索引
Read index map DWBC.CT_MDRDictionary(T1).UniCodeIdx, using the given %SQLUPPER(UniCode), and getting T1.ID.

# 读bitmap索引
Read bitmap index My.ppl1.idxWLRecDep, looping on %SQLUPPER(WLRecDep) (with a given set of values) and bitmap chunks.

第二章 数据类型（一）

指定 SQL 实体（如列）可以包含的数据类型。

描述

此处描述了以下主题：

• 支持的 DDL 数据类型及其类属性映射表

• 数据类型优先级用于从具有不同数据类型的数据值中选择最具包容性的数据类型

• 日期、时间、PosixTime 和时间戳数据类型

  • 使用SqlCategory和用户定义的标准
  • 对 1840 年 12 月 31 日之前的日期的可配置支持

• 支持字符串数据类型、列表数据类型和流数据类型

• 支持 ROWVERSION 数据类型

• IRIS® 数据平台 ODBC / JDBC 公开的数据类型

• 使用查询元数据方法和数据类型整数代码确定列的数据类型

• 创建用户定义的数据类型

• 处理未定义的数据类型

• 数据类型转换函数

数据类型指定列可以保存的值的种类。在使用 CREATE TABLE 或 ALTER TABLE 定义字段时指定数据类型。定义 SQL 字段时，可以指定下表（左列）中列出的 数据类型。当指定其中一种 数据类型时，它会映射到右侧列中列出的IRIS 数据类型类。在IRIS 中定义字段时，可以指定 数据类型或数据类型类。 数据类型名称不区分大小写。数据类型类名称区分大小写。 数据类型类可以通过全名（例如，）或短名（）来指定。

它们映射到的 数据类型和数据类型类通常提供不同的参数和参数默认值。

第八十章 SQL命令 UNION

组合两个或多个SELECT语句。

大纲

select-statement {UNION [ALL] [%PARALLEL] select-statement}

select-statement {UNION [ALL]  [%PARALLEL] (query)}

(query) {UNION [ALL]  [%PARALLEL] select-statement}

(query) {UNION [ALL]  [%PARALLEL] (query)}

参数

• ALL - 可选——关键字字面量。 如果指定，则返回重复的数据值。 如果省略，重复的数据值将被抑制。
• %PARALLEL - 可选—%PARALLEL关键字。 如果指定，则union的每一边都作为单独的进程并行运行。
• - 从数据库中检索数据的语句。
• query - 组合一个或多个SELECT语句的查询。

描述

将两个或多个查询组合为一个查询，该查询将数据检索到结果中。 由组合的查询可以是由单个语句组成的简单查询，也可以是复合查询。

为了在语句之间实现联合，每个分支中指定的列数必须匹配。 指定具有不同列数的将导致SQLCODE -9错误。 可以指定一个中的列与另一个中的数据列配对，以匹配列的数量。 例如:

SQL通过自动计算

第十一章 信号（一） - 概念

背景

维基百科对信号量有这样的定义：“在计算机科学中，特别是在操作系统中，信号量是一种变量或抽象数据类型，用于控制多个进程在并行编程或多用户环境中对公共资源的访问。”信号量不同于互斥体（或锁）。互斥锁最常用于管理竞争进程对单个资源的访问。当一个资源有多个相同的副本并且这些副本中的每一个都可以由单独的进程同时使用时，就会使用信号量。

考虑一个办公用品商店。它可能有几台复印机供其客户使用，但每台复印机一次只能由一个客户使用。为了控制这一点，有一组键可以启用机器并记录使用情况。当客户想要复印文件时，他们向职员索取钥匙，使用机器，然后归还钥匙，并支付使用费。如果所有机器都在使用，客户必须等到钥匙归还。保存键的位置用作信号量。

该示例可以进一步推广到包括不同类型的复印机，也许可以通过它们可以制作的副本的大小来区分。在这种情况下，将有多个信号量，如果复制者在复制的大小上有任何重叠，那么希望复制共同大小的客户将有两个资源可供提取。

介绍

信号量是共享对象，用于在进程之间提供快速、高效的通信。每个信号量都是类 %SYSTEM.Semaphore 的一个实例。信号量可以建模为一个共享变量，它包含一个 64 位非负整数。信号量上的操作在共享它的所有进程中以同步的方式更改变量的值。按照惯例，值的变化会在共享信号量的进程之间传递信息。

第六十一章 SQL命令 LOCK

锁表

大纲

LOCK [TABLE] tablename IN EXCLUSIVE MODE [WAIT seconds]

LOCK [TABLE] tablename IN SHARE MODE [WAIT seconds]

参数

• tablename - 要锁定的表的名称。 Tablename必须是已经存在的表。 表名可以是限定的(schema.table)，也可以是非限定的()。 非限定表名接受默认模式名。 模式搜索路径被忽略。
• / - IN EXCLUSIVE MODE关键字短语创建一个常规的IRIS锁。 关键字短语创建一个共享的IRIS锁。
• - 可选-一个整数，指定在超时前尝试获取锁的秒数。 如果省略，则应用系统默认超时时间。

描述

和是同义词。

命令显式锁定SQL表。 此表必须是已存在的表，对其具有必要的特权。 如果是一个不存在的表，LOCK会失败并出现编译错误。 如果是临时表，则命令执行成功，但不执行任何操作。 如果是视图，则命令失败，并出现错误。

命令用来反转操作。 显式LOCK将保持有效，直到针对同一模式发出显式，或者直到进程终止。

可以使用多次锁定一个表; 必须显式解锁表，解锁次数为表被显式锁定的次数。 每个必须指定与相应LOCK相同的模式。

权限

LOCK命令是一个特权操作。 在使用之前，进程必须对指定的表拥有

近日遇到客户反映在Business Operation中使用SQL Outbound Adapter调用Oracle存储过程时，无法获取CLOB完整的返回内容。借此在这里介绍下该如何调用，话不多说，直接上代码。

注意，以下代码片段直接应用于Business Operation中，

set pIn = 4
set pIn(1) = "aaaa"
set pIn(1,"IOType") = 1    // 1：input , 4:output
set pIn(1,"SqlType") = 12  // 12: varchar

set pIn(2,"IOType") = 4     
set pIn(2,"SqlType") = 4   // 4: integer

set pIn(3,"IOType") = 4     
set pIn(3,"SqlType") = 12  

set pIn(4,"IOType") = 4     
set pIn(4,"SqlType") = 2005   // CLOB
set pIn(4,"LOB") = 1

set tQuery = "{ call test_hc(?,?,?,?) }"  /// the first one parameter is input parameter, the last three are all output parameters.

set tSC = ..Adapter.ExecuteProcedureParmArray(.tRS,.pOut,tQuery,"iooo",.pIn)

set cnt = pOut.Count()

// you will get this stream data 
if cnt >1
{
  for i=1:1:cnt
  {
     set ov = pOut.GetAt(i))
     $$$TRACE("pOut("_i_")="_ov)

     /// the third one is the CLOB output.
     if (i = 3)
     {
        while 'ov.AtEnd 
        { 
          $$$TRACE(ov.Read())
        }
     }
  }
}

第二十六章 SQL命令 DECLARE

声明游标

大纲

DECLARE cursor-name CURSOR FOR query

参数

• cursor-name - 游标的名称，必须以字母开头，并且仅包含字母和数字。(游标名称不遵循SQL标识符约定)。游标名称区分大小写。它们受其他命名限制的约束，如下所述。
• query - 定义游标结果集的标准SELECT语句。此选择可以包括%NOFPLAN关键字，以指定应忽略此查询的冻结计划(如果有)。此可以包括子句，可以带有或不带有子句。此可以在子句中指定表值函数。

描述

DECLARE语句声明在基于游标的嵌入式中使用的游标。声明游标后，可以发出语句来打开游标，然后发出一系列语句来检索各个记录。游标定义查询，该查询用于选择要由这些语句检索的记录。可以发出一条语句来关闭(但不是删除)游标。

作为语句，仅嵌入式支持DECLARE。对于动态，可以使用简单的语句(不带子句)，也可以使用动态SQL和嵌入式SQL的组合。使用ODBC API通过ODBC支持等效操作。

声明只进(不可滚动)游标。提取操作从查询结果集中的第一条记录开始，并按顺序遍历结果集记录。一次提取只能提取一次记录。下一次提取将获取结果集中的下一条连续记录。

因为是一个声明，而不是执行的语句，所以它不设置或终止SQLCODE变量。

游标名称

游标名称区分大小写。

第三章 优化表（二）

调整表计算值

调优表操作根据表中的代表性数据计算和设置表统计信息:

• ExtentSize，它可能是表中的实际行数(行数)，也可能不是。
• 表中每个属性(字段)的选择性。 可以选择性地阻止单个属性的选择性计算。
• 属性的离群选择性，其中一个值比其他值出现得更普遍。 有效的查询可以利用离群值优化。
• 标识某些属性特征的每个属性的注释。
• 每个属性的平均字段大小。
• 表的SQL Map Name、BlockCount和Source of BlockCount。

区段大小和行计数

从管理门户运行Tune Table工具时，是表中当前行的实际计数。默认情况下，GatherTableStats()方法还将实际行数用作ExtentSize。当表包含大量行时，最好对较少的行执行分析。可以使用SQL tune table命令并指定来仅对总行的一定百分比执行分析。在针对包含大量行的表运行时，可以使用此选项来提高性能。此值应该足够大，以便对代表性数据进行采样。如果。

可以将设置为。如果表从来不打算填充数据，但用于其他目的(如查询联接)，则可能需要这样做。当将ExtentSize设置为时，InterSystems IRIS会将每个字段的选择性设置为，并将每个字段的平均字段大小设置为。

选择性和异常值选择性

Tune Table以百分比计算每个属性(字段)值的选择性。

什么时候使用索引

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

索引什么

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

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

  FROM Table1 AS T1 LEFT OUTER JOIN Table2 AS T2 ON T1.f1 = T2.f2

如果查询计划中的第一个项目是 "read master map"，或者查询计划调用的模块的第一个项目是 "read master map"，那么查询的第一个map就是master map而不是索引map。