Kylin利用Restful API构建Cube

2018年1月7日 0 条评论 2.97k 次阅读 1 人点赞

身份认证

  • 目前 Kylin采用basic authentication认证方式;
  • 首次请求认证需要添加Authorization报头;
  • 或者可以通过POST http：//localhost:7070/kylin/api/user/authentication执行特定请求;
  • 一旦通过身份验证，客户端就可以使用cookie发送后续请求任务。

Shell
1
2
3
4
POST http://10.4.27.5:7070/kylin/api/user/authentication
    
Authorization:Basic QURNSU46S1lMSU4=
Content-Type: application/json;charset=UTF-8

其中QURNSU46S1lMSU4=是<用户名:密码>base64加密以后的字符串，可以通过http://tool.oschina.net/encrypt?type=3进行测试：

通过PostMan提交认证请求，通过后显示如下：

获取Cube详情

  • GET http://localhost:7070/kylin/api/cubes?cubeName={cube_name}&limit=15&offset=0
  • 客户端可以在返回的Cube详细数据中找到Cube Segment的日期范围

Shell
1
2
3
4
http://10.4.27.5:7070/kylin/api/cubes?cubeName=kylin_sales_cube&limit=15&offset=0
 
Authorization:Basic QURNSU46S1lMSU4=
Content-Type: application/json;charset=UTF-8

提交Cube构建作业

  • PUT http://localhost:7070/kylin/api/cubes/{cube_name}/rebuild
  • 对于put请求body的详细设置，请参考Build Cube API
    • startTime和endTime应该是UTC时间戳
    • buildType可以是BUILD，MERGE或REFRESH。其中 BUILD是建立一个新的segment，刷新指的是对现有segment进行刷新操作， MERGE用于将多个现有segment合并成一个更大的segment
    • 该方法将返回一个新创建的作业实例，其uuid是跟踪作业状态的唯一ID

Shell
1
2
3
4
5
6
7
8
9
10
PUT http://localhost:7070/kylin/api/cubes/test_kylin_cube_with_slr/rebuild
 
Authorization:Basic xxxxJD124xxxGFxxxSDF
Content-Type: application/json;charset=UTF-8
    
{
    "startTime": 0,
    "endTime": 1388563200000,
    "buildType": "BUILD"
}

选择endTime时间(>startTime)，并转换为13位时间戳(转换工具)：

根据实际生产环境进行更改：

Shell
1
2
3
4
5
6
7
8
9
put http://10.4.27.5:7070/kylin/api/cubes/kylin_sales_cube/rebuild
 
Authorization:Basic xxxxJD124xxxGFxxxSDF
Content-Type: application/json;charset=UTF-8
{
    "startTime": 0,
    "endTime": 1515600006000,
    "buildType": "BUILD"
}

跟踪作业状态

  • GET http://localhost:7070/kylin/api/jobs/{job_uuid}
  • 返回job_status表示当前的工作状态

作业恢复

如果作业出现错误可以对其进行恢复：

Shell
1
2
3
PUT http://localhost:7070/kylin/api/jobs/{job_uuid}/resume
 
#由于cube在构建的过程中没有出问题，本文暂时就不演示了

© 著作权归作者所有

勇敢，和生活的艰难无关。

文章评论（0）