Cette page explique comment télécharger du contenu (visualisations ou données) depuis Looker.
Pour télécharger du contenu, un administrateur Looker doit vous accorder l'autorisation download_with_limit
ou download_without_limit
.
Le processus et les options de téléchargement et de mise en forme du contenu téléchargé varient selon que vous effectuez le téléchargement à partir d'une présentation ou d'une exploration, d'un tableau de bord ou d'une requête de résultats fusionnés.
Télécharger des données depuis une présentation ou une exploration
Pour télécharger les données d'une page de look ou d'exploration, 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 décrivent chaque champ de la fenêtre Télécharger:
Format
Les téléchargements dans des formats utilisant le moteur de rendu (PNG et PDF) utilisent les résultats du mode Production. Si votre téléchargement est dans un autre format, les résultats s'affichent dans le mode de développement ou de production utilisé.
Les données peuvent être téléchargées à partir de Looks et d'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)
Lorsque vous choisissez le format de données à télécharger, si les options HTML ou PNG (image de la visualisation) ne s'affichent pas (pour les looks), demandez à votre administrateur Looker d'installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.
Au format JSON, Looker utilise les étiquettes des champs comme valeur affichée dans sa sortie JSON. Consultez le post destiné à la communauté Modification de la mise en forme JSON pour en savoir plus sur la façon dont Looker affiche les champs au format JSON.
Les tableaux transposés ne s'affichent que dans les téléchargements PNG.
Pour les développeurs Looker, si vous êtes en mode Développement, les téléchargements de données dans la plupart des formats de fichiers interrogent votre modèle tel qu'il est en mode Développement. Les formats de fichiers 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 indiquer un nom de fichier pour le téléchargement ou utiliser le nom de fichier par défaut qui est prérempli dans le champ. Looker ajoute 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 à votre téléchargement de données TXT, Excel, CSV, JSON, HTML ou Markdown.
Si vous sélectionnez Avec les options de visualisation appliquées, Looker applique certains paramètres de visualisation à votre téléchargement. Tous les paramètres suivants des menus Tracer, 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 des lignes
- 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 le champ labels comme valeur affichée dans sa sortie JSON. Pour en savoir plus sur la façon dont Looker affiche les champs au format JSON, consultez le post sur la modification de la mise en forme JSON de la communauté Looker.
- Mise en forme conditionnelle pour le téléchargement de visualisations sous forme de tableaux au format Excel
La mise en forme conditionnelle ne s'affiche dans les envois Excel de présentations et d'explorations avec des visualisations sous forme de tableau que si la règle Sur une échelle est appliquée.
Certains paramètres de visualisation ne sont pas appliqués aux résultats téléchargés. Exemple :
- Les couleurs personnalisées du texte de l'en-tête et de l'arrière-plan ne sont pas appliquées aux résultats téléchargés, sauf pour les fichiers PNG.
- Pour les tableaux de résultats avec tableaux croisés dynamiques et mesures multiples, chaque valeur du tableau croisé dynamique est répétée dans les colonnes au lieu d'être représentée sous la forme d'une 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 Totals (Totaux) et Row Totals (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 continu.
Dans les tableaux, les colonnes qui ont été modifiées manuellement apparaîtront dans leur ordre d'origine lors du téléchargement si la requête comprend l'un des éléments suivants:
- des champs qui sont délibérément masqués dans la visualisation.
Champs présents dans le SQL sous-jacent, mais qui ne sont pas présents dans la visualisation, par exemple:
- Une dimension présente dans la visualisation qui contient un paramètre
link
qui fait référence à un autre champ qui n'apparaît pas 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 le paramètre
{{ 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 le remplissage des dimensions activé
Trois champs croisés ou plus
Nombre total de lignes activé
Un ou plusieurs champs incluant le paramètre LookML
order_by_field
dans la définition du champ
Si vous sélectionnez Telle qu'affichée dans le tableau de données, les options de visualisation ne seront pas appliquées et le téléchargement apparaîtra comme le tableau de données de la section Données de la présentation ou de l'exploration.
Valeurs des données
Dans la section Valeurs des données, choisissez la manière dont vous souhaitez que les résultats de requête téléchargés s'affichent:
- Si vous sélectionnez Non formaté, Looker n'applique aucune mise en forme particulière des résultats de votre requête, comme arrondir les nombres longs ou ajouter des 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.
- 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:
- Tableau des résultats actuel: nombre de lignes concernées 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é: un 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 base de données permettront ou non de télécharger l'intégralité de la requête. Si vous disposez des autorisations (pour les 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:
- impliquent des totaux de lignes ou des calculs de table ;
- Utilisez les types de mesures pourcentage du total, pourcentage des totaux précédents ou total cumulés.
- Récupérez 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 pivotées calculées par Looker, car les données proviennent d'un dialecte de base de données qui ne peut pas calculer les tableaux croisés dynamiques
Même si 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 ou des millions de lignes, ce qui peut 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.
Streaming des résultats de la requête
Le traitement par flux fait référence à la capacité de Looker à traiter les données en fragments plutôt qu'en une seule fois. 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. Tous les résultats ne sera pas disponible s'il n'est pas possible de diffuser les résultats en flux continu.
En dehors des exigences propres à chaque format, la transmission en continu n'est pas possible dans les deux cas suivants :
- Calculs de table: il n'est pas possible de diffuser les calculs de table en flux 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 diffusées si des tableaux croisés dynamiques sont inclus dans la requête. 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 diffuser de résultats en continu, ce qui signifie que les téléchargements illimités ne sont pas possibles.
Les bases de données suivantes sont compatibles avec le streaming :
Dialecte | Compatibilité |
---|---|
Actian Avalanche | Oui |
Amazon Athena | Oui |
Amazon Aurora MySQL | Oui |
Amazon Redshift | Oui |
Apache Druid | Non |
Apache Druid 0.13 ou version ultérieure | Non |
Apache Druid 0.18 ou version ultérieure | Non |
Apache Hive 2.3 et versions ultérieures | Oui |
Apache Hive 3.1.2 et versions ultérieures | Oui |
Apache Spark 3 et versions ultérieures | Oui |
ClickHouse | Oui |
Cloudera Impala 3.1+ | Oui |
Cloudera Impala 3.1+ avec pilote natif | Oui |
Cloudera Impala avec Native Driver | Oui |
DataVirtuality | Oui |
Databricks | Oui |
Denodo 7 | Oui |
Denodo 8 | Oui |
Dremio | Oui |
Dremio 11 et versions ultérieures | Oui |
Exasol | Oui |
Feu | Oui |
Ancien SQL de Google BigQuery | Oui |
SQL standard Google BigQuery | 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 |
Base de données Microsoft Azure SQL | Oui |
Microsoft Azure Synapse Analytics | Oui |
Microsoft SQL Server 2008 et versions ultérieures | Oui |
Microsoft SQL Server 2012 et versions ultérieures | Oui |
Microsoft SQL Server 2016 | Oui |
Microsoft SQL Server 2017 et versions ultérieures | Oui |
MongoBI | Oui |
MySQL | Oui |
MySQL 8.0.12 et versions ultérieures | Oui |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5 et versions ultérieures | Oui |
PostgreSQL version antérieure à 9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA 2 et versions ultérieures | Non |
SingleStore | Oui |
SingleStore 7 et versions ultérieures | Oui |
Snowflake | Oui |
Teradata | Oui |
Trino | Oui |
Vecteur | Oui |
Vertica | Oui |
Voici les bases de données qui prennent en charge les flux de données lorsque des tableaux croisés dynamiques sont appliqués:
Dialecte | Compatibilité |
---|---|
Actian Avalanche | Oui |
Amazon Athena | Oui |
Amazon Aurora MySQL | Non |
Amazon Redshift | Oui |
Apache Druid | Non |
Apache Druid 0.13 ou version ultérieure | Non |
Apache Druid 0.18 ou version ultérieure | Non |
Apache Hive 2.3 et versions ultérieures | Non |
Apache Hive 3.1.2 ou version ultérieure | Non |
Apache Spark 3 et versions ultérieures | Oui |
ClickHouse | Non |
Cloudera Impala 3.1+ | Oui |
Cloudera Impala 3.1+ avec pilote natif | Oui |
Cloudera Impala avec Native Driver | Oui |
DataVirtuality | Non |
Databricks | Oui |
Denodo 7 | Non |
Denodo 8 | Non |
Dremio | Non |
Dremio 11 ou version ultérieure | Non |
Exasol | Oui |
Feu | Oui |
Ancien SQL de Google BigQuery | Oui |
SQL standard Google BigQuery | 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 |
Base de données Microsoft Azure SQL | Oui |
Microsoft Azure Synapse Analytics | Oui |
Microsoft SQL Server 2008 et versions ultérieures | Oui |
Microsoft SQL Server 2012 et versions ultérieures | Oui |
Microsoft SQL Server 2016 | Oui |
Microsoft SQL Server 2017 et versions ultérieures | Oui |
MongoBI | Non |
MySQL | Non |
MySQL 8.0.12 ou version ultérieure | Non |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5 et versions ultérieures | Oui |
PostgreSQL version antérieure à 9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA 2 et versions ultérieures | Non |
SingleStore | Oui |
SingleStore 7 et versions ultérieures | Oui |
Snowflake | Oui |
Teradata | Oui |
Trino | Oui |
Vecteur | 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 de trier votre requête avant de télécharger les résultats. La sélection de cette option peut accélérer le téléchargement, car le tri d'une requête peut s'avérer coûteux pour certains types de bases de données.
L'option Supprimer tous les tris de la requête n'est pas disponible pour les résultats croisés.
Autoriser un nombre élevé de résultats
Lorsque vous téléchargez un ensemble de résultats volumineux 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 un nombre élevé de résultats 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 les résultats qui dépassent la taille de réponse maximale de BigQuery, Looker doit exécuter 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 BigQuery
allowLargeResults
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'écrire dans un schéma.
- Les résultats de la requête sont stockés dans ce schéma entièrement nouveau temporaire, sous un nom de table aléatoire pendant une heure.
Télécharger ou ouvrir dans un navigateur
Une fois que vous avez sélectionné vos options, vous pouvez cliquer sur le bouton Télécharger pour télécharger un fichier sur votre ordinateur, ou sélectionner Ouvrir dans un 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 des 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 d'ensemble 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 carte 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 l'intégralité du tableau de bord, sélectionnez Télécharger dans le menu à trois points
du tableau de bord.La boîte de dialogue qui s'ouvre 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 l'intégralité de votre tableau de bord au format PDF, ce qui signifie que vous obtiendrez un PDF qui affiche le titre du tableau de bord, tous les filtres du tableau de bord, certaines ou toutes les vignettes du tableau de bord, ainsi que le fuseau horaire dans lequel le tableau de bord a été exécuté. Le PDF comprendra également un code temporel indiquant l'heure à laquelle le tableau de bord a été téléchargé.
Les téléchargements au format PDF renvoient toujours les données du modèle comme s'il était en mode Production, même 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 Taille du papier :
L'option Ajuster la page au tableau de bord est définie par défaut. la taille du PDF est définie sur la largeur par défaut des tableaux de bord (1 260 pixels). D'autres options de format de papier adaptent la taille du PDF à un format de papier standard et s'y intègrent entièrement ou partiellement dans le tableau de bord. Selon la mise en page du tableau de bord et le format de papier sélectionné, certaines sorties PDF peuvent différer de la mise en page du tableau de bord lorsqu'elles sont affichées dans Looker. Par exemple, lorsque le format de papier sélectionné est plus étroit que celui du tableau de bord, vous pouvez rencontrer des problèmes d'espacement ou d'autres formats et devoir apporter quelques ajustements:
- Les grandes visualisations ou les groupes de tuiles qui se chevauchent peuvent avoir besoin d'être redimensionnés pour tenir dans le PDF.
- Les vignettes contenant des tableaux peuvent ne pas afficher toutes les colonnes des tableaux dans le PDF.
- La largeur des tuiles peut être réduite pour s'adapter au PDF. De même, les vignettes qui nécessitent un défilement dans l'application Looker peuvent ne pas se développer pour afficher tout le contenu.
Si vous ne voyez pas l'option Format de papier, demandez à votre administrateur Looker d'installer la dernière version du moteur de rendu Chromium pour votre instance Looker.
Si vous sélectionnez autre chose que Ajuster la page au tableau de bord dans la liste déroulante Format de papier, une option Orientation s'affiche. Vous pouvez choisir d'orienter le tableau de bord en position portrait ou paysage.
Cochez ou décochez la case Développer les tableaux pour afficher toutes les lignes. Si vous sélectionnez cette option, pour les vignettes de tableau de bord qui utilisent des visualisations de table, le PDF affichera toutes les lignes disponibles dans la visualisation de table, et pas seulement celles qui sont visibles dans la vignette de la vignette du tableau de bord. Si vous ne sélectionnez pas cette option, seules les lignes visibles dans la vignette sans défilement apparaîtront dans le PDF. Les filtres du tableau de bord et de la requête s'appliquent toujours, ainsi que 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 tables pour afficher toutes les lignes est sélectionnée, les vignettes du tableau de bord contenant des visualisations de table peuvent être légèrement différentes dans les PDF téléchargés et dans Looker. Les différences suivantes peuvent être visibles dans le PDF :
- Les personnalisations apportées aux couleurs d'arrière-plan et aux 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 dans le thème blanc. Sinon, le thème personnalisé est appliqué lors du téléchargement.
- L'icône de tri ne s'affiche pas sur les tableaux croisés dynamiques qui n'ont pas été triés manuellement.
- Les tableaux pour lesquels l'option Redimensionner les colonnes pour les ajuster est activé sont étirés sur toute la largeur de la tuile.
En outre, pour les tableaux comportant plus de 20 000 cellules, les différences suivantes peuvent être perceptibles dans le PDF:
- Les options de mise en forme conditionnelle autres que Couleur de l'arrière-plan ne s'affichent plus.
- Les visualisations de cellules dans les colonnes numériques ne s'affichent plus.
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 moteur de rendu Chromium pour votre instance Looker.
Cochez ou décochez la case Organiser les vignettes du tableau de bord dans 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 du navigateur. Vous pouvez alors 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 Download (Télécharger) pour lancer le téléchargement. Un nouvel onglet s'ouvre dans votre navigateur pour afficher l'état 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 fichier CSV compressé.
Lorsque vous téléchargez un tableau de bord au format CSV, les options de mise en forme des téléchargements ne sont pas disponibles (par exemple, pour définir une limite de lignes personnalisées ou choisir tous les résultats). Les limites de lignes dans les fichiers téléchargés correspondent aux limites de lignes des cartes 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 recommande d'utiliser un extracteur de fichier qui reconnaît le format 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 cartes de tableau de bord basées sur des requêtes de résultats fusionnés, mais elles 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 à partir d'une vignette de tableau de bord, sélectionnez l'icône à trois points sur la vignette et sélectionnez Télécharger les données:
Une boîte de dialogue s'ouvre avec plusieurs options semblables à celles d'une présentation ou d'une exploration. Développez le menu Options de données avancées pour afficher toutes les options disponibles pour votre téléchargement:
Format
Les données peuvent être téléchargées à partir de vignettes de tableau de bord aux 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 visualisation)
Selon le format que vous sélectionnez, certaines options du menu Options de données avancées peuvent ne pas être disponibles.
Si les options HTML ou PNG (image de visualisation) sont manquantes, contactez votre administrateur Looker pour lui demander d'installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.
Au format JSON, Looker utilise les étiquettes des champs comme valeur affichée dans sa sortie JSON. Consultez le post destiné à la communauté Modification de la mise en forme JSON pour en savoir plus sur la façon dont Looker affiche les champs au format JSON.
Les visualisations de tableau transposées ne s'affichent que dans les téléchargements PDF et PNG.
Les téléchargements au format PNG renvoient toujours les données du modèle tel qu'il est en mode Production, même si vous êtes en mode Développement.
Résultats
Dans la section Résultats, choisissez si vous souhaitez appliquer des paramètres de visualisation à votre téléchargement de données:
Si vous sélectionnez Avec les options de visualisation appliquées, Looker applique certains paramètres de visualisation à votre téléchargement. Les paramètres suivants des menus Graphique, Séries et Mise en forme configurés pour la visualisation seront appliqués au téléchargement des données :
- Afficher les numéros de lignes
- Masquer les totaux
- Masquer les totaux des lignes
- Limitez les lignes affichées à 500 lignes affichées ou masquées au maximum.
- Afficher le nom complet du champ
- Étiquettes personnalisées pour chaque colonne (Looker utilise des étiquettes de champ comme valeur affichée dans sa sortie JSON. Pour en savoir plus sur la façon dont {looker_name_short}} affiche les champs au format JSON, consultez l'article de la communauté Looker Changement de format JSON.
- La mise en forme conditionnelle pour le téléchargement de visualisations sous forme de tableaux au format Excel.
La mise en forme conditionnelle ne s'affiche dans les téléchargements au format Excel avec des visualisations sous forme de tableaux que si la règle Sur une échelle est appliquée.
Dans les tableaux, les colonnes qui ont été modifiées manuellement apparaîtront dans leur ordre d'origine lors du téléchargement si la requête comprend l'un des éléments suivants:
- Un ou plusieurs calculs de tables
- Un ou plusieurs champs masqués dans la visualisation
- Un ou plusieurs champs avec le remplissage des dimensions activé
- Trois champs croisés ou plus
- Nombre total de lignes activé
Si vous sélectionnez Telle qu'affichée dans le tableau de données, les options de visualisation ne seront pas appliquées et le téléchargement apparaîtra comme le tableau de données de la section Données de la présentation ou de l'exploration.
Valeurs des données
Dans la section Valeurs des données, choisissez le mode d'affichage des résultats téléchargés:
- Si vous sélectionnez Formaté, les données s'afficheront davantage comme celles de l'expérience Explorer dans Looker, même si certaines fonctionnalités (comme l'association) ne sont pas compatibles avec tous les formats de fichiers.
- Si vous choisissez Non mises en forme, Looker n'applique aucune mise en forme particulière à vos résultats, par exemple arrondir les nombres longs ou ajouter des 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
Cette section vous permet de spécifier la quantité de données à télécharger. Dans la plupart des cartes, cette section du pop-up de téléchargement est intitulée Nombre de lignes à inclure. Si la requête d'emplacement contient des dimensions croisées dynamiques, cette section est intitulée Nombre de lignes et de colonnes à inclure. Vous disposez des options suivantes:
- Table de résultats actuelle: nombre de lignes spécifiées par la limite de lignes (et par colonne, si la requête de vignette contient au moins une dimension croisée) de la table de données sous-jacente de votre vignette.
- Tous les résultats: tous les résultats renvoyés par la requête de tuile, même si la table 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 lors de l'utilisation de l'option Tous les résultats ou Personnalisée de cette page. Cette option n'est pas visible par les utilisateurs qui ne disposent pas des autorisations
download_without_limit
. - Personnalisé: un nombre personnalisé de lignes à télécharger. 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 a augmenté cette limite (consultez le post de la communauté Ancienne fonctionnalité: 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 permettront de télécharger l'ensemble de la requête. Si vous êtes autorisé à télécharger les 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:
- impliquent des totaux de ligne ;
- Utilisez les types de mesures pourcentage du total, pourcentage des totaux précédents ou total cumulés.
- Récupérer les données d'un dialecte de base de données qui ne peut pas diffuser les résultats
- Inclure les colonnes pivotées calculées par Looker, car les données proviennent d'un dialecte de base de données qui ne peut pas calculer les tableaux croisés dynamiques
Même lorsque l'option Tous les résultats est disponible, soyez prudent lorsque vous téléchargez tous les résultats. Certaines requêtes sont très volumineuses et contiennent des milliers ou des millions de lignes, ce qui peut 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 avec vos autorisations. Lorsque vous sélectionnez Personnalisé, vous pouvez spécifier le nombre de lignes de résultats à télécharger. Si votre requête contient des dimensions croisées dynamiques, 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 nécessitent que les administrateurs des déploiements Looker hébergés par le client aient installé la version appropriée du moteur de rendu Chromium. Si votre instance est hébergée par Looker, Chromium est déjà installé.
La page de documentation Gérer les fonctionnalités utilisateur métier contient des informations d'administration importantes sur le processus de téléchargement:
- Autorisations des utilisateurs et téléchargements de tableaux de bord
- Afficher des formats basés sur des images à télécharger
- Formats affichés 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 que les utilisateurs doivent accorder aux utilisateurs pour qu'ils puissent télécharger leurs données (en particulier les autorisations download_with_limit
et download_without_limit
), consultez la page de documentation Rôles.
Pour réduire le délai d'affichage des téléchargements de PDF pour les tableaux de bord contenant des visualisations de table avec de nombreuses lignes, les administrateurs Looker peuvent activer la fonctionnalité de laboratoire Render Long Tables (Afficher des tables longues).