改变分享

适用于:检查标记是的砖的SQL检查标记是的砖运行时10.3及以上检查标记是的统一目录只

补充说,改变或删除模式、表的物化视图,视图或份额。重命名。转移所有权的分享到一个新的主要。

语法

改变分享share_name{alter_add_materialized_view|删除物化视图mat_view_name|alter_add_table|删除表table_name|alter_add_schema|删除模式schema_name|alter_add_view|删除视图view_name|重命名来to_share_name|(集]老板来主要}alter_add_materialized_view{{改变|添加}物化视图mat_view_name(评论评论](作为mat_view_share_name]alter_add_table{{改变|添加}(表]table_name(评论评论](分区条款](作为table_share_name](与历史|没有历史]}alter_add_schema{{改变|添加}模式schema_name(评论评论]alter_add_view{{改变|添加}视图view_name(评论评论](作为view_share_name]

为检查标记是的砖的SQL和检查标记是的砖运行时在11.1和12.0之间必须指定与改变数据饲料(开始版本版本]]而不是与历史。这一条款将被弃用。

参数

  • share_name

    共享的名称被改变。

  • alter_add_materialized_view

    适用于:检查标记是的砖运行时13.3及以上

    添加一个物化视图共享或修改现有物化视图共享。运行该语句,你必须的所有者和分享选择物化视图上的特权。

    • 添加物化视图mat_view_name

      标识了物化视图添加。如果无法找到物化视图,砖了TABLE_OR_VIEW_NOT_FOUND错误。

    • 改变物化视图mat_view_name

      确定了物化视图被改变。如果没有物化视图的一部分份额,砖引发了一个错误。

    • 评论评论

      一个可选的字符串文字与物化视图作为评论分享。

    • 作为mat_view_share_name

      可选地暴露了物化视图下一个不同的名称。名称可以用模式名合格。如果没有mat_view_share_name指定,物化视图下自己的名字。

      如果共享名称已经存在,砖提出了一个错误。

  • 删除物化视图mat_view_name

    适用于:检查标记是的砖运行时13.3及以上

    消除发现的物化视图mat_view_name的份额。运行该语句,你必须分享的主人。

  • alter_add_table

    添加一个表或表的分区共享或修改现有的共享表。运行该语句,你必须的所有者和分享选择特权在桌子上。

    • 添加(表]table_name

      表添加标识。表不能驻留在统一目录。如果表不能发现砖了TABLE_OR_VIEW_NOT_FOUND错误。

    • 改变(表]table_name

      标识表被修改。如果表没有共享数据砖引发了一个错误的一部分。

    • 评论评论

      一个可选的字符串文字与表分享评论。

    • 分区条款

      一个或多个分区的表被添加。分区键必须匹配的分区表和与价值观有关。如果没有分区条款存在添加表增加了整个表。

      通过引用分区收件人属性使用语法:

      分区(column_name=CURRENT_RECPIENT()。<财产- - - - - -关键>)

      分区通过引用收件人属性适用于:检查标记是的砖的SQL检查标记是的砖运行时12.2及以上。

    • 作为table_share_name

      有选择地公开表在一个不同的名称。与数据库的名称可以限定(模式)的名字。如果没有table_share_name指定表将以自己的名字。

    • 与历史或没有历史

      适用于:检查标记是的砖的SQL检查标记是的砖运行时12.1及以上

      当与历史指定,分享与完整的历史表,允许接收者执行时间旅行的查询。共享表可以参考使用版本和时间戳的。

      一个表可以被共享table_changes()函数查看的历史变化,如果“三角洲。enableChangeDataFeed”设置为“true”的源表和历史是共享的。

      默认行为是没有历史。

  • 删除表table_name

    表被删除table_name的份额。运行该语句,你必须分享的主人。

  • alter_add_schema

    适用于:检查标记是的砖的SQL检查标记是的砖运行时13.2及以上

    添加一个模式来分享或修改现有的共享模式。运行该语句,你必须分享的所有者和模式。

    • 添加模式schema_name

      确定要添加的模式。如果模式不能被发现,砖了SCHEMA_NOT_FOUND错误。

    • 改变模式schema_name

      确定要改变的模式。如果模式不是已经共享的一部分,砖引发了一个错误。

    • 评论评论

      一个可选的字符串文字连接模式分享评论。

  • 删除模式schema_name

    消除发现的模式schema_name的份额。运行该语句,你必须分享的主人。

  • alter_add_view

    适用于:检查标记是的砖的SQL检查标记是的砖运行时13.2及以上

    添加一个视图来分享或修改现有的共享视图。运行该语句,你必须的所有者和分享选择在视图特权。

    • 添加视图view_name

      确定视图添加。如果视图不能发现砖了TABLE_OR_VIEW_NOT_FOUND错误。

    • 改变视图view_name

      标识被改变。如果视图没有共享数据砖引发了一个错误的一部分。

    • 评论评论

      一个可选的字符串字面上看来分享评论。

    • 作为view_share_name

      有选择地公开视图在一个不同的名称。名称可以用模式名合格。如果没有view_share_name指定,视图下自己的名字。

      如果共享名称已经存在,砖提出了一个错误。

  • 删除视图view_name

    删除视图了view_name的份额。运行该语句,你必须分享的主人。

  • 重命名来to_share_name

    适用于:检查标记是的砖的SQL检查标记是的砖运行时11.1及以上

    重命名的份额。名称必须是唯一的在所有metastore股票。运行该语句,你必须的所有者和分享创建分享metastore特权。

  • (集]老板来主要

    转移所有权的份额主要。运行该语句,你必须分享的主人。

    适用于:检查标记是的砖的SQLSQL仓库2022.35版本或更高版本检查标记是的砖运行时11.2及以上

    集可以作为一个可选的字。

例子

——创建一个名为“some_share”分享。>创建共享some_share;——表添加到共享。my_schema >修改共享some_share添加表。my_tab评论的一些评论的分区(c1_int = 5, c2_date像“2021%”)shared_schema.shared_tab;——添加一个模式份额。>改变分享some_share添加模式some_schema评论的一些评论;——添加一个视图来分享。my_schema >修改共享some_share添加视图。shared_schema.shared_view my_view评论的一些评论; -- Add a materialized view to the share. > ALTER SHARE some_share ADD MATERIALIZED VIEW my_schema.my_mat_view COMMENT 'some comment' AS shared_schema.shared_mat_view; — Share a table with history > ALTER SHARE share ADD TABLE table1 WITH HISTORY; > ALTER SHARE share ADD TABLE table2 WITHOUT HISTORY; > SHOW ALL IN SHARE share; Name type ... history_sharing ... ------ ------ ... ---------------- Table1 TABLE ... ENABLED ... Table2 TABLE ... DISABLED ... -- Remove the table again > ALTER SHARE some_share REMOVE TABLE shared_schema.shared_tab; -- Remove the schema again > ALTER SHARE some_share REMOVE SCHEMA some_schema; -- Remove a view again > ALTER SHARE some_share REMOVE VIEW shared_schema.shared_view; -- Rename a share > ALTER SHARE some_share RENAME TO new_share; -- Change ownership of the share > ALTER SHARE some_share OWNER TO `alf@melmak.et`