第四十九章 SQL命令 GROUP BY

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

大纲

SELECT ...
GROUP BY field {,field2}

参数

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

描述

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

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

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

可以在命令的子句中使用。 不能在或命令中使用。

指定字段

子句最简单的形式指定单个字段，如。 这将为每个惟一的City值选择任意一行。 还可以指定以逗号分隔的字段列表，将其组合值视为单个分组术语。 它为每个和值的唯一组合选择任意一行。 因此，返回与相同的结果。

字段必须通过列名指定。 有效的字段值包括以下内容:列名(); (返回所有行); 指定列名的标量函数(); 指定列名的排序规则函数()。

不能通过列别名指定字段; 尝试这样做会产生错误。 不能通过列号指定字段; 这被解释为一个文字并返回一行。

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

GRANT COLUMN-权限

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

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

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

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

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

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

如果用户将新记录插入到表中，则只会将数据插入到已授予列权限的那些字段中。所有其他数据列都设置为定义的列默认值，如果没有定义的默认值，则设置为。不能向和列授予列级或权限。插入时, SQL会自动提供

第四十七章 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角色的用户。 键字指定所有当前定义的和尚未定义的用户。
• - 被授予的管理级别特权或以逗号分隔的管理级别特权列表。 该列表可由下列一项或多项按任何顺序组成: ，

[toc]

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

%PARALLEL

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

既指定单个字段又指定聚合函数且不包含子句的查询不能执行并行处理。 例如，。 Person不执行并行处理，而是从执行并行处理。

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

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

注意:指定%PARALLEL的查询必须在读/写而不是只读的数据库中运行。 否则，可能发生错误。

不管在子句中是否存在关键字，有些查询可能使用线性处理，而不是并行处理:有些查询不支持并行处理; 一些优化后的查询可能无法从并行处理中获益。 可以使用确定 IRIS是否以及如何对查询进行了并行处理分区。 要确定当前系统上的处理器数量，使用 方法。

%STARTTABLE

这个可选关键字指定查询优化器应该开始对子句中列出的第一个表执行联接。 其余表的连接顺序留给查询优化器。 将此关键字与进行比较，后者指定了完整的连接顺序。

不能与交叉连接或右外连接一起使用。 不能使用(或%FIRSTTABLE

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

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

大纲

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

参数

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

描述

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

多个表被指定为逗号分隔的列表，或者由其他语法分隔的列表。 可以为每个表名提供一个别名。

在语句中为多个表指定字段名时使用表名别名。 如果FROM子句中指定了两个(或更多)表，可以通过指定来指明需要哪个表的字段。 子句中每个字段的字段名。 由于表名通常是长名称，因此短表名别名在此上下文中很有用()。

下面的示例展示了表名别名的使用:

SELECT e.Name,c.Name
FROM Sample.Company AS c,Sample.Employee AS e

第四十四章 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)。 非限定表名接受默认模式名。
• - 现有模式的名称。 该命令冻结指定模式中所有表的所有查询计划。

描述

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

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

为冻结查询计划提供了四种语法形式:

• 指定的查询计划:语句哈希。 语句哈希值必须用双引号分隔。

第四十三章 SQL命令 FETCH

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

大纲

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

参数

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

描述

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

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

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

当游标前进到数据的末尾时，操作就完成了。 这将设置(没有更多数据)。 它还将%ROWCOUNT变量设置为获取的行数。

注意:只有当

第四十二章 SQL命令 EXPLAIN

返回指定查询的查询计划。

大纲

EXPLAIN [ALT] [STAT]  [INTO :host-variable] query

参数

• ALT - 可选-返回备用查询计划。默认情况下，返回单个查询计划。
• STAT - 可选-(仅限动态SQL)：返回查询计划运行时性能统计信息。默认情况下，返回不带运行时统计信息的查询计划。对于嵌入式SQL，此语法被忽略。
• INTO :host-variable - 可选-(仅限嵌入式SQL)：放置查询计划的输出主机变量。对于动态SQL，此语法被忽略。
• query - SELECT query

描述

命令以标记文本字符串的形式返回指定查询的查询计划。 该查询计划作为一个结果集返回，该结果集由一个名为的字段组成。

查询必须是查询。 不能用于创建查询计划的其他SQL操作，例如带SELECT子句的。 指定不以关键字开始的查询将导致。 可以使用显示非查询的查询计划。

和关键字可以以任何顺序指定。 INTO关键字必须在这些关键字之后指定。

可选的关键字生成备用查询计划。 所有备用查询计划都以相同的标记文本字符串返回。 规范化查询文本(标记为)在每个查询计划之前列出。

可选的关键字生成查询计划中每个模块的运行时性能统计。 这些统计信息包含在包含查询计划的标记文本字符串中。 每个模块的统计数据如下:

• :模块名。

第四十一章 SQL命令 DROP VIEW

删除视图

大纲

DROP VIEW view-name [CASCADE | RESTRICT]

参数

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

描述

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

也可以使用方法调用来调用拖放视图操作：

$SYSTEM.SQL.Schema.DropView(viewname,SQLCODE,%msg)

权限

DROP VIEW命令是特权操作。在使用之前，进程必须拥有指定视图的管理权限或权限。否则将导致错误(特权冲突)。可以通过调用命令来确定当前用户是否具有删除权限。可以通过调用方法来确定指定用户是否具有删除权限。如果拥有适当的授予权限，则可以使用命令分配权限。

在嵌入式SQL中，可以使用方法以具有适当权限的用户身份登录：

   DO $SYSTEM.Security.Login("_SYSTEM","SYS")
   &sql(      )

必须具有权限才能调用方法。

可以删除基于从部署的持久类投影的表的视图。

第四十章 SQL命令 DROP USER

删除用户帐户。

大纲

DROP USER user-name

参数

• user-name 要删除的用户名。

描述

DROP USER命令可删除用户帐户。此用户帐户是使用CREATE USER创建的，并指定了用户名。如果指定的用户名与现有用户帐户不对应， IRIS将发出错误。可以通过调用方法来确定用户是否存在。

用户名不区分大小写。

还可以使用管理门户删除用户。选择System Administration(系统管理)、Security(安全性)、Users(用户)以列出现有用户。在此用户帐户表上，可以单击要删除的用户帐户的删除。

权限

命令是特权操作。在嵌入式SQL中使用之前，必须以具有适当权限的用户身份登录。否则将导致SQLCODE-99错误(特权冲突)。

使用$SYSTEM.Security.Login()方法分配具有适当权限的用户：

   DO $SYSTEM.Security.Login("_SYSTEM","SYS")
   &sql(      )

必须具有权限才能调用方法。

示例

可以通过下面的语句来删除PSMITH:

DROP USER psmith

第三十九章 SQL命令 DROP TRIGGER

删除触发器

大纲

DROP TRIGGER name [ FROM table ]

参数

• name - 要删除的触发器的名称。触发器名称可以是限定的，也可以是非限定的；如果限定，则其架构名称必须与表的架构名称匹配。
• FROM table - 可选-要从中删除触发器的表。如果指定了FROM子句，则只在表中搜索命名触发器。如果未指定FROM子句，则在中指定的整个架构中搜索命名触发器。

描述

DROP TRIGGER命令删除触发器。如果要修改现有触发器，则必须先调用删除旧版本的触发器，然后再调用。

注：删除与该表关联的所有触发器。

命令是特权操作。用户必须具有%DROP_TRIGGER管理权限才能执行DROP TRIGGER。否则将导致错误，因为用户没有权限。

用户必须对指定表拥有特权。如果用户是表的所有者(创建者)，则会自动授予该用户对该表的权限。否则，必须授予用户对该表的%ALTER特权。否则将导致错误，因为用户没有更改的表定义所需的%ALTER特权。

如果拥有适当的授予权限，则可以使用命令分配和权限。

在嵌入式SQL中，您可以使用方法以具有适当权限的用户身份登录：

   DO $SYSTEM.Security.Login("_SYSTEM","SYS")
   &sql(      )

必须具有权限才能调用方法。

第三十八章 SQL命令 DROP TABLE

删除表及其数据(可选)。

大纲

DROP TABLE table 
     [RESTRICT | CASCADE] [%DELDATA | %NODELDATA]

参数

• table - 要删除的表的名称。 表名可以是限定的(schema.table)，也可以是非限定的(table)。 非限定表名接受默认模式名。 没有使用架构搜索路径值。
• ， - 可选-限制仅允许删除没有依赖视图或完整性约束的表。如果未指定关键字，则默认设置为RESTRITION。允许删除具有依赖视图或完整性约束的表；作为表删除的一部分，任何引用视图或完整性约束也将被删除。外键约束不支持关键字选项。
• ， - 可选-这些关键字指定在删除表时是否删除与表关联的数据。默认情况下，删除表格数据。

描述

命令删除一个表及其对应的持久化类定义。如果该表是其架构中的最后一项，则删除该表也会删除该架构及其相应的持久化类包。

默认情况下，同时删除表定义和表数据(如果存在)。关键字允许指定删除表定义，但不能指定删除表的数据。

DROP TABLE删除与该表关联的所有索引和触发器。

要删除表格，必须满足以下条件：

• 该表必须存在于当前命名空间中。尝试删除不存在的表会生成SQLCODE-30错误。
• 表定义必须是可修改的。如果投影表的类没有定义，则尝试删除该表会生成错误。

第三十七章 SQL命令 DROP ROLE

删除角色

大纲

DROP ROLE role-name

参数

• role-name - 要删除的角色的名称。名称是一个标识符。角色名称不区分大小写。

描述

DROP ROLE语句删除角色。删除角色时， IRIS会将其从已授予该角色的所有用户和角色中撤消，并将其从数据库中删除。

可以通过调用$SYSTEM.SQL.Security.RoleExists()方法来确定角色是否存在。如果尝试删除不存在(或已被删除)的角色，则将发出SQLCODE-118错误。

权限

命令是特权操作。在嵌入式SQL中使用之前，至少需要满足以下要求之一：

• 必须具有%Admin_Secure:USE权限。
• 该角色的所有者。
• 已被授予具有管理员选项的角色。

否则将导致错误(特权冲突)。

使用方法分配具有适当权限的用户：

   DO $SYSTEM.Security.Login("_SYSTEM","SYS")
   &sql(      )

必须具有权限才能调用方法。

示例

下面的嵌入式SQL示例创建名为的角色，稍后将其删除：

ClassMethod DropRole()
{
	DO $SYSTEM.Security.Login("MyName","SecretPassword")
	&sql(
		CREATE ROLE BkName
	)
	if SQLCODE=-99 {
		w !,"没有创建角色的权限" 
	} else { 
		w !,"创建角色"
	}
	/* Use role */
	&sql(
		DROP ROLE BkName
	)
	if SQLCODE=-99 {
		w !,"没有删除角色的权限" 
	} else { 
		w !,"删除橘色" 
	}
}

第三十六章 SQL命令 DROP QUERY

删除查询

大纲

DROP QUERY name [ FROM className ]

参数

• name - 要删除的查询的名称。名称是一个标识符。不要指定查询的参数括号。名称可以是限定的(schema.name)，也可以是非限定的(Name)。除非指定了子句，否则非限定查询名称将采用系统范围的默认架构名称。
• - 可选-如果指定，子句将从给定类中删除查询。如果未指定此子句， IRIS将在架构的所有类中搜索查询，并将其删除。但是，如果找不到该名称的查询，或者找到多个该名称的查询，则会返回错误代码。如果删除查询导致空类，则DROP QUERY也会删除该类。

描述

DROP QUERY命令删除查询。删除查询时， IRIS将从所有已授予该查询的用户和角色中吊销该查询，并将其从数据库中删除。

要删除查询，必须具有命令指定的管理权限。如果要尝试删除具有已定义所有者的类的查询，则必须以类的所有者身份登录。否则，系统会生成SQLCODE-99错误(权限冲突)。

如果包含查询定义的类定义是已部署的类，则不能删除该查询。此操作失败，并出现错误，并显示以修改已部署的类：。

支持名称和的以下组合。请注意，

第三十五章 SQL命令 DROP PROCEDURE

删除存储过程

大纲

DROP PROCEDURE procname [ FROM className ]
DROP PROC procname [ FROM className ]

参数

• procname - procname要删除的过程的名称。名称是一个标识符。不要指定过程的参数括号。名称可以是限定的(schema.name)，也可以是非限定的()。除非指定了子句，否则非限定过程名称将采用默认架构名称。
• - 可选-如果指定，子句将从给定类中删除过程。如果未指定此子句， IRIS将在架构的所有类中搜索该过程，并将其删除。但是，如果找不到此名称的过程，或者找到多个此名称的过程，则会返回错误代码。如果删除过程导致空类，则DROP PROCEDURE也会删除该类。

描述

DROP PROCEDURE命令删除当前命名空间中的过程。删除过程时， IRIS会将其从已授予该过程的所有用户和角色中撤消，并将其从数据库中删除。

要删除过程，必须具有命令指定的管理权限。如果要尝试删除具有已定义所有者的类的过程，则必须以类的所有者身份登录。否则，系统会生成SQLCODE-99错误(权限冲突)。

如果包含过程定义的类定义是已部署的类，则不能删除该过程。此操作失败，并出现错误，并显示以修改已部署的类：。

进程名不区分大小写。

第三十四章 SQL命令 DROP METHOD

删除方法

大纲

DROP METHOD name [ FROM className ]

参数

• name - 要删除的方法的名称。名称是一个标识符。请不要指定方法的参数括号。名称可以是限定的(schema.name)，也可以是非限定的(Name)。除非指定了子句，否则非限定方法名称将采用默认架构名称。
• - 可选-如果指定，子句将从给定类中删除该方法。请注意，必须指定方法的类名(MethBonusCalc)，而不是SQL名称()。如果未指定此子句， IRIS将在架构的所有类中搜索该方法，并将其删除。但是，如果找不到此名称的方法，或者找到多个此名称的方法，则会返回错误代码。如果删除该方法会导致空类，则方法也会删除该类。

描述

DROP METHOD命令可删除方法。删除方法时， IRIS会将其从已授予该方法的所有用户和角色中撤消，并将其从数据库中删除。

要删除方法，必须具有命令指定的管理权限。如果要尝试删除具有已定义所有者的类的方法，则必须以类所有者的身份登录。否则，系统会生成SQLCODE-99错误(权限冲突)。

如果包含方法定义的类定义是已部署的类，则不能删除该方法。此操作失败，并出现错误，并显示以修改已部署的类：。

支持名称和的以下组合。请注意，子句指定的是类包名称和方法名称，而不是SQL名称。

第三十三章 SQL命令 DROP INDEX

删除索引。

大纲

DROP INDEX index-name [ON [TABLE] table-name]

DROP INDEX table-name.index-name

参数

• index-name - 要删除的索引的名称。Index-name是名称的SQL版本，可以包括下划线和其他标点符号。它作为SQL映射名称列在表的Management Portal SQL Catalog Details中。
• 或 - 可选-与索引关联的表的名称。可以使用任一语法指定表名：第一个语法使用ON子句；关键字是可选的。第二个语法使用限定名称语法。表名可以是限定的()，也可以是非限定的()。未限定的表名采用缺省模式名。如果完全省略表名， IRIS将删除找到的第一个与匹配的索引，如下所述。

描述

DROP INDEX语句从表定义中删除索引。可以使用删除标准索引、位图索引或位片索引。通过删除相应的唯一索引，可以使用删除唯一约束或主键约束。不能使用删除位图范围索引或主地图(数据/主)索引。

可能出于以下任一原因希望删除索引：

• 打算对表执行大量的、或操作。可以对操作使用选项，而不是接受让这些操作中的每个操作都写入索引的性能开销。或者，在某些情况下，可能更可取的做法是删除索引，对数据库执行批量更改，然后重新创建索引并填充它。

第三十二章 SQL命令 DROP FUNCTION

删除函数

大纲

DROP FUNCTION name [ FROM className ]

参数

• name - 要删除的函数的名称。名称是一个标识符。不要指定函数的参数括号。名称可以是限定的(schema.name)，也可以是非限定的(Name)。除非指定了子句，否则非限定函数名称将采用系统范围的默认架构名称。
• - 可选-如果指定，子句将从给定类中删除函数。请注意，必须指定函数的类名(FuncBonusCalc)，而不是SQL名称()。如果未指定子句， 将在架构的所有类中搜索该函数，并将其删除。但是，如果找不到此名称的函数，或者找到多个此名称的函数，则会返回错误代码。如果删除函数会导致空类，则函数也会删除该类。

描述

DROP Function命令用于删除函数。当删除某个函数时， IRIS会将其从已授予该函数的所有用户和角色中撤消，并将其从数据库中删除。

要删除函数，必须拥有由命令指定的管理权限。否则，系统会生成SQLCODE-99错误(权限冲突)。

如果包含函数定义的类定义是已部署的类，则不能删除该函数。此操作失败，并出现错误，并显示以修改已部署的类：。

支持名称和的以下组合。请注意，子句指定类包名称和函数名称，而不是SQL名称。

第三十一章 SQL命令 DROP DATABASE

删除数据库(命名空间)。

大纲

DROP DATABASE dbname [RETAIN_FILES]

参数

• dbname - 要删除的数据库(命名空间)的名称。
• RETAIN_FILES - 可选-如果指定，则不会删除物理数据库文件(IRIS.DAT文件)。默认情况下，删除.dat文件以及命名空间和其他数据库实体。

描述

DROP DATABASE命令删除命名空间及其关联的数据库。

指定的是包含相应数据库文件的命名空间和目录的名称。指定作为标识符。命名空间名称不区分大小写。如果指定的DBNAME命名空间不存在， IRIS将发出错误。

命令是一个特权操作。 在使用之前，必须以%Admin_Manage资源的用户身份登录。 用户还必须拥有用于例程和全局数据库定义的资源的权限。 如果不这样做，将导致错误(权限冲突)。

使用方法为用户分配适当的权限:

   DO $SYSTEM.Security.Login("_SYSTEM","SYS")
   &sql(      )

必须具有%Service_Login：Use权限才能调用方法。

不管权限如何，都不能用于删除系统命名空间。尝试这样做会导致错误。

不能用于删除当前正在使用或连接到的命名空间。尝试这样做会导致错误。

还可以使用管理门户删除命名空间。

第三十章 SQL命令 DROP AGGREGATE

删除用户定义的聚合函数。

大纲

DROP AGGREGATE name

参数

• name - 要删除的用户定义聚合函数的名称。名称可以是限定的(schema.aggname)，也可以是非限定的(aggname)。非限定名称采用默认架构名称。

描述

DROP Aggregate命令删除用户定义的聚合函数(UDAF)。使用命令创建用户定义的聚合函数。

如果尝试删除不存在的UDAF，SQL会发出错误，并显示如下消息：.

删除UDAF会自动清除引用该的所有缓存查询。

第二十九章 SQL命令 DISTINCT

指定仅返回不同值的SELECT子句。

大纲

SELECT [DISTINCT [BY (item {,item2})] ]  |  [ALL]
  select-item {,select-item2}

参数

• DISTINCT - 可选-返回组合选择项值唯一的行。
• DISTINCT BY (item {,item2}) - 可选-返回按(项)值唯一的行的选择项值。
• ALL - 可选-返回结果集中的所有行。默认设置。

描述

可选子句出现在关键字之后、可选TOP子句和第一个之前。

子句应用于语句的结果集。它将每个不同(唯一)值返回的行数限制为一个任意行。如果未指定子句，则默认情况下显示满足选择条件的所有行。子句与不指定子句相同；如果指定，将返回表中满足选择条件的所有行。

从句有两种形式：

• SELECT DISTINCT：为选择项值的每个唯一组合返回一行。可以指定一个或多个选择项。例如，以下查询返回一行，其中包含Home_State和值的每个唯一组合的和值：

• ：为项目值的每个唯一组合返回一行。可以指定单个项目或逗号分隔的项目列表。指定的项目或项目列表必须用括号括起来。可以在by关键字和圆括号之间指定或省略空格。选择项列表可以(但不一定)包括指定的项。例如，以下查询返回一行，其中包含和Age值的每个唯一组合的和值：

SELECT DISTINCT BY (Home_State,Age) Name,Age FROM Sample.Person

第二十八章 SQL命令 DELETE（二）

示例

以下两个示例都删除了TempEmployees表中的所有行。请注意，FROM关键字是可选的：

DELETE FROM TempEmployees

DELETE TempEmployees

以下示例从Employees表中删除员工编号234：

DELETE
     FROM Employees
     WHERE EmpId = 234

下面的示例从表中删除CurStatus列设置为“RETIRED”的所有行：

下面的示例使用子查询删除行：

嵌入式SQL和动态SQL示例

在下面的一组程序示例中，第一个程序创建了一个名为的表，该表有三列。下一个程序插入六条记录。后续程序使用基于指针的嵌入式删除所有英语记录，并使用动态SQL删除所有法语记录。最后一个程序显示剩余的记录，然后删除该表。

第二十七章 SQL命令 DELETE（一）

从表中删除行。

大纲

DELETE [%keyword] [FROM] table-ref [[AS] t-alias]
     [FROM [optimize-option] select-table [[AS] t-alias]
              {,select-table2 [[AS] t-alias]} ]
     [WHERE condition-expression]

DELETE [%keyword] [FROM] table-ref [[AS] t-alias]
     [WHERE CURRENT OF cursor]

参数

• %keyword - 可选-以下一个或多个关键字选项，以空格分隔：%NOCHECK、%NOFPLAN、、、、、、。
• - 要从中删除行的表。这不是子句；它是一个FROM关键字，后跟一个表引用。(关键字是可选的；是必需的。)表名(或视图名)可以是限定的()，也可以是不限定的()。使用架构搜索路径(如果提供)或默认架构名称将非限定名称与其架构匹配。可以指定可通过其删除表行的视图，而不是表引用，也可以指定括在圆括号中的子查询。与语句子句不同，不能在此处指定关键字。不能在此参数中指定表值函数或联接语法。
• - 可选-子句，在table-ref

第二十六章 SQL命令 DECLARE

声明游标

大纲

DECLARE cursor-name CURSOR FOR query

参数

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

描述

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

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

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

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

游标名称

游标名称区分大小写。

第二十五章 SQL命令 CREATE VIEW（二）

通过视图更新

视图可用于更新视图所基于的表。可以通过视图插入新行，更新通过视图看到的行中的数据，以及删除通过视图看到的行。如果CREATE VIEW语句指定了此功能，则可以为视图发出INSERT、UPDATE和语句。要允许通过视图进行更新，请在定义视图时指定选项(默认值)。

注意:如果视图基于分片表，则不能通过视图进行、UPDATE或操作。 尝试这样做会导致一个，其中。

若要防止通过视图进行更新，请指定。尝试通过使用创建的视图执行插入、更新或删除操作会生成SQLCODE-35错误。

要通过视图进行更新，必须具有要更新表或视图的适当权限，如命令所指定。

通过视图更新受以下限制：

• 该视图不能是投影为视图的类查询。
• 视图的类不能包含类参数READONLY=1。
• 视图的SELECT语句不能包含DISTINCT、TOP、或子句，也不能是的一部分。
• 视图的语句不能包含子查询。
• 视图的语句只能列出作为列引用的值表达式。
• 视图的语句只能有一个表引用；它不能在或子句中包含子句、联接语法或箭头语法。表引用必须指定可更新的表或可更新的视图。

子句导致或UPDATE操作根据视图定义的子句验证结果行。这可确保插入或修改的行是派生视图表格的一部分。有两个可用的检查选项：

第二十四章 SQL命令 CREATE VIEW（一）

创建视图

大纲

CREATE [OR REPLACE] VIEW view-name [(column-commalist)]
       AS select-statement 
       [ WITH READ ONLY  |  WITH [level] CHECK OPTION ]

参数

• view-name - 正在创建的视图的名称。有效的标识符，受与表名相同的附加命名限制。视图名称可以是限定的(schema.viewname)，也可以是不限定的(Viewname)。未限定的视图名称采用默认架构名称。请注意，同一架构中的表和视图不能使用相同的名称。
• - 可选-组成视图的列名、一个或多个有效标识符。如果指定，此列表括在圆括号中，列表中的项目用逗号分隔。
• - 定义视图的SELECT语句。
• WITH READ ONLY - 可选-指定不能通过此视图对视图所基于的表执行插入、更新或删除操作。默认情况下，允许通过视图执行这些操作，但要遵守下面描述的约束条件。
• - 可选-指定如何通过此视图对视图所基于的表执行插入、更新或删除操作。级别可以是关键字LOCAL或。如果未指定级别，则选项默认为级联。

描述

命令定义视图的内容。定义视图的语句可以引用多个表，也可以引用其他视图。

权限

命令是特权操作。

第二十三章 SQL命令 CREATE USER

创建用户帐户。

大纲

CREATE USER user-name IDENTIFY BY password

CREATE USER user-name IDENTIFIED BY password

参数

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

描述

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

用户名可以是最多个字符的任何有效标识符。用户名必须遵循标识符命名约定。用户名可以包含字符。用户名不区分大小写。

作为分隔标识符指定的用户名可以是SQL保留字，可以包含逗号()、句号()、插入符号()和两个字符的箭头序列()。 它可以以除星号()以外的任何有效字符开头。

和关键字是同义词。

密码可以是数字文字、标识符或带引号的字符串。数字文字或标识符不必用引号括起来。带引号的字符串通常用于在密码中包含空格；带引号的密码可以包含除引号字符本身之外的任何字符组合。数字文字只能由0到字符组成。标识符必须以字母(大写或小写)或%(百分号)开头；后面可以是字母、数字或以下任何符号的任意组合：(下划线)。

第二十二章 SQL命令 CREATE TRIGGER（二）

SQL触发器代码

如果LANGUAGE SQL(默认)，被触发的语句是一个SQL过程块，包括一个SQL过程语句后跟一个分号，或者关键字BEGIN后跟一个或多个SQL过程语句，每个SQL过程语句后跟一个分号，最后以END关键字结束。

被触发的操作是原子的，它要么完全应用，要么根本不应用，并且不能包含或语句。 关键字BEGIN ATOMIC与关键字是同义词。

如果语言是SQL, 语句可以选择包含引用子句、子句和/或UPDATE OF子句。 子句指定，只有在对为该触发器指定的一个或多个列执行时，才应该执行该触发器。 带有的语句不能包含这些子句。

SQL触发器代码作为嵌入式SQL执行。 这意味着IRIS将SQL触发器代码转换为ObjectScript; 因此，如果查看与SQL触发器代码对应的类定义，将在触发器定义中看到。

在执行SQL触发器代码时，系统会自动重置()触发器代码中使用的所有变量。 在执行每条SQL语句之后 IRIS会检查SQLCODE。 如果发生错误，IRIS将变量设置为，终止并回滚触发器代码操作和相关的、或。

ObjectScript触发代码

如果，则语句不能包含引用子句、子句或子句。 使用指定这些仅sql子句将分别导致编译时错误、或。

如果

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

创建触发器

大纲

CREATE TRIGGER trigname {BEFORE | AFTER} event [,event]
          [ORDER integer]
          ON table
          [REFERENCING {OLD | NEW} [ROW] [AS] alias]
         action

参数

• trigname - 要创建的触发器的名称，它是一个标识符。触发器名称可以是限定的，也可以是非限定的；如果限定，则其架构名称必须与表的架构名称匹配。
• BEFORE event，AFTER event - 事件执行触发器的时间(之前或之后)。 触发器事件或以逗号分隔的触发器事件列表。可用的事件列表选项包括INSERT、和。 可以指定事件的单个更新。子句后跟列名或逗号分隔的列名列表。仅当为时才能指定子句。不能在逗号分隔的事件列表中指定子句。
• - 可选-当具有相同时间和事件的表有多个触发器时，触发器的执行顺序。如果省略顺序，则为触发器分配的顺序为0。
• - 为其创建触发器的表。表名可以是限定的，也可以是非限定的；如果限定，则触发器必须驻留在与表相同的架构中。
• REFERENCING OLD ROW AS alias，

第二十章 SQL命令 CREATE TABLE AS SELECT

将现有表中的列定义和列数据复制到新表中。

大纲

CREATE TABLE table-name AS query [shard-key] [WITH table-option]

参数

• table-name 要创建的表的名称，指定为有效标识符。表名可以是限定的(schema.table)，也可以是非限定的(Table)。未限定的表名采用缺省模式名。
• 为新表提供列定义和列数据的查询。此查询可以指定表、视图或多个联接的表。
• shard-key - 可选-切片键定义，由切片键本身或后跟附加切片键定义语法组成。
• - 可选-一个或多个表选项的逗号分隔列表，如%CLASSPARAMETER关键字后跟名称和关联的文字，或STORAGETYPE=ROW或。

描述

命令通过复制查询中指定的现有表(或多个表)中的列定义和列数据来创建新表。查询可以指定表或视图的任意组合。

注：现有表定义。使用命令指定新的表定义。

还可以使用QueryToTable()方法调用复制表操作:

复制数据定义

• 从查询表复制列定义。要重命名复制的列，请在查询中指定列别名。

如果查询指定联接的表，可以从多个表复制列定义。

• 始终将RowID定义为隐藏。
  • 如果源表具有隐藏的RowID，则CREATE TABLE AS SELECT