Looker JAR ファイルのダウンロード

Looker を更新する前に、Looker インスタンスのバックアップを作成することをおすすめします。手順については、バックアップの作成のドキュメントをご覧ください。

顧客がホストするデプロイ用の Looker アプリケーションをインストールまたは更新するには、Looker JAR ファイルをダウンロードする必要があります。このページでは、Looker JAR ファイルをダウンロードするための 2 つの方法について説明します。

  1. Looker JAR ファイルをダウンロードするのウェブページを使用する
  2. API の呼び出し

JAR ファイルをダウンロードする前に、エンドユーザー仕様契約(EULA)に同意する必要があります。この契約は、このページの仕様を使用して、Looker JAR ファイルをダウンロードのウェブページで入手できます。JAR ファイルをダウンロードする各ユーザーは、この EULA を 1 回のみ承諾する必要があります。(今後、EULA が更新される場合、各ユーザーは新しいバージョンにも同意する必要があります)。

Looker JAR ファイルをダウンロードのウェブページを使用する

Looker JAR ファイルをダウンロードのウェブページ(https://download.looker.com/validate)にアクセスできます。

  1. Looker ライセンス番号を入力します。
  2. メールアドレスを入力します。これは、非公開でホストされているメールドメインである必要があります。
  3. ダウンロードする Looker のバージョンを選択します。

    [最新バージョン] を選択すると、現在の Looker リリースの最新バージョンの Looker JAR ファイルがダウンロードされます。[特定のバージョン] を選択した場合、Looker コアの JAR ファイル名を正確に入力する必要があります。

    各リリースの JAR ファイルの命名規則は、バージョン番号に . を含み、設定されたパターンに従います。たとえば、Looker 22.2 の JAR ファイル名は、looker-22.2.jarlooker-dependencies-22.2.jar です。

  4. [ダウンロード] をクリックします。

    EULA にまだ同意していない場合は、EULA 承認フォームが表示されます。EULA の全文を表示するには、[利用規約を読む] をクリックします。[] と [] を入力し、[利用規約に同意します] の横のチェックボックスをオンにします。[ダウンロード] をクリックします。

  5. [Download 1 of 2] をクリックして、Looker コア JAR ファイルをダウンロードします。次に、[Download 2 of 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" に設定し、目的のコア JAR ファイル名を値とする specific という API ペイロード内に別の Key-Value ペアを含めます。

API を呼び出す必要があるのは 1 回だけです。最初のレスポンスには両方のダウンロード リンクが含まれ、10 分間有効です。両方の JAR ファイルを個別にダウンロードする必要があります。

ES6(JavaScript)で作成されたリクエストの 2 つの例を以下に示します。最新バージョンをリクエストするには:

    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 リクエストを行うシェルコマンドを 2 つ紹介します。

wget コマンド(Looker 22.2 など)を使用して、特定のバージョンの JAR ファイルをリクエストするには:

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
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 がインストールされている場合は、次のシェルコマンドの例を使用できます。

一連の 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_VERSIONlatest22.2-latest、または他のサポートされているバージョンに設定して、他のバージョンの JAR をダウンロードすることもできます。たとえば、Looker 22.2 のコアファイルと依存関係ファイルをリクエストするには、次のようにします。 none export LOOKER_VERSION="22.2-latest" none 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)" none 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)"

正常なレスポンスには、JAR ファイルのダウンロード URL と SHA-256 ハッシュの両方が含まれます。

API ペイロード エラー(入力パラメータの欠落や入力ミスなど)により、「無効なリクエスト本文」レスポンスが返されます。specific バージョンのリクエスト時に誤ったライセンスキーを指定したり、specific 値を省略したりすると、「無効なリクエスト」のレスポンスが返されます。

両方の JAR ファイルをダウンロードすると、splitJarMessage フィールドにメッセージが表示されることがあります。

最新の EULA に同意していない場合、レスポンスには eulaMessageeulaTexteulaNeeded の 3 つのフィールドが含まれます。eulaMessageは、API がダウンロード URL を返す前に、Looker JAR ファイルをダウンロードウェブページ経由で EULA に同意する必要があることを示します。