SHOW DATASETS

显示有关您账户中数据集的信息。您可以显示所有数据集或使用 IN 子命令仅显示架构或数据库级别的结果。

另请参阅：

CREATE DATASET、ALTER DATASET

语法

SHOW DATASETS
  [ LIKE '<pattern>' ]
  [ IN { SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT } ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

可选参数

LIKE pattern

将返回的数据集列表限制为与指定模式匹配的数据集。

IN SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT

将返回的数据集列表限制为账户中指定架构或数据库中的数据集。

DATABASE db_name

将返回的数据集列表限制为指定数据库中的数据集。如果指定数据库而不指定 db_name，并且没有使用任何数据库，则关键字对输出没有影响。

SCHEMA schema_name

默认情况下，返回正在使用的架构的记录。您还可以指定 schema_name。

STARTS WITH name_string

使用您指定的字符串来限制返回的数据集。返回的数据集的名称与指定字符串具有相同的开头字符。

LIMIT rows [ FROM name_string ]

将返回的数据集的数量限制为指定的行数。可选的 FROM 子句指定返回的数据集的起始点。

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

OWNERSHIP 或 USAGE

数据集

提供在账户内显示数据集的权限。

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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

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

示例

以下示例显示 PUBLIC 架构中的两个数据集：

SHOW DATASETS IN SCHEMA PUBLIC LIMIT 2;
Copy
语言: 中文