下載 Looker JAR 檔案

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

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

下載 JAR 檔案前,您必須先接受「使用者授權協議」(EULA),該協議位於「下載 Looker JAR 檔案」網頁,並使用本頁面的規格。每位下載 JAR 檔案的使用者都必須接受這份 EULA,且只需接受一次。(如果日後更新 EULA,每位使用者也必須接受新版條款)。

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

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

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

    如果選取「最新版本」,系統會下載目前 Looker 版本的最新 Looker JAR 檔案。如果選取「特定版本」,請務必輸入正確的 Looker Core JAR 檔案名稱。

  4. 按一下「取得下載連結」

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

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

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"

如要使用一系列 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 酬載發生錯誤 (例如缺少或輸入錯誤的參數),系統會傳回「Invalid request body」回應。要求 specific 版本時,如果提供錯誤的授權金鑰或省略 specific 值,系統會傳回「要求無效」回應。

如果無法下載這兩個 JAR 檔案,splitJarMessage 欄位中可能會顯示訊息。

如果您先前未接受最新版 EULA,回應會包含三個欄位:eulaMessageeulaTexteulaNeededeulaMessage 表示您必須先透過「Download Looker JAR file」(下載 Looker JAR 檔案) 網頁接受 EULA,API 才會傳回下載網址。