第六十一章 SQL命令 LOCK

锁表

大纲

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

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

参数

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

描述

LOCK和LOCK TABLE是同义词。

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

UNLOCK命令用来反转LOCK操作。

第六十章 SQL命令 JOIN（二）

单向外部联接

IRIS支持单向外部联接：左外部联接和右外部联接。

使用标准的“inner”联接时，当一个表的行链接到第二个表的行时，第一个表中找不到第二个表中对应行的行将从输出表中排除。

使用单向外联接时，即使第二个表中没有匹配项，第一个表中的所有行也会包括在输出表中。使用单向外连接，第一个表会从第二个表中取出相关信息，但不会因为第二个表中缺少匹配项而牺牲自己的行。

例如，如果查询首先列出Table1并创建一个左外部联接，那么它应该能够看到Table1中的所有行，即使它们在Table2中没有对应的记录。

在指定单向外联接时，在FROM子句中命名表的顺序非常重要。对于左外部联接，指定的第一个表是联接的源表。对于右外部联接，指定的第二个表是联接的源表。因此，%INORDER或%STARTTABLE优化关键字不能与RIGHT OUTER JOIN一起使用。以下语法相互矛盾，导致SQLCODE-34错误：FROM%INORDER TABLE1 RIGHT OUTER JOIN TABLE2 ON....。

外部联接语法

IRIS支持两种表示外连接的格式：

1. ANSI标准语法：LEFT OUTER JOIN和RIGHT OUTER

第五十九章 SQL命令 JOIN（一）

基于两个表中的数据创建表的SELECT子句。

大纲

table1 [[AS] t-alias1] CROSS JOIN table2 [[AS] t-alias2] |
table1 [[AS] t-alias1] , table2 [[AS] t-alias2]

 table1 [[AS] t-alias1]
NATURAL [INNER] JOIN |
NATURAL LEFT [OUTER] JOIN |
NATURAL RIGHT [OUTER] JOIN |
table2 [[AS] t-alias2] 

table1 [[AS] t-alias1]
[INNER] JOIN |
LEFT [OUTER] JOIN |
RIGHT [OUTER] JOIN |
FULL [OUTER] JOIN
table2 [[AS] t-alias2] 
ON condition-expression

table1 [[AS] t-alias1]
[INNER] JOIN |
LEFT [OUTER] JOIN |
RIGHT [OUTER] JOIN |
table2 [[AS] t-alias2] 
USING (identifier-commalist)

(上述联接语法用于SELECT语句FROM子句。

第五十八章 SQL命令 %INTRANSACTION

显示事务状态。

大纲

%INTRANSACTION
%INTRANS

参数

无

描述

%INTRANSACTION语句设置SQLCODE以指示事务状态：

• 如果当前在事务中，则SQLCODE=0。
• 如果不在事务中，则SQLCODE=100。

事务正在进行时，%INTRANSACTION返回SQLCODE=0。此事务可以是由START TRANSACTION或SAVEPOINT发起的SQL事务。它也可以是由TSTART发起的ObjectScript事务。

事务嵌套对%INTRANSACTION没有影响。SET TRANSACTION对%INTRANSACTION没有影响。

还可以使用$TLEVEL确定事务状态。%INTRANSACTION仅指示事务是否正在进行。$TLEVEL指示事务是否正在进行以及当前的事务级别数。

示例

以下嵌入式SQL示例显示%INTRANSACTION如何设置SQLCODE：

ClassMethod %INTRANSACTION()
{
	n SQLCODE
	&sql(%INTRANSACTION)
	w "Before %INTRANS SQLCODE=",SQLCODE," TL=",$TLEVEL,!

技术概要：InterSystems IRIS Native API for Python

目录

技术概要： InterSystems IRIS Native API for Python 1

1. InterSystems IRIS 存储结构简介 1
2. 探索 IRIS Native for Python 1
   
   1. 用前须知 2
   2. 安装 Native API 包 2
   3. IRIS Native 应用程序 2
   4. 运行练习 3
   5. 确认管理门户（Management Portal）中的变更 3

3. 了解有关 IRIS Native 的更多信息 3

技术概要：InterSystems IRIS Native API for Python

本技术概要（First Look）指南解释了如何使用 InterSystems IRIS Native 功能从 Python 应用程序访问 InterSystems IRIS® globals。IRIS Native 还允许您运行 ObjectScript 方法、函数和例程。在本文中，您将首先连接到 InterSystems IRIS。然后您将在 InterSystems IRIS 中设置和检索一个 global 节点的值，并在另一个 global 节点上进行迭代。您还将调用 InterSystems IRIS 类方法。

技术概要：LDAP 和 InterSystems 产品

目录

技术概要： LDAP 和 InterSystems 产品 1

1. 设置 LDAP 身份验证 1
   
   1. 选择 InterSystems IRIS 实例 1
   2. 定义 LDAP 配置 1
   3. 选择新的 LDAP 域作为默认值 2
   4. 启用 LDAP 身份验证 2
   5. 为 LDAP 服务器安装安全证书 3

2. 探索 LDAP 用户和组 4
   
   1. User1: 操作员 4
   2. User2: 管理者 5
   3. User3: 开发者 5
   4. 自动创建用户 6

3. 了解有关 LDAP 和安全的更多信息 6

技术概要：LDAP 和 InterSystems 产品

InterSystems IRIS®数据平台可以与 LDAP（轻量级目录访问协议，Lightweight Directory Access Protocol）服务器集成，从而可以无缝地使用这种流行技术对用户进行身份验证。通过 LDAP 提供授权也很容易。

当用户尝试登录 InterSystems IRIS 时，用户名和密码会被发送到 LDAP 服务器，以验证该用户是否存在。一旦用户的身份得到验证，LDAP 服务器就会向 InterSystems IRIS 发送关于用户属于哪些组的信息。

第五十七章 SQL命令 INTO

一个SELECT子句，指定在宿主变量中存储选定的值。

大纲

INTO :hostvar1 [,:hostvar2]...

参数

• :hostvar1 - 在宿主语言中声明的输出宿主变量。 当在INTO子句中指定时，变量名前面加冒号(:)。 主机变量可以是局部变量(非下标或下标)或对象属性。 可以将多个变量指定为逗号分隔的列表、单个下标数组变量或逗号分隔的列表和单个下标数组变量的组合。

描述

INTO子句和主机变量仅在嵌入式SQL中使用。它们不在动态SQL中使用。在动态SQL中，%SQL.Statement类为输出变量提供了类似的功能。在通过ODBC、JDBC或动态SQL处理的SELECT查询中指定INTO子句会导致SQLCODE-422错误。

INTO子句可以在SELECT、DECLARE或FETCH语句中使用。INTO子句对于所有三个语句都是相同的；本页上的示例都引用SELECT语句。

INTO子句使用在SELECT-ITEM列表中检索(或计算)的值来设置相应的输出主机变量，从而使这些返回的数据值可用于ObjectScript。在SELECT中，可选INTO子句出现在SELECT-ITEM列表之后、FROM子句之前。

注意：编译嵌入式SQL时，输出主机变量将初始化为空字符串。这可以防止在执行时出现<UNDECLARED>错

InterSystems很高兴地宣布一个全新的 开发者下载网站 提供InterSystems IRIS社区版和InterSystems IRIS for Health社区版的完整配套版本。  这些都是免费提供给应用开发者使用的。

 你可以选择直接从 InterSystems开发者社区 直接 下载 InterSystems IRIS.

第五十六章 SQL命令 INSERT OR UPDATE

在表中添加新行或更新表中的现有行。

大纲

INSERT OR UPDATE [%keyword] [INTO] table
          SET column = scalar-expression {,column2 = scalar-expression2} ...  |
          [ (column{,column2} ...) ] VALUES (scalar-expression {,scalar-expression2} ...)  |
          VALUES :array()  |
          [  (column{,column2} ...) ] query  |
          DEFAULT VALUES

参数

• %keyword - 可选-以下一个或多个关键字选项，以空格分隔：%NOCHECK、%NOFPLAN、%NOINDEX、%NOJOURN、%NOLOCK、%NOTRIGGER、%PROFILE、%PROFILE_ALL。
• table - 要对其执行插入操作的表或视图的名称。此参数可以是子查询。INTO关键字是可选的。
• column - 可选-与提供的值列表顺序对应的列名或以逗号分隔的列名列表。

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

嵌入式SQL和动态SQL示例

下面的嵌入式SQL示例创建一个新表SQLUser.MyKids。下面的示例使用INSERT用数据填充此表。在插入示例之后，提供了一个删除SQLUser.MyKids的示例。

ClassMethod Insert2()
{
	&sql(
		CREATE TABLE SQLUser.MyKids 
		(
			KidName VARCHAR(16) UNIQUE NOT NULL,
			KidDOB INTEGER NOT NULL,
			KidPetName VARCHAR(16) DEFAULT 'no pet'
		) 
	)
	if SQLCODE=0 {
		w !,"创建的表" 
	} elseif SQLCODE=-201 {
		w !,"表已存在"  
		q
	} else {
		w !,"CREATE TABLE失败。SQLCODE=",SQLCODE 
	}
}

下面的嵌入式SQL示例插入具有两个字段值的行(第三个字段KidPetName采用默认值)。

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

SQLCODE错误

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

表：

• 该表必须已经存在。尝试插入到不存在的表会导致SQLCODE-30错误。
• 不能将该表定义为READONLY。尝试编译引用ReadOnly表的插入会导致SQLCODE-115错误。请注意，此错误是在编译时发出的，而不是在执行时发出的。
• 如果通过视图更新表，则不能将该视图定义为只读。尝试这样做会导致SQLCODE-35错误。如果视图基于分割表，则不能通过使用CHECK OPTION定义的视图进行插入。尝试这样做会导致SQLCODE-35，其中不允许基于带有CHECK选项条件的切片表的视图(sample.myview)使用%msg INSERT/UPDATE/DELETE。
• 必须具有适当的权限才能插入表

字段名称：

• 该字段必须存在。尝试插入不存在的字段会导致SQLCODE-29错误。
• 插入必须指定所有必填字段。尝试插入行而不为必填字段指定值会导致SQLCODE-108错误。
• 插入不能包含重复的字段名称。尝试插入包含两个同名字段的行会导致SQLCODE-377错误。

亲爱的开发者们，

是否准备参加InterSystems 2021全球峰会呢？不要错过InterSystems Developer Community、Open Exchange和Global Masters的专题会议！

⚡️ "Win. Win. Win with InterSystems Developer Ecosystem" VSummit21 session ⚡️

🎁 注意：所有参会者都将获得额外奖励哦~

分享嘉宾：
🗣 @Anastasia Dyubaylo, InterSystems开发者社区经理 
🗣 @Lena Evsikova, Product Owner of InterSystems Open Exchange
🗣 @Olga Zavrazhnova, Customer Advocacy Manager, InterSystems

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

流数据

可以将以下类型的数据值插入到流字段中：

• 对于任何表：字符串文字或包含字符串文字的主机变量，例如：

    set literal="Technique 1"

    //do the insert; use a string
    &sql(INSERT INTO MyStreamTable (MyStreamField) VALUES (:literal))

• 对于非切片表：对流对象的对象引用(OREF)。 IRIS打开此对象并将其内容复制到新的流字段中。例如：

    set oref=##class(%Stream.GlobalCharacter).%New()
    do oref.Write("Technique non-shard 1")

    //do the insert; use an actual OREF
    &sql(INSERT INTO MyStreamTable (MyStreamField) VALUES (:oref))

或流的OREF的字符串版本，例如：

    set oref=##class(%Stream.GlobalCharacter).%New()
    do oref.

10月26日-29日，InterSystems 2021全球线上峰会将聚焦于“Analytics”，为您提供全球先进经验和分享。

第五十二章 SQL命令 INSERT（一）

向表中添加新行(或多行)。

大纲

INSERT [%keyword] [INTO] table
          SET column1 = scalar-expression1 
                 {,column2 = scalar-expression2} ...  |
          [ (column1{,column2} ...) ] 
                 VALUES (scalar-expression1 {,scalar-expression2} ...)  |
          VALUES :array()  |
          [ (column1{,column2} ...) ] query  |
          DEFAULT VALUES

参数

• %keyword - 可选参数:%NOCHECK， %NOFPLAN， %NOINDEX， %NOJOURN， %NOLOCK， %NOTRIGGER， %PROFILE， %PROFILE_ALL。
• table - 要对其执行插入操作的表或视图的名称。此参数可以是子查询。INTO关键字是可选的。表名(或视图名)可以是限定的(schema.table)，也可以是不限定的

第五十一章 SQL命令 HAVING（二）

In和%INLIST谓词

IN谓词用于将值与一系列非结构化的项进行匹配。

%INLIST谓词是 IRIS扩展，用于将值与列表结构的元素进行匹配。

使用任一谓词，都可以执行相等比较和子查询比较。

在中有两种格式。第一个用作使用与OR运算符链接在一起的多个相等比较的速记。例如：

SELECT Name, Home_State FROM Sample.Person
GROUP BY Home_State
HAVING Home_State IN ('ME','NH','VT','MA','RI','CT')

如果Home_State等于括号列表中的任意值，则计算为TRUE。列表元素可以是常量或表达式。排序规则适用于IN比较，因为它适用于相等性测试。默认情况下，IN比较使用字段定义的排序规则类型；默认情况下，字符串字段定义为SQLUPPER，不区分大小写。

当日期或时间用于IN谓词相等比较时，会自动执行适当的数据类型转换。如果HAVING子句字段是TIMESTAMP类型，则DATE或TIME类型的值将转换为TIMESTAMP。如果HAVING子句字段为DATE类型，则TIMESTAMP或STRING类型的值将转换为DATE。如果HAVING子句字段为TIME类型，则TIMESTAMP或STRING类型的值将转换为TIME。

第五十章 SQL命令 HAVING（一）

对一组数据值指定一个或多个限制性条件的SELECT子句。

大纲

SELECT field
FROM table
GROUP BY field
HAVING condition-expression

SELECT aggregatefunc(field %AFTERHAVING)
FROM table
[GROUP BY field]
HAVING condition-expression

参数

• condition-expression - 由一个或多个布尔谓词组成的表达式，用于控制要检索哪些数据值。

描述

可选的HAVING子句出现在FROM子句、可选的WHERE和GROUP BY子句之后，可选的ORDER BY子句之前。

SELECT语句的HAVING子句限定或取消查询选择中的特定行。符合条件的行是条件表达式为真的行。条件表达式是一系列逻辑测试(谓词)，它们可以通过AND和OR逻辑运算符链接起来。

HAVING子句类似于WHERE子句，它可以在组上操作，而不是在整个数据集上操作。因此，在大多数情况下，HAVING子句要么与使用%AFTERHAVING关键字的聚合函数一起使用，要么与GROUP BY子句结合使用，或者两者兼而有之。

HAVING子句条件表达式还可以指定聚合函数。WHERE子句条件表达式不能指定聚合函数。

Hi 亲爱的开发者们，

在这篇帖子中，我们将向您展示如何善用开发者社区的各类标签（Tags），让我们充分利用这个开发者社区的选项吧！

第四十九章 SQL命令 GROUP BY

SELECT子句，它根据一个或多个列对查询的结果行进行分组。

大纲

SELECT ...
GROUP BY field {,field2}

参数

• field - 从其中检索数据的一个或多个字段。 单个字段名或以逗号分隔的字段名列表。

描述

GROUP BY是SELECT命令的一个子句。 可选的GROUP BY子句出现在FROM子句和可选的WHERE子句之后，可选的HAVING和ORDER BY子句之前。

GROUP BY子句接受查询的结果行，并根据一个或多个数据库列将它们分成单独的组。 当将SELECT与GROUP BY结合使用时，将为GROUP BY字段的每个不同值检索一行。 GROUP BY将NULL(没有指定值)字段作为一个独立的值组。

GROUP BY子句在概念上类似于 IRIS聚合函数扩展关键字%FOREACH，但是GROUP BY操作整个查询，而%FOREACH允许在子填充上选择聚合，而不限制整个查询填充。

GROUP BY可以在INSERT命令的SELECT子句中使用。 不能在UPDATE或DELETE命令中使用GROUP BY。

指定字段

GROUP BY子句最简单的形式指定单个字段，如GROUP BY City。 这将为每个惟一的City值选择任意一行。

目录

技术概要： 基于角色的访问控制 1

1. 基于角色的访问控制：为什么它很重要？ 1
2. 基于角色的访问控制：如何在 InterSystems IRIS 中工作 1
   
   1. 简要概念概述 1
   2. 示例用例 2

3. 基于角色的访问控制：探索它 3
   
   1. 用前须知 3
   2. 发现管理门户（Management Portal）页面访问所需的资源 3
   3. 创建和分配您自己的管理者角色 4
   4. 创建用户并分配新角色 5
   5. 尝试管理门户（Management Portal）中的角色 6

4. 了解有关基于角色的访问控制的更多信息 7

技术概要：基于角色的访问控制

本文档向您介绍基于角色的访问控制，解释它在 InterSystems IRIS®数据平台中的工作原理，并帮助您亲自探索。

要浏览所有的技术概要（First Look），包括可以在 InterSystems IRIS 免费的评估实例上执行的那些，请参见 InterSystems First Looks（《InterSystems 技术概要》）。

基于角色的访问控制：为什么它很重要？

当您首次开始使用一个新的数据库平台时，有件事情可能很快就会变得清晰起来：您可能不希望企业中的所有用户都查看和更改系统上的所有内容。

第四十八章 SQL命令 GRANT（二）

GRANT COLUMN-权限

列权限授予用户或角色对指定表或视图上的指定列列表的指定权限。这允许访问某些表列，而不允许访问同一表的其他列。这提供了比GRANT OBJECT-PRIVICATION选项更具体的访问控制，后者定义了整个表或视图的权限。向被授权者授予权限时，应为表授予表级权限或列级权限，但不能同时授予两者。SELECT、INSERT、UPDATE和REFERENCES权限可用于授予对单个列中数据的访问权限。

对具有GRANT OPTION的表具有SELECT、INSERT、UPDATE或REFERENCES对象权限的用户可以向其他用户授予该表的列的相同类型的列权限。

可以指定单个列，也可以指定逗号分隔的列列表。列列表必须用括号括起来。列名可以按任意顺序指定，允许重复。将COLUMN特权授予已具有该特权的列不起作用。

以下示例授予两列的UPDATE权限：

GRANT UPDATE(Name,FavoriteColors) ON Sample.Person TO Deborah

可以授予表或视图的列特权。可以向任何类型的被授权者授予列权限，包括用户列表、角色列表、*和_PUBLIC。但是，不能将星号(*)通配符用于权限、字段名或表名。

如果用户将新记录插入到表中，则只会将数据插入到已授予列权限的那些字段中。

第四十七章 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角色的用户。 _PUBLIC关键字指定所有当前定义的和尚未定义的用户。
• admin-privilege - 被授予的管理级别特权或以逗号分隔的管理级别特权列表。

[toc]

第四十六章 SQL命令 FROM（二）

%PARALLEL

这个可选关键字在查询的FROM子句中指定。 它建议 IRIS使用多个处理器(如果适用)并行处理查询。 这可以显著提高使用一个或多个COUNT、SUM、AVG、MAX或MIN聚合函数和/或GROUP BY子句的某些查询的性能，以及许多其他类型的查询。 这些通常是处理大量数据并返回小结果集的查询。 例如，SELECT AVG(SaleAmt) FROM %PARALLEL User.AllSales GROUP BY Region使用并行处理。

既指定单个字段又指定聚合函数且不包含GROUP BY子句的查询不能执行并行处理。 例如，SELECT Name,AVG(Age) FROM %PARALLEL Sample。 Person不执行并行处理，而是从SELECT Name,AVG(Age) FROM %PARALLEL Sample.Person GROUP BY Home_State执行并行处理。

%PARALLEL用于SELECT查询及其子查询。 INSERT命令子查询不能使用%PARALLEL。

指定%PARALLEL可能会降低某些查询的性能。 在具有多个并发用户的系统上使用%PARALLEL运行查询可能会导致整体性能下降。

注意:指定%PARALLEL的查询必须在读/写而不是只读的数据库中运行。

Mysql里有sql_safe_updates参数，可以限制不带where条件的update/delete语句执行失败，这个参数设置后，可以防止业务bug/漏洞导致把整个表都更新或者删除（线上发生过的案例），也可以防止在线误操作更新/删除整张表。

请问Cache或者IRIS中有相关的设置吗？翻了下帮助文档，没找到，有个话，告诉下是哪个设置？谢谢

第四十五章 SQL命令 FROM（一）

一个SELECT子句，指定要查询的一个或多个表。

大纲

SELECT ... FROM [optimize-option] table-ref [[AS] t-alias][,table-ref [[AS] t-alias]][,...]

参数

• optimize-option - 可选-指定查询优化选项(优化器提示)的单个关键字或由空格分隔的一系列关键字。支持以下关键字：%ALLINDEX、%FIRSTTABLE TABLE TABNAME、%FULL、%IGNOREINDEX NAME、%INORDER、%NOFLATTEN、%NOMERGE、%NOREDUCE、%NOSVSO、%NOTOPOPT、%NOUNIONOROPT、%PARALLEL和%STARTTABLE。
• table-ref - 从其中检索数据的一个或多个表、视图、表值函数或子查询，以逗号分隔的列表或使用JOIN语法指定。 在使用带有JOIN语法的视图时存在一些限制。 可以指定一个用括号括起来的子查询。
• AS t-alias - 可选—表名的别名。 必须是有效的标识符。

描述

FROM子句指定在SELECT语句中查询数据的一个或多个表(或视图或子查询)。 如果没有查询表数据，则FROM子句是可选的，如下所述。

多个表被指定为逗号分隔的列表，或者由其他JOIN语法分隔

第四十四章 SQL命令 FREEZE PLANS

冻结查询计划。

大纲

FREEZE PLANS BY ID statement-hash

FREEZE PLANS BY TABLE table-name

FREEZE PLANS BY SCHEMA schema-name

FREEZE PLANS

参数

• statement-hash - 查询计划的SQL语句定义的内部哈希表示，用引号括起来。 偶尔，看起来相同的SQL语句可能有不同的语句散列项。 需要SQL语句的不同代码生成的设置/选项的任何差异都会导致不同的语句散列。 这种情况可能发生在支持不同内部优化的不同客户机版本或不同平台上。
• table-name - 现有表或视图的名称。 表名可以是限定的(schema.table)，也可以是非限定的(table)。 非限定表名接受默认模式名。
• schema-name - 现有模式的名称。 该命令冻结指定模式中所有表的所有查询计划。

描述

FREEZE PLANS命令用来冻结查询计划。 需要解冻已冻结的查询计划，使用unfreeze plans命令。

“冻结计划”可以冻结“计划状态”为“未冻结”的查询计划。 它不能冻结计划状态为“Unfrozen/Parallel”的查询计划。

第四十三章 SQL命令 FETCH

重新定位游标，并从中检索数据。

大纲

FETCH cursor-name [INTO host-variable-list ]

参数

• cursor-name - 当前打开的游标的名称。 游标名称是在DECLARE命令中指定的。 游标名称区分大小写。
• INTO host-variable-list - 可选—将取操作列中的数据放入局部变量中。 host-variable-list指定一个主机变量或一个逗号分隔的主机变量列表，它们是包含与游标关联的数据的目标。 INTO句是可选的。 如果没有指定，FETCH语句只定位游标。

描述

在嵌入式SQL应用程序中，FETCH语句从游标检索数据。 所需的操作顺序是:DECLARE、OPEN、FETCH、CLOSE。 在未打开的游标上尝试FETCH会导致SQLCODE -102错误。

作为SQL语句，这只在嵌入式SQL中得到支持。 通过ODBC使用ODBC API支持等价的操作。

INTO子句可以指定为DECLARE语句的子句，也可以指定为FETCH语句的子句，或者两者都指定。 INTO子句允许将fetch列中的数据放到本地主机变量中。 列表中的每个主机变量，从左到右，都与游标结果集中的相应列相关联。 每个变量的数据类型必须匹配或支持对应结果集列的数据类型的隐式转换。 变量的数量必须与游标选择列表中的列数匹配。