通过

CREATE TABLE LIKE

  • 项目

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime

定义一个使用现有表或视图的定义和元数据的表。

Delta Lake 在 Databricks SQL 和 Databricks Runtime 13.3 LTS 及更高版本中确实支持 CREATE TABLE LIKE。 在 Databricks Runtime 12.2 LTS 及更低版本中，使用 CREATE TABLE AS。

语法

CREATE TABLE [ IF NOT EXISTS ] table_name LIKE source_table_name [table_clauses]

table_clauses
   { USING data_source |
     LOCATION path |
     TBLPROPERTIES clause |
     ROW FORMAT row_format |
     STORED AS file_format } [...]

row_format
   { SERDE serde_class [ WITH SERDEPROPERTIES (serde_key = serde_val [, ...] ) ] |
     { DELIMITED [ FIELDS TERMINATED BY fields_terminated_char [ ESCAPED BY escaped_char ] ]
       [ COLLECTION ITEMS TERMINATED BY collection_items_terminated_char ]
       [ MAP KEYS TERMINATED BY map_key_terminated_char ]
       [ LINES TERMINATED BY row_terminated_char ]
       [ NULL DEFINED AS null_char ] } }

property_key
  { identifier [. ...] | string_literal }

parameters

  • IF NOT EXISTS

    如果已指定，则忽略语句（如果已存在 table_name）。

  • table_name

    要创建的表的名称。 名称不得包含 时态规范或选项规范。 如果未限定该名称，则会在当前架构中创建该表。 不能已经存在 table_name。

  • source_table_name

    复制其定义的表的名称。 source_table_name 和 table_name 必须均位于 Hive 元存储中，或者均位于 Unity Catalog 中。

  • table_clauses

    （可选）指定新表的数据源格式、位置和用户定义的属性。 每个子子句只能指定一次。

    • LOCATION path

      用于存储表数据的目录路径，可以是分布式存储上的一个路径。 如果指定了位置，则新表将变为外部表。 如果未指定位置，则表为托管表。

      不能在与托管表的位置重叠的位置创建外部表。

    • TBLPROPERTIES

      可以选择设置一个或多个用户定义的属性。

    • USING data_source

      将要用于表的文件格式。 data_source 必须是以下各项之一：

      • TEXT
      • CSV
      • JSON
      • JDBC
      • PARQUET
      • DELTA

      Databricks Runtime 支持用于表的以下附加文件格式：

      • ORC
      • HIVE
      • LIBSVM
      • org.apache.spark.sql.sources.DataSourceRegister 的自定义实现的完全限定的类名。

      如果未指定 USING，则将继承源表的格式。

      以下内容适用于：Databricks Runtime

      支持 HIVE 在 Databricks Runtime 中创建 Hive SerDe 表。 你可以使用 OPTIONS 子句指定 Hive 特定的 file_format 和 row_format，这是不区分大小写的字符串映射。 option_keys 为：

      • FILEFORMAT
      • INPUTFORMAT
      • OUTPUTFORMAT
      • SERDE
      • FIELDDELIM
      • ESCAPEDELIM
      • MAPKEYDELIM
      • LINEDELIM

    • ROW FORMAT row_format

      适用于：勾选“是” Databricks Runtime

      若要指定自定义 SerDe，请将其设置为 SERDE 并指定自定义 SerDe 和可选 SerDe 属性的完全限定类名。 若要使用本机 SerDe，请将其设置为 DELIMITED 并指定分隔符、转义字符和空字符等。

      • SERDEPROPERTIES

        用于标记 SerDe 定义的键值对列表。

      • FIELDS TERMINATED BY

        定义列分隔符。

      • ESCAPED BY

        定义转义机制。

      • COLLECTION ITEMS TERMINATED BY

        定义收集项分隔符。

      • MAP KEYS TERMINATED BY

        定义映射键分隔符。

      • LINES TERMINATED BY

        定义行分隔符。

      • NULL DEFINED AS

        定义 NULL 的特定值。

      • STORED AS

        此表的文件格式。 可用格式包括 TEXTFILE、SEQUENCEFILE、RCFILE、ORC、PARQUET 和 AVRO。 或者，你可以通过 INPUTFORMAT 和 OUTPUTFORMAT 指定你自己的输入和输出格式。 只能将格式 TEXTFILE、SEQUENCEFILE 和 RCFILE 用于 ROW FORMAT SERDE，并且只能将 TEXTFILE 用于 ROW FORMAT DELIMITED。

说明

并非表的所有属性都可以传输，具体取决于数据源和目标。

CREATE TABLE LIKE（当 source 为 Delta Lake Table 时）：

功能/属性 目标为非 Delta Table 目标为 Delta Table
COMMENT 是 是
列 是 是
分区列 是 是
配置 否 是
表约束 不适用 是
Delta 协议 不适用 是

CREATE TABLE LIKE（当 source 不为 Delta Lake Table 时）：

功能/属性 目标为非 Delta Table 目标为 Delta Table
COMMENT 是 是
列 是 是
分区列 是 是
配置 是 是
表约束 否 是
Delta 协议 否（该会话的当前默认协议） 是

示例

-- Create table using a new location
> CREATE TABLE Student_Dupli LIKE Student LOCATION '/path/to/data_files';

-- Create table like using a data source
> CREATE TABLE Student_Dupli LIKE Student USING CSV LOCATION '/path/to/csv_files';