ALTER SHARE (Databricks SQL)

  • 项目

重要

Delta Sharing 目前为公共预览版。 要使用预览版，必须在 Azure Databricks 帐户控制台中启用外部数据共享功能组。 请参阅为帐户启用外部数据共享功能组。

Delta Sharing 受适用条款约束。 启用外部数据共享功能组即表示接受这些条款。

在共享中添加或删除表。 将共享的所有权转移到新的主体。

语法

ALTER share_name
  { alter_table |
    REMOVE TABLE clause }

alter_table
  { ADD [ TABLE ] table_name [ COMMENT comment ]
        [ PARTITION clause ] [ AS table_share_name ] }

参数

  • share_name

    要更改的共享的名称。

  • alter_table

    将表或表的分区添加到共享。

    • ADD [ TABLE ] table_name

      标识要添加的表。 该表不得驻留在 hive_metastore。

    • COMMENT comment

      附加到表的可选字符串文本作为注释共享。

    • PARTITION 子句

      要添加的表的一个或多个分区。 分区键必须与表的分区匹配，并且必须与值关联。 如果不存在 PARTITION clause，则 ADD TABLE 会添加整个表。

    • AS table_share_name

      （可选）以其他名称公开表。 可以使用数据库（架构）名称限定该名称。 如果没有指定 table_share_name，则该表将以其自己的名称显示。

  • REMOVE [ TABLE ] table_name

    从共享中删除由 table_name 标识的表。

示例

-- Creates a share named `some_share`.
> CREATE SHARE some_share;

-- Add a table to the share.
> ALTER SHARE some_share
     ADD TABLE my_db.my_tab
         COMMENT 'some comment'
         PARTITION(c1_int = 5, c2_date LIKE '2021%')
         AS shared_db.shared_tab;

-- Remove the table again
> ALTER SHARE some_share
    REMOVE TABLE shared_db.shared_tab;