浏览代码

docs(zh_CN/ rules):translate 9 files into chinese

ican_do_it 4 年之前
父节点
当前提交
b1a04c398c

文件差异内容过多而无法显示
+ 30 - 30
docs/zh_CN/rules/overview.md


+ 27 - 27
docs/zh_CN/rules/sinks/edgex.md

@@ -2,17 +2,17 @@
 
 该目标用于将消息发送到 EdgeX 消息总线上。
 
-| name        | Optional | Description                                                  |
+| 名称        | 可选 | Description                                                  |
 | ----------- | -------- | ------------------------------------------------------------ |
-| protocol    | true     | 如未指定,使用缺省值 ``tcp``.                                |
-| host        | true     | 消息总线目标主机地址,使用缺省值 ``*``.                      |
-| port        | true     | 消息总线端口号。 如未指定,使用缺省值 ``5563``.              |
-| topic       | true     | 发布的主题名称,如未指定,使用缺省值 ``events``.             |
-| contentType | true     | 发布消息的内容类型,如未指定,使用缺省值 ``application/json``. |
-| metadata    | true     | 该属性为一个字段名称,该字段是 SQL SELECT 子句的一个字段名称,这个字段应该类似于 ``meta(*) AS xxx`` ,用于选出消息中所有的 EdgeX 元数据. |
-| deviceName  | true     | 允许用户指定设备名称,该名称将作为从 Kuiper 中发送出来的 Event 结构体的设备名称. |
-| type          | true     | 消息总线类型,目前支持两种类型的消息总线, ``zero`` 或者 ``mqtt``,其中 ``zero`` 为缺省类型。 |
-| optional      | true     | 如果指定了 ``mqtt`` 消息总线,那么还可以指定一下可选的值。请参考以下可选的支持的配置类型。 |
+| protocol    | true     | 如未指定,使用缺省值 `tcp`.                                |
+| host        |     | 消息总线目标主机地址,使用缺省值 `*`.                      |
+| port        |     | 消息总线端口号。 如未指定,使用缺省值 `5563`.              |
+| topic       |     | 发布的主题名称,如未指定,使用缺省值 `events`.             |
+| contentType |     | 发布消息的内容类型,如未指定,使用缺省值 `application/json`. |
+| metadata    |     | 该属性为一个字段名称,该字段是 SQL SELECT 子句的一个字段名称,这个字段应该类似于 `meta(*) AS xxx` ,用于选出消息中所有的 EdgeX 元数据. |
+| deviceName  |     | 允许用户指定设备名称,该名称将作为从 Kuiper 中发送出来的 Event 结构体的设备名称. |
+| type          |     | 消息总线类型,目前支持两种类型的消息总线, `zero` 或者 `mqtt`,其中 `zero` 为缺省类型。 |
+| optional      | 是    | 如果指定了 `mqtt` 消息总线,那么还可以指定一下可选的值。请参考以下可选的支持的配置类型。 |
 
 以下为支持的可选的配置列表,您可以参考 MQTT 协议规范来获取更详尽的信息。
 
@@ -32,10 +32,10 @@
 
 ## 例子
 
-### 发布结果到 EdgeX 消息总线,而不保留原有的元数据
-在此情况下,原有的元数据 (例如``Events`` 结构体中的 ``id, pushed, created, modified, origin``,以及``Reading`` 结构体中的  ``id, created, modified, origin, pushed, device`` 不会被保留)。Kuiper 在此情况下作为 EdgeX 的一个单独微服务,它有自己的 ``device name``。 提供了属性 ``deviceName``, 该属性允许用户指定 Kuiper 的设备名称。如下所示,
+### 发布结果到  EdgeX 消息总线,而不保留原有的元数据
+在此情况下,原有的元数据 (例如 `Events` 结构体中的 `id, pushed, created, modified, origin`,以及`Reading` 结构体中的  `id, created, modified, origin, pushed, device` 不会被保留)。Kuiper 在此情况下作为 EdgeX 的一个单独微服务,它有自己的 `device name`。 提供了属性 `deviceName`, 该属性允许用户指定 Kuiper 的设备名称。如下所示,
 
-1) 从 EdgeX 消息总线上的 ``events`` 主题上收到的消息,
+1) 从 EdgeX 消息总线上的 `events` 主题上收到的消息,
 
 ```
 {
@@ -47,7 +47,7 @@
   ]
 }
 ```
-2) 使用如下的规则,并且在 ``edgex`` action 中给属性 ``deviceName`` 指定 ``kuiper``。
+2) 使用如下的规则,并且在 `edgex` action 中给属性 `deviceName` 指定 ``kuiper``。
 
 ```json
 {
@@ -80,15 +80,15 @@
 }
 ```
 请注意,
-- Event 结构体中的设备名称( `` Device``)变成了 ``kuiper``
-- ``Events and Readings`` 结构体中的数据被更新为新的值. 字段 ``Created`` 被 Kuiper 更新为新的值 (这里为 ``0``).
+- Event 结构体中的设备名称( ``Device`)变成了 `kuiper`
+- `Events and Readings` 结构体中的数据被更新为新的值。 字段 `Created` 被 Kuiper 更新为新的值 (这里为 `0`).
 
-### 发布结果到 EdgeX 消息总线,并保留原有的元数据
-但是在某些场景中,你可能需要保留原来的元数据。比如保留发送到 Kuiper 的设备名称,在本例中为 ``demo``, 还有 reading 数组中的其它元数据。在此情况下,Kuiper 更像是一个过滤器 - 将不关心的数据过滤掉,但是依然保留原有的数据。
+### 发布结果到  EdgeX 消息总线,并保留原有的元数据
+但是在某些场景中,你可能需要保留原来的元数据。比如保留发送到 Kuiper 的设备名称,在本例中为 `demo`, 还有 reading 数组中的其它元数据。在此情况下,Kuiper 更像是一个过滤器 - 将不关心的数据过滤掉,但是依然保留原有的数据。
 
 参考以下的例子,
 
-1) 从 EdgeX 消息总线上的 ``events`` 主题上收到的消息,
+1) 从 EdgeX 消息总线上的 `events` 主题上收到的消息,
 
 ```
 {
@@ -100,7 +100,7 @@
   ]
 }
 ```
-2) 使用如下规则,在``edgex`` action 中,为 ``metadata`` 指定值 ``edgex_meta`` 。
+2) 使用如下规则,在`edgex` action 中,为 `metadata` 指定值 `edgex_meta` 。
 
 ```json
 {
@@ -121,8 +121,8 @@
 }
 ```
 请注意,
-- 用户需要在 SQL 子句中加 ``meta(*) AS edgex_meta`` ,函数 ``meta(*)`` 返回所有的元数据。
-- 在 ``edgex`` action里, 属性 ``metadata`` 指定值 ``edgex_meta`` 。该属性指定哪个字段包含了元数据。
+- 用户需要在 SQL 子句中加 `meta(*) AS edgex_meta` ,函数 `meta(*)` 返回所有的元数据。
+- 在 `edgex` action里, 属性 `metadata` 指定值 `edgex_meta` 。该属性指定哪个字段包含了元数据。
 
 3) 发送给 EdgeX 消息总线的数据
 
@@ -137,16 +137,16 @@
 }
 ```
 请注意,
-- ``Events`` 结构体的元数据依然保留,例如 ``Device`` & ``Created``.
-- 对于在原有消息中可以找到的 reading,元数据将继续保留。 比如 ``humidity`` 的元数据就是从 EdgeX 消息总线里接收到的``原值 - 或者说是旧值``。
-- 对于在原有消息中无法找到的 reading,元数据将不会被设置。如例子中的``t1`` 的元数据被设置为 Kuiper 产生的缺省值。
+- `Events` 结构体的元数据依然保留,例如 `Device` & `Created`.
+- 对于在原有消息中可以找到的 reading,元数据将继续保留。 比如 `humidity` 的元数据就是从 EdgeX 消息总线里接收到的`原值 - 或者说是旧值`。
+- 对于在原有消息中无法找到的 reading,元数据将不会被设置。如例子中的 `t1` 的元数据被设置为 Kuiper 产生的缺省值。
 - 如果你的 SQL 包含了聚合函数,那保留原有的元数据就没有意义,但是 Kuiper 还是会使用时间窗口中的某一条记录的元数据。例如,在下面的 SQL 里,
 ```SELECT avg(temperature) AS temperature, meta(*) AS edgex_meta FROM ... GROUP BY TUMBLINGWINDOW(ss, 10)```. 
-这种情况下,在时间窗口中可能有几条数据,Kuiper 会使用窗口中的第一条数据的元数据来填充 ``temperature`` 的元数据。
+这种情况下,在时间窗口中可能有几条数据,Kuiper 会使用窗口中的第一条数据的元数据来填充 `temperature` 的元数据。
 
 ## 结果发布到 MQTT 消息总线
 
-以下是将分析结果发送到 MQTT 消息总线的规则,请注意在``optional`` 中是如何指定 ``ClientId`` 的。
+以下是将分析结果发送到 MQTT 消息总线的规则,请注意在`optional` 中是如何指定 `ClientId` 的。
 
 ```json
 {

+ 1 - 1
docs/zh_CN/rules/sinks/logs.md

@@ -1,6 +1,6 @@
 # 日志操作
 
-该操作用于将输出消息打印到日志文件中,默认情况下,该日志文件位于$ kuiper_install/log/stream.log中。
+该操作用于将输出消息打印到日志文件中,默认情况下,该日志文件位于 `$ kuiper_install/log/stream.log` 中。
 
 无法为操作指定属性。
 

+ 11 - 11
docs/zh_CN/rules/sinks/mqtt.md

@@ -1,18 +1,18 @@
 # MQTT动作
 
-该操作用于将输出消息发布到MQTT服务器中。
+该操作用于将输出消息发布到 MQTT 服务器中。
 
-| Property name | Optional | Description                                          |
+| 属性名称 | 是否可选 | 说明                                          |
 | ------------- | -------- | ---------------------------------------------------- |
-| server        | false    | mqtt服务器的代理地址,例如``tcp://127.0.0.1:1883`` |
-| topic          | false    | mqtt主题,例如``分析/结果``                          |
-| clientId      | true     | mqtt连接的客户端ID。 如果未指定,将使用一个uuid      |
-| protocolVersion   | true     | 3.1 (也被称为 MQTT 3) 或者 3.1.1 (也被称为 MQTT 4)。 如果未指定,缺省值为 3.1。|
-| qos               | true     | 消息转发的服务质量                               |
-| username          | true     | 连接用户名                            |
-| password          | true     | 连接密码                             |
-| certificationPath | true     | 证书路径。可以为绝对路径,也可以为相对路径。如果指定的是相对路径,那么父目录为执行``server``命令的路径。比如,如果你在``/var/kuiper`` 中运行 ``bin/server`` ,那么父目录为 ``/var/kuiper``; 如果运行从``/var/kuiper/bin``中运行``./server``,那么父目录为 ``/var/kuiper/bin``。 |
-| privateKeyPath    | true     | 私钥路径。可以为绝对路径,也可以为相对路径。更详细的信息,请参考 ``certificationPath``. |
+| server        | 否    | mqtt  服务器的代理地址,例如 `tcp://127.0.0.1:1883` |
+| topic          | 否    | mqtt 主题,例如``分析/结果``                         |
+| clientId      | 是     | mqtt 连接的客户端 ID。 如果未指定,将使用一个 uuid   |
+| protocolVersion   |     | 3.1 (也被称为 MQTT 3) 或者 3.1.1 (也被称为 MQTT 4)。 如果未指定,缺省值为 3.1。|
+| qos               |     | 消息转发的服务质量                               |
+| username          |     | 连接用户名                            |
+| password          |     | 连接密码                             |
+| certificationPath |     | 证书路径。可以为绝对路径,也可以为相对路径。如果指定的是相对路径,那么父目录为执行 `server` 命令的路径。比如,如果你在 `/var/kuiper` 中运行 `bin/server` ,那么父目录为 `/var/kuiper`; 如果运行从 `/var/kuiper/bin` 中运行`./server`,那么父目录为 `/var/kuiper/bin`。 |
+| privateKeyPath    |     | 私钥路径。可以为绝对路径,也可以为相对路径。更详细的信息,请参考 `certificationPath`. |
 
 以下为使用 SAS 连接到 Azure IoT Hub 的样例。
 ```json

+ 3 - 3
docs/zh_CN/rules/sinks/nop.md

@@ -1,9 +1,9 @@
 # Nop action
 
-该 action 是一个空操作目标,所有发送到此的结果将被忽略。如果指定 ``log`` 属性为 ``true``,那么结果将会保存到日志文件,日志文件缺省保存在  `` $kuiper_install/log/stream.log``。
+该 action 是一个空操作目标,所有发送到此的结果将被忽略。如果指定 ``log`` 属性为 `true`,那么结果将会保存到日志文件,日志文件缺省保存在  `$kuiper_install/log/stream.log`。
 
-| Property name      | Optional | Description                                                  |
+| 属性名称  | 是否可选 | 说明                                                  |
 | ------------------ | -------- | ------------------------------------------------------------ |
-| log             | true | true/false - 是否将结果打印到日志。缺省为 ``false``,这种情况下将不会打印到日志文件。 |
+| log             | true | true/false - 是否将结果打印到日志。缺省为 `false`,这种情况下将不会打印到日志文件。 |
 
 

文件差异内容过多而无法显示
+ 11 - 10
docs/zh_CN/rules/sinks/rest.md


+ 22 - 22
docs/zh_CN/rules/sources/edgex.md

@@ -23,25 +23,25 @@ EdgeX 源会试图取得某个字段的类型,
 
 ### Boolean
 
-如果 ``ValueDescriptor````Type`` 的值为 ``Bool`` ,那么 Kuiper 会试着将其转换为 ``boolean`` 类型,以下的值将被转化为 ``true``。
+如果 `ValueDescriptor` 中  `Type` 的值为 `Bool` ,那么 Kuiper 会试着将其转换为 ``boolean`` 类型,以下的值将被转化为 `true`。
 
 - "1", "t", "T", "true", "TRUE", "True" 
 
-以下值将被转换为 ``false``。
+以下值将被转换为 `false`。
 
 - "0", "f", "F", "false", "FALSE", "False"
 
 ### Bigint
 
-如果 ``ValueDescriptor````Type`` 的值为 ``INT8`` , ``INT16``, ``INT32``,  ``INT64`` , ``UINT8`` , ``UINT16`` ,  ``UINT32`` , ``UINT64`` 那么 Kuiper 会试着将其转换为 ``Bigint`` 类型。 
+如果 `ValueDescriptor` 中  `Type` 的值为 `INT8` , `INT16`, `INT32`,  `INT64` , `UINT8` , `UINT16` ,  `UINT32` , `UINT64` 那么 Kuiper 会试着将其转换为 `Bigint` 类型。 
 
 ### Float
 
-如果 ``ValueDescriptor````Type`` 的值为 ``FLOAT32``, ``FLOAT64`` ,那么 Kuiper 会试着将其转换为 ``Float`` 类型。 
+如果 `ValueDescriptor` 中  `Type` 的值为 `FLOAT32`, `FLOAT64` ,那么 Kuiper 会试着将其转换为 `Float` 类型。 
 
 ### String
 
-如果 ``ValueDescriptor````Type`` 的值为 ``String``,那么 Kuiper 会试着将其转换为 ``String`` 类型。
+如果 `ValueDescriptor` 中  `Type` 的值为 `String`,那么 Kuiper 会试着将其转换为 `String` 类型。
 
 ### Boolean 数组
 
@@ -49,15 +49,15 @@ EdgeX 中的 `Bool` 数组类型会被转换为 `boolean` 数组。
 
 ### Bigint 数组
 
-EdgeX 中所有的 ``INT8`` , ``INT16``, ``INT32``,  ``INT64``,``UINT`` , ``UINT8`` , ``UINT16`` ,  ``UINT32`` , ``UINT64``  数组类型会被转换为 `Bigint` 数组。
+EdgeX 中所有的 `INT8` , `INT16`, `INT32`,  `INT64` , `UINT8` , `UINT16` ,  `UINT32` , `UINT64` 数组类型会被转换为 `Bigint` 数组。
 
 ### Float 数组
 
-EdgeX 中所有的 ``FLOAT32``, ``FLOAT64``  数组类型会被转换为 `Float` 数组。 
+EdgeX 中所有的 `FLOAT32`, `FLOAT64`  数组类型会被转换为 `Float` 数组。 
 
 # 全局配置
 
-EdgeX 源配置文件为 ``$kuiper/etc/sources/edgex.yaml``,以下配置文件内容。
+EdgeX 源配置文件为 `$kuiper/etc/sources/edgex.yaml`,以下配置文件内容。
 
 ```yaml
 #Global Edgex configurations
@@ -73,38 +73,38 @@ default:
 #    Password: password
 ```
 
-用户可以在此指定全局的 EdgeX 配置。在 ``default`` 部分中指定的配置将作为所有 EdgeX 源的缺省配置。
+用户可以在此指定全局的 EdgeX 配置。在 `default` 部分中指定的配置将作为所有 EdgeX 源的缺省配置。
 
 ## protocol
 
-连接到 EdgeX 消息总线的协议,缺省为 ``tcp``
+连接到 EdgeX 消息总线的协议,缺省为 `tcp`
 
 ## server
 
-EdgeX 消息总线的地址,缺省为 ``localhost``
+EdgeX 消息总线的地址,缺省为 `localhost`
 
 ## port
 
-EdgeX 消息总线的端口,缺省为 ``5573``
+EdgeX 消息总线的端口,缺省为 `5573`
 
 ## topic
 
-EdgeX 消息总线上监听的主题名称,缺省为 ``events``
+EdgeX 消息总线上监听的主题名称,缺省为 `events`
 
 ## serviceServer
 
-访问 value descriptors 的基础服务地址,配置项 ``serviceServer`` 的值与 ``/api/v1/valuedescriptor`` 拼接后,用于获取 EdgeX 服务器上定义的所有 value descriptors。
+访问 value descriptors 的基础服务地址,配置项 `serviceServer` 的值与 `/api/v1/valuedescriptor` 拼接后,用于获取 EdgeX 服务器上定义的所有 value descriptors。
 
 ## type
 
-EdgeX 消息总线类型,目前支持两种消息总线。如果指定了错误的消息总线类型,那么会使用缺省 ``zero`` 类型。
+EdgeX 消息总线类型,目前支持两种消息总线。如果指定了错误的消息总线类型,那么会使用缺省 `zero` 类型。
 
-- ``zero``:使用 ZeroMQ 类型的消息总线 
-- ``mqtt``:使用 MQTT 服务器作为消息总线
+- `zero`:使用 ZeroMQ 类型的消息总线 
+- `mqtt`:使用 MQTT 服务器作为消息总线
 
 ## optional
 
-如果使用了 MQTT 消息总线,还可以指定别的一些可选配置项。请注意,所有在可选的配置项里指定的值都必须为**<u>字符类型</u>**,因此这里出现的所有的配置应该是字符类型的 - 例如 ``KeepAlive: "5000"``。以下为支持的可选的配置列表,您可以参考 MQTT 协议规范来获取更详尽的信息。
+如果使用了 MQTT 消息总线,还可以指定别的一些可选配置项。请注意,所有在可选的配置项里指定的值都必须为**<u>字符类型</u>**,因此这里出现的所有的配置应该是字符类型的 - 例如 `KeepAlive: "5000"`。以下为支持的可选的配置列表,您可以参考 MQTT 协议规范来获取更详尽的信息。
 
 - ClientId
 
@@ -122,10 +122,10 @@ EdgeX 消息总线类型,目前支持两种消息总线。如果指定了错
 
 ## 重载缺省设置
 
-在某些情况下,你可能想消费来自于多个主题的数据。Kuiper 支持指定别的配置,并且在创建流定义的时候使用 ``CONF_KEY`` 来指定新的配置。
+在某些情况下,你可能想消费来自于多个主题的数据。Kuiper 支持指定别的配置,并且在创建流定义的时候使用 `CONF_KEY` 来指定新的配置。
 
 ```yaml
-#Override the global configurations
+#覆盖全局配置
 demo1: #Conf_key
   protocol: tcp
   server: 10.211.55.6
@@ -133,7 +133,7 @@ demo1: #Conf_key
   topic: events
 ```
 
-如果你有个特定的源需要覆盖缺省的设置,你可以定义一个自定义的配置段。在上面的例子中,我们创建了一个新的配置 ``demo1``,然后你在创建流定义的时候可以使用选项 ``CONF_KEY`` 来使用新的配置 (参考 [流定义规范](../../sqls/streams.md) 获取更多详细信息)。
+如果你有个特定的源需要覆盖缺省的设置,你可以定义一个自定义的配置段。在上面的例子中,我们创建了一个新的配置 `demo1`,然后你在创建流定义的时候可以使用选项 `CONF_KEY` 来使用新的配置 (参考 [流定义规范](../../sqls/streams.md) 获取更多详细信息)。
 
 **例子**
 
@@ -141,5 +141,5 @@ demo1: #Conf_key
 create stream demo1() WITH (FORMAT="JSON", type="edgex", CONF_KEY="demo1");
 ```
 
-在自定义的配置中,能够使用的配置项与 ``default`` 部分的是一样的,任何在自定义段中设置的值将覆盖 ``default`` 部分里的配置。
+在自定义的配置中,能够使用的配置项与 `default` 部分的是一样的,任何在自定义段中设置的值将覆盖 `default` 部分里的配置。
 

+ 26 - 26
docs/zh_CN/rules/sources/http_pull.md

@@ -1,77 +1,77 @@
-# HTTP pull source 
+# HTTP 提取源
 
-Kuiper provides built-in support for pulling HTTP source stream, which can pull the message from HTTP server broker and feed into the Kuiper processing pipeline.  The configuration file of HTTP pull source is at ``etc/sources/httppull.yaml``. Below is the file format.
+Kuiper 为提取 HTTP 源流提供了内置支持,该支持可从 HTTP 服务器代理提取消息并输入 Kuiper 处理管道。 HTTP提取源的配置文件位于 `etc/sources/httppull.yaml`中。 以下是文件格式。
 
 ```yaml
-#Global httppull configurations
+#全局httppull配置
 default:
-  # url of the request server address
+  # 请求服务器地址的URL
   url: http://localhost
   # post, get, put, delete
   method: post
-  # The interval between the requests, time unit is ms
+  # 请求之间的间隔,时间单位为 ms
   interval: 10000
-  # The timeout for http request, time unit is ms
+  # http请求超时,时间单位为 ms
   timeout: 5000
-  # If it's set to true, then will compare with last result; If response of two requests are the same, then will skip sending out the result.
-  # The possible setting could be: true/false
+  # 如果将其设置为 true,则将与最后的结果进行比较; 如果两个请求的响应相同,则将跳过发送结果。
+  # 可能的设置可能是:true/false
   incremental: false
-  # The body of request, such as '{"data": "data", "method": 1}'
+  # 请求正文,例如'{"data": "data", "method": 1}'
   body: '{}'
-  # Body type, none|text|json|html|xml|javascript|form
+  # 正文类型, none|text|json|html|xml|javascript|form
   bodyType: json
-  # HTTP headers required for the request
+  # 请求所需的HTTP标头
   headers:
     Accept: application/json
 
-#Override the global configurations
+#重载全局配置
 application_conf: #Conf_key
   incremental: true
   url: http://localhost:9090/pull
 ```
 
-## Global HTTP pull configurations
+## 全局HTTP提取配置
 
-Use can specify the global HTTP pull settings here. The configuration items specified in ``default`` section will be taken as default settings for all HTTP connections. 
+用户可以在此处指定全局 HTTP 提取设置。 `default` 部分中指定的配置项将用作所有HTTP 连接的默认设置。
 
 ### url
 
-The URL where to get the result.
+获取结果的 URL。
 
 ### method
-HTTP method, it could be post, get, put & delete.
+HTTP 方法,它可以是 post、get、put 和 delete。
 
 ### interval
 
-The interval between the requests, time unit is ms.
+请求之间的间隔时间,单位为 ms。
 
 ### timeout
 
-The timeout for http request, time unit is ms.
+http 请求的超时时间,单位为 ms。
 
 ### incremental
 
-If it's set to true, then will compare with last result; If response of two requests are the same, then will skip sending out the result.
+如果将其设置为 true,则将与最后的结果进行比较; 如果两个请求的响应相同,则将跳过发送结果。
 
 ### body
 
-The body of request, such as `'{"data": "data", "method": 1}'`
+请求的正文, 例如 `{"data": "data", "method": 1}`
 
 ### bodyType
 
-Body type, it could be none|text|json|html|xml|javascript|form.
+正文类型,可以是 none|text|json|html|xml|javascript| 格式。
 
 ### headers
 
-The HTTP request headers that you want to send along with the HTTP request.
+需要与 HTTP 请求一起发送的 HTTP 请求标头。
 
 
 
-## Override the default settings
+## 重载默认设置
 
-If you have a specific connection that need to overwrite the default settings, you can create a customized section. In the previous sample, we create a specific setting named with ``application_conf``.  Then you can specify the configuration with option ``CONF_KEY`` when creating the stream definition (see [stream specs](../../sqls/streams.md) for more info).
+如果您有特定的连接需要重载默认设置,则可以创建一个自定义部分。 在上一个示例中,我们创建了一个名为 `application_conf` 的特定设置。 然后,您可以在创建流定义时使用选项 `CONF_KEY` 指定配置(有关更多信息,请参见 [流规格](../../sqls/streams.md))。
 
-**Sample**
+**样例**
 
 ```
 demo (
@@ -79,5 +79,5 @@ demo (
 	) WITH (DATASOURCE="test/", FORMAT="JSON", TYPE="httppull", KEY="USERID", CONF_KEY="application_conf");
 ```
 
-The configuration keys used for these specific settings are the same as in ``default`` settings, any values specified in specific settings will overwrite the values in ``default`` section.
+这些特定设置所使用的配置键与 `default` 设置中的配置键相同,在特定设置中指定的任何值都将重载 `default` 部分中的值。
 

+ 14 - 14
docs/zh_CN/rules/sources/mqtt.md

@@ -1,9 +1,9 @@
 # MQTT源
 
-Kuiper为MQTT源流提供了内置支持,流可以订阅来自MQTT代理的消息并输入Kuiper处理管道。 MQTT源的配置文件位于``$ kuiper / etc / mqtt_source.yaml''。 以下是文件格式。
+Kuiper  MQTT 源流提供了内置支持,流可以订阅来自 MQTT 代理的消息并输入Kuiper 处理管道。 MQTT 源的配置文件位于 `$kuiper/etc/mqtt_source.yaml`。 以下是文件格式。
 
 ```yaml
-#Global MQTT configurations
+#全局MQTT配置
 default:
   qos: 1
   sharedsubscription: true
@@ -15,15 +15,15 @@ default:
   #privateKeyPath: /var/kuiper/xyz-private.pem.key
 
 
-#Override the global configurations
+#重载全局配置
 demo: #Conf_key
   qos: 0
   servers: [tcp://10.211.55.6:1883]
 ```
 
-## 全局MQTT配置
+## 全局 MQTT 配置
 
-用户可以在此处指定全局MQTT设置。 `默认'部分中指定的配置项将用作所有MQTT连接的默认设置。
+用户可以在此处指定全局 MQTT 设置。`default` 部分中指定的配置项将用作所有MQTT 连接的默认设置。
 
 ### qos
 
@@ -34,35 +34,35 @@ demo: #Conf_key
 
 ### sharedsubscription
 
-是否使用共享订阅模式。 如果使用共享订阅模式,那么多个Kuiper进程可以进行负载平衡。
+是否使用共享订阅模式。 如果使用共享订阅模式,那么多个 Kuiper 进程可以进行负载平衡。
 
 ### servers
 
-MQTT消息代理的服务器列表。 当前,只能指定一个服务器。
+MQTT 消息代理的服务器列表。 当前,只能指定一个服务器。
 
 ### username
 
-MQTT 连接用户名。如果指定了``certificationPath`` 或者 ``privateKeyPath``,那么该项配置不会被使用。
+MQTT 连接用户名。如果指定了 `certificationPath`  或者 `privateKeyPath`,那么该项配置不会被使用。
 
 ### password
 
-MQTT 连接密码。如果指定了``certificationPath`` 或者 ``privateKeyPath``,那么该项配置不会被使用。
+MQTT 连接密码。如果指定了 `certificationPath` 或者 `privateKeyPath`,那么该项配置不会被使用。
 
 ### certificationPath
 
-证书路径。可以为绝对路径,也可以为相对路径。如果指定的是相对路径,那么父目录为执行``server``命令的路径。比如,如果你在``/var/kuiper`` 中运行 ``bin/server`` ,那么父目录为 ``/var/kuiper``; 如果运行从``/var/kuiper/bin``中运行``./server``,那么父目录为 ``/var/kuiper/bin``。 比如  ``d3807d9fa5-certificate.pem``.
+证书路径。可以为绝对路径,也可以为相对路径。如果指定的是相对路径,那么父目录为执行 `server` 命令的路径。比如,如果你在 `/var/kuiper` 中运行 `bin/server` ,那么父目录为 `/var/kuiper`; 如果运行从`/var/kuiper/bin`中运行`./server`,那么父目录为 `/var/kuiper/bin`。 比如  `d3807d9fa5-certificate.pem`。
 
 ### privateKeyPath
 
-私钥路径。可以为绝对路径,也可以为相对路径。更详细的信息,请参考 ``certificationPath``. 比如``d3807d9fa5-private.pem.key``.
+私钥路径。可以为绝对路径,也可以为相对路径。更详细的信息,请参考 `certificationPath`,比如 `d3807d9fa5-private.pem.key`。
 
 ### bufferLength
 
 指定最大缓存消息数目。该参数主要用于防止内存溢出。实际内存用量会根据当前缓存消息数目动态变化。增大该参数不会增加初始内存分配量,因此设置较大的数值是安全的。该参数默认值为102400;如果每条消息为100字节,则默认情况下,缓存最大占用内存量为102400 * 100B ~= 10MB. 
 
-## 覆盖默认设置
+## 重载默认设置
 
-如果您有一个特定连接需要覆盖默认设置,则可以创建一个自定义模块。 在上一个示例中,我们创建一个名为“ demo”的特定设置。 然后,您可以在创建流定义时使用选项“ CONF_KEY”指定配置(有关更多信息,请参见 [stream specs](../../sqls/streams.md) )。
+如果您有一个特定连接需要重载默认设置,则可以创建一个自定义模块。 在上一个示例中,我们创建一个名为 `demo` 的特定设置。 然后,您可以在创建流定义时使用选项 `CONF_KEY` 指定配置(有关更多信息,请参见 [stream specs](../../sqls/streams.md) )。
 
 **示例**
 
@@ -72,5 +72,5 @@ demo (
 	) WITH (DATASOURCE="test/", FORMAT="JSON", KEY="USERID", CONF_KEY="demo");
 ```
 
-这些特定设置使用的配置键与“默认”设置中的配置键相同,在特定设置中指定的任何值都将覆盖“默认”部分中的值。
+这些特定设置使用的配置键与 `default` 设置中的配置键相同,在特定设置中指定的任何值都将覆盖 `default` 部分中的值。