---
title: NATS Sink 集成
---

# NATS Sink 集成

本文介绍如何将 FlowMQ 数据写入 NATS。

## 前提条件

- 已了解管道结构与创建流程，参考 [数据集成](data-integration.md)；Sink 连接器总览见 [Sink](data-integration-output.md)
- NATS 服务可访问
- 已规划目标 subject

## 配置步骤

1. 在“数据管道”中创建管道，完成基础信息配置。
2. 在 Source 步骤选择 `Kafka`（Topic：`flowmq.mqtt.kafka`），Processors 按需配置。
3. 在 Sink 步骤选择 `NATS`，配置 `urls`、`subject` 等参数。
4. 点击“测试”验证连接。
5. 继续完成确认步骤。

## 配置示例

以下示例将 Kafka Topic `flowmq.mqtt.kafka` 中的样例消息写入目标系统。样例 JSON 与 Source 约定见 [Sink · 示例场景](data-integration-output.md#示例场景)。

可参考以下参数示例：

| 参数 | 建议值 |
|---|---|
| urls | host `127.0.0.1`，port `4222` |
| subject | `flowmq.sink.demo` |
| max_in_flight | `64` |

## 必要表单参数

参数名后带 `*` 表示控制台必填。「支持表达式」为「是」时，可使用 `${! ... }` 按消息动态取值，详见 [Processors](data-integration-processors-expressions.md)。

| 参数 | 支持表达式 | 说明 |
|------|------------|------|
| `urls*` | 否 | NATS 地址列表，在控制台按 host、port 逐项填写 |
| `subject*` | 是 | 发布目标 subject |
| `max_in_flight*` | 否 | 并发写入上限 |
| `auth` | 否 | 启用鉴权时需要配置 |

## 参数建议

- `subject` 建议按业务域分层命名；也可按消息动态生成
- `max_in_flight` 可先沿用默认值，压测后再上调

## 注意事项

- 若某 NATS subject 的数据会流入本管道读取的 Kafka Topic，Sink 请勿再发布到该 subject，以免形成消息环路
- 并发参数建议在压测后再调整
