如要為客戶代管的部署作業安裝或更新 Looker 應用程式,您必須下載 Looker JAR 檔案。本頁面說明下載 Looker JAR 檔案的兩種方法:
下載 JAR 檔案前,您必須先接受「使用者授權協議」(EULA),該協議位於「下載 Looker JAR 檔案」網頁,並使用本頁面的規格。每位下載 JAR 檔案的使用者都必須接受這份 EULA,且只需接受一次。(如果日後更新 EULA,每位使用者也必須接受新版條款)。
使用「下載 Looker JAR 檔案」網頁
您可以透過這個連結存取「下載 Looker JAR 檔案」網頁:https://download.looker.com/validate。如要下載 Looker JAR 檔案,請按照下列步驟操作:
- 輸入 Looker 授權號碼。
- 輸入電子郵件地址。這必須是私人代管的電子郵件網域。
選取要下載的 Looker 版本。
如果選取「最新版本」,系統會下載目前 Looker 版本的最新 Looker JAR 檔案。如果選取「特定版本」,請務必輸入正確的 Looker Core JAR 檔案名稱。
按一下「取得下載連結」。
如果您尚未接受使用者授權協議,系統會顯示「使用者授權協議接受」表單。選取「閱讀條款及細則」,即可查看完整 EULA。接著輸入名字和姓氏,然後勾選「我同意條款及細則」旁的核取方塊。最後按一下「取得下載連結」。
按一下「下載 1/2」,下載 Looker 核心 JAR 檔案。然後按一下「下載 2 個檔案 (2/2)」,下載 Looker 依附元件 JAR 檔案。連結會在 10 分鐘後失效。如果連結失效,請重新啟動下載程序。
呼叫 API
如要透過呼叫 API 下載 JAR 檔案,您必須先透過「下載 Looker JAR 檔案」網頁接受 EULA。
接著,您可以使用任何所需方法 (JavaScript、Java、Ruby、殼層指令等),向 HTTPS 端點發出 POST 要求,進行必要的 API 呼叫。如要讓這些要求正常運作,您必須使用 POST 方法,將 API 酬載傳送至 https://apidownload.looker.com/download。API 酬載必須包含 lic
、email
和 latest
的值。
latest
屬性表示 Looker JAR 的版本。如要下載目前 Looker 版本 (looker-latest.jar
) 的最新 JAR 檔案,只要指定 "latest"
即可。如要下載特定版本,請將 latest
設為 "specific"
,並在 API 酬載中加入另一個名為 specific
的鍵/值組合,並將核心 JAR 檔案名稱設為值。
您只需要呼叫一次 API,初始回應就會包含兩個下載連結,且連結會在 10 分鐘內有效。您必須分別下載這兩個 JAR 檔案。
以下是使用 ES6 (JavaScript) 提出要求的兩個範例。如要索取最新版本,請按照下列步驟操作:
axios({
url: "https://apidownload.looker.com/download",
method: "post",
data: {
lic: "YOUR-LOOK-ERLI-CENS-EKEY",
email: "contact@email.com",
latest: "latest"
}
}).then(function (response) {
console.log(response.data);
})
如要要求特定 JAR 版本 (例如 Looker 22.2):
none
data: {
lic: "YOUR-LOOK-ERLI-CENS-EKEY",
email: "contact@email.com",
latest: "specific",
specific: "looker-22.2-latest.jar"
}
以下是兩個範例殼層指令,可向 HTTPS 端點發出 POST 要求。
如要使用 wget
指令要求特定版本的 JAR 檔案 (例如 Looker 22.2):
wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"
wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-dependencies-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"
如要使用一系列 curl
和 wget
指令要求最新的 JAR 檔案,請在本機下載並儲存檔案:
curl -X POST -H 'Content-Type: application/json' -d '{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"latest"}'
https://apidownload.looker.com/download > api_response.json
sed -i 1,12d api_response.json
wget -O "looker-latest.jar" "$(cat api_response.json | jq -r '.url')"
wget -O "looker-dependencies-latest.jar" "$(cat api_response.json | jq -r '.depUrl')"
或者,如果您已安裝 jq 和 wget
,可以使用下列 Shell 指令範例。
如要使用一連串的 wget
指令要求最新的 JAR 檔案,請按照下列步驟操作:
wget -O "looker-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .url -r)"
wget -O "looker-dependencies-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"
您也可以在下列一系列指令範例中,將 LOOKER_VERSION
設為 latest
、22.2-latest
或其他支援版本,下載其他版本的 JAR。舉例來說,如要要求 Looker 22.2 的核心和依附元件檔案,請執行下列指令:
export LOOKER_VERSION="22.2-latest"
wget -O "looker$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"specific\",\
\"specific\":\"looker-$(LOOKER_VERSION).jar\"} "https://apidownload.looker.com/download | jq .url -r)"
wget -O "looker-dependencies$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H\
'Content-Type: application/json' -d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\":\
\"$(contact@email.com)\",\"latest\":\"specific\", \"specific\":\"looker-dependencies-$(LOOKER_VERSION).jar\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"
如果 API 酬載發生錯誤 (例如缺少或輸入錯誤的參數),系統會傳回「Invalid request body」回應。要求 specific
版本時,如果提供錯誤的授權金鑰或省略 specific
值,系統會傳回「要求無效」回應。
如果無法下載這兩個 JAR 檔案,splitJarMessage
欄位中可能會顯示訊息。
如果您先前未接受最新版 EULA,回應會包含三個欄位:eulaMessage
、eulaText
和 eulaNeeded
。eulaMessage
表示您必須先透過「Download Looker JAR file」(下載 Looker JAR 檔案) 網頁接受 EULA,API 才會傳回下載網址。