第三十九章 SQL命令 DROP TRIGGER

删除触发器

大纲

DROP TRIGGER name [ FROM table ]

参数

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

描述

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

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

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

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

第三十八章 SQL命令 DROP TABLE

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

大纲

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

参数

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

描述

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

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

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

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

• 该表必须存在于当前命名空间中。

第三十七章 SQL命令 DROP ROLE

删除角色

大纲

DROP ROLE role-name

参数

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

描述

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

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

权限

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

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

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

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

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

必须具有%Service_Login：Use权限才能调用$SYSTEM.Security.Login方法。

第三十六章 SQL命令 DROP QUERY

删除查询

大纲

DROP QUERY name [ FROM className ]

参数

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

描述

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

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

如果包含查询定义的类定义是已部署的类，则不能删除该查询。

第三十五章 SQL命令 DROP PROCEDURE

删除存储过程

大纲

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

参数

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

描述

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

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

第三十四章 SQL命令 DROP METHOD

删除方法

大纲

DROP METHOD name [ FROM className ]

参数

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

描述

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

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

如果包含方法定义的类定义是已部署的类，则不能删除该方法。

第三十三章 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 table-name 或 ON TABLE table-name - 可选-与索引关联的表的名称。可以使用任一语法指定表名：第一个语法使用ON子句；TABLE关键字是可选的。第二个语法使用限定名称语法schema-name.table-name.index-name。表名可以是限定的(schema.table)，也可以是非限定的(Table)。未限定的表名采用缺省模式名。如果完全省略表名， IRIS将删除找到的第一个与index-name匹配的索引，如下所述。

描述

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

第三十二章 SQL命令 DROP FUNCTION

删除函数

大纲

DROP FUNCTION name [ FROM className ]

参数

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

描述

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

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

如果包含函数定义的类定义是已部署的类，则不能删除该函数。

第三十一章 SQL命令 DROP DATABASE

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

大纲

DROP DATABASE dbname [RETAIN_FILES]

参数

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

描述

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

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

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

使用$SYSTEM.Security.Login()方法为用户分配适当的权限:

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

必须具有%Service_Login：Use权限才能调用$SYSTEM.Security.Login方法。

第三十章 SQL命令 DROP AGGREGATE

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

大纲

DROP AGGREGATE name

参数

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

描述

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

如果尝试删除不存在的UDAF，SQL会发出SQLCODE-428错误，并显示如下消息：User Defined Aggregate Function Sample.SecondHighest does not exist.

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

第二十九章 SQL命令 DISTINCT

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

大纲

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

参数

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

描述

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

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

DISTINCT从句有两种形式：

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

SELECT DISTINCT Home_State,Age FROM Sample.

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

示例

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

DELETE FROM TempEmployees

DELETE TempEmployees

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

DELETE
     FROM Employees
     WHERE EmpId = 234

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

DELETE FROM ActiveEmployees
     WHERE CurStatus = 'Retired'

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

DELETE FROM (SELECT Name,Age FROM Sample.Person WHERE Age > 65)

嵌入式SQL和动态SQL示例

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

ClassMethod Delete1()
{
	&sql(
		CREATE TABLE SQLUser.

第二十七章 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、%NOINDEX、%NOJOURN、%NOLOCK、%NOTRIGGER、%PROFILE、%PROFILE_ALL。
• FROM table-ref - 要从中删除行的表。这不是FROM子句；它是一个FROM关键字，后跟一个表引用。(FROM关键字是可选的；table-ref是必需的。)表名(或视图名)可以是限定的(schema.table)，也可以是不限定的(Table)。使用架构搜索路径(如果提供)或默认架构名称将非限定名称与其架构匹配。

第二十六章 SQL命令 DECLARE

声明游标

大纲

DECLARE cursor-name CURSOR FOR query

参数

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

描述

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

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

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

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

通过视图更新

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

注意:如果视图基于分片表，则不能通过WITH CHECK OPTION视图进行INSERT、UPDATE或DELETE操作。 尝试这样做会导致一个SQLCODE -35，其中%msg INSERT/UPDATE/DELETE not allowed for view (sample.myview) based on sharded table with check option conditions。

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

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

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

• 该视图不能是投影为视图的类查询。
• 视图的类不能包含类参数READONLY=1。

第二十四章 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)。未限定的视图名称采用默认架构名称。请注意，同一架构中的表和视图不能使用相同的名称。
• column-commalist - 可选-组成视图的列名、一个或多个有效标识符。如果指定，此列表括在圆括号中，列表中的项目用逗号分隔。
• AS select-statement - 定义视图的SELECT语句。
• WITH READ ONLY - 可选-指定不能通过此视图对视图所基于的表执行插入、更新或删除操作。默认情况下，允许通过视图执行这些操作，但要遵守下面描述的约束条件。
• WITH level CHECK OPTION - 可选-指定如何通过此视图对视图所基于的表执行插入、更新或删除操作。级别可以是关键字LOCAL或CASCADED。

第二十三章 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命令使用指定的密码创建用户帐户。

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

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

IDENTIFY BY和IDENTIFIED BY关键字是同义词。

密码可以是数字文字、标识符或带引号的字符串。数字文字或标识符不必用引号括起来。带引号的字符串通常用于在密码中包含空格；带引号的密码可以包含除引号字符本身之外的任何字符组合。数字文字只能由0到9字符组成。

Object Script(四)

面向脚本

• 
  

  类

类的主要类型

类成员

Object Script(三)

面向脚本

• 
  

  Routine

可将routine看做全局可调用的函数，一个函数是一个执行程序(Roution)，它执行一个操作（例如，将一个字符串转换为其对应的ASCII码值）并且可以返回一个值。

语法结构：

Routine可以有一个标签，ObjectScript代码，以及结尾的注释，所有这些元素都是可选的。可以使用"；"或"//"来表示注释。对于多行注释，用"/*"标记注释的开头，用 "*/"标记注释的结尾。

结构示例:

标签

      ObjectScript代码

end

• 
  

  创建Routine示例

Studio创建:

打开Studio，点击左上角新建文件。选择General->ObjectScript Routine

将下段代码填写入建好的Routine。

        hello ; hello world routine
            write !, "hello world"
          write !, "bye"
      end quit  ; end

Terminal调用：

打开Terminal，执行下段代码，即可检查结果。

    do ^hello

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

SQL触发器代码

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

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

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

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

在执行SQL触发器代码时，系统会自动重置(NEWs)触发器代码中使用的所有变量。 在执行每条SQL语句之后 IRIS会检查SQLCODE。

第二十一章 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、DELETE和UPDATE。 可以指定事件的单个更新。UPDATE OF子句后跟列名或逗号分隔的列名列表。仅当language为SQL时才能指定UPDATE OF子句。不能在逗号分隔的事件列表中指定UPDATE OF子句。
• ORDER integer - 可选-当具有相同时间和事件的表有多个触发器时，触发器的执行顺序。如果省略顺序，则为触发器分配的顺序为0。
• ON table - 为其创建触发器的表。

第二十章 SQL命令 CREATE TABLE AS SELECT

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

大纲

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

参数

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

描述

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

注：CREATE TABLE AS SELECT COPPLICES FROM现有表定义。使用CREATE TABLE命令指定新的表定义。

第十九章 SQL命令 CREATE TABLE（六）

WITH子句，%CLASSPARAMETER关键字，STORAGETYPE关键字

可选的WITH子句可以在表格元素逗号结尾的圆括号之后和Shard Key定义(如果存在的话)之后指定。 WITH子句可以包含一个用逗号分隔的列表:

• 一个或多个%CLASSPARAMETER 子句。
• STORAGETYPE子句

%CLASSPARAMETER子句

在WITH关键字之后，可以指定多个%CLASSPARAMETER关键字子句，每个子句定义一个类参数。 多个%CLASSPARAMETER子句子句之间用逗号分隔。 为了向后兼容，支持将%CLASSPARAMETER关键字子句指定为table-element-commalist中的元素。 在两个位置中指定相同的%CLASSPARAMETER关键字子句将产生SQLCODE -327错误。

%CLASSPARAMETER关键字后面跟着类参数名称、一个可选的等号和要分配给该类参数的文字值(字符串或数字)。 类参数总是定义为常数值。

因为用户可以用任何名称或值定义额外的类参数，所以只执行语法验证; 既不验证类参数是否存在，也不验证类参数的有效值。

第十八章 SQL命令 CREATE TABLE（五）

定义外键

外键是引用另一个表的字段；存储在外键字段中的值是唯一标识另一个表中的记录的值。此引用的最简单形式如下例所示，其中外键显式引用Customers表中的主键字段CustID：

CREATE TABLE Orders (
   OrderID INT UNIQUE NOT NULL,
   OrderItem VARCHAR,
   OrderQuantity INT,
   CustomerNum INT,
   CONSTRAINT OrdersPK PRIMARY KEY (OrderID),
   CONSTRAINT CustomersFK FOREIGN KEY (CustomerNum) REFERENCES Customers (CustID)
   )

最常见的情况是，外键引用另一个表的主键字段。但是，外键可以引用RowID(ID)或标识列。在任何情况下，外键引用都必须存在于被引用的表中，并且必须定义为唯一的；被引用的字段不能包含重复值或NULL。

在外键定义中，可以指定：

• 字段名:FOREIGN KEY (CustomerNum) REFERENCES Customers (CustID)。

第十七章 SQL命令 CREATE TABLE（四）

唯一字段约束

唯一字段约束对多个字段的组合值施加唯一值约束。它具有以下语法：

CONSTRAINT uname UNIQUE (f1,f2)

此约束指定字段f1和f2的值组合必须始终是唯一的，即使这两个字段本身的值可能不是唯一的。可以为此约束指定一个、两个或多个字段。

此约束中指定的所有字段都必须在字段定义中定义。如果在此约束中指定的字段没有出现在字段定义中，则会生成SQLCODE-86错误。指定的字段应定义为非空。任何指定的字段都不应定义为唯一的，因为这会使指定此约束变得毫无意义。

字段可以按任何顺序指定。字段顺序指定相应索引定义的字段顺序。允许重复的字段名称。虽然可以在唯一字段约束中指定单个字段名称，但这与为该字段指定唯一数据约束在功能上是相同的。单字段约束确实提供了约束名称以供将来使用。

可以在表定义中指定多个唯一字段约束语句。约束语句可以在字段定义中的任何位置指定；按照惯例，它们通常放在已定义字段列表的末尾。

约束名称

Constraint关键字和唯一字段约束名称是可选的。以下各项在功能上等效：

CONSTRAINT myuniquefields UNIQUE (name,dateofbirth)
UNIQUE (name,dateofbirth)

约束名唯一地标识约束，并且还用于派生相应的索引名。

第十六章 SQL命令 CREATE TABLE（三）

字段数据约束

数据约束控制字段允许使用的值、字段的默认值以及数据值使用的排序规则类型。所有这些数据约束都是可选的。可以按任何顺序指定多个数据约束，并以空格分隔。

NULL和NOT NULL

NOT NULL数据约束关键字指定该字段不接受空值；换句话说，每条记录都必须为该字段指定一个值。NULL和空字符串('') IRIS中是不同的值。可以在接受字符串的字段中输入空字符串，即使该字段定义了NOT NULL限制也是如此。不能在数值字段中输入空字符串。

NULL数据约束关键字显式指定此字段可以接受空值；这是字段的默认定义。

UNIQUE

唯一数据约束指定此字段仅接受唯一值。因此，没有两条记录可以包含该字段的相同值。SQL空字符串('')被视为数据值，因此在应用了UNIQUE数据约束的情况下，任何两条记录都不能包含此字段的空字符串值。NULL不被视为数据值，因此唯一数据约束不适用于多个NULL。要限制字段使用NULL，请使用NOT NULL关键字约束。

• 唯一数据约束要求指定字段的所有值都是唯一值。
• UNIQUE fields constraint(使用CONSTRAINT关键字)要求一组指定字段的所有值在串联在一起时产生唯一值。不需要将各个字段限制为唯一值。

定义为分片表的表对UNIQUE数据约束的使用有额外的限制。

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

全局临时表

指定GLOBAL TEMPORARY关键字将表定义为全局临时表。表定义是全局的(对所有进程都可用)；表数据是临时的(在进程期间持续存在)。相应的类定义包含一个附加的类参数SQLTABLETYPE=“GLOBAL TEMPORARY”。与标准的 IRIS表一样，ClassType=Persistent，并且类包含Final关键字，表示它不能有子类。

无论哪个进程创建临时表，临时表的所有者都会自动设置为_PUBLIC。这意味着所有用户都可以访问缓存的临时表定义。例如，如果存储过程创建了一个临时表，则允许调用该存储过程的任何用户都可以访问该表定义。这仅适用于临时表定义；临时表数据特定于调用，因此只能由当前用户进程访问。

全局临时表的表定义与基表相同。全局临时表必须具有唯一的名称；尝试为其提供与现有基表相同的名称会导致SQLCODE-201错误。该表将一直存在，直到显式删除(使用DROP TABLE)。可以使用ALTER TABLE更改表定义。

下面的嵌入式SQL示例创建一个全局临时表：

ClassMethod CreateTable3()
{
	d $SYSTEM.Security.

第十四章 SQL命令 CREATE TABLE（一）

创建表

大纲

CREATE [GLOBAL TEMPORARY] TABLE 
table (table-element-commalist) [shard-key] [WITH table-option-commalist]

table-element ::= 
     [%DESCRIPTION string] 
     [%FILE string] 
     [{%EXTENTSIZE | %NUMROWS} integer] 
     [%PUBLICROWID] 
     [%ROUTINE string] 
   
    { fieldname datatype [AUTO_INCREMENT] | IDENTITY | SERIAL | ROWVERSION 
            [ %DESCRIPTION string ]
           {
             [ [COLLATE] sqlcollation ]
             [ UNIQUE ]
             [ NULL | NOT NULL ]
             [ PRIMARY KEY ]
             [ REFERENCES table

第十三章 SQL命令 CREATE ROLE

创建角色

大纲

CREATE ROLE role-name

参数

• role-name - 要创建的角色的名称，它是一个标识符。角色名称不区分大小写。

描述

CREATE ROLE命令可创建角色。角色是可以分配给多个用户的一组命名权限。一个角色可以分配给多个用户，一个用户可以分配多个角色。角色在系统范围内可用，它不限于特定的命名空间。

角色名可以是最多64个字符的任何有效标识符。角色名称必须遵循标识符命名约定。角色名称可以包含Unicode字符。角色名称不区分大小写。如果选中了支持分隔标识符配置选项(默认设置)，则角色名可以是用引号括起来的分隔标识符。如果是分隔标识符，则角色名可以是SQL保留字。它可以包含句点(.)、插入符号(^)和两个字符的箭头序列(->)。它不能包含逗号(，)或冒号(：)字符。它可以以除星号(*)以外的任何有效字符开头。

最初创建角色时，角色只是一个名称；它没有权限。要向角色添加权限，请使用GRANT命令。还可以使用GRANT命令为角色分配一个或多个角色。这允许创建角色层次结构。

如果调用CREATE ROLE来创建已经存在的角色，SQL会发出SQLCODE-118错误。可以通过调用$SYSTEM.SQL.Security.RoleExists()方法确定角色是否已存在：

  WRITE $SYSTEM.SQL.Security.

第十二章 SQL命令 CREATE QUERY

创建Query

大纲

CREATE QUERY queryname(parameter_list) [characteristics] 
   [ LANGUAGE SQL ]
   BEGIN
code_body ;
   END

CREATE QUERY queryname(parameter_list) [characteristics] 
    LANGUAGE OBJECTSCRIPT
   { code_body }

参数

• queryname - 要在存储过程类中创建的查询的名称。queryname必须是有效的标识符。过程名可以是限定的(schema.procname)，也可以是非限定的(procname)。非限定过程名接受默认模式名。即使没有指定参数，queryname也必须后跟括号。
• parameter_list - 可选-传递给查询的参数列表。参数列表用圆括号括起来，列表中的参数用逗号分隔。即使没有指定参数，括号也是必须的。
• characteristics - 可选-指定查询特征的一个或多个关键字。允许的关键字有结果、容器ID、FOR、FINAL、PROCEDURE、SELECTMODE。多个特征由空白(空格或换行符)分隔。特性可以以任何顺序指定。