您正在查看 Looker 22.16 的文档。最新的文档可在此处找到。

下载 Looker JAR 文件

我们建议您在更新 Looker 之前创建 Looker 实例的备份。有关说明，请参阅创建备份文档页面。

如需为客户托管的部署安装或更新 Looker 应用，您必须下载 Looker JAR 文件。本页介绍了下载 Looker JAR 文件的两种方法：

使用下载 Looker JAR 文件网页
调用 API

您必须先接受最终用户许可协议 (EULA)（位于 Download Looker JAR files 网页，请按照本页列出的规范下载），然后才能下载 JAR 文件。每个下载 JAR 文件的用户只能接受一次此最终用户许可协议。（如果最终用户许可协议日后更新，每位用户还必须接受新版）。

使用下载 Looker JAR 文件网页

您可以通过以下链接访问下载 Looker JAR 文件网页：https://download.looker.com/validate：

输入您的 Looker 许可编号。
输入您的电子邮件地址。必须是私人托管的电子邮件域名。
选择要下载的 Looker 版本。

如果您选择最新版本，则会下载当前 Looker 版本的 Looker JAR 文件的最新版本。如果您选择特定版本，则需要精确输入 Looker 核心 JAR 文件名。

每个版本的 JAR 文件的命名惯例都包含版本号中的 . 并遵循一种既定模式。例如，Looker 22.2 的 JAR 文件名为 looker-22.2.jar 和 looker-dependencies-22.2.jar。
点击下载。

如果您尚未接受最终用户许可协议，系统会显示最终用户许可协议表单。点击阅读条款及条件以完整阅读最终用户许可协议。然后，输入您的名字和姓氏并勾选我同意条款及条件旁边的复选框。然后，点击 Get Download：
点击下载第 1 步（共 2 步），下载 Looker 核心 JAR 文件。然后，点击下载第 2 步（共 2 步），下载 Looker 依赖项 JAR 文件。此链接将在 10 分钟后过期。如果链接过期，您可以重新开始下载流程。

调用 API

在调用 API 下载 JAR 文件之前，您必须先通过下载 Looker 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"，并在 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 请求的 shell 命令示例。

如需使用 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

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 请求核心和依赖项文件，请执行以下操作： 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 文件的 SHA-256 哈希。

API 载荷错误（例如输入参数缺失或输入错误）会导致“请求正文无效”响应。如果在请求 specific 版本时提供不正确的许可密钥或省略 specific 值，将导致响应“无效”响应。

下载两个 JAR 文件时遇到问题可能会导致 splitJarMessage 字段中显示消息。

如果您之前未接受最新的 EULA，则响应中将包含三个字段：eulaMessage、eulaText 和 eulaNeeded。eulaMessage 表示您必须先通过下载 Looker JAR 文件网页接受最终用户许可协议，然后 API 才能返回下载网址。