REPLACE TABLE

概述

REPLACE 语句可用于原子性地更新表。

此语句支持 Atomic 和 Replicated 数据库引擎，它们分别是 ClickHouse 和 ClickHouse Cloud 的默认数据库引擎。

通常，如需从表中删除部分数据，可以创建一个新表，并通过不查询所需删除数据的 SELECT 语句向其中填充数据，然后删除旧表并重命名新表。以下示例演示了这种方法：

CREATE TABLE myNewTable AS myOldTable;

INSERT INTO myNewTable
SELECT * FROM myOldTable 
WHERE CounterID <12345;

DROP TABLE myOldTable;

RENAME TABLE myNewTable TO myOldTable;

除上述方法外，如果您使用的是默认数据库引擎，也可以使用 REPLACE 达到相同效果：

REPLACE TABLE myOldTable
ENGINE = MergeTree()
ORDER BY CounterID 
AS
SELECT * FROM myOldTable
WHERE CounterID <12345;

语法

{CREATE [OR REPLACE] | REPLACE} TABLE [db.]table_name

CREATE 语句的所有语法形式同样适用于此语句。对不存在的表执行 REPLACE 会导致错误。

示例

本地
Cloud

以下是一个表：

CREATE DATABASE base 
ENGINE = Atomic;

CREATE OR REPLACE TABLE base.t1
(
    n UInt64,
    s String
)
ENGINE = MergeTree
ORDER BY n;

INSERT INTO base.t1 VALUES (1, 'test');

SELECT * FROM base.t1;

┌─n─┬─s────┐
│ 1 │ test │
└───┴──────┘

可以使用 REPLACE 语句清空所有数据：

CREATE OR REPLACE TABLE base.t1 
(
    n UInt64,
    s Nullable(String)
)
ENGINE = MergeTree
ORDER BY n;

INSERT INTO base.t1 VALUES (2, null);

SELECT * FROM base.t1;

┌─n─┬─s──┐
│ 2 │ \N │
└───┴────┘

也可以使用 REPLACE 语句修改表结构：

REPLACE TABLE base.t1 (n UInt64) 
ENGINE = MergeTree 
ORDER BY n;

INSERT INTO base.t1 VALUES (3);

SELECT * FROM base.t1;

┌─n─┐
│ 3 │
└───┘

以下是在 ClickHouse Cloud 上创建的表：

CREATE DATABASE base;

CREATE OR REPLACE TABLE base.t1 
(
    n UInt64,
    s String
)
ENGINE = MergeTree
ORDER BY n;

INSERT INTO base.t1 VALUES (1, 'test');

SELECT * FROM base.t1;

1    test

可以使用 REPLACE 语句清空所有数据：

CREATE OR REPLACE TABLE base.t1 
(
    n UInt64, 
    s Nullable(String)
)
ENGINE = MergeTree
ORDER BY n;

INSERT INTO base.t1 VALUES (2, null);

SELECT * FROM base.t1;

2    

也可以使用 REPLACE 语句修改表结构：

REPLACE TABLE base.t1 (n UInt64) 
ENGINE = MergeTree 
ORDER BY n;

INSERT INTO base.t1 VALUES (3);

SELECT * FROM base.t1;

3

SQL Reference

Data Types

Engines

Functions

Formats

Settings

System Tables

Data Lakes

概述

语法

示例

​概述

​语法

​示例

概述

语法

示例