Update join.md (#11798)

optimize the original Chinese translation for the doc.

docs/zh/engines/table-engines/special/join.md

@@ -1,28 +1,115 @@
-# 加入我们 {#join}
+---
+toc_priority: 40
+toc_title: 关联表引擎
+---
 
-加载好的 JOIN 表数据会常驻内存中。
+# 关联表引擎 {#join}
 
-    Join(ANY|ALL, LEFT|INNER, k1[, k2, ...])
+使用 [JOIN](../../../sql-reference/statements/select/join.md#select-join)操作的一种可选的数据结构。
 
-引擎参数：`ANY|ALL` – 连接修饰；`LEFT|INNER` – 连接类型。更多信息可参考 [JOIN子句](../../../engines/table-engines/special/join.md#select-join)。
+!!! 注意 "Note"
-这些参数设置不用带引号，但必须与要 JOIN 表匹配。 k1，k2，……是 USING 子句中要用于连接的关键列。
+    该文档和 [JOIN 语句](../../../sql-reference/statements/select/join.md#select-join) 无关.
 
-此引擎表不能用于 GLOBAL JOIN 。
+## 建表语句 {#creating-a-table}
 
-类似于 Set 引擎，可以使用 INSERT 向表中添加数据。设置为 ANY 时，重复键的数据会被忽略（仅一条用于连接）。设置为 ALL 时，重复键的数据都会用于连接。不能直接对 JOIN 表进行 SELECT。检索其数据的唯一方法是将其作为 JOIN 语句右边的表。
+``` sql
+CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
+(
+    name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1] [TTL expr1],
+    name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2] [TTL expr2],
+) ENGINE = Join(join_strictness, join_type, k1[, k2, ...])
+```
 
-跟 Set 引擎类似，Join 引擎把数据存储在磁盘中。
+建表语句详情参见[创建表](../../../sql-reference/statements/create.md#create-table-query).
 
-### 限制和设置 {#join-limitations-and-settings}
+**引擎参数**
 
-创建表时，将应用以下设置:
+-   `join_strictness` – [JOIN 限制](../../../sql-reference/statements/select/join.md#select-join-strictness).
+-   `join_type` – [JOIN 类型](../../../sql-reference/statements/select/join.md#select-join-types).
+-   `k1[, k2, ...]` – 进行`JOIN` 操作时 `USING`语句用到的key列
 
--   join\_use\_nulls
+使用`join_strictness` 和 `join_type` 参数时不需要用引号, 例如, `Join(ANY, LEFT, col1)`. 这些参数必须和进行join操作的表相匹配。否则，CH不会报错，但是可能返回错误的数据。
--   max\_rows\_in\_join
--   max\_bytes\_in\_join
--   join\_overflow\_mode
--   join\_any\_take\_last\_row
 
-该 `Join`-发动机表不能用于 `GLOBAL JOIN` 操作。
+## 表用法 {#table-usage}
 
-[来源文章](https://clickhouse.tech/docs/en/operations/table_engines/join/) <!--hide-->
+### 示例 {#example}
+
+创建左关联表:
+
+``` sql
+CREATE TABLE id_val(`id` UInt32, `val` UInt32) ENGINE = TinyLog
+```
+
+``` sql
+INSERT INTO id_val VALUES (1,11)(2,12)(3,13)
+```
+
+创建 `Join` 右边的表:
+
+``` sql
+CREATE TABLE id_val_join(`id` UInt32, `val` UInt8) ENGINE = Join(ANY, LEFT, id)
+```
+
+``` sql
+INSERT INTO id_val_join VALUES (1,21)(1,22)(3,23)
+```
+
+表关联:
+
+``` sql
+SELECT * FROM id_val ANY LEFT JOIN id_val_join USING (id) SETTINGS join_use_nulls = 1
+```
+
+``` text
+┌─id─┬─val─┬─id_val_join.val─┐
+│  1 │  11 │              21 │
+│  2 │  12 │            ᴺᵁᴸᴸ │
+│  3 │  13 │              23 │
+└────┴─────┴─────────────────┘
+```
+
+作为一种替换方式，可以从 `Join`表获取数据，需要设置好join的key字段值。
+
+``` sql
+SELECT joinGet('id_val_join', 'val', toUInt32(1))
+```
+
+``` text
+┌─joinGet('id_val_join', 'val', toUInt32(1))─┐
+│                                         21 │
+└────────────────────────────────────────────┘
+```
+
+### 数据查询及插入 {#selecting-and-inserting-data}
+
+可以使用 `INSERT`语句向 `Join`引擎表中添加数据。如果表是通过指定 `ANY`限制参数来创建的，那么重复key的数据会被忽略。指定 `ALL`限制参数时，所有行记录都会被添加进去。
+
+不能通过 `SELECT` 语句直接从表中获取数据。请使用下面的方式：
+- 将表放在 `JOIN` 的右边进行查询
+- 调用 [joinGet](../../../sql-reference/functions/other-functions.md#joinget)函数，就像从字典中获取数据一样来查询表。
+
+
+### 使用限制及参数设置 {#join-limitations-and-settings}
+
+创建表时，会应用下列设置参数：
+
+-   [join\_use\_nulls](../../../operations/settings/settings.md#join_use_nulls)
+-   [max\_rows\_in\_join](../../../operations/settings/query-complexity.md#settings-max_rows_in_join)
+-   [max\_bytes\_in\_join](../../../operations/settings/query-complexity.md#settings-max_bytes_in_join)
+-   [join\_overflow\_mode](../../../operations/settings/query-complexity.md#settings-join_overflow_mode)
+-   [join\_any\_take\_last\_row](../../../operations/settings/settings.md#settings-join_any_take_last_row)
+
+
+`Join`表不能在 `GLOBAL JOIN`操作中使用
+
+ `Join`表创建及 [查询](../../../sql-reference/statements/select/index.md)时，允许使用[join\_use\_nulls](../../../operations/settings/settings.md#join_use_nulls)参数。如果使用不同的`join_use_nulls`设置，会导致表关联异常（取决于join的类型）。当使用函数 [joinGet](../../../sql-reference/functions/other-functions.md#joinget)时，请在建表和查询语句中使用相同的 `join_use_nulls` 参数设置。
+
+
+## 数据存储 {#data-storage}
+
+`Join`表的数据总是保存在内存中。当往表中插入行记录时，CH会将数据块保存在硬盘目录中，这样服务器重启时数据可以恢复。
+
+如果服务器非正常重启，保存在硬盘上的数据块会丢失或被损坏。这种情况下，需要手动删除被损坏的数据文件。
+
+
+[原始文档](https://clickhouse.tech/docs/en/operations/table_engines/join/) <!--hide-->