发布日期: 2021-10-16
版本号: v0.2.7

新版本主要包含以下改进：功能方面新增推荐结果分页获取支持，允许插入未来时间戳反馈，支持推荐结果回写延迟配置，增加Prometheus监控指标覆盖主节点、工作节点、服务器及数据库，实现日志文件存储，支持多种反馈类型读取及自定义本地缓存路径。性能优化包括采用自定义编解码器替代原有gob编码，改用流式协议传输模型数据，并为反馈表添加item_id索引以提升查询效率。问题修复涉及数据库接口未关闭结果集的缺陷处理。升级注意事项包括配置文件中"read_feedback_type"更名为数组型"read_feedback_types"，推荐API中"write-back"调整为"write-back-type"并新增延迟参数，命令行新增日志路径和缓存路径配置选项。

更新内容 （中文）

功能

  • 支持推荐结果分页获取（偏移量与限制数量）(#287)
  • 支持插入含未来时间戳的反馈数据(#283)
  • 支持推荐结果获取时配置write-back-delay写入延迟(#283)
  • 支持master/worker/server/database的Prometheus监控指标(#289)
  • 支持将日志写入文件(#289)
  • 支持多类型反馈数据读取(#288)
  • 支持自定义本地缓存路径(#292)

性能

  • 使用自定义编解码器替代encoding/gob标准库(#284)
  • 采用基于流的协议替代原有消息式模型分发机制(#284)
  • 为反馈表的item_id字段添加索引(#286)

修复

  • 修复数据库接口中未关闭结果集的问题(#275)

升级指南

  • 配置文件中read_feedback_type已更名为read_feedback_types（字符串数组类型）
  • 推荐接口变更:
    • write-back参数更名为write-back-type
    • 使用write-back-delay配置反馈写入延迟时间
    • 使用offset参数实现推荐结果分页加载
  • 命令行变更:
    • 使用--log-path指定日志文件路径
    • 使用--cache-path指定本地缓存文件路径

更新内容 （原始）

Features

  • Support offset and limit for recommendation result fetching (#287).
  • Support insert feedback with future timestamps (#283).
  • Support write-back-delay for recommendation result fetching (#283).
  • Support prometheus metrics for master, worker, server and database (#289).
  • Support write logs to files (#289).
  • Support multiple read feedback types (#288).
  • Support custom location for local cache (#292).

Performance

  • Replace encoding/gob with custom encoder/decoder (#284).
  • Replace message based model distribution with stream based protocol (#284).
  • Add index for item_id in feedback table (#286).

Fix

  • Fix unclosed result sets in database interfaces (#275).

Upgrade Guide

  • In configuration file, read_feedback_type has been replaced by read_feedback_types, which is an array of strings.
  • In recommendation API:
    • write-back has been replaced by write-back-type.
    • Use write-back-delay to set delayed timestamps of write back feedbacks.
    • Use offset to load paged recommendation results.
  • In command line:
    • Use --log-path to specify the path of logging file.
    • Use --cache-path to specify the path of local cache file.

下载链接