diff --git a/docs/zh/06-advanced/05-data-in/07-mqtt.mdx b/docs/zh/06-advanced/05-data-in/07-mqtt.mdx index c3242a80c2..5ac22a7423 100644 --- a/docs/zh/06-advanced/05-data-in/07-mqtt.mdx +++ b/docs/zh/06-advanced/05-data-in/07-mqtt.mdx @@ -37,6 +37,14 @@ TDengine 可以通过 MQTT 连接器从 MQTT 代理订阅数据并将其写入 T 在 **MQTT 端口** 中填写 MQTT 代理的端口,例如:`1883` +在 **TLS 校验** 中选择 TLS 证书的校验方式 + +1. 不开启:表示不进行 TLS 证书认证。在连接 MQTT 时,会先进行 TCP 连接,如果连接失败,会进行无证书认证模式的 TLS 连接。 + +2. 单向认证:开启 TLS 连接,并验证服务端证书,此时需要上传 CA 证书。 + +3. 双向认证:开启 TLS 连接,并与服务端进行双向认证,此时需要上传 CA 证书,客户端证书以及客户端密钥。 + 在 **用户** 中填写 MQTT 代理的用户名。 在 **密码** 中填写 MQTT 代理的密码。 @@ -44,13 +52,7 @@ TDengine 可以通过 MQTT 连接器从 MQTT 代理订阅数据并将其写入 T ![mqtt-03.png](./mqtt-03.png) -### 4. 配置 SSL 证书 - -如果 MQTT 代理使用了 SSL 证书,需要在 **SSL证书** 中上传证书文件。 - -![mqtt-04.png](./mqtt-04.png) - -### 5. 配置采集信息 +### 4. 配置采集信息 在 **采集配置** 区域填写采集任务相关的配置参数。 @@ -75,13 +77,13 @@ TDengine 可以通过 MQTT 连接器从 MQTT 代理订阅数据并将其写入 T ![mqtt-05.png](./mqtt-05.png) -### 6. 配置 MQTT Payload 解析 +### 5. 配置 MQTT Payload 解析 在 **MQTT Payload 解析** 区域填写 Payload 解析相关的配置参数。 taosX 可以使用 JSON 提取器解析数据,并允许用户在数据库中指定数据模型,包括,指定表名称和超级表名,设置普通列和标签列等。 -#### 6.1 解析 +#### 5.1 解析 有三种获取示例数据的方法: @@ -112,7 +114,7 @@ json 数据支持 JSONObject 或者 JSONArray,使用 json 解析器可以解 ![mqtt-07.png](./mqtt-07.png) -#### 6.2 字段拆分 +#### 5.2 字段拆分 在 **从列中提取或拆分** 中填写从消息体中提取或拆分的字段,例如:将 message 字段拆分成 `message_0` 和 `message_1` 这2 个字段,选择 split 提取器,seperator 填写 -, number 填写 2。 @@ -126,7 +128,7 @@ json 数据支持 JSONObject 或者 JSONArray,使用 json 解析器可以解 ![mqtt-09.png](./mqtt-09.png) -#### 6.3 数据过滤 +#### 5.3 数据过滤 在 **过滤** 中,填写过滤条件,例如:填写`id != 1`,则只有 id 不为 1 的数据才会被写入 TDengine。 @@ -138,7 +140,7 @@ json 数据支持 JSONObject 或者 JSONArray,使用 json 解析器可以解 ![mqtt-11.png](./mqtt-11.png) -#### 6.4 表映射 +#### 5.4 表映射 在 **目标超级表** 的下拉列表中选择一个目标超级表,也可以先点击右侧的 **创建超级表** 按钮创建新的超级表。 @@ -164,7 +166,7 @@ json 数据支持 JSONObject 或者 JSONArray,使用 json 解析器可以解 ![mqtt-19.png](./mqtt-19.png) -### 7. 高级选项 +### 6. 高级选项 在 **消息等待队列大小** 中填写接收 MQTT 消息的缓存队列大小,当队列满时,新到达的数据会直接丢弃。可设置为 0,即不缓存。 @@ -182,12 +184,12 @@ json 数据支持 JSONObject 或者 JSONArray,使用 json 解析器可以解 ![mqtt-14](./mqtt-14.png) -### 8. 异常处理策略 +### 7. 异常处理策略 import Contributing from './_03-exception-handling-strategy.mdx' -### 9. 创建完成 +### 8. 创建完成 点击 **提交** 按钮,完成创建 MQTT 到 TDengine 的数据同步任务,回到**数据源列表**页面可查看任务执行情况。 diff --git a/docs/zh/06-advanced/05-data-in/mqtt-03.png b/docs/zh/06-advanced/05-data-in/mqtt-03.png index 292fed0d1a..576db44905 100644 Binary files a/docs/zh/06-advanced/05-data-in/mqtt-03.png and b/docs/zh/06-advanced/05-data-in/mqtt-03.png differ diff --git a/docs/zh/06-advanced/05-data-in/mqtt-04.png b/docs/zh/06-advanced/05-data-in/mqtt-04.png deleted file mode 100644 index e099875679..0000000000 Binary files a/docs/zh/06-advanced/05-data-in/mqtt-04.png and /dev/null differ