CREATE SHARE

  • 项目

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

创建具有指定名称的共享。 如果已存在同名共享，则会引发异常。

若要创建共享，你必须是元存储管理员，或者对要共享的数据所要注册到的 Unity Catalog 元存储拥有 CREATE SHARE 权限。

若要向共享添加内容，请使用 ALTER SHARE。

语法

CREATE SHARE [ IF NOT EXISTS ] share_name
    [ COMMENT comment ]

参数

  • share_name

    要创建的共享名称。

  • IF NOT EXISTS

    创建具有给定名称的共享（如果不存在）。 如果已存在同名共享，则不会执行任何操作。

  • comment

    可选的 STRING 文本。 共享的说明。

示例

-- Create share `customer_share`. This throws exception if a share with name customer_share
-- already exists.
> CREATE SHARE customer_share;

-- Create share `customer_share` only if share with same name doesn't exist.
> CREATE SHARE IF NOT EXISTS customer_share;

-- Create share `customer_share` only if share with same name doesn't exist, with a comment.
> CREATE SHARE IF NOT EXISTS customer_share COMMENT 'This is customer share';