SHOW CATALOG INTEGRATIONS¶
列出您账户中的 目录集成。输出返回集成元数据和属性。
语法¶
SHOW CATALOG INTEGRATIONS [ LIKE '<pattern>' ]
参数¶
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). |
有关创建具有指定权限集的自定义角色的说明,请参阅 创建自定义角色。
使用说明¶
该命令不需要正在运行的仓库即可执行。
若要对此命令的输出进行后处理,可以使用 RESULT_SCAN 函数,该函数会将输出视为可查询的表。
输出¶
命令输出在以下列中提供表属性和元数据:
列 |
描述 |
---|---|
|
目录集成的名称。 |
|
指定目录集成是否可用于 Iceberg 表。 |
|
集成的类型。该值始终为 CATALOG。 |
|
集成的类别。该值始终为 CATALOG。 |
|
字符串(字面量),用于指定集成注释。 |
|
创建目录集成的日期和时间。 |
有关可为目录集成指定的属性的更多信息,请参阅 CREATE CATALOG INTEGRATION。
示例¶
显示所有目录集成:
SHOW CATALOG INTEGRATIONS;
显示您有权查看且名称以 demo
开头的所有目录集成:
SHOW CATALOG INTEGRATIONS LIKE 'demo%';