创建表克隆

适用于:检查标记是的砖的SQL检查标记是的砖运行时

克隆源三角洲表目标目的地在一个特定的版本。克隆可以是深或浅:深克隆复制数据从源和浅克隆不。你也可以克隆源拼花和冰山表。看到增量克隆拼花和冰山表三角洲湖

在砖SQL和砖的运行时13.1及以上,您可以使用浅克隆与统一目录管理表。在砖运行时的13.0和下面,没有支持浅克隆统一目录。看到统一目录管理表浅克隆

重要的

浅和深克隆之间有重要的区别,可以决定如何最好地使用它们。看到克隆一个表在砖上

语法

创建(如果存在]table_name(|]克隆source_table_name(TBLPROPERTIES条款](位置路径]
(创建]取代table_name(|]克隆source_table_name(TBLPROPERTIES条款](位置路径]

参数

  • 如果不存在

    如果指定,声明将被忽略table_name已经存在。

  • 创建或替换

    如果创建指定表代替如果它存在,如果它不新创建的。没有创建table_name必须存在。

  • table_name

    三角洲湖的名字表被创建。必须不包含一个名称时间规范。如果名字不是合格的当前模式中创建的表。table_name必须不存在已经除非取代如果存在已经指定。

  • 浅克隆深克隆

    如果您指定克隆砖将复制源表的定义,但是参考源表的文件。当你指定克隆(默认)砖将使一个完整的、独立的源表的副本。

  • source_table_name

    克隆三角洲湖表的名称。可能包括一个名称时间规范

  • TBLPROPERTIES

    选择一个或多个用户定义的属性集。

  • 位置路径

    选择创建一个外部表,提供数据存储位置的路径。如果table_name本身一个路径,而不是表标识符,操作将会失败。路径必须是一个字符串。

例子

您可以使用创建克隆对于复杂的操作,比如数据迁移、数据归档、机器学习流复制、短期实验和数据共享。看到克隆一个表在砖上