Notez que vous consultez actuellement la documentation de Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Cette page a été traduite par l'API Cloud Translation.

Télécharger les fichiers JAR de Looker

Nous vous recommandons de créer une sauvegarde de votre instance Looker avant de mettre à jour Looker. Consultez la page de documentation Créer des sauvegardes pour obtenir des instructions.

Pour installer ou mettre à jour l'application Looker pour un déploiement hébergé par un client, vous devez télécharger les fichiers JAR de Looker. Cette page décrit deux méthodes de téléchargement des fichiers JAR Looker:

Utiliser la page Web Télécharger des fichiers JAR Looker
Appeler l'API

Avant de pouvoir télécharger les fichiers JAR, vous devez accepter un contrat de licence utilisateur final (CLUF), disponible sur la page Web Télécharger des fichiers JAR Looker et conformément aux spécifications indiquées sur cette page. Chaque utilisateur qui télécharge les fichiers JAR ne doit accepter le présent CLUF qu'une seule fois. Si le CLUF est mis à jour à une date ultérieure, chaque utilisateur devra également accepter la version la plus récente.

Utiliser la page Web Télécharger un ou plusieurs fichiers JAR Looker

Vous pouvez accéder à la page Web Télécharger des fichiers JAR Looker à l'adresse https://download.looker.com/validate :

Saisissez votre numéro de licence Looker.
Veuillez saisir votre adresse e-mail. Il doit s'agir d'un domaine de messagerie hébergé de manière privée.
Sélectionnez la version de Looker à télécharger.

Si vous sélectionnez Dernière version, vous téléchargerez la dernière version des fichiers JAR de Looker pour la version actuelle de Looker. Si vous sélectionnez Specific Version (Version spécifique), vous devez saisir exactement le nom de fichier JAR de Looker.

La convention d'attribution de noms des fichiers JAR pour chaque version inclut . dans le numéro de version et suit un modèle défini. Par exemple, les noms de fichiers JAR pour Looker 22.2 sont looker-22.2.jar et looker-dependencies-22.2.jar.
Sélectionnez Télécharger.

Si vous n'avez pas encore accepté le CLUF, un formulaire d'acceptation CLUF s'affiche. Sélectionnez Lire les conditions d'utilisation pour afficher le CLUF dans son intégralité. Saisissez ensuite votre prénom et votre nom, puis cochez la case J'accepte les conditions d'utilisation. Enfin, sélectionnez Télécharger.
Sélectionnez Download 1 of 2 (Télécharger 1 sur 2) pour télécharger le fichier JAR principal de Looker. Sélectionnez ensuite Download 2 of 2 (Télécharger 2 sur 2) pour télécharger le fichier JAR des dépendances Looker. Ce lien expire au bout de 10 minutes. Si le lien expire, vous pouvez relancer le processus de téléchargement.

Appeler l'API

Avant de pouvoir télécharger les fichiers JAR en appelant l'API, vous devez accepter le CLUF via la page Web Télécharger les fichiers JAR Looker.

Vous pouvez ensuite effectuer l'appel d'API nécessaire en envoyant une requête POST au point de terminaison HTTPS avec la méthode de votre choix (JavaScript, Java, Ruby, commande shell, etc.). Pour que l'une de ces requêtes fonctionne, vous devez utiliser la méthode POST pour envoyer la charge utile de l'API à https://apidownload.looker.com/download. La charge utile de l'API doit contenir des valeurs pour lic, email et latest.

La propriété latest indique la version du fichier JAR de Looker. Pour télécharger la dernière version des fichiers JAR pour la version actuelle de Looker (looker-latest.jar), spécifier "latest" est suffisant. Pour télécharger une version spécifique, définissez latest sur "specific" et incluez une autre paire clé-valeur dans la charge utile de l'API, appelée specific, avec comme valeur le nom de fichier JAR principal souhaité.

Vous n'avez besoin d'appeler l'API qu'une seule fois. La réponse initiale contiendra les deux liens de téléchargement et sera disponible pendant 10 minutes. Les deux fichiers JAR doivent être téléchargés séparément.

Voici deux exemples d'envoi d'une requête écrite en ES6 (JavaScript). Pour demander la dernière version:

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

Pour demander une version de JAR spécifique (par exemple, Looker 22.2) : none data: { lic: "YOUR-LOOK-ERLI-CENS-EKEY", email: "contact@email.com", latest: "specific", specific: "looker-22.2-latest.jar" }

Voici deux exemples de commandes shell permettant d'envoyer des requêtes POST au point de terminaison HTTPS.

Pour demander une version spécifique des fichiers JAR à l'aide de la commande wget (par exemple, 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"

Pour demander les fichiers JAR les plus récents à l'aide d'une série de commandes curl et wget afin de télécharger et d'enregistrer les fichiers localement:

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

Si vous avez installé jq et wget, vous pouvez utiliser les exemples de commandes shell suivants.

Pour demander les fichiers JAR les plus récents à l'aide d'une série de commandes wget, procédez comme suit:

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

Vous pouvez également télécharger d'autres versions du fichier JAR en définissant LOOKER_VERSION sur latest, 22.2-latest ou une autre version compatible dans les séries d'exemples de commandes suivantes. Par exemple, pour demander les fichiers principaux et de dépendances pour 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)"

Une réponse réussie contient à la fois les URL des téléchargements et les hachages SHA-256 des fichiers JAR.

Les erreurs de charge utile de l'API, telles que des paramètres d'entrée manquants ou mal saisis, entraînent une réponse "Corps de la requête non valide". Si vous fournissez une clé de licence incorrecte ou omettez de valeur specific lorsque vous demandez une version specific, la réponse "Requête non valide" s'affiche.

Les problèmes liés au téléchargement des deux fichiers JAR peuvent entraîner l'affichage d'un message dans le champ splitJarMessage.

Si vous n'avez pas encore accepté le dernier CLUF, la réponse contiendra trois champs: eulaMessage, eulaText et eulaNeeded. eulaMessage indique que vous devez d'abord accepter le CLUF via la page Web Télécharger le fichier JAR Looker avant que l'API renvoie une URL de téléchargement.