DROP CATALOG INTEGRATION

从账户中移除 目录集成。

另请参阅：

CREATE CATALOG INTEGRATION、SHOW CATALOG INTEGRATIONS、DESCRIBE CATALOG INTEGRATION

语法

DROP CATALOG INTEGRATION [ IF EXISTS ] <name>
Copy

参数

name

指定要删除的目录集成的标识符。如果标识符包含空格、特殊字符或大小写混合字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写（例如，"My Catalog"）。

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

OWNERSHIP

集成（目录）

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 删除的目录集成无法恢复；必须重新创建。

  • 如果一个或多个 Iceberg 表与目录集成关联，您无法删除或替换目录集成。

    要查看依赖于目录集成的表，您可以使用 SHOW ICEBERG TABLES 命令和使用 RESULT_SCAN 对 catalog_name 列进行筛选的查询。

    备注

    列标识符 (catalog_name) 区分大小写。指定与 SHOW ICEBERG TABLES 输出中显示的完全相同的列标识符。

    例如：

    SHOW ICEBERG TABLES;

SELECT * FROM TABLE(
  RESULT_SCAN(
      LAST_QUERY_ID()
    )
  )
  WHERE "catalog_name" = 'my_catalog_integration_1';
    Copy

示例

删除目录集成：

DROP CATALOG INTEGRATION myInt;
Copy

再次删除目录集成，但如果目录集成不存在，则不会引发错误：

DROP CATALOG INTEGRATION IF EXISTS myInt;
Copy
语言: 中文