CREATE TABLE AS CLONE OF

适用于:Microsoft Fabric 中的仓库

在 Microsoft Fabric 中的仓库内,创建一个新表,将其用作另一个表的零复制克隆。 仅复制表的元数据。 不复制以 parquet 文件形式存储的表基础数据。

若要详细了解如何在 Microsoft Fabric 中克隆表,请参阅使用 TSQL 在 Microsoft Fabric 中克隆表。 还可以通过 Fabric 门户在 Microsoft Fabric 中的克隆表,相关示例,请参阅在 Fabric 门户中克隆表

Transact-SQL 语法约定

语法

CREATE TABLE 
    { database_name.schema_name.table_name | schema_name.table_name | table_name } 
AS CLONE OF 
    { database_name.schema_name.table_name | schema_name.table_name | table_name } [AT {point_in_time}]

参数

database_name

将包含新克隆的表的数据库的名称。 默认为当前数据库。

schema_name

表克隆所在的表的架构。 如果表是在同一架构中克隆的,则指定 schema 为可选。 如果是空白,将使用默认架构。

跨架构克隆表时,需要提供架构名称。

table_name

克隆的表的名称。 表名必须遵循标识符规则。 table_name 最多可以包含 128 个字符。

point_in_time

在提供的日期和时间,表克隆会准确地反映出在该特定日期和时间(采用 UTC 格式)的数据。 日期/时间数据类型值的格式必须为“YYYY-MM-DDThh:mm:ss”,其中“T”表示时间的开始。

从当前时间点开始,创建表克隆不需要指定 point_in_time

仓库会自动保留和维护七个日历天的数据历史记录。 有关详细信息,请参阅克隆表。克隆表

权限

需要:

  • 对整个源表的 SELECT 权限
  • 对将在其中创建表克隆的架构的 CREATE TABLE 权限

约束

创建克隆时,将复制源表中定义的主键约束和唯一键约束。

限制

有关限制信息,请参阅克隆表限制

示例

A. 在同一架构中创建表克隆

--Clone creation within the same schema
CREATE TABLE dbo.Employee AS CLONE OF dbo.EmployeeUSA;

B. 在同一数据仓库内跨架构创建表克隆

--Clone creation across schemas
CREATE TABLE dbo.Employee AS CLONE OF dbo1.EmployeeUSA;

°C 在某个时间点的同一架构中创建表克隆

--Clone creation within the same schema
CREATE TABLE dbo.Employee AS CLONE OF dbo.EmployeeUSA AT '2023-05-23T14:24:10.325';

D. 在某个时间点跨架构创建表克隆

--Clone creation within the same schema
CREATE TABLE dbo.Employee AS CLONE OF dbo1.EmployeeUSA AT '2023-05-23T14:24:10';