CREATE TABLE AS CLONE OF
適用対象:Microsoft Fabric の ウェアハウス
Microsoft Fabric の Warehouse に、別のテーブルのゼロコピー クローンとして新しいテーブルが作成されます。 テーブルのメタデータのみがコピーされます。 Parquet ファイルとして格納されている、テーブルの基になるデータはコピーされません。
Microsoft Fabric でのテーブルの複製の詳細については、Microsoft Fabric の TSQL でのテーブルの複製に関する記事を参照してください。 また、Fabric ポータルを使用して Microsoft Fabric のテーブルを複製することもできます。たとえばFabric ポータルのテーブルの複製を参照してください。
構文
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
テーブルのクローンが配置されるテーブルのスキーマ。 同じスキーマ内でテーブルを複製する場合、"スキーマ" の指定は省略可能です。 空白の場合は、既定のスキーマが使われます。
スキーマ名の指定は、テーブルがスキーマ間で複製されるときに必要です。
table_name
複製されたテーブルの名前。 テーブル名は識別子の規則に従っている必要があります。 table_name には、最大 128 文字まで指定できます。
point_in_time
指定された日時に、テーブル複製は、その特定の日付と時刻 (UTC) のデータを正確にミラーします。 datetime データ型の値の形式は 'YYYY-MM-DDThh:mm:ss' である必要があります。ここで、'T' は時刻の開始時刻を示します。
現在の時点でテーブルクローンを作成するために、point_in_time を指定する必要はありません。
Warehouse では、7 日間のデータ履歴が自動的に保存および維持されます。 詳細については、「テーブルの複製」を参照してください。
アクセス許可
必須:
- ソース テーブル全体に対する 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';