如需为客户托管的部署安装或更新 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 版本。
如果您选择最新版本,则会下载当前 Looker 版本的最新版 Looker JAR 文件。如果您选择 Specific Version(具体版本),则需要输入 Looker 核心 JAR 文件名。
点击获取下载内容。
如果您尚未接受最终用户许可协议,系统会显示最终用户许可协议接受表单。选择阅读条款及条件可查看完整的 EULA。接下来,输入您的名字和姓氏,然后选中我同意条款及条件旁边的复选框。最后,点击获取下载内容。
点击 Download 1 of 2(下载 1 / 2)以下载 Looker 核心 JAR 文件。然后,点击 Download 2 of 2(下载 2 / 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"
,并在 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
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
值将导致“请求无效”响应。
下载这两个 JAR 文件时出现问题可能会导致 splitJarMessage
字段中显示消息。
如果您之前未接受最新的 EULA,则响应将包含三个字段:eulaMessage
、eulaText
和 eulaNeeded
。eulaMessage
将指明您必须先通过 Download Looker JAR file 网页接受 EULA,然后 API 才会返回下载网址。