SYSTEM$CANCEL_CLASSIFY_SCHEMA

计划取消指定架构中表的分类过程。针对用于调用此存储过程的角色可访问的表，您可以取消分类过程。

在再次对表进行分类之前，已为取消分类过程而暂存的表不会被分类。

语法

SYSTEM$CANCEL_CLASSIFY_SCHEMA( '<object_name>' )
Copy

实参

object_name

包含要取消分类过程的表的架构名称。如果当前会话中未使用数据库和架构，则名称必须完全限定。

名称必须与数据库中存储的名称完全相同。如果名称包含特殊字符、大写字母或空格，则名称必须先用双引号括起来，然后再放在单引号内。

返回

存储过程根据指定的架构名称，采用下列格式返回 JSON 对象：

  • 如果调用 SYSTEM$CLASSIFY_SCHEMA 来暂存分类，然后调用具有相同架构名称的 SYSTEM$CANCEL_CLASSIFY_SCHEMA 来取消分类过程，则输出结果如下：

    {
  "failed": [],
  "succeeded": [
    {
      "message": "Classification Cancelled for table [T1].",
      "table_name": "T1"
    },
    {
      "message": "Classification Cancelled for table [T2].",
      "table_name": "T2"
    },
    ...
    }
  ]
}
    Copy

  • 如果调用 SYSTEM$CANCEL_CLASSIFY_SCHEMA，且指定架构未为分类而暂存，则输出结果如下：

    {
  "failed": [
    {
      "message": "Unable to cancel classification for table [T1] since its already complete.",
      "table_name": "T1"
    },
    {
      "message": "Unable to cancel classification for table [T2] since its already complete.",
      "table_name": "T2"
    },
    ...
  ],
  "succeeded": []
}
    Copy

其中：

failed

指定无法为指定表执行取消过程的原因。

succeeded

确认已经为指定表计划取消过程。

使用说明

  • 取消过程只需很短的时间（数秒钟）即可完成。这类似于 取消查询。

  • 指定的架构名称可包含最多 1000 个表对象。如果架构包含的表对象超过 1000 个，则 Snowflake 会返回一条错误消息。

  • Snowflake 提供的存储过程使用调用方的权限。有关更多详细信息，请参阅 了解调用方权限和所有者权限存储过程。

示例

为架构中的表取消分类：

CALL SYSTEM$CANCEL_CLASSIFY_SCHEMA('hr.tables');
Copy
语言: 中文