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     }}