怎樣進(jìn)行Kylin Restful API的使用，針對(duì)這個(gè)問(wèn)題，這篇文章詳細(xì)介紹了相對(duì)應(yīng)的分析和解答，希望可以幫助更多想解決這個(gè)問(wèn)題的小伙伴找到更簡(jiǎn)單易行的方法。

成都創(chuàng)新互聯(lián)主要從事做網(wǎng)站、網(wǎng)站建設(shè)、網(wǎng)頁(yè)設(shè)計(jì)、企業(yè)做網(wǎng)站、公司建網(wǎng)站等業(yè)務(wù)。立足成都服務(wù)日照,10余年網(wǎng)站建設(shè)經(jīng)驗(yàn),價(jià)格優(yōu)惠、服務(wù)專業(yè),歡迎來(lái)電咨詢建站服務(wù):18982081108

說(shuō)明：官網(wǎng)上關(guān)于Restful API Response部分介紹倒是很詳細(xì)，但Request部分卻很簡(jiǎn)單，有些沒(méi)有舉例說(shuō)明，筆者在進(jìn)行restful接口開(kāi)發(fā)時(shí)剛開(kāi)始很是懵逼，而我們當(dāng)然更在意如何發(fā)請(qǐng)求去訪問(wèn)Kylin，這樣拿到的Response也才有意義。這篇文章著重舉例說(shuō)明下如何使用Restful API訪問(wèn)Kylin（結(jié)構(gòu)與官網(wǎng)保持一致）。

1. Query  |  Authentication

官網(wǎng)：有舉例。

API說(shuō)明：進(jìn)行認(rèn)證。

筆者剛開(kāi)始這里有點(diǎn)暈，一時(shí)沒(méi)看懂它的權(quán)限驗(yàn)證是什么意思。這里簡(jiǎn)單說(shuō)明一下：

第一次訪問(wèn)時(shí)：

curl -c /path/to/cookiefile.txt -X POST \

-H "Authorization: Basic XXXXXXXXX" \

-H 'Content-Type: application/json' \

http://:/kylin/api/user/authentication

第二次訪問(wèn)時(shí)：

curl -b /path/to/cookiefile.txt -X PUT  \

-H 'Content-Type: application/json'  \

-d '{"startTime":'1423526400000',  \

 "endTime":'1423526400',  \

 "buildType":"BUILD"}'   \

http://:/kylin/api/cubes/your_cube/build 

這里有點(diǎn)像kerberos認(rèn)證：先為每個(gè)用戶生成一個(gè)keytab文件，而后用戶就可以通過(guò)這個(gè)keytab文件去進(jìn)行登錄訪問(wèn)，當(dāng)然原理是不一樣的。第一次訪問(wèn)Kylin時(shí)，要進(jìn)行認(rèn)證操作，通過(guò)Authorization頭，傳入一個(gè)base64編碼后的值，通常是對(duì)“用戶名：密碼”進(jìn)行編碼后傳入，然后會(huì)生成一個(gè)cookie文件保存在本地，即cookiefile.txt 。當(dāng)?shù)诙蔚卿洉r(shí)，不必再進(jìn)行認(rèn)證，只需通過(guò)指定這個(gè)cookie文件即可訪問(wèn)Kylin（指定Authorization頭當(dāng)然也可以訪問(wèn)Kylin）。

Authorization值可通過(guò)如下代碼獲?。?/p>

byte[] key = ("ADMIN:KYLIN").getBytes();

encoding = new sun.misc.BASE64Encoder().encode(key);

可得到：encoding = "QURNSU46S1lMSU4="

然后通過(guò) -H "Authorization: Basic QURNSU46S1lMSU4=" 進(jìn)行訪問(wèn)

2. Query  |  Query

官網(wǎng)：有舉例。

API說(shuō)明：執(zhí)行所有查詢語(yǔ)句。

3. Query  |  List queryable tables

API說(shuō)明：列出指定項(xiàng)目下可查詢的表

API舉例說(shuō)明：

curl -X GET -H "Content-Type: application/json"   \

-H "Authorization: Basic QURNSU46S1lMSU4="   \

http://:/kylin/api/tables_and_columns?project=projectName

4. CUBE  |  List cubes

API說(shuō)明：列出符合條件的cube信息

API舉例說(shuō)明：

a.列出所有項(xiàng)目所有的cube信息（limit=15）

curl -vi  -X  GET  \

-H "Authorization: Basic QURNSU46S1lMSU4="  \

-H "Content-Type: application/json"  \

http://:/kylin/api/cubes?limit=15&offset=0

b.列出所有項(xiàng)目下cubeName=xxxx的cube信息

curl -vi  -X  GET \

-H "Authorization: Basic QURNSU46S1lMSU4="  \

-H "Content-Type: application/json"  \

http://:/kylin/api/cubes?cubeName=xxxx&limit=15&offset=0

注：cubeName參數(shù)必須寫(xiě)在limit和offset前，否則失效

c.列出指定項(xiàng)目下所有的cube信息

curl -vi  -X  GET  \

-H "Authorization: Basic QURNSU46S1lMSU4="  \

-H "Content-Type: application/json"  \

http://:/kylin/api/cubes?projectName=xxxx&limit=15&offset=0

注：projectName參數(shù)必須寫(xiě)在limit和offset前，否則失效

d.cubeName與projectName為可選項(xiàng)，哪個(gè)在前哪個(gè)生效

curl -vi  -X  GET  \

-H "Authorization: Basic QURNSU46S1lMSU4="   \

-H "Content-Type: application/json"   \

http://:/kylin/api/cubes?cubeName=xxxx& \

projectName=xxxx&limit=15&offset=0

5. CUBE  |  Get Cube

API說(shuō)明：獲取指定cube信息

API舉例說(shuō)明：

curl -vi -b /home/cookiefile.txt -X GET  \

-H "Content-Type: application/json"  \

http://:/kylin/api/cubes?cubeName=xxxx

6. CUBE  |  Get cube descriptor

API說(shuō)明：獲取指定cube的描述信息

API舉例說(shuō)明：

curl -vi -b /home/cookiefile.txt -X GET  \

-H "Content-Type: application/json"   \

http://:/kylin/api/cube_desc/{cubeName}

7. CUBE  |  Get data model

API說(shuō)明：獲取指定model的信息

API舉例說(shuō)明：

curl -vi -b /home/cookiefile.txt -X GET  \

-H "Content-Type: application/json"   \

http://:/kylin/api/model/{modelName}

8. CUBE  |  Build cube

API說(shuō)明：構(gòu)建cube

API舉例說(shuō)明：官網(wǎng)有案例

注：PUT /kylin/api/cubes/{cubeName}/build與PUT /kylin/api/cubes/{cubeName}/rebuild測(cè)試均可。

9. CUBE  |  Enable Cube

API說(shuō)明：使已構(gòu)建的cube不可用

API舉例說(shuō)明：

curl -X PUT  \

-H "Authorization: Basic QURNSU46S1lMSU4="  \

-H 'Content-Type: application/json'  \

http://:/kylin/api/cubes/{cubeName}/enable

10. CUBE  |  Disable Cube

API說(shuō)明：恢復(fù)不可用cube為可用

API舉例說(shuō)明：

curl -X PUT \

-H "Authorization: Basic QURNSU46S1lMSU4="  \

-H 'Content-Type: application/json'  \

http://:/kylin/api/cubes/{cubeName}/disable

11. CUBE  |  Purge Cube

API說(shuō)明：清空cube所有數(shù)據(jù)

API舉例說(shuō)明：

curl -X PUT \

-H "Authorization: Basic QURNSU46S1lMSU4="  \

-H 'Content-Type: application/json'  \

http://:/kylin/api/cubes/{cubeName}/purge

注：purge前必須先disable，purge后只是刪除了元數(shù)據(jù)，表并沒(méi)有被刪除。

12. 刪除無(wú)用的segment

API說(shuō)明：官網(wǎng)上沒(méi)有，Google好久才找到，當(dāng)錯(cuò)誤build一個(gè)cube時(shí)，可使用此API。

API舉例說(shuō)明：

curl -vi -b /home/cookiefile.txt  \

-XDELETE -H "Content-Type: application/json"  \

關(guān)于怎樣進(jìn)行Kylin Restful API的使用問(wèn)題的解答就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，如果你還有很多疑惑沒(méi)有解開(kāi)，可以關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道了解更多相關(guān)知識(shí)。