如要為客戶代管部署安裝或更新 Looker 應用程式,您必須下載 Looker JAR 檔案。本頁面將說明兩種下載 Looker JAR 檔案的方法:
您必須先接受「使用者授權協議」(EULA),才能下載 JAR 檔案。您可以前往「下載 Looker JAR 檔案」網頁,使用本頁所述規格接受協議。每位下載 JAR 檔案的使用者都必須接受這份 EULA 一次。(如果日後更新 EULA,每位使用者也必須接受新版本)。
使用「下載 Looker JAR 檔案」網頁
您可以透過以下連結前往「下載 Looker JAR 檔案」網頁:https://download.looker.com/validate。如要下載 Looker JAR 檔案,請按照下列步驟操作:
- 輸入 Looker 執照號碼。
- 輸入電子郵件地址。這必須是私人代管的電子郵件網域。
選取要下載的 Looker 版本。
如果選取「Latest Version」,系統會下載目前 Looker 版本的最新版 Looker JAR 檔案。如果選取「Specific Version」,您必須輸入 Looker 核心 JAR 檔案名稱。
按一下「取得下載檔案」。
如果您尚未接受使用者授權協議,系統會顯示「接受使用者授權協議」表單。選取「閱讀條款及細則」即可查看完整的 EULA。接著輸入姓氏和名字,然後勾選「我同意《條款及細則》」旁的核取方塊。最後,請按一下「取得下載」。
按一下「Download 1 of 2」,下載 Looker 核心 JAR 檔案。接著,按一下「Download 2 of 2」下載 Looker 依附元件 JAR 檔案。這個連結會在 10 分鐘後失效。如果連結失效,您可以重新啟動下載程序。
呼叫 API
您必須先透過 下載 Looker JAR 檔案網頁接受 EULA,才能透過呼叫 API 下載 JAR 檔案。
接著,您可以使用任何所需方法 (JavaScript、Java、Ruby、shell 指令等) 向 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"
,並在名為 specific
的 API 酬載中加入另一個鍵/值組合,並將核心 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 酬載錯誤 (例如缺少或輸入錯誤的輸入參數) 會導致「無效的請求主體」回應。請求 specific
版本時,如果提供錯誤的授權金鑰或省略 specific
值,系統會傳回「Invalid request」回應。
下載兩個 JAR 檔案時發生問題,可能會導致 splitJarMessage
欄位中出現訊息。
如果您先前未接受最新的 EULA,回應會包含三個欄位:eulaMessage
、eulaText
和 eulaNeeded
。eulaMessage
會指出您必須先透過 Download Looker JAR 檔案 網頁接受 EULA,API 才會傳回下載網址。