SHOW CATALOG INTEGRATIONS

列出您账户中的 目录集成。输出返回集成元数据和属性。

另请参阅:

CREATE CATALOG INTEGRATIONDROP CATALOG INTEGRATIONDESCRIBE CATALOG INTEGRATION

语法

SHOW CATALOG INTEGRATIONS [ LIKE '<pattern>' ]
Copy

参数

LIKE 'pattern'

(可选)按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配,并支持 SQL 通配符(%_)。

例如,以下模式返回 相同的 结果:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 默认:无值(不对输出应用筛选)。

访问控制要求

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

权限

对象

备注

USAGE

集成

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 操作的相应角色和权限授予的一般信息,请参阅 访问控制概述

使用说明

  • 该命令不需要正在运行的仓库即可执行。

  • 若要对此命令的输出进行后处理,可以使用 RESULT_SCAN 函数,该函数会将输出视为可查询的表。

输出

命令输出在以下列中提供表属性和元数据:

描述

name

目录集成的名称。

enabled

指定目录集成是否可用于 Iceberg 表。

type

集成的类型。该值始终为 CATALOG。

category

集成的类别。该值始终为 CATALOG。

comment

字符串(字面量),用于指定集成注释。

created_on

创建目录集成的日期和时间。

有关可为目录集成指定的属性的更多信息,请参阅 CREATE CATALOG INTEGRATION

示例

显示所有目录集成:

SHOW CATALOG INTEGRATIONS;
Copy

显示您有权查看且名称以 demo 开头的所有目录集成:

SHOW CATALOG INTEGRATIONS LIKE 'demo%';
Copy
语言: 中文