下載 Looker JAR 檔案

如要為客戶代管部署安裝或更新 Looker 應用程式,您必須下載 Looker JAR 檔案。本頁面將說明兩種下載 Looker JAR 檔案的方法:

  1. 使用「下載 Looker JAR 檔案」網頁
  2. 呼叫 API

您必須先接受「使用者授權協議」(EULA),才能下載 JAR 檔案。您可以前往「下載 Looker JAR 檔案」網頁,使用本頁所述規格接受協議。每位下載 JAR 檔案的使用者都必須接受這份 EULA 一次。(如果日後更新 EULA,每位使用者也必須接受新版本)。

使用「下載 Looker JAR 檔案」網頁

您可以透過以下連結前往「下載 Looker JAR 檔案」網頁:https://download.looker.com/validate。如要下載 Looker JAR 檔案,請按照下列步驟操作:

  1. 輸入 Looker 執照號碼。
  2. 輸入電子郵件地址。這必須是私人代管的電子郵件網域。
  3. 選取要下載的 Looker 版本。

    如果選取「Latest Version」,系統會下載目前 Looker 版本的最新版 Looker JAR 檔案。如果選取「Specific Version」,您必須輸入 Looker 核心 JAR 檔案名稱。

  4. 按一下「取得下載檔案」

    如果您尚未接受使用者授權協議,系統會顯示「接受使用者授權協議」表單。選取「閱讀條款及細則」即可查看完整的 EULA。接著輸入姓氏名字,然後勾選「我同意《條款及細則》」旁的核取方塊。最後,請按一下「取得下載」

  5. 按一下「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 酬載必須包含 licemaillatest 的值。

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"

如要使用一系列 curlwget 指令要求最新的 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')"

或者,如果您已安裝 jqwget,可以使用下列 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 設為 latest22.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,回應會包含三個欄位:eulaMessageeulaTexteulaNeededeulaMessage 會指出您必須先透過 Download Looker JAR 檔案 網頁接受 EULA,API 才會傳回下載網址。