You need to enable JavaScript to run this app.
导航

富化映射函数

最近更新时间2023.11.13 16:31:41

首次发布时间2023.09.27 14:09:14

f_dict_map 函数

与指定字典进行映射,根据映射关系将输入的字段映射为一个新字段。

函数语法/格式

f_dict_map(value=映射的字典,fields=映射字段,output_field=输出字段,missing=缺省填充字段,mode="fill")

参数说明如下:

参数

参数类型

是否必选

默认值

取值范围

说明

value

Dict

/

/

用于映射的字符串字典。其中 key 和 value 必须为字符串格式。

fields

String

/

/

字段名或字段名列表,多个字段名之间通过英文逗号分隔。指定为多个字段名时:

  • 日志服务会依次对匹配到的值进行映射。
  • 如果匹配命中多条日志,且 mode 的取值为 overwrite 时,则最后一个会覆盖前面的结果。
  • 若没有匹配到任何字段,则使用 missing 参数的值作为匹配值。

output_field

String

/

/

输出字段名称。

missing

String

/

/

如果没有匹配到默认字段,则将该参数的值赋予输出字段 output_field。默认为 None 表示不做映射赋值操作。

mode

String

overwrite

  • overwrite
  • fill

指定值对输出字段的覆盖模式。

  • overwrite: 在任何情况下均默认覆盖写入。
  • fill: 当目标字段不存在时,设置目标字段。

函数示例

  • 场景:用 dict 中的映射把日志内容 status 字段,映射到 status_msg 字段。

  • 加工规则:

    f_dict_map(dict_make("200","成功","400","参数异常"),"status","status_msg","未知状态")
    
  • 日志样例:

    {
        "status": "200"
    }
    
  • 加工结果:

    {
        "status": "200",
        "status_msg": "成功"
    }