離線算法開發手冊__算法規範_開發者指南_推薦引擎-阿裏雲

• 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

  上一篇： 實時修正__用戶指南_推薦引擎-阿裏雲

  下一篇： 在線算法開發手冊__算法規範_開發者指南_推薦引擎-阿裏雲