Cette page explique comment télécharger du contenu (visualisations ou données) depuis Looker.
Pour télécharger du contenu, vous devez disposer de l'autorisation download_with_limit
ou download_without_limit
accordée par un administrateur Looker.
La procédure et les options de téléchargement de contenu, ainsi que la mise en forme du contenu téléchargé, varient selon que vous téléchargez à partir d'un Look ou d'une exploration, à partir d'un tableau de bord ou à partir d'une requête de résultats fusionnés.
Télécharger des données à partir d'une présentation ou d'une exploration
Pour télécharger des données à partir d'une page "Look" ou "Explorer", sélectionnez le menu en forme de roue dentée en haut à droite, puis Télécharger.
Looker affiche la fenêtre Télécharger, dans laquelle vous pouvez nommer et mettre en forme votre téléchargement.
Les sections suivantes vous guideront à travers chaque champ de la fenêtre Télécharger :
Format
Les téléchargements aux formats qui utilisent le moteur de rendu (PNG et PDF) utiliseront les résultats du mode Production. Si votre téléchargement est dans un autre format, les résultats affichés dépendront du mode dans lequel vous vous trouvez (développement ou production).
Vous pouvez télécharger des données à partir des Looks et des Explorations dans les formats de fichier suivants :
- TXT (valeurs séparées par une tabulation)
- Feuille de calcul Excel (Excel 2007 ou version ultérieure)
- CSV
- JSON
- HTML
- Markdown
- PNG (image de la visualisation)
Si vous ne voyez pas les options HTML ou PNG (image de la visualisation) lorsque vous choisissez le format de données à télécharger (pour les looks), demandez à votre administrateur Looker d'installer la version appropriée du rendu Chromium pour votre instance Looker.
Pour le format JSON, Looker utilise les libellés de champ comme valeur d'affichage pour le fichier de sortie JSON. Pour en savoir plus sur la façon dont Looker affiche les champs au format JSON, consultez le post de la communauté Modification du format JSON.
Les tableaux transposés ne s'affichent que dans les téléchargements au format PNG.
Si vous êtes un développeur Looker et que vous êtes en mode Développement, les téléchargements de données dans la plupart des formats de fichier interrogent votre modèle tel qu'il est en mode Développement. Les formats de fichier PDF et PNG font exception. Les téléchargements de données dans ces formats interrogent toujours votre modèle comme s'il était en mode Production.
Nom de fichier
Vous pouvez saisir un nom de fichier pour le téléchargement ou utiliser le nom de fichier par défaut prérempli dans le champ. Looker ajoutera automatiquement l'extension de fichier appropriée en fonction de votre sélection dans le champ Format.
Résultats
Dans la section Résultats, indiquez si vous souhaitez appliquer les paramètres de visualisation à vos données TXT, Excel, CSV, JSON, HTML ou Markdown téléchargées.
Si vous sélectionnez Avec application des options de visualisation, Looker applique certains paramètres de visualisation à votre téléchargement. Tous les paramètres suivants des menus Tracé, Série et Mise en forme configurés pour la visualisation seront appliqués au téléchargement des données :
- Afficher les numéros de ligne
- Afficher les totaux
- Afficher les totaux de ligne
- Limiter les lignes affichées à un maximum de 500 lignes affichées ou masquées
- Afficher le nom complet du champ
- Étiquettes personnalisées pour chaque colonne (Looker utilise les libellés de champ comme valeur d'affichage pour le fichier de sortie JSON). Pour en savoir plus sur la façon dont Looker affiche les champs au format JSON, consultez le post de la communauté Looker Modification de la mise en forme JSON.
- Mise en forme conditionnelle pour les téléchargements de visualisations de tableaux au format Excel
La mise en forme conditionnelle n'est disponible dans les envois Excel de Looks et d'Explores avec des visualisations sous forme de tableaux que si la règle "Le long d'une échelle" est appliquée.
Certains paramètres de visualisation ne sont pas appliqués aux résultats téléchargés. Exemple :
- La couleur personnalisée du texte et de l'arrière-plan de l'en-tête ne sont pas appliquées aux résultats téléchargés, à l'exception des fichiers PNG.
- Pour les tableaux de résultats avec des tableaux croisés dynamiques et plusieurs mesures, chaque valeur de tableau croisé dynamique est répétée dans les colonnes au lieu d'être représentée sous la forme d'une seule colonne fusionnée. Les téléchargements HTML et PNG font exception, de sorte que la colonne fusionnée est conservée.
- Lorsque vous téléchargez des données à partir d'un tableau de bord, le titre de la vignette du tableau de bord n'est pas inclus dans les résultats téléchargés.
- Les valeurs Totaux et Totaux des lignes sont incluses dans les résultats téléchargés, mais les lignes et colonnes correspondantes ne sont pas libellées.
- Les sous-totaux ne seront pas téléchargés pour les requêtes qui ne peuvent pas être diffusées en streaming.
Les colonnes des tableaux qui ont été réorganisées manuellement apparaîtront dans leur ordre d'origine dans le téléchargement si la requête inclut l'un des éléments suivants :
- les champs qui sont délibérément masqués dans la visualisation.
les champs présents dans le code SQL sous-jacent, mais pas dans la visualisation, tels que les suivants :
- une dimension présente dans la visualisation qui contient un paramètre
link
qui fait référence à un autre champ qui n'est pas présent dans la visualisation. - un champ qui utilise le paramètre
case
. - une dimension présente dans la visualisation qui fait référence à un autre champ avec
{{ field_name._value }} Liquid variable syntax
, qui n'est pas présent dans la visualisation.
- une dimension présente dans la visualisation qui contient un paramètre
Un ou plusieurs champs avec l'option Remplissage de la dimension activée
Trois champs croisés ou plus
Totaux des lignes activés
Un ou plusieurs champs incluant le paramètre LookML
order_by_field
dans la définition du champ
Si vous sélectionnez Tel qu'affiché dans le tableau de données, les options de visualisation ne seront pas appliquées et le téléchargement s'affichera comme dans le tableau de données de la section Données du Look ou de l'exploration.
Valeurs des données
Dans la section Valeurs des données, choisissez le format d'affichage des résultats de la requête téléchargés :
- Si vous sélectionnez Non mises en forme, Looker n'applique aucune mise en forme particulière aux résultats de vos requêtes, comme l'arrondi des nombres longs ou l'ajout de caractères spéciaux éventuellement mis en place par les développeurs Looker. Cette façon de procéder est souvent préférable lorsque les données sont transmises à un autre outil de traitement.
- Si vous sélectionnez Formaté, l'apparence des données sera semblable à celle de l'expérience Explorer dans Looker, bien que certaines fonctionnalités (comme l'association) ne soient pas compatibles avec tous les types de fichiers. Par exemple, toute mise en forme appliquée avec le paramètre
html
ne sera pas appliquée aux téléchargements TXT, CSV, Excel ou JSON.
Nombre de lignes et de colonnes à inclure
Vous pouvez choisir la quantité de données à télécharger comme suit :
- Table de résultats actuelle : nombre de lignes spécifié par la limite de lignes de votre contenu.
- Tous les résultats : tous les résultats renvoyés par la requête. Avant de sélectionner cette option, consultez la section Tous les résultats de cette page.
- Personnalisé : nombre de lignes personnalisé. Les utilisateurs disposant des autorisations
download_with_limit
sont limités à 5 000 lignes. La limite pour les autres utilisateurs est généralement de 100 000.
Tous les résultats
Lorsque vous sélectionnez Exécuter dans une présentation ou une exploration, Looker vérifie vos autorisations et détermine si la complexité de la requête et le dialecte de la base de données permettront de télécharger l'intégralité de la requête. Si vous disposez des autorisations requises (pour les résultats dépassant une limite définie) et si Looker détermine que l'intégralité de votre requête peut être téléchargée, l'option Tous les résultats sera disponible dans la fenêtre Télécharger.
L'option Tous les résultats est généralement désactivée pour les requêtes qui effectuent l'une des actions suivantes :
- impliquent des totaux de lignes ou des calculs de tables.
- Utilisez des types de mesures pourcentage du total, pourcentage par rapport à la période précédente ou totaux cumulés.
- Récupérer des données à partir d'un dialecte de base de données qui ne peut pas diffuser de résultats en continu
- Inclure les colonnes croisées calculées par Looker, car les données proviennent d'un dialecte de base de données qui ne peut pas calculer les croisements
Même si l'option Tous les résultats est disponible, vous devez rester prudent lorsque vous téléchargez tous les résultats. Certaines requêtes sont très volumineuses et contiennent des milliers, voire des millions de lignes. Elles peuvent surcharger la plupart des tableurs, voire votre instance Looker.
Si l'option Tous les résultats n'est pas disponible, vous pouvez utiliser l'option Personnalisé pour spécifier le nombre maximal de lignes autorisées par vos autorisations.
Diffusion en continu des résultats de requête
La transmission en continu désigne la capacité de Looker à traiter les données par blocs plutôt qu'une par une. Si Looker peut transmettre un jeu de résultats en continu, les téléchargements illimités sont possibles. L'option Tous les résultats repose sur la capacité de Looker à diffuser les résultats. Elle ne sera pas disponible si la diffusion des résultats n'est pas possible.
En dehors des exigences propres à chaque format, la transmission en continu n'est pas possible dans les deux cas suivants :
- Calculs de table : les calculs de table ne peuvent pas être transmis en continu. Par conséquent, pour télécharger un nombre illimité de résultats pour une requête, vous devez retirer les calculs de table de cette dernière.
- Limites des bases de données : certaines bases de données ne peuvent pas être transmises en continu si la requête contient des tableaux croisés dynamiques. Dans ce cas, vous devez retirer les tableaux croisés dynamiques pour télécharger un nombre illimité de résultats. Certaines bases de données ne peuvent pas transmettre de résultats en continu, et les téléchargements illimités sont donc impossibles.
Les bases de données suivantes sont compatibles avec la transmission en continu :
Dialecte | Compatibilité |
---|---|
Actian Avalanche | Oui |
Amazon Athena | Oui |
Amazon Aurora MySQL | Oui |
Amazon Redshift | Oui |
Amazon Redshift 2.1+ | Oui |
Amazon Redshift Serverless 2.1+ | Oui |
Apache Druid | Non |
Apache Druid 0.13+ | Non |
Apache Druid 0.18+ | Non |
Apache Hive 2.3+ | Oui |
Apache Hive 3.1.2+ | Oui |
Apache Spark 3+ | Oui |
ClickHouse | Oui |
Cloudera Impala 3.1+ | Oui |
Cloudera Impala 3.1+ with Native Driver | Oui |
Cloudera Impala with Native Driver | Oui |
DataVirtuality | Oui |
Databricks | Oui |
Denodo 7 | Oui |
Denodo 8 | Oui |
Dremio | Oui |
Dremio 11+ | Oui |
Exasol | Oui |
Firebolt | Oui |
Google BigQuery Legacy SQL | Oui |
Google BigQuery Standard SQL | Oui |
Google Cloud PostgreSQL | Oui |
Google Cloud SQL | Oui |
Google Spanner | Non |
Greenplum | Oui |
HyperSQL | Non |
IBM Netezza | Non |
MariaDB | Oui |
Microsoft Azure PostgreSQL | Oui |
Microsoft Azure SQL Database | Oui |
Microsoft Azure Synapse Analytics | Oui |
Microsoft SQL Server 2008+ | Oui |
Microsoft SQL Server 2012+ | Oui |
Microsoft SQL Server 2016 | Oui |
Microsoft SQL Server 2017+ | Oui |
MongoBI | Oui |
MySQL | Oui |
MySQL 8.0.12+ | Oui |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5+ | Oui |
PostgreSQL pre-9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA | Non |
SAP HANA 2+ | Non |
SingleStore | Oui |
SingleStore 7+ | Oui |
Snowflake | Oui |
Teradata | Oui |
Trino | Oui |
Vector | Oui |
Vertica | Oui |
Voici les bases de données compatibles avec la transmission en continu en présence de tableaux croisés dynamiques :
Dialecte | Compatibilité |
---|---|
Actian Avalanche | Oui |
Amazon Athena | Oui |
Amazon Aurora MySQL | Non |
Amazon Redshift | Oui |
Amazon Redshift 2.1+ | Oui |
Amazon Redshift Serverless 2.1+ | Oui |
Apache Druid | Non |
Apache Druid 0.13+ | Non |
Apache Druid 0.18+ | Non |
Apache Hive 2.3+ | Non |
Apache Hive 3.1.2+ | Non |
Apache Spark 3+ | Oui |
ClickHouse | Non |
Cloudera Impala 3.1+ | Oui |
Cloudera Impala 3.1+ with Native Driver | Oui |
Cloudera Impala with Native Driver | Oui |
DataVirtuality | Non |
Databricks | Oui |
Denodo 7 | Non |
Denodo 8 | Non |
Dremio | Non |
Dremio 11+ | Non |
Exasol | Oui |
Firebolt | Oui |
Google BigQuery Legacy SQL | Oui |
Google BigQuery Standard SQL | Oui |
Google Cloud PostgreSQL | Oui |
Google Cloud SQL | Non |
Google Spanner | Non |
Greenplum | Oui |
HyperSQL | Non |
IBM Netezza | Oui |
MariaDB | Non |
Microsoft Azure PostgreSQL | Oui |
Microsoft Azure SQL Database | Oui |
Microsoft Azure Synapse Analytics | Oui |
Microsoft SQL Server 2008+ | Oui |
Microsoft SQL Server 2012+ | Oui |
Microsoft SQL Server 2016 | Oui |
Microsoft SQL Server 2017+ | Oui |
MongoBI | Non |
MySQL | Non |
MySQL 8.0.12+ | Non |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5+ | Oui |
PostgreSQL pre-9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA | Non |
SAP HANA 2+ | Non |
SingleStore | Oui |
SingleStore 7+ | Oui |
Snowflake | Oui |
Teradata | Oui |
Trino | Oui |
Vector | Oui |
Vertica | Oui |
Supprimer tous les tris de la requête
Lorsque vous sélectionnez Tous les résultats, l'option Supprimer tous les tris de la requête peut également s'afficher. Cette option empêche le tri de votre requête avant le téléchargement des résultats. La sélection de cette option peut accélérer votre téléchargement, car le tri d'une requête peut avoir un impact négatif sur les performances pour certains types de bases de données.
L'option Supprimer tous les tris de la requête n'est pas compatible avec les résultats croisés.
Autoriser un nombre élevé de résultats
Lorsque vous téléchargez un grand ensemble de résultats dans Looker en utilisant Google BigQuery comme dialecte de base de données et que vous sélectionnez Tous les résultats, l'option Autoriser les résultats volumineux peut s'afficher. En effet, Google BigQuery a une taille de réponse maximale pour les résultats de requête, comme décrit dans la section Écrire les résultats de requête de la documentation Google Cloud. Pour télécharger des résultats qui dépassent la taille de réponse maximale de BigQuery, Looker doit effectuer un processus différent.
Si vous sélectionnez Autoriser un nombre élevé de résultats, le processus de téléchargement est affecté comme suit :
- L'option
allowLargeResults
BigQuery est définie surtrue
pour la requête. - Les clauses
ORDER BY
de la requête sont supprimées. - La requête écrira dans un schéma temporaire PDT et nécessite l'autorisation d'y écrire.
- Les résultats de la requête sont stockés dans ce schéma temporaire sous un nom de table aléatoire pendant une heure.
Télécharger ou ouvrir dans un navigateur
Une fois vos options sélectionnées, vous pouvez cliquer sur le bouton Télécharger pour télécharger un fichier sur votre ordinateur ou sur Ouvrir dans le navigateur pour afficher le fichier dans le navigateur.
Télécharger des données à partir d'une requête de résultats fusionnés
Pour télécharger les requêtes de résultats fusionnés, vous pouvez enregistrer la requête dans un tableau de bord, puis télécharger le tableau de bord au format PDF ou sous forme de collection de fichiers CSV. Toutefois, vous devez télécharger l'intégralité du tableau de bord. Vous ne pouvez pas télécharger les données d'une seule tuile basée sur une requête de résultats fusionnés.
Télécharger des données à partir d'un tableau de bord
Pour télécharger le tableau de bord complet, sélectionnez Télécharger dans le menu à trois points
du tableau de bord.Une boîte de dialogue s'ouvre et vous permet de sélectionner le format de téléchargement, PDF ou CSV.
Télécharger un tableau de bord au format PDF
Vous pouvez télécharger votre tableau de bord complet au format PDF, ce qui signifie que vous obtiendrez un PDF affichant le titre du tableau de bord, les filtres du tableau de bord, certaines ou toutes les vignettes du tableau de bord, et le fuseau horaire d'exécution du tableau de bord. Le PDF comportera également un code temporel indiquant la date et l'heure de téléchargement du tableau de bord.
Les téléchargements au format PDF renvoient toujours les données du modèle comme s'il était en mode Production, même si vous êtes en mode Développement.
Pour télécharger un tableau de bord au format PDF, procédez comme suit :
- Sélectionnez PDF dans le menu déroulant Format.
Sélectionnez une option dans le menu déroulant Format du papier :
L'option Adapter la taille de la page au tableau de bord est sélectionnée par défaut. Elle adapte la taille du PDF à la largeur par défaut des tableaux de bord (1 260 px). D'autres options de formats de papier adaptent la taille du PDF à un format de papier standard et dimensionnent le tableau de bord en conséquence. Selon la mise en page du tableau de bord et le format de papier sélectionné, certains PDF peuvent différer de la mise en page du tableau de bord lorsqu'ils sont affichés dans Looker. Par exemple, si le format de papier sélectionné est plus étroit que le tableau de bord, vous pouvez rencontrer des problèmes d'espacement ou de mise en forme, et vous devrez peut-être effectuer des ajustements :
- Il est possible que vous deviez redimensionner les visualisations de grande taille ou les groupes de vignettes qui se chevauchent afin qu'ils tiennent dans le PDF.
- Il est possible que les vignettes contenant des tableaux n'affichent pas toutes les colonnes dans le PDF.
- La largeur des vignettes peut être réduite pour s'adapter au PDF. De même, les tuiles qui nécessitent un défilement dans l'application Looker peuvent ne pas se développer pour afficher tout le contenu.
Si l'option Format de papier ne s'affiche pas, demandez à votre administrateur Looker d'installer la dernière version du rendu Chromium pour votre instance Looker.
Si vous sélectionnez une option autre que Adapter la page au tableau de bord dans le menu déroulant Format du papier, une option Orientation s'affiche. Vous pouvez choisir d'orienter le tableau de bord en position portrait ou paysage.
Sélectionnez ou non l'option Agrandir les tables pour afficher toutes les lignes. Si vous sélectionnez cette option, pour les vignettes de tableau de bord qui utilisent des visualisations de tableau, le PDF affichera toutes les lignes disponibles dans la visualisation de tableau, et pas seulement celles visibles dans la miniature de la vignette de tableau de bord. Dans le cas contraire, seules les lignes visibles dans la miniature sans défilement apparaîtront dans le PDF. Les filtres de requête et de tableau de bord s'appliqueront toujours, tout comme les paramètres de visualisation tels que les limites de lignes, les limites de colonnes et les paramètres définis avec l'option Limiter les lignes affichées.
Si l'option Développer les tableaux pour afficher toutes les lignes est sélectionnée, les vignettes de tableau de bord contenant des visualisations de tableau peuvent sembler légèrement différentes dans les PDF téléchargés que dans Looker. Les différences suivantes peuvent être visibles dans le PDF :
- Les personnalisations des couleurs d'arrière-plan et des tailles de police sont supprimées des en-têtes de colonne et des lignes de sous-totaux.
- Si aucun thème personnalisé n'est défini, les tableaux s'affichent avec le thème blanc. Sinon, le thème personnalisé est appliqué lors du téléchargement.
- L'icône de tri n'apparaît pas dans les tableaux croisés dynamiques qui n'ont pas été triés manuellement.
- Les tableaux pour lesquels l'option Ajuster la taille des colonnes est activée s'étirent sur toute la largeur de la vignette.
De plus, pour les tableaux comportant plus de 20 000 cellules, les différences suivantes peuvent être visibles dans le PDF :
- Les options de mise en forme conditionnelle autres que Couleur d'arrière-plan ne s'affichent plus.
- Les visualisations de cellules ne s'affichent plus dans les colonnes numériques.
Si l'option Développer les tableaux pour afficher toutes les lignes ne s'affiche pas, demandez à votre administrateur Looker d'installer la version appropriée du rendu Chromium pour votre instance Looker.
Sélectionnez ou non l'option Disposer les vignettes du tableau de bord en une seule colonne. Si vous sélectionnez cette option, les vignettes du tableau de bord s'affichent dans une seule colonne verticale dans le PDF. Dans le cas contraire, les vignettes du tableau de bord apparaissent telles qu'elles sont disposées dans le tableau de bord.
Sélectionnez Ouvrir dans un navigateur pour afficher une image du PDF dans un nouvel onglet de votre navigateur. Vous pouvez ensuite choisir de télécharger le PDF à l'aide des commandes de votre navigateur.
Sélectionnez Annuler si vous ne souhaitez plus télécharger le tableau de bord.
Sélectionnez Télécharger pour lancer le téléchargement. Un nouvel onglet s'ouvre dans votre navigateur pour montrer la progression de votre téléchargement.
Télécharger un tableau de bord au format CSV
Vous pouvez télécharger toutes les vignettes de requête de votre tableau de bord sous forme de dossier zippé regroupant les fichiers CSV. Les vignettes de texte ne sont pas incluses dans le fichier ZIP. Pour télécharger votre tableau de bord sous forme de dossier de fichiers CSV, suivez ces étapes :
- Sélectionnez CSV dans le menu déroulant Format.
- Sélectionnez Annuler si vous ne souhaitez plus télécharger le tableau de bord.
- Sélectionnez Télécharger pour lancer le téléchargement de votre dossier zippé de fichiers CSV.
Lorsque vous téléchargez un tableau de bord au format CSV, les options de mise en forme des téléchargements, comme la définition de limites de lignes personnalisées ou le choix de tous les résultats, ne sont pas disponibles. Les limites de lignes dans les fichiers téléchargés correspondent à celles des tuiles correspondantes.
Looker génère des fichiers compressés en utilisant le codage UTF-8. Si les caractères du nom de vos fichiers CSV semblent confus, il existe peut-être un conflit entre le codage UTF-8 de Looker et le codage par défaut du système d'exploitation de votre machine ou d'une application tierce. Looker vous suggère d'utiliser un extracteur de fichiers qui reconnaît le codage UTF-8, tel que 7-Zip, et de vous assurer que toutes les applications tierces sont configurées pour prendre en charge UTF-8.
Téléchargement de données à partir de vignettes de tableau de bord
Vous ne pouvez pas télécharger les données des vignettes de tableau de bord basées sur des requêtes de résultats fusionnés. Toutefois, les données des vignettes de résultats fusionnés sont incluses si vous téléchargez un tableau de bord au format PDF ou sous forme de collection de fichiers CSV.
Pour télécharger les données d'une vignette de tableau de bord, cliquez sur l'icône à trois points de cette vignette, puis sélectionnez Télécharger les données :
Une boîte de dialogue s'ouvre et vous propose différentes options semblables à celles d'un Look ou d'une exploration. Développez le menu Options avancées des données pour afficher toutes les options disponibles pour votre téléchargement :
Format
Vous pouvez télécharger les données des vignettes de tableau de bord dans les formats suivants :
- TXT (valeurs séparées par une tabulation)
- Feuille de calcul Excel (Excel 2007 ou version ultérieure)
- CSV
- JSON
- HTML
- Markdown
- PNG (image de la visualisation)
Selon le format que vous sélectionnez, certaines options du menu Options avancées des données peuvent ne pas être disponibles.
Si les options HTML ou PNG (image de la visualisation) sont manquantes, vérifiez auprès de l'administrateur Looker s'il a bien installé la version appropriée du rendu Chromium pour votre instance Looker.
Pour le format JSON, Looker utilise les libellés de champ comme valeur d'affichage pour le fichier de sortie JSON. Pour en savoir plus sur la façon dont Looker affiche les champs au format JSON, consultez le post de la communauté Modification du format JSON.
Les visualisations de tableaux transposés ne s'affichent que dans les téléchargements au format PDF et PNG.
Les téléchargements au format PNG renvoient toujours les données du modèle telles qu'elles sont en mode Production, même si vous êtes en mode Développement.
Résultats
Dans la section Résultats, indiquez si vous souhaitez appliquer les paramètres de visualisation à votre téléchargement de données :
Si vous sélectionnez Avec application des options de visualisation, Looker applique certains paramètres de visualisation à votre téléchargement. Tous les paramètres suivants des menus Tracé, Série et Mise en forme configurés pour la visualisation seront appliqués au téléchargement des données :
- Afficher les numéros de ligne
- Masquer les totaux
- Masquer les totaux de lignes
- Limiter les lignes affichées : affichez ou masquez jusqu'à 500 lignes.
- Afficher le nom complet du champ
- Étiquettes personnalisées pour chaque colonne (Looker utilise les libellés de champ comme valeur d'affichage pour le fichier de sortie JSON). Pour en savoir plus sur la façon dont {looker_name_short}} affiche les champs au format JSON, consultez le post de la communauté Looker Changement de format JSON.
- Mise en forme conditionnelle pour les téléchargements de visualisations de tableaux au format Excel.
La mise en forme conditionnelle n'est disponible dans les téléchargements au format Excel avec des visualisations sous forme de tableaux que si la règle "Le long d'une échelle" est appliquée.
Les colonnes des tableaux qui ont été réorganisées manuellement apparaîtront dans leur ordre d'origine dans le téléchargement si la requête inclut l'un des éléments suivants :
- Un ou plusieurs champs masqués dans la visualisation
- Un ou plusieurs champs référencent une dimension dans le paramètre
link
qui n'est pas sélectionnée dans l'exploration actuelle. - Un ou plusieurs champs avec l'option Remplissage de la dimension activée
- Trois champs croisés ou plus
- Totaux des lignes activés
Si vous choisissez Tels qu'affichés dans la table de données, les options de visualisation ne seront pas appliquées et le téléchargement s'affichera comme la table de données dans la section Données du Look ou de l'exploration.
Valeurs des données
Dans la section Valeurs des données, choisissez le format d'affichage des résultats téléchargés :
- Si vous sélectionnez Formaté, les données s'afficheront de manière plus similaire à l'expérience Explorer dans Looker, bien que certaines fonctionnalités (comme l'association) ne soient pas compatibles avec tous les formats de fichier.
- Si vous sélectionnez Non mises en forme, Looker n'applique aucune mise en forme particulière à vos résultats, comme l'arrondi des nombres longs ou l'ajout de caractères spéciaux que vos développeurs Looker ont pu mettre en place. Cette façon de procéder est souvent préférable lorsque les données sont transmises à un autre outil de traitement.
Nombre de lignes et de colonnes à inclure
Dans cette section, vous pouvez spécifier la quantité de données à inclure dans votre téléchargement. Dans la plupart des tuiles, cette section du pop-up de téléchargement s'intitule Nombre de lignes à inclure. Si la requête de la tuile contient des dimensions pivotées, cette section s'intitule Nombre de lignes et de colonnes à inclure. Vous avez le choix entre plusieurs options :
- Table de résultats actuelle : nombre de lignes spécifié par la limite de lignes (et la limite de colonnes, si la requête du bloc contient au moins une dimension pivotée) de la table de données sous-jacente de votre bloc.
- Tous les résultats : tous les résultats renvoyés par la requête de vignette, même si le tableau de données de la vignette spécifie une limite de lignes ou de colonnes plus restrictive. Avant de sélectionner cette option, consultez la section Éléments à prendre en compte lorsque vous utilisez l'option "Tous les résultats" ou "Personnalisé" sur cette page. Cette option n'est pas visible par les utilisateurs qui ne disposent pas des autorisations
download_without_limit
. - Personnalisé : nombre de lignes à télécharger personnalisé. Les utilisateurs disposant des autorisations
download_with_limit
sont limités à 5 000 lignes. La limite pour les autres utilisateurs est généralement de 100 000,sauf si votre administrateur Looker l'a augmentée (consultez le post de la communauté Fonctionnalité ancienne : autoriser les téléchargements illimités (Looker 4.14+)).
Éléments à prendre en compte lorsque vous utilisez l'option "Tous les résultats" ou "Personnalisé"
Looker vérifie vos autorisations et détermine si la complexité de la requête et le dialecte de la base de données permettent de télécharger l'intégralité de la requête. Si vous êtes autorisé à télécharger des résultats au-delà d'une limite définie et si Looker détermine que l'intégralité de votre requête peut être téléchargée, l'option Tous les résultats sera disponible dans la fenêtre Télécharger.
L'option Tous les résultats est généralement désactivée pour les requêtes qui :
- Impliquer les totaux des lignes
- Utilisez des types de mesures pourcentage du total, pourcentage par rapport à la période précédente ou totaux cumulés.
- Récupérer des données à partir d'un dialecte de base de données qui ne peut pas diffuser de résultats en continu
- Inclure les colonnes croisées calculées par Looker, car les données proviennent d'un dialecte de base de données qui ne peut pas calculer les croisements
Même lorsque l'option Tous les résultats est disponible, vous devez faire preuve de prudence lorsque vous téléchargez tous les résultats. Certaines requêtes sont très volumineuses et contiennent des milliers, voire des millions de lignes. Elles peuvent surcharger la plupart des tableurs, voire votre instance Looker.
Si l'option Tous les résultats n'est pas disponible, vous pouvez utiliser l'option Personnalisé pour spécifier le nombre maximal de lignes autorisé par vos autorisations. Lorsque vous sélectionnez Personnalisée, vous pouvez spécifier le nombre de lignes de résultats à télécharger. Si votre requête contient des dimensions croisées, vous pouvez également spécifier le nombre de colonnes à télécharger.
Pour les administrateurs : activer le téléchargement de données pour votre instance Looker
Certaines options de téléchargement exigent que les administrateurs des déploiements Looker hébergés par le client aient installé la version appropriée du rendu Chromium. Si votre instance est hébergée par Looker, Chromium est déjà installé.
La page de documentation Gestion des fonctionnalités Utilisateur métier contient des informations importantes pour les administrateurs concernant le processus de téléchargement :
- Autorisations utilisateur et téléchargements de tableaux de bord
- Rendu des formats d'images pour le téléchargement
- Formats rendus et autorisations de téléchargement
- Formats de téléchargement JSON
- Résoudre les problèmes de téléchargement de fichiers Excel volumineux
Pour en savoir plus sur les autorisations à attribuer aux utilisateurs pour leur permettre de télécharger des fichiers (en particulier les autorisations download_with_limit
et download_without_limit
), consultez la page de documentation Rôles.