Les blocs Looker sont des modèles de données prédéfinis pour les modèles analytiques et les sources de données courants. Cette page explique comment les développeurs peuvent personnaliser les blocs Looker installés à partir de Looker Marketplace. Le Looker Marketplace est un emplacement centralisé qui permet de rechercher, de déployer et de gérer de nombreux types de contenu Looker, tels que des applications, des visualisations et des plug-ins.
Pour en savoir plus sur tous les blocs Looker disponibles, ainsi que sur les autres méthodes de personnalisation des blocs, consultez la page de documentation Blocs Looker.
Conditions requises pour installer et gérer des blocs Looker à partir de Looker Marketplace
Avant d'installer et d'utiliser certains blocs de Looker Marketplace, tenez compte des exigences suivantes :
- Si vous installez votre bloc via Looker Marketplace, votre administrateur Looker doit activer la fonctionnalité Marketplace.
- Les utilisateurs doivent disposer des autorisations
develop,manage_modelsetdeploypour installer et gérer des packages à partir de Marketplace. Si le bloc spécifique contient un paramètre
local_dependency, il utilise le processus d'importation de projet local. Pour en savoir plus sur l'importation de projets, consultez la page de documentation Importer des fichiers à partir d'autres projets. Les blocs suivants contiennent un paramètrelocal_dependency:- Analyses du marketing numérique
- Analyses des ventes
- Analyse d'audience Internet
Pour en savoir plus sur l'installation et la gestion des blocs Looker à partir de Looker Marketplace, consultez la page de documentation Looker Marketplace.
Accéder au code LookML d'un bloc Marketplace
Les blocs basés sur des projets qui utilisent des perfectionnements sont installés à partir de Marketplace en tant que projet CONFIG unique et modifiable qui importe à distance le projet CORE, qui contient tout le code LookML et la paramétrisation constante.
Une fois qu'un bloc est installé à partir de Marketplace, vous pouvez accéder à son projet depuis le menu Développer en cliquant sur le nom du projet dans la liste des projets. Le nom d'un bloc de perfectionnements Marketplace est généralement précédé de marketplace_ , suivi de l'ID de la fiche.
Bien que vous ne puissiez pas modifier directement le projet CORE en lecture seule d'un bloc, vous pouvez utiliser le code LookML défini dans les fichiers CORE en lecture seule du bloc comme référence lorsque vous personnalisez les fichiers CONFIG du bloc. Pour afficher les fichiers CORE du bloc, accédez aux fichiers de projet du bloc dans l'IDE et développez le imported_projects répertoire dans l'explorateur de fichiers de l'IDE.
Structure des fichiers de bloc
Lorsque vous installez un bloc conçu pour les perfectionnements, ces fichiers sont créés automatiquement dans le cadre de la partie CONFIG du projet de bloc :
| Nom de fichier | Accès | Fonction |
|---|---|---|
<model_name>.model.lkml |
Lecture seule pour tous les utilisateurs | Fichier de modèle "virtuel"lié à l'installation du bloc ; gère l'importation de tous les modèles à partir du projet CORE du bloc. Lorsqu'un bloc est désinstallé ou mis à jour, le ou les fichiers de modèle associés sont supprimés, ce qui évite les conflits de modèles entre plusieurs installations de blocs. |
manifest.lkml |
Modifiable pour les utilisateurs disposant des autorisations develop |
Décrit le projet et ses dépendances externes. Contient l'ID de la fiche Marketplace pour l'installation du bloc et facilite l'importation à distance des fichiers de projet CORE du bloc via le mot clé marketplace. |
marketplace_lock.lkml |
Lecture seule pour tous les utilisateurs | Contient une référence au marketplace_ref mot clé du fichier manifeste qui gère l'importation à distance du projet CORE. Fournit les informations spécifiques sur la fiche, la version et le modèle associés à l'installation. Contient des informations sur les constantes configurées lors de l'installation (et qui peuvent être mises à jour à l'aide de l'option Gérer dans l'interface utilisateur de Marketplace). |
refinements.lkml |
Modifiable pour les utilisateurs disposant des autorisations develop |
Permet aux développeurs d'affiner les vues et les explorations définies dans les fichiers de projet CORE importés. |
Personnaliser un bloc Marketplace
Activez le mode Développement pour personnaliser les fichiers modifiables du bloc.
Si vous disposez des autorisations develop, vous pouvez personnaliser le code LookML dans le fichier refinements.lkml du projet CONFIG du bloc. Vous pouvez affiner les vues et les explorations déjà définies dans le projet CORE du bloc, ou même ajouter de nouvelles vues et explorations qui ne sont pas encore définies dans le projet CORE. Tout ce qui est possible avec les perfectionnements LookML dans d'autres projets LookML est possible dans le fichier refinements.lkml du bloc. La combinaison du perfectionnement et du code LookML d'origine se comporte comme s'il s'agissait du code LookML d'origine de l'objet.
Vous pouvez également modifier le fichier manifest.lkml du projet CONFIG pour spécifier les dépendances à capturer pour ce bloc.
Vous n'êtes pas limité à la modification de ces fichiers pour obtenir les personnalisations souhaitées. Vous pouvez également créer des fichiers dans le projet CONFIG. Veillez simplement à include tous les nouveaux fichiers dans le fichier refinements.lkml.
Personnaliser le fichier de perfectionnements
Si vous disposez des autorisations develop, vous pouvez ajouter du code LookML personnalisé au projet CONFIG pour combiner des données supplémentaires ou modifier le modèle analytique de base du bloc. Vous pouvez créer des vues et les joindre à des explorations existantes, définir de nouveaux champs ou redéfinir des champs existants, ou appliquer des libellés selon vos besoins pour créer un modèle pour l'analyse que vous souhaitez fournir. Si vous avez créé des fichiers dans le projet CONFIG, vous devez les include dans le fichier de perfectionnements.
Supposons, par exemple, que vous ayez installé un bloc et que son fichier refinements.lkml contienne le code LookML suivant :
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
où listing_id est la valeur du paramètre listing du fichier manifest.lkml.
Vous pouvez utiliser des perfectionnements pour ajouter une dimension à une vue appelée flights :
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
view: +flights {
dimension: air_carrier {
type: string
sql: ${TABLE}.air_carrier ;;
}
}
Vous pouvez également appliquer un libellé à une exploration appelée aircraft afin qu'elle s'affiche dans l'interface utilisateur sous le nom Aircraft Simplified (Avion simplifié) :
include: "//<listing_id>/**/*.view.lkml"
include: "//<listing_id>/**/*.explore.lkml"
explore: +aircraft {
label: "Aircraft Simplified"
}
Le fichier refinements.lkml est inclus automatiquement dans le fichier de modèle "virtuel" du bloc, qui importe essentiellement les modèles du projet CORE.
Pour en savoir plus sur ce sujet avancé, consultez la documentation sur les perfectionnements LookML.
Personnaliser le fichier manifeste modifiable
Dans les blocs qui utilisent des perfectionnements, les projets CORE et CONFIG disposent de fichiers manifestes. Toutefois, seul le fichier manifeste du projet CONFIG est modifiable.
Vous pouvez modifier le fichier CONFIG manifest.lkml pour ajouter des paramètres de projet à ceux qui apparaissent déjà dans le fichier manifeste du projet CORE. Par exemple, vous pouvez ajouter un local_dependency pour joindre votre bloc à un autre bloc sur la même instance Looker.
Mettre à jour les valeurs des constantes
Les constantes du bloc sont définies dans le fichier manifeste du projet CORE importé. La modification de la valeur d'une constante, si elle est autorisée, doit être effectuée dans l'interface utilisateur de Marketplace lors de la configuration ou de la mise à jour du bloc. Pour mettre à jour un bloc, les utilisateurs doivent disposer des autorisations develop, manage_models et deploy.
Pour remplacer la valeur d'une constante en mettant à jour un bloc, procédez comme suit :
- Dans Looker Marketplace, accédez au bloc que vous souhaitez mettre à jour.
- Cliquez sur le bouton Gérer.
- À côté du nom du bloc que vous souhaitez mettre à jour, cliquez sur l'icône en forme de roue dentée. La fenêtre de configuration du bloc s'ouvre alors.
- Modifiez les valeurs constantes selon vos besoins.
- Cliquez sur Mettre à jour pour fermer la fenêtre de configuration du bloc et mettre à jour le bloc avec vos modifications.
Vos modifications sont reflétées dans le fichier marketplace_lock.lkml en lecture seule de votre projet installé.
Conserver les personnalisations d'un bloc Marketplace qui utilise des extensions
Certains blocs disponibles dans Looker Marketplace étaient composés de projets qui utilisaient des extensions LookML extends. Looker convertit tous les blocs Marketplace pour les instances sur Looker 21.8 ou version ultérieure en une structure de projet qui utilise des perfectionnements LookML et supprimera la compatibilité avec les blocs basés sur des extensions.
Looker vous recommande d'installer la version basée sur les perfectionnements de tous les blocs Marketplace que vous avez sur votre instance dès qu'ils sont disponibles, en remplaçant les blocs créés avec des extensions. Bien que ce processus de remplacement soit simple (vous pouvez installer le nouveau bloc (perfectionnements) à partir de la fiche de bloc Looker Marketplace et désinstaller le bloc d'origine (extensions) sur la page Gérer de Looker Marketplace), il ne conservera aucune des personnalisations qui ont pu être apportées au bloc créé avec des extensions. Looker ne transférera pas non plus de contenu ni de fonctions Looker basés sur ce contenu (tableaux de bord, explorations, livraisons de contenu planifiées, alertes) du bloc d'origine vers le nouveau bloc.
Cette section explique comment conserver les personnalisations d'un bloc créé avec des projets qui utilisent des extensions, qui seraient autrement difficiles ou longues à reproduire à partir de zéro.
Pour conserver les personnalisations de votre bloc, un utilisateur ayant la possibilité d'installer et de gérer des packages à partir de Marketplace doit procéder comme suit :
- Mettre à jour le projet CONFIG du bloc d'origine pour préparer la migration
- Installer la nouvelle version du bloc à partir de Looker Marketplace
- Transférer les personnalisations vers le nouveau bloc Marketplace
- Recréer le contenu Looker en fonction du bloc d'origine
- Désinstaller la version du bloc créée avec des extensions
Mettre à jour un bloc personnalisé pour préparer la migration
Cette section explique comment mettre à jour les fichiers de projet clés dans un bloc créé avec des extensions afin de pouvoir copier les personnalisations du bloc dans une nouvelle version du bloc basée sur les perfectionnements. Un bloc basé sur un projet qui utilise des extensions est installé à partir de Marketplace en tant que projet CORE en lecture seule et projet CONFIG modifiable.
Accédez au projet CONFIG du bloc à partir de la section Développer de l'une des manières suivantes :
- Cliquez sur l'option Projets , puis sur le nom du projet.
- Cliquez sur le nom du projet CONFIG du bloc dans la liste des projets.
Les noms de projet CONFIG se terminent généralement par _config, tandis que le nom du projet CORE n'a généralement pas de suffixe.
Ouvrez le fichier de modèle du projet, qui peut ressembler à ceci :
explore: ga_sessions_config {
extends: [ga_sessions_core]
extension: required
join: user_sales_data {
sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
}
join: sales__by__category {
sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
}
}
explore: future_input_config {
extends: [future_input_core]
extension: required
join: future_purchase_prediction {
type: left_outer
sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
relationship: one_to_one
}
}
En mode Développement, procédez comme suit :
- Supprimez l'intégralité des lignes
extendsetextension. - Supprimez
_configdes nomsexplore. - Ajoutez
+au début des nomsexplore.
L'exemple de fichier de modèle précédent se présenterait comme suit :
- Supprimez l'intégralité des lignes
explore: +ga_sessions {
join: user_sales_data {
sql_on: ${user_sales_data.full_visitor_id} = ${ga_sessions.full_visitor_id} ;;
}
join: sales__by__category {
sql: LEFT JOIN UNNEST(${user_sales_data.sales_by_category}) as sales__by__category;;
}
}
explore: +future_input {
join: future_purchase_prediction {
type: left_outer
sql_on: ${future_input.full_visitor_id} = ${future_purchase_prediction.full_visitor_id} ;;
relationship: one_to_one
}
}
- Copiez et conservez le contenu de ce fichier pour une étape ultérieure.
Installer le nouveau bloc Marketplace
Un bloc basé sur un projet qui utilise des perfectionnements est installé à partir de Marketplace en tant que projet LookML unique et modifiable qui importe à distance le projet contenant tout le code LookML et la paramétrisation constante.
- Sélectionnez l'icône de boutique dans la barre de menu Looker pour accéder à Looker Marketplace.
- Cliquez sur la fiche du nouveau bloc Marketplace basé sur les perfectionnements. Ce bloc porte le même nom que le bloc existant créé avec des extensions.
- Cliquez sur Installer pour installer le nouveau bloc. Une fois ce bloc installé, deux fiches identiques s'affichent sur la page Gérer de Looker Marketplace.
Transférer les personnalisations vers le nouveau bloc Marketplace
Cette section explique comment transférer les modifications que vous avez apportées au bloc d'origine (extensions) vers le nouveau bloc (perfectionnements).
Dans la section Développer, ouvrez le projet du nouveau bloc de l'une des manières suivantes :
- Cliquez sur l'option Projets , puis sur le nom du projet.
- Cliquez sur le nom du projet du bloc dans la liste des projets.
Le nom d'un bloc de perfectionnements Marketplace est généralement précédé de marketplace_ , suivi de l'ID de la fiche.
Dans le fichier
refinements.lkml, collez le contenu mis à jour du fichier de modèle du bloc d'origine (extensions). Veillez à conserver toutes les instructionsincludequi se trouvent déjà dans le fichier de perfectionnements.
Recréer le contenu Looker en fonction du bloc d'origine
La dernière étape de l'adoption de la version basée sur les perfectionnements d'un bloc Marketplace consiste à désinstaller la version d'origine du bloc basée sur les extensions. Certains blocs basés sur des extensions contiennent des tableaux de bord et des explorations LookML prédéfinis. Si les utilisateurs ont créé des alertes ou des livraisons planifiées basées sur des tableaux de bord LookML définis dans le bloc d'origine (extensions), ces alertes ou planifications seront désactivées ou échoueront, respectivement, une fois ce bloc désinstallé de Looker Marketplace.
Vous devez recréer ces alertes ou livraisons planifiées sur les tableaux de bord LookML du nouveau bloc (perfectionnements). Les administrateurs Looker et les utilisateurs disposant des autorisations appropriées pour les planifications et les alertes peuvent utiliser les pages Alertes et planifications de la section "Admin" pour rechercher les noms des tableaux de bord du bloc (extensions), puis créer des alertes ou des livraisons planifiées selon les besoins sur les tableaux de bord correspondants du bloc (perfectionnements).
Vous devez également modifier tout autre contenu Looker qui fait référence aux explorations ou aux tableaux de bord LookML du bloc d'origine (extensions) pour qu'il pointe vers le nouveau bloc (perfectionnements), si nécessaire.
Désinstaller le bloc d'origine
Pour désinstaller la version du bloc créée avec des extensions, procédez comme suit :
Sélectionnez l'icône de boutique dans la barre de menu Looker pour accéder à Looker Marketplace.
Dans Looker Marketplace, sélectionnez Gérer dans le panneau de navigation de gauche pour ouvrir la page Gérer.
Sur la page Gérer, cliquez sur l'icône de corbeille pour désinstaller le bloc d'origine (extensions). Vous pouvez distinguer la liste des blocs d'extensions de la liste des blocs de perfectionnements en examinant les numéros de version. Le bloc d'extensions aura une version majeure de retard par rapport au bloc de perfectionnements. Par exemple, le bloc d'extensions peut être la version
1.0.4et le bloc de perfectionnements la version2.0.0.
Résoudre les problèmes liés à un bloc
Si un bloc Marketplace affiche des erreurs, il est possible que votre schéma ne corresponde pas à la structure du bloc.
Vous pouvez également vérifier que les constantes fournies lors de l'installation du bloc, représentant la connexion, la base de données ou le schéma du bloc, ont été définies correctement. Pour ce faire, procédez comme suit :
Sélectionnez l'icône de boutique dans la barre de menu Looker pour accéder à Looker Marketplace.
Dans Looker Marketplace, sélectionnez Gérer dans le panneau de navigation principal pour ouvrir la page Gérer.
Sur la page Gérer, cliquez sur l'icône en forme de roue dentée du bloc pour afficher ses paramètres de configuration.
Dans la fenêtre Mettre à jour les configurations, vérifiez que le bloc est configuré correctement. Cliquez sur Mettre à jour après avoir apporté des modifications pour enregistrer vos mises à jour et fermer la fenêtre de configuration du bloc.