DROP 语句

DROP 语句用于从当前或指定的 Catalog 中删除一个已经注册的表、视图或函数。

Flink SQL 目前支持以下 DROP 语句:

  • DROP TABLE
  • DROP DATABASE
  • DROP FUNCTION

执行 DROP 语句

可以使用 TableEnvironment 中的 sqlUpdate() 方法执行 DROP 语句,也可以在 SQL CLI 中执行 DROP 语句。 若 DROP 操作执行成功,sqlUpdate() 方法不返回任何内容,否则会抛出异常。

以下的例子展示了如何在 TableEnvironment 和 SQL CLI 中执行一个 DROP 语句。

  1. EnvironmentSettings settings = EnvironmentSettings.newInstance()...
  2. TableEnvironment tableEnv = TableEnvironment.create(settings);
  3. // 注册名为 “Orders” 的表
  4. tableEnv.sqlUpdate("CREATE TABLE Orders (`user` BIGINT, product STRING, amount INT) WITH (...)");
  5. // 字符串数组: ["Orders"]
  6. String[] tables = tableEnv.listTable();
  7. // 从 catalog 删除 “Orders” 表
  8. tableEnv.sqlUpdate("DROP TABLE Orders");
  9. // 空字符串数组
  10. String[] tables = tableEnv.listTable();
  1. val settings = EnvironmentSettings.newInstance()...
  2. val tableEnv = TableEnvironment.create(settings)
  3. // 注册名为 “Orders” 的表
  4. tableEnv.sqlUpdate("CREATE TABLE Orders (`user` BIGINT, product STRING, amount INT) WITH (...)");
  5. // 字符串数组: ["Orders"]
  6. val tables = tableEnv.listTable()
  7. // 从 catalog 删除 “Orders” 表
  8. tableEnv.sqlUpdate("DROP TABLE Orders")
  9. // 空字符串数组
  10. val tables = tableEnv.listTable()
  1. settings = EnvironmentSettings.newInstance()...
  2. table_env = TableEnvironment.create(settings)
  3. # 字符串数组: ["Orders"]
  4. tables = tableEnv.listTable()
  5. # 从 catalog 删除 “Orders” 表
  6. tableEnv.sqlUpdate("DROP TABLE Orders")
  7. # 空字符串数组
  8. tables = tableEnv.listTable()
  1. Flink SQL> CREATE TABLE Orders (`user` BIGINT, product STRING, amount INT) WITH (...);
  2. [INFO] Table has been created.
  3. Flink SQL> SHOW TABLES;
  4. Orders
  5. Flink SQL> DROP TABLE Orders;
  6. [INFO] Table has been removed.
  7. Flink SQL> SHOW TABLES;
  8. [INFO] Result was empty.

DROP TABLE

  1. DROP TABLE [IF EXISTS] [catalog_name.][db_name.]table_name

根据给定的表名删除某个表。若需要删除的表不存在,则抛出异常。

IF EXISTS

表不存在时不会进行任何操作。

DROP DATABASE

  1. DROP DATABASE [IF EXISTS] [catalog_name.]db_name [ (RESTRICT | CASCADE) ]

根据给定的表名删除数据库。若需要删除的数据库不存在会抛出异常 。

IF EXISTS

若数据库不存在,不执行任何操作。

RESTRICT

当删除一个非空数据库时,会触发异常。(默认为开)

CASCADE

删除一个非空数据库时,把相关联的表与函数一并删除。

DROP FUNCTION

  1. DROP [TEMPORARY|TEMPORARY SYSTEM] FUNCTION [IF EXISTS] [catalog_name.][db_name.]function_name;

删除一个有 catalog 和数据库命名空间的 catalog function。若需要删除的函数不存在,则会产生异常。

TEMPORARY

删除一个有 catalog 和数据库命名空间的临时 catalog function。

TEMPORARY SYSTEM

删除一个没有数据库命名空间的临时系统函数。

IF EXISTS

若函数不存在,则不会进行任何操作。