DESCRIBE SHARE

描述 共享 中包含的数据对象。

DESCRIBE 可以缩写为 DESC。

另请参阅：

DROP SHARE、ALTER SHARE、CREATE SHARE、SHOW SHARES

语法

提供商（出站共享）

DESC[RIBE] SHARE <name>
Copy

使用者（入站共享）

DESC[RIBE] SHARE <provider_account>.<share_name>
Copy

参数

name

指定要描述的出站共享的标识符。如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

provider_account.share_name

指定要描述的入站共享的完全限定标识符。

使用说明

  • 只有 ACCOUNTADMIN 角色才有权描述共享。使用除 ACCOUNTADMIN 之外的其他任何角色执行此命令都会返回错误信息。

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

输出

  • 该命令的输出结果因您是提供商还是使用者而不同：

    • 对于提供商，共享中的对象名称以数据库名称为前缀。

    • 对于使用者，仅当在共享中创建数据库时，共享中对象的名称才会以数据库名称为前缀。如果尚未在共享中创建数据库，则对象前缀为 :code:` <DB> `。

  • 输出中的 kind 列显示共享对象的类型。

示例

作为提供商，显示 sales_s 共享对象：

DESC SHARE sales_s;

+----------+--------------------------------------+-------------------------------+
| kind     | name                                 | shared_on                     |
|----------+--------------------------------------+-------------------------------|
| DATABASE | SALES_DB                             | 2017-06-15 17:03:16.642 -0700 |
| SCHEMA   | SALES_DB.AGGREGATES_EULA             | 2017-06-15 17:03:16.790 -0700 |
| TABLE    | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | 2017-06-15 17:03:16.963 -0700 |
+----------+--------------------------------------+-------------------------------+
Copy

作为使用者，显示账户 ab67890 提供的 sales_s 共享对象：

DESC SHARE ab67890.sales_s;

+----------+----------------------------------+---------------------------------+
| kind     | name                             | shared_on                       |
|----------+----------------------------------+---------------------------------|
| DATABASE | <DB>                             | Thu, 15 Jun 2017 17:03:16 -0700 |
| SCHEMA   | <DB>.AGGREGATES_EULA             | Thu, 15 Jun 2017 17:03:16 -0700 |
| TABLE    | <DB>.AGGREGATES_EULA.AGGREGATE_1 | Thu, 15 Jun 2017 17:03:16 -0700 |
+----------+----------------------------------+---------------------------------+
Copy

在此示例中，使用者账户中尚未在 sales_s 共享中创建数据库。

语言: 中文