# Http Sink 组件使用说明
# 组件说明
Http Sink 连接器用于向任何 HTTP 接口推送 JSON 数据。
# 配置项说明
| 配置名称 | 数据类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| 节点名称 | String | 是 | Http | 当前创建的节点名称,由用户自定义且不可为空。命名可包含字母、数字、下划线。确保唯一性。 |
| 节点编码 | String | 是 | 自动生成 | 当前创建的节点编码,以此标识此组件,由用户自定义且不可为空。命名可包含字母、数字、下划线。确保唯一性。 |
| 请求URL | String | 是 | - | HTTP 请求地址。支持变量替换(如 ${database_name}) |
| 请求方式 | String | 是 | POST | 仅支持 POST 方法,数据作为 JSON body 发送。 不支持 GET/PUT/DELETE 等其他 HTTP 方法。 数据格式固定为 JSON,不支持 XML、Form 表单等格式。 |
| 请求头 | String | 否 | - | HTTP 请求头,如 token、Content-Type。 |
| 请求参数 | String | 否 | - | 请求体参数。 |
| 最大重试次数 | Int | 否 | 0 | 请求失败时的最大重试次数(仅对 IOException 生效) |
| 重试乘数 | Int | 否 | 100 | 如果请求 Http 失败,重试回退次数(毫秒)乘数。 |
| 重试等待时间 | Int | 否 | 10000 | 请求 Http 失败时,等待下次重试的时间(毫秒) 。 |
| 可选参数 | Map | 否 | - | 其他参数,用户可以根据需求进行配置。 |
# 注意事项
- Content-Type 自动处理
若用户未显式设置 Content-Type,Sink 会自动添加 application/json。
无需手动指定,但推荐显式声明以增强可读性。
- 空值处理
字段值为 null 时,JSON body 中保留 null,不会省略该字段。
- 错误处理与重试
retry 仅对网络级异常(IOException)生效。
HTTP 状态码非 2xx 不会触发重试,任务直接失败。
如需处理业务错误码,需在目标接口层保障。