Tieni presente che stai visualizzando la documentazione di Looker. Per la documentazione di Looker Studio, visita https://support.google.com/looker-studio.

Scaricare i file JAR di Looker

Ti consigliamo di creare un backup dell'istanza di Looker prima di aggiornare Looker. Per istruzioni, consulta la pagina della documentazione Creare backup.

Per installare o aggiornare l'applicazione Looker per un deployment ospitato dal cliente, devi scaricare i file JAR di Looker. Questa pagina descrive due metodi per scaricare i file JAR di Looker:

Utilizzare la pagina web Scaricare i file JAR di Looker
Chiamare l'API

Prima di poter scaricare i file JAR, devi accettare il Contratto di licenza con l'utente finale (EULA), disponibile sulla pagina web Download dei file JAR di Looker, utilizzando le specifiche riportate in questa pagina. Ogni utente che scarica i file JAR deve accettare questo Contratto di licenza con l'utente finale (EULA) solo una volta. Se il Contratto di licenza con l'utente finale (EULA) viene aggiornato in futuro, ogni utente dovrà accettare anche la versione più recente.

Utilizza la pagina web Scarica i file JAR di Looker.

Puoi accedere alla pagina web Scarica file JAR di Looker a questo link: https://download.looker.com/validate:

Inserisci il numero di licenza di Looker.
Inserisci l'indirizzo email. Deve essere un dominio email ospitato privatamente.
Seleziona la versione di Looker da scaricare.

Se selezioni Ultima versione, scaricherai la versione più recente dei file JAR di Looker per la release Looker attuale. Se selezioni Versione specifica, devi inserire esattamente il nome del file JAR di Looker.

La convenzione di denominazione dei file JAR per ogni release include il numero . nella versione e segue un pattern definito. Ad esempio, i nomi file JAR per Looker 22.2 sono looker-22.2.jar e looker-dependencies-22.2.jar.
Seleziona Scarica.

Se non hai ancora accettato il Contratto di licenza con l'utente finale (EULA), verrà visualizzato un modulo di accettazione di Contratto di licenza con l'utente finale (EULA). Seleziona Leggi Termini e condizioni per visualizzare il Contratto di licenza con l'utente finale (EULA) nella sua interezza. Inserisci il Nome e il Cognome e seleziona la casella di controllo accanto a Accetto i Termini e condizioni. Infine, seleziona Scarica.
Seleziona Scarica 1 di 2 per scaricare il file JAR principale di Looker. Seleziona quindi Scarica 2 di 2 per scaricare il file JAR delle dipendenze Looker. Il link scade dopo 10 minuti. Se il link scade, puoi riavviare la procedura di download.

Chiamata all'API

Prima di poter scaricare i file JAR chiamando l'API, devi accettare il Contratto di licenza con l'utente finale (EULA) tramite la pagina dei file JAR di Lookerpagina web.

Puoi quindi effettuare la chiamata API necessaria inviando una richiesta POST all'endpoint HTTPS con qualsiasi metodo desiderato: JavaScript, Java, Ruby, comando shell e così via. Affinché una di queste richieste funzioni, devi utilizzare il metodo POST per inviare il payload dell'API a https://apidownload.looker.com/download. Il payload dell'API deve contenere i valori lic, email e latest.

La proprietà latest indica la versione della JAR di Looker. Per scaricare la versione più recente dei file JAR per la release Looker attuale (looker-latest.jar), è necessario specificare "latest". Per scaricare una versione specifica, imposta latest su "specific" e includi un'altra coppia chiave-valore all'interno del payload dell'API denominata specific con il nome file JAR principale desiderato come valore.

Devi chiamare l'API solo una volta; la risposta iniziale conterrà entrambi i link per il download e sarà disponibile per 10 minuti. Dovrai scaricare entrambi i file JAR separatamente.

Ecco due esempi di richieste effettuate scritte in ES6 (JavaScript). Per richiedere la versione più recente:

    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);
    })

Per richiedere una versione JAR specifica (ad esempio, Looker 22.2): none data: { lic: "YOUR-LOOK-ERLI-CENS-EKEY", email: "contact@email.com", latest: "specific", specific: "looker-22.2-latest.jar" }

Di seguito sono riportati due comandi shell di esempio per effettuare richieste POST all'endpoint HTTPS.

Per richiedere una versione specifica dei file JAR utilizzando il comando wget (ad esempio, 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"

Per richiedere i file JAR più recenti utilizzando una serie di comandi curl e wget per scaricare e salvare i file localmente:

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')"

In alternativa, se hai installato jq e wget, puoi usare i seguenti esempi di comandi della shell.

Per richiedere i file JAR più recenti utilizzando una serie di comandi wget:

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)"

Puoi anche scaricare altre versioni della JAR impostando LOOKER_VERSION su latest, 22.2-latest o un'altra versione supportata nei seguenti esempi di comandi. Ad esempio, per richiedere i file principali e delle dipendenze per 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)"

Una risposta corretta conterrà sia gli URL dei download sia gli hash SHA-256 dei file JAR.

Gli errori di payload dell'API, come parametri di input mancanti o digitati in modo errato, generano una risposta "Corpo della richiesta non valido". Se fornisci un codice licenza errato o ometti un valore specific quando richiedi una versione di specific, verrà restituito un messaggio "Richiesta non valida".

I problemi di download di entrambi i file JAR potrebbero causare la visualizzazione di un messaggio nel campo splitJarMessage.

Se non hai accettato in precedenza il Contratto di licenza con l'utente finale (EULA) più recente, la risposta conterrà tre campi: eulaMessage, eulaText e eulaNeeded. L'elemento eulaMessage indicherà che devi accettare il Contratto di licenza con l'utente finale (EULA) tramite la pagina web Scarica file JAR di Looker prima che l'API restituisca un URL di download.