第三十八章 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删除与该表关联的所有索引和触发器。
要删除表格，必须满足以下条件：
- 该表必须存在于当前命名空间中。尝试删除不存在的表会生成
SQLCODE-30错误。 - 表定义必须是可修改的。如果投影表的类没有定义
[DdlAllowed]，则尝试删除该表会生成SQLCODE-300错误。 - 该表不能被另一个并发进程锁定。如果表被锁定，
DROP TABLE将无限期等待锁被释放。如果可能出现锁争用，那么在发出DROP TABLE之前以独占模式锁定表是很重要的。 - 该表必须没有关联的视图，或者
DROP TABLE必须指定CASCADE关键字。尝试在不级联的情况下删除具有关联视图的表会生成SQLCODE-321错误。 - 必须具有必要的权限才能删除该表。尝试在没有必要权限的情况下删除表会生成
SQLCODE-99错误。 - 即使相应的类被定义为已部署的类，也可以删除表。
- 如果投影表的持久类具有派生类(子类)，则不能删除该表。尝试删除会使子类成为孤立的超类时，会生成
SQLCODE-300错误，并显示以下消息：Class 'MySuperClass' has derived classes and therefore cannot be dropped via DDL.
可以使用$SYSTEM.SQL.Schema.DropTable()方法删除当前名称空间中的表。可以指定SQL表名。与DROP TABLE不同，此方法可以删除未使用[DdlAllowed]定义的表。第二个参数指定是否也应该删除表数据；默认情况下，不删除数据。
DO $SYSTEM.SQL.Schema.DropTable("Sample.MyTable",1,.SQLCODE,.%msg)
IF SQLCODE '= 0 {WRITE "SQLCODE ",SQLCODE," error: ",%msg}
可以使用$SYSTEM.OBJ.Delete()方法删除当前名称空间中的一个或多个表。必须指定投影表的永久类名(而不是SQL表名)。可以使用通配符指定多个类名。第二个参数指定是否也应该删除表数据；默认情况下，不删除数据。
权限
DROP TABLE命令是特权操作。用户必须具有%DROP_TABLE管理权限才能执行DROP TABLE。否则将导致SQLCODE-99错误，因为%msg用户没有%DROP_TABLE权限。如果拥有适当的授予权限，则可以使用GRANT命令分配%DROP_TABLE权限。
即使DROP TABLE操作同时删除了表和表数据，用户也不必具有指定表的DELETE OBJECT权限。
在嵌入式SQL中，可以使用$SYSTEM.Security.Login()方法以具有适当权限的用户身份登录：
DO $SYSTEM.Security.Login("_SYSTEM","SYS")
&sql( )
必须具有%Service_Login：Use权限才能调用$SYSTEM.Security.Login方法。
DROP TABLE不能用于通过定义持久类创建的表，除非表类定义包括[DdlAllowed]。否则，操作将失败，并出现SQLCODE-300错误，同时未为类‘Schema.tablename’启用%msg DDL。
Existing Object Privileges
删除表不会删除该表的对象权限。例如，授予用户在该表上插入、更新或删除数据的权限。
- 如果删除一个表，然后创建另一个同名的表，则用户和角色对新表的权限将与对旧表的权限相同。
- 一旦表被删除，就不可能撤销该表的对象权限。
由于这些原因，通常建议在删除表之前使用REVOKE命令撤消表中的对象权限。
包含数据的表
默认情况下，DROP TABLE删除表定义和表数据。此表数据删除是原子操作；如果DROP TABLE遇到无法删除的数据(例如，具有引用约束的行)，则任何已执行的数据删除都会自动回滚，结果是不会删除表数据。
可以使用$SYSTEM.SQL.Util.SetOption()方法DDLDropTabDelData选项设置表数据删除的系统范围默认值。要确定当前设置，请调用$SYSTEM.SQL.CurrentSettings()，显示Does DDL DROP TABLE delete the table's data? setting.
默认值为1(“是”)。这是此选项的推荐设置。如果希望DROP TABLE在删除表定义时不删除表数据，请将此选项设置为0(“否”)。
可以在每个表的基础上覆盖数据删除。删除表时，可以使用%NODELDATA选项指定DROP TABLE，以防止自动删除表数据。如果系统范围的默认值设置为不删除表数据，则可以通过使用%DELDATA选项指定DROP TABLE来逐个表删除数据。
在大多数情况下，DROP TABLE使用高效的终止范围操作自动删除表的数据。以下情况阻止使用KILL EXTEND：表有引用它的外键；投影表的类是持久类的子类；类不使用默认存储；有ForEach = "row/object"触发器；有引用非默认流字段全局位置的流字段。如果其中任何一个适用，DROP TABLE将使用效率较低的DELETE RECORD操作删除表的数据。
可以使用TRUNCATE TABLE命令删除表的数据，而不删除表定义。
锁应用
DROP TABLE语句获取表的独占表级锁。这可以防止其他进程在表删除过程中修改表定义或表数据。这个表级锁足以删除表定义和表数据；DROP TABLE不会获得表数据的每一行的锁。此锁在DROP TABLE操作结束时自动释放。
外键约束
默认情况下，如果在引用尝试删除的表的另一个表上定义了任何外键约束，则不能删除该表。在删除它们引用的表之前，必须删除所有引用的外键约束。在尝试DROP TABLE操作之前未删除这些外键约束会导致SQLCODE-320错误。
此默认行为与限制关键字选项一致。外键约束不支持CASCADE关键字选项。
要更改此默认外键约束行为，请参考SET OPTION命令的COMPILEMODE=NOCHECK选项。
相关查询
删除表会自动清除所有相关的高速缓存查询，并清除%SYS.PTools.StatsSQL生成的查询信息。删除表会自动清除任何相关查询的所有SQL运行时统计信息(SQL Stats)信息。
不存在的表
要确定当前命名空间中是否存在指定表，请使用$SYSTEM.SQL.Schema.TableExists()方法。
默认情况下，如果尝试删除不存在的表，DROP TABLE会发出SQLCODE-30错误。这是推荐的设置。要确定当前设置，请调用$SYSTEM.SQL.CurrentSettings()，它显示允许DDL删除不存在的表或视图设置。默认值为0(“否”)。如果此选项设置为1(“是”)，则不存在的表的DROP TABLE不执行任何操作，也不会发出错误消息。
在管理门户、系统管理、配置、SQL和对象设置中，通过选中忽略冗余DDL语句复选框，可以在系统范围内设置此选项(以及其他类似的创建、更改和删除选项)。
示例
下面的嵌入式SQL示例创建名为SQLUser.MyEmployees的表，然后将其删除。此示例指定在删除该表时不删除与该表关联的任何数据：
ClassMethod DropTable()
{
&sql(CREATE TABLE SQLUser.MyEmployees
(
NAMELAST CHAR (30) NOT NULL,
NAMEFIRST CHAR (30) NOT NULL,
STARTDATE TIMESTAMP,
SALARY MONEY
)
)
w !,"创建表"
/*
&sql(SQL code populating SQLUser.MyEmployees table)
&sql(SQL code using SQLUser.MyEmployees table)
*/
n SQLCODE,%msg
&sql(DROP TABLE SQLUser.MyEmployees %NODELDATA)
if SQLCODE = 0 {
w !,"表已删除"
} else {
w !,"SQLCODE=",SQLCODE,": ",%msg
}
}
