현재 Looker 문서를 보고 있습니다. Looker Studio 문서는 https://support.google.com/looker-studio를 방문하세요.

Looker JAR 파일 다운로드

고객 호스팅 배포를 위해 Looker 애플리케이션을 설치하거나 업데이트하려면 Looker JAR 파일을 다운로드해야 합니다. 이 페이지에서는 Looker JAR 파일을 다운로드하는 두 가지 방법을 설명합니다.

Looker JAR 파일 다운로드 웹페이지 사용
API 호출

JAR 파일을 다운로드하려면 먼저 이 페이지의 사양을 사용하여 Looker JAR 파일 다운로드 웹페이지에서 제공되는 최종 사용자 라이선스 계약(EULA)에 동의해야 합니다. JAR 파일을 다운로드하는 각 사용자는 이 EULA에 한 번만 동의해야 합니다. 향후 EULA가 업데이트되면 각 사용자도 최신 버전에 동의해야 합니다.

Looker JAR 파일 다운로드 웹페이지 사용

https://download.looker.com/validate 링크에서 Looker JAR 파일 다운로드 웹페이지에 액세스할 수 있습니다. Looker JAR 파일을 다운로드하려면 다음 단계를 따르세요.

Looker 라이선스 번호를 입력합니다.
이메일 주소를 입력합니다. 비공개 호스팅 이메일 도메인이어야 합니다.
다운로드할 Looker 버전을 선택합니다.

최신 버전을 선택하면 현재 Looker 출시 버전을 위한 최신 버전의 Looker JAR 파일을 다운로드합니다. 특정 버전을 선택하면 Looker 코어 JAR 파일 이름을 정확하게 입력해야 합니다.

참고: 각 출시 버전의 JAR 파일 이름 지정 규칙에서는 버전 번호에 마침표(.)가 포함되며 설정된 패턴을 따릅니다. 예를 들어 Looker 22.2의 JAR 파일 이름은 looker-22.2.jar 및 looker-dependencies-22.2.jar입니다.
다운로드 받기를 클릭합니다.

아직 최종 사용자 라이선스 계약에 동의하지 않은 경우 EULA 동의 양식이 표시됩니다. 최종 사용자 라이선스 계약 전체를 보려면 이용약관 읽기를 선택합니다. 그런 다음 이름과 성을 입력하고 이용약관에 동의합니다 옆의 체크박스를 선택합니다. 마지막으로 다운로드 받기를 클릭합니다.
1/2 다운로드를 클릭하여 Looker 코어 JAR 파일을 다운로드합니다. 그런 다음 2/2 다운로드를 클릭하여 Looker 종속 항목 JAR 파일을 다운로드합니다. 이 링크는 10분 후에 만료됩니다. 링크가 만료되면 다운로드 프로세스를 다시 시작할 수 있습니다.

API 호출

API를 호출하여 JAR 파일을 다운로드하려면 먼저 Looker JAR 파일 다운로드 웹페이지를 통해 EULA에 동의해야 합니다.

그런 다음 JavaScript, Java, Ruby, 셸 명령어 등 원하는 메서드를 사용하여 HTTPS 엔드포인트에 POST 요청을 수행하여 필요한 API 호출을 수행할 수 있습니다. 이 요청이 작동하려면 POST 메서드를 사용하여 https://apidownload.looker.com/download에 API 페이로드를 전송해야 합니다. API 페이로드에는 lic, email, latest 값이 포함되어야 합니다.

latest 속성은 Looker JAR 버전을 나타냅니다. 현재 Looker 출시 버전(looker-latest.jar)의 최신 JAR 파일을 다운로드하려면 "latest"를 지정하면 충분합니다. 특정 버전을 다운로드하려면 latest를 "specific"으로 설정하고 코어 JAR 파일 이름을 값으로 사용하여 specific이라는 API 페이로드 내에 다른 키-값 쌍을 포함합니다.

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"

일련의 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가 설치되어 있는 경우 다음과 같은 셸 명령어 예시를 사용할 수 있습니다.

일련의 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의 3개 필드가 포함됩니다. eulaMessage에 API가 다운로드 URL을 반환하기 전에 Looker JAR 파일 다운로드 웹페이지를 통해 EULA에 동의해야 한다고 표시됩니다.