离线算法开发手册__算法规范_开发者指南_推荐引擎-阿里云

• String context.getExtParam(String key) 获取算法额外参数。

ActivityNode

Node元信息。包含nodeCode，tableName，alg，nodeWeight，datafrom字段

• nodeCode 表示算法的唯一标识
• tableName 表示算法的输出数据表，对于系统内置dataform，tablename是”前缀+dataform“的格式拼接，且会在业务初始化时新建完成。
• dataform 表示算法的输出数据抽象格式
• alg 表示在当前流程中的唯一标识，默认为”nodeCode+节点顺序“格式拼接。对应数据表的alg分区值。用于区分流程中多次出现的相同算法。

本地测试

main函数里面用文件的方式加载ODPS配置，即可本地测试

public static void main(String[] args) throws Exception {
        RecPlatformContext context = new RecPlatformContext("./odps_conf.ini");
        context.parseParam("");
        Client.run(context, TestPlugin.class);
    }

参数是固定的JSON字符串，其中ds,biz,path 都与输入输出表的分区相关，external_params表示算法额外参数，prefix表示内置DataForm的表前缀。

{
    "ds":"",
    "biz":"",
    "path":"",
    "external_params":{
        "p1":"v1"
    },
    "input_nodes":[
        {
        "node_code":"",
        "data_form":"",
        "tableName":"",
        "node_weight":1.0
        },
        {
        "node_code":"",
        "data_form":"",
        "tableName":"",
        "node_weight":1.0
        }
    ],
    "output_node":{
        "node_code":"",
        "data_form":"",
        "tableName":"",
        "node_weight":1.0
    },
    "prefix":"alidata_rp",
    "task_id":""
}

打包

编写完算法逻辑并且本地测试通过，就可以打包在界面上传jar包注册算法。需要注意的是， 所有依赖包都不要打入jar包，包括SDK本身。

界面注册

配置流程

系统内置DataForm

输入类DataForm

作为整个算法流程的输入，无法导入在线存储。不区分场景和abtest

USER_META

描述：用户原始数据，由客户上传或者日志解析。

字段

分区字段

ITEM_META

描述：物品原始数据，由客户上传或者日志解析。

字段

分区字段

REC_ITEM_INFO

描述：可被推荐物品及信息，由客户上传。

字段

分区字段

USER_BEHAVIOR

描述：用户行为类，由客户上传或者日志解析。

字段

*行为类数据（user_behavior）注意：如果业务方无法上传用户行为表，并且业务方使用了UT埋点，则可以由RecEng从UT日志中解析出用户行为表。

分区字段

离线算法类DataForm

可以作为离线流程的中间数据，也可导出到在线存储

USER_ASSET

描述：用户历史行为记录汇总。

字段

分区字段

ITEM_POOL

描述： 推荐池，用于导出到线上数据，做规则匹配

字段

分区字段

ITEM_FEATURE

描述：物品特征

字段

分区字段

USER_FEATURE

描述：用户特征

字段

分区字段

SYMMETRIC_FEATURE

描述：用户物品对称特征

字段

分区字段

分区字段

USER_ITEM_FEATURE

描述：用户物品交互特征

字段

分区字段

USER_ITEM_SCORE

描述：用户物品偏好评分

字段

分区字段

ITEM_ITEM_REC_LIST

描述：物品-物品推荐候选集

字段

分区字段

USER_ITEM_REC_LIST

描述：用户-物品推荐候选集

字段

分区字段

DEFAULT_REC_LIST

描述：默认推荐候选集

字段

分区字段

TAG_ITEM_REC_LIST

描述：基于标签的推荐候选集

字段

分区字段

RANKING_MODEL

描述：LTR模型数据

字段

分区字段

相关下载

依赖库

    <dependency>
      <groupId>net.sf.json-lib</groupId>
      <artifactId>json-lib</artifactId>
      <version>2.4</version>
    </dependency>
    <dependency>
      <groupId>xom</groupId>
      <artifactId>xom</artifactId>
      <version>1.2.5</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>com.aliyun.odps</groupId>
      <artifactId>odps-graph-local</artifactId>
      <version>0.18.3-public</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>com.aliyun.odps</groupId>
      <artifactId>odps-sdk-core</artifactId>
      <version>0.18.3-public</version>
     <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>com.aliyun.odps</groupId>
      <artifactId>odps-sdk-mapred</artifactId>
      <version>0.18.3-public</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>com.aliyun.odps</groupId>
      <artifactId>odps-sdk-graph</artifactId>
      <version>0.18.3-public</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>com.aliyun.odps</groupId>
      <artifactId>odps-sdk-commons</artifactId>
      <version>0.18.3-public</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>httpclient</groupId>
      <artifactId>httpclient</artifactId>
      <version>4.1.2</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>httpcore</groupId>
      <artifactId>httpcore</artifactId>
      <version>4.1.2</version>
      <scope>provided</scope>
    </dependency>

推荐引擎SDK jar包下载

推荐引擎SDK javadoc下载

最后更新：2016-11-23 17:31:33

  上一篇： 实时修正__用户指南_推荐引擎-阿里云

  下一篇： 在线算法开发手册__算法规范_开发者指南_推荐引擎-阿里云