SHOW SHARES

适用于:check marked yes Databricks SQL check marked yes Databricks Runtime 10.3 及更高版本 check marked yes 仅限 Unity Catalog

列出与可选择提供的正则表达式模式匹配的 Delta Sharing 共享。 如果未提供模式,则命令将列出元存储中的所有共享。

要列出共享的内容,请使用 SHOW ALL IN SHARE

语法

SHOW SHARES [ [ LIKE ] regex_pattern ]

参数

  • regex_pattern

    用于筛选语句结果的正则表达式模式。

    • *| 字符外,该模式的工作方式类似于正则表达式。
    • 只有 * 则匹配 0 个或多个字符,| 用于分隔多个不同的正则表达式,其中任何一个表达式都可以匹配。
    • 在处理前,在输入模式中删除前导空格和尾随空格。 模式匹配不区分大小写。

示例

> CREATE SHARE vaccine COMMENT 'vaccine data to publish';
> CREATE SHARE meds COMMENT 'meds data to publish';
> SHOW SHARES;
  name      created_at                   created_by                 comment
  --------- ---------------------------- -------------------------- -----------------------
  vaccine   2022-01-01T00:00:00.000+0000 alwaysworks@databricks.com vaccine data to publish
  meds      2022-01-01T00:00:01.000+0000 alwaysworks@databricks.com meds data to publish

> SHOW SHARES LIKE 'vaccine';
  name      created_at                   created_by                 comment
  --------- ---------------------------- -------------------------- -----------------------
  vaccine   2022-01-01T00:00:00.000+0000 alwaysworks@databricks.com vaccine data to publish

> SHOW SHARES IN PROVIDER some_provider;
  name      created_at                   created_by                 comment
  --------- ---------------------------- -------------------------- -----------------------
  vaccine   2022-01-01T00:00:00.000+0000 alwaysworks@databricks.com vaccine data to publish