EXCHANGE ステートメント

2つのテーブルまたはディクショナリの名前をアトミックに交換します。 この処理は、一時的な名前を用いた RENAME クエリでも実行できますが、その場合、この操作はアトミックではありません。

:::note
EXCHANGE クエリは、Atomic および Shared データベースエンジンでのみサポートされています。 :::

構文

EXCHANGE TABLES|DICTIONARIES [db0.]name_A AND [db1.]name_B [ON CLUSTER cluster]

テーブルの入れ替え

2 つのテーブルの名前を入れ替えます。

構文

EXCHANGE TABLES [db0.]table_A AND [db1.]table_B [ON CLUSTER cluster]

複数テーブルの EXCHANGE

カンマで区切ることで、1つのクエリで複数のテーブルペアを入れ替えることができます。

注記

複数のテーブルペアを入れ替える場合、入れ替えはアトミックではなく逐次的に行われます。操作中にエラーが発生した場合、一部のテーブルペアだけが入れ替えられ、他のテーブルペアは入れ替えられないままになる可能性があります。

例

-- テーブルを作成
CREATE TABLE a (a UInt8) ENGINE=Memory;
CREATE TABLE b (b UInt8) ENGINE=Memory;
CREATE TABLE c (c UInt8) ENGINE=Memory;
CREATE TABLE d (d UInt8) ENGINE=Memory;

-- 1つのクエリで2組のテーブルを交換
EXCHANGE TABLES a AND b, c AND d;

SHOW TABLE a;
SHOW TABLE b;
SHOW TABLE c;
SHOW TABLE d;

-- テーブル 'a' はテーブル 'b' の構造を持ち、テーブル 'b' はテーブル 'a' の構造を持つ
┌─statement──────────────┐
│ CREATE TABLE default.a↴│
│↳(                     ↴│
│↳    `b` UInt8         ↴│
│↳)                     ↴│
│↳ENGINE = Memory        │
└────────────────────────┘
┌─statement──────────────┐
│ CREATE TABLE default.b↴│
│↳(                     ↴│
│↳    `a` UInt8         ↴│
│↳)                     ↴│
│↳ENGINE = Memory        │
└────────────────────────┘

-- テーブル 'c' はテーブル 'd' の構造を持ち、テーブル 'd' はテーブル 'c' の構造を持つ
┌─statement──────────────┐
│ CREATE TABLE default.c↴│
│↳(                     ↴│
│↳    `d` UInt8         ↴│
│↳)                     ↴│
│↳ENGINE = Memory        │
└────────────────────────┘
┌─statement──────────────┐
│ CREATE TABLE default.d↴│
│↳(                     ↴│
│↳    `c` UInt8         ↴│
│↳)                     ↴│
│↳ENGINE = Memory        │
└────────────────────────┘

EXCHANGE DICTIONARIES

2つの辞書の名前を入れ替えます。

構文

EXCHANGE DICTIONARIES [db0.]dict_A AND [db1.]dict_B [ON CLUSTER cluster]

関連項目

• 辞書 (Dictionaries)