From 031c1fbff7d08bf74421d454e8248bdcffaccb58 Mon Sep 17 00:00:00 2001 From: evenyag Date: Thu, 3 Apr 2025 20:00:55 +0800 Subject: [PATCH 1/5] docs: docs for replace statement --- docs/reference/sql/overview.md | 1 + docs/reference/sql/replace.md | 39 ++++++++++++++++++++++++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 docs/reference/sql/replace.md diff --git a/docs/reference/sql/overview.md b/docs/reference/sql/overview.md index f7c552f0b..a7788c78a 100644 --- a/docs/reference/sql/overview.md +++ b/docs/reference/sql/overview.md @@ -13,6 +13,7 @@ * [LIMIT](./limit.md) * [JOIN](./join.md) * [RANGE](./range.md) +* [REPLACE](./replace.md) * [DELETE](./delete.md) * [SHOW](./show.md) * [TQL](./tql.md) diff --git a/docs/reference/sql/replace.md b/docs/reference/sql/replace.md new file mode 100644 index 000000000..b356e1195 --- /dev/null +++ b/docs/reference/sql/replace.md @@ -0,0 +1,39 @@ +--- +keywords: [SQL REPLACE, SQL syntax, SQL examples, inserting records, SQL data manipulation] +description: Describes the SQL REPLACE statement for adding records to a table in GreptimeDB, including syntax, examples for inserting single and multiple records. +--- + +# REPLACE + +The `REPLACE` statement is used to insert a new record into a table. In GreptimeDB, this statement is exactly the same as the `INSERT` statement. Please refer to [`INSERT`](/reference/sql/insert.md) for more details. + +## `REPLACE INTO` Statement + +### Syntax + +The syntax for the REPLACE INTO statement is as follows: + +```sql +REPLACE INTO table_name (column1, column2, column3, ...) +VALUES (value1, value2, value3, ...); +``` + +### Examples + +Here is an example of an `REPLACE INTO` statement that inserts a record into a table named `system_metrics`: + +```sql +REPLACE INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts) +VALUES + ("host1", "idc_b", 50.0, 66.7, 40.6, 1667446797462); +``` + +Here is an example of an `REPLACE INTO` statement that inserts multiple records into the `system_metrics` table: + +```sql +REPLACE INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts) +VALUES + ("host1", "idc_a", 11.8, 10.3, 10.3, 1667446797460), + ("host2", "idc_a", 80.1, 70.3, 90.0, 1667446797461), + ("host1", "idc_c", 50.1, 66.8, 40.8, 1667446797463); +``` From a731e9012bb8d96ddf5d08073fd3f64f6070d8a8 Mon Sep 17 00:00:00 2001 From: evenyag Date: Thu, 3 Apr 2025 20:16:36 +0800 Subject: [PATCH 2/5] docs: fix header --- docs/reference/sql/overview.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/reference/sql/overview.md b/docs/reference/sql/overview.md index a7788c78a..02e836bf2 100644 --- a/docs/reference/sql/overview.md +++ b/docs/reference/sql/overview.md @@ -1,3 +1,8 @@ +--- +keywords: [SQL syntax, SQL examples] +description: GreptimeDB SQL statements. +--- + # Overview * [Data Types](./data-types) From 02bfb2dbbbf53c5bdb2746526b3e0f15f4cd2ff4 Mon Sep 17 00:00:00 2001 From: Yingwen Date: Mon, 7 Apr 2025 16:27:59 +0800 Subject: [PATCH 3/5] chore: address CR comments Co-authored-by: jeremyhi --- docs/reference/sql/replace.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/sql/replace.md b/docs/reference/sql/replace.md index b356e1195..fda484a1c 100644 --- a/docs/reference/sql/replace.md +++ b/docs/reference/sql/replace.md @@ -5,7 +5,7 @@ description: Describes the SQL REPLACE statement for adding records to a table i # REPLACE -The `REPLACE` statement is used to insert a new record into a table. In GreptimeDB, this statement is exactly the same as the `INSERT` statement. Please refer to [`INSERT`](/reference/sql/insert.md) for more details. +The `REPLACE` statement is used to insert new records into a table. In GreptimeDB, this statement is exactly the same as the `INSERT` statement. Please refer to [`INSERT`](/reference/sql/insert.md) for more details. ## `REPLACE INTO` Statement From 7c5e1f806ad198ce323ca9c0a2d8155c6da3eeb7 Mon Sep 17 00:00:00 2001 From: evenyag Date: Wed, 9 Apr 2025 11:24:18 +0800 Subject: [PATCH 4/5] docs: add replace to sidebar --- sidebars.ts | 1 + 1 file changed, 1 insertion(+) diff --git a/sidebars.ts b/sidebars.ts index 9de8f07bf..4b8e4c1de 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -424,6 +424,7 @@ const sidebars: SidebarsConfig = { 'reference/sql/limit', 'reference/sql/order_by', 'reference/sql/range', + 'reference/sql/replace', 'reference/sql/select', 'reference/sql/show', 'reference/sql/tql', From 5cf709419a2e6971643d012b30b9a0c01dce56f3 Mon Sep 17 00:00:00 2001 From: evenyag Date: Wed, 9 Apr 2025 11:24:33 +0800 Subject: [PATCH 5/5] docs: add zh docs for replace --- .../current/reference/sql/overview.md | 6 +++ .../current/reference/sql/replace.md | 39 +++++++++++++++++++ 2 files changed, 45 insertions(+) create mode 100644 i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/replace.md diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/overview.md b/i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/overview.md index 8d5fa9fc7..da6a86f06 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/overview.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/overview.md @@ -1,3 +1,8 @@ +--- +keywords: [SQL 语法, SQL 示例] +description: GreptimeDB SQL 语句. +--- + # 概述 * [数据类型](./data-types) @@ -13,6 +18,7 @@ * [LIMIT](./limit.md) * [JOIN](./join.md) * [RANGE](./range.md) +* [REPLACE](./replace.md) * [DELETE](./delete.md) * [SHOW](./show.md) * [TQL](./tql.md) diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/replace.md b/i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/replace.md new file mode 100644 index 000000000..31ca919e8 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/reference/sql/replace.md @@ -0,0 +1,39 @@ +--- +keywords: [SQL REPLACE 语句, SQL 语法, SQL 示例, 插入记录, SQL 数据操作] +description: 描述在 GreptimeDB 中使用 SQL REPLACE 语句向表中添加记录的方法，包括语法和插入单条及多条记录的示例。 +--- + +# REPLACE + +`REPLACE` 语句用于向表中插入新记录。在 GreptimeDB 中，这个语句与 `INSERT` 语句完全相同。更多详情请参考 [`INSERT`](/reference/sql/insert.md)。 + +## `REPLACE INTO` 语句 + +### 语法 + +REPLACE INTO 语句的语法如下： + +```sql +REPLACE INTO table_name (column1, column2, column3, ...) +VALUES (value1, value2, value3, ...); +``` + +### 示例 + +以下是使用 `REPLACE INTO` 语句向名为 `system_metrics` 的表中插入一条记录的示例： + +```sql +REPLACE INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts) +VALUES + ("host1", "idc_b", 50.0, 66.7, 40.6, 1667446797462); +``` + +以下是使用 `REPLACE INTO` 语句向 `system_metrics` 表中插入多条记录的示例： + +```sql +REPLACE INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts) +VALUES + ("host1", "idc_a", 11.8, 10.3, 10.3, 1667446797460), + ("host2", "idc_a", 80.1, 70.3, 90.0, 1667446797461), + ("host1", "idc_c", 50.1, 66.8, 40.8, 1667446797463); +```