SHOW SHARES

列出系统中所有可用的 共享：

  • 在账户（作为提供商）中创建的出站共享（针对用户）。

  • 可供账户使用的入站共享（来自提供商）。

另请参阅：

CREATE SHARE、ALTER SHARE、DROP SHARE、DESCRIBE SHARE

语法

SHOW SHARES [ LIKE '<pattern>' ]
            [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

参数

LIKE 'pattern'

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

例如，以下模式返回 相同的 结果：

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

. 默认：无值（不对输出应用筛选）。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且 区分大小写。

例如，以下字符串会返回 不同的 结果：

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows [ FROM 'name_string' ]

（可选）限制返回的最大行数，同时还对结果启用“分页”功能。实际返回的行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

可选的 FROM 'name_string' 分子句实际上会充当结果的“游标”。这样就可以提取对象名称与指定字符串匹配的第一行之后的指定行数：

  • 该字符串必须放在单引号内并且 区分大小写。

  • 该字符串不必包含完整的对象名称；支持部分名称。

默认：无值（不对输出应用限制）

备注

对于支持 FROM 'name_string' 和 STARTS WITH 'name_string' 子句的 SHOW 命令，您可以将这两个子句组合在同一语句中。但是，两个条件都必须满足，否则它们相互抵消，不返回任何结果。

此外，对象按名称的字典顺序返回，因此 FROM 'name_string' 仅返回字典值高于 STARTS WITH 'name_string' 所返回行的行。

例如：

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' 不会返回任何结果。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' 不会返回任何结果。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' 将返回结果（如果有任何行与输入字符串匹配）。

使用说明

  • 该命令仅列出具有 IMPORT SHARE 权限的角色的用户共享：

    • 默认情况下，该 ACCOUNTADMIN 角色具有此权限。

    • 具有 ACCOUNTADMIN 角色的用户可以委派此权限。请参阅 启用非 ACCOUNTADMIN 角色执行数据共享任务。

    • 如果没有 IMPORT SHARE 权限的用户运行此命令，则不会列出任何共享。

    备注

    在没有足够权限的情况下执行此命令将返回空结果。

  • 以前缀 is_ 开头的列返回 Y (yes) 或 N (no)。

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

  • 该命令 最多 返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定；即使应用了筛选器，也不会返回任何超过 1 万条限制的记录。

    要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中查询相应的视图（如果存在）。

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

输出

  • kind 列显示以下内容：

    • INBOUND 表示共享可供您的账户使用（即，您可以从该共享创建数据库）。

    • OUTBOUND 表示您的账户正在与其他账户共享数据，并且此共享是在您的账户中创建的。

  • 对于 OUTBOUND 共享，如果已将账户添加到共享中，则 to 列将显示这些账户。此列中显示的最大账户数为 3 个；但是，可以添加到共享的账户数量没有硬性限制。

示例

显示在账户中创建或可供账户使用的所有共享：

SHOW SHARES;

+-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------+---------------------+
| created_on                    | kind     | owner_account        | name          | database_name         | to               | owner        | comment                                | listing_global_name |                  |
|-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------|---------------------|
| 2016-07-09 19:18:09.821 -0700 | INBOUND  | SNOW.MY_TEST_ACCOUNT | SAMPLE_DATA   | SNOWFLAKE_SAMPLE_DATA |                  |              | Sample data sets provided by Snowflake |                     |
| 2017-06-15 17:02:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT | SALES_S       | SALES_DB              | XY12345, YZ23456 | ACCOUNTADMIN |                                        |                     |
+-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------+---------------------+
Copy

显示在账户中创建且包含字符串“SNOW”的所有共享，或可供账户使用且包含该字符串的所有共享：

SHOW SHARES LIMIT 5 FROM 'SNOW';

+-------------------------------+----------+-------------------------+-----------------+----------------+------------------+--------------+---------+---------------------+
| created_on                    | kind     | owner_account           | name            | database_name  | to               | owner        | comment | listing_global_name |
|-------------------------------+----------+-------------------------+-----------------+----------------+------------------+--------------+---------+---------------------|
| 2020-07-07 19:18:09.821 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOW_DATA       | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2020-07-10 19:18:09.821 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | DATA_SNOWS      | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 12:02:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOW_DATA       | ALFALFA_DB     | AB12345, YZ23456 | ACCOUNTADMIN |         |                     |
| 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOW_SHARE      | SALES_DB       | AB12345          | ACCOUNTADMIN |         |                     |
| 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT    | SNOWIER_SHARE   | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
+-------------------------------+----------+-------------------------+-----------------+----------------+------------------+--------------+---------+---------------------+
Copy

显示在账户中创建或可供账户使用的所有共享，这些共享以 SNOW 开头，并按字典顺序排序：

SHOW SHARES STARTS WITH 'SNOW' LIMIT 5 FROM 'A';

+-------------------------------+----------+------------------------+------------------------+----------------+------------------+--------------+---------+---------------------+
| created_on                    | kind     | owner_account          |  name                  | database_name  | to               | owner        | comment | listing_global_name |
|-------------------------------+----------+------------------------+------------------------+----------------+------------------+--------------+---------+---------------------|
| 2020-07-07 19:18:09.821 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOW_DATA              | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 12:02:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOW_DATA              | ALFALFA_DB     | AB12345, YZ23456 | ACCOUNTADMIN |         |                     |
| 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOWIER_SHARE          | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
| 2022-08-20 15:03:50.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOWY_SHARE            | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT   | SNOW_SHARE             | SALES_DB       | AB12345          | ACCOUNTADMIN |         |                     |
+-------------------------------+----------+------------------------+------------------------+----------------+------------------+--------------+---------+---------------------+
Copy
语言: 中文