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.
Le processus et les options de téléchargement et de mise en forme des contenus téléchargés varient selon que vous téléchargez des données à partir d'une exploration ou d'un look, à 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 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 vous expliquent chaque champ de la fenêtre Télécharger:
Format
Les téléchargements dans des formats qui utilisent le moteur de rendu (PNG et PDF) utiliseront les résultats du mode Production. Si votre téléchargement est au format d'un autre environnement, il affichera les résultats du mode (développement ou production) dans lequel vous vous trouvez.
Vous pouvez télécharger des données à partir de vos présentations et explorations dans les formats de fichiers 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.
Pour le format JSON, 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 de la communauté Changement de format JSON.
Les tableaux transposés ne s'affichent que dans les téléchargements au format 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 fichier PDF et PNG font exception : les téléchargements de données dans ces formats de fichier 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 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 au téléchargement de vos données au format TXT, Excel, CSV, JSON, HTML ou Markdown.
Si vous choisissez Avec application des options de visualisation, Looker applique certains paramètres de visualisation à votre téléchargement. Les paramètres suivants des menus Graphique, 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 à 500 lignes maximum 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 l'article de la communauté Looker Changement de mise en forme JSON.
- Mise en forme conditionnelle pour le téléchargement de visualisations sous forme de tableaux au format Excel
La mise en forme conditionnelle n'est disponible dans les envois Excel de présentations et d'explorations 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 du texte et de l'arrière-plan de l'en-tête personnalisé ne sont pas appliquées aux résultats téléchargés, sauf pour les fichiers PNG.
- Pour les tableaux de résultats avec des pivots et plusieurs mesures, chaque valeur de pivot est répétée dans les colonnes plutôt que représentée dans une seule colonne fusionnée. Les téléchargements au format HTML et PNG font exception. La colonne fusionnée est donc conservée.
- Lorsque vous effectuez un téléchargement à 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.
Les colonnes des tableaux qui ont été réorganisées manuellement apparaîtront dans l'ordre d'origine lors du téléchargement si la requête inclut l'un des éléments suivants:
- les champs délibérément masqués dans la visualisation ;
les champs présents dans le code SQL sous-jacent, mais qui ne figurent pas 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'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 la fonctionnalité Remplissage de la dimension activée
Trois champs pivotés ou plus
Totaux des lignes activés
Un ou plusieurs champs qui incluent le paramètre LookML
order_by_field
dans la définition du champ
Si vous choisissez Comme dans la table de données, les options de visualisation ne seront pas appliquées et le téléchargement s'affichera comme dans la table 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 comment les résultats de la requête téléchargés doivent s'afficher:
- Si vous choisissez Non mises en forme, Looker n'applique aucune mise en forme particulière aux résultats de vos requêtes, 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.
- Si vous choisissez Formaté, l'apparence des données sera semblable à celle de l'exploration dans Looker, bien que certaines fonctionnalités (telles que 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 au format 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 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 permettent de télécharger l'intégralité de la requête. Si vous disposez des autorisations (pour les résultats dépassant une limite définie) et si Looker détermine que l'ensemble de votre requête peut être téléchargé, l'option Tous les résultats s'affiche 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 opérations suivantes:
- Incluez des totaux de ligne ou des calculs de table.
- Utilisez les types de mesures pourcentage du total, pourcentage de l'élément précédent ou totaux 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.
- Incluez les colonnes croisées dynamiques 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 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. Elles peuvent submerger la plupart des programmes de feuilles de calcul, 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é avec 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 n'est donc 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 diffusés 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 diffusion en continu:
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 ou version ultérieure | Oui |
Apache Hive 3.1.2 ou version ultérieure | Oui |
Apache Spark 3 ou version ultérieure | Oui |
ClickHouse | Oui |
Cloudera Impala 3.1 ou version ultérieure | Oui |
Cloudera Impala 3.1 ou version ultérieure avec pilote natif | Oui |
Cloudera Impala avec pilote natif | Oui |
DataVirtuality | Oui |
Databricks | Oui |
Denodo 7 | Oui |
Denodo 8 | Oui |
Dremio | Oui |
Dremio 11 ou version ultérieure | Oui |
Exasol | Oui |
Flèche de feu | Oui |
Google BigQuery Legacy SQL | Oui |
SQL standard de 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 |
Microsoft Azure SQL Database | Oui |
Microsoft Azure Synapse Analytics | Oui |
Microsoft SQL Server 2008 ou version ultérieure | Oui |
Microsoft SQL Server 2012 ou version ultérieure | Oui |
Microsoft SQL Server 2016 | Oui |
Microsoft SQL Server 2017 ou version ultérieure | Oui |
MongoBI | Oui |
MySQL | Oui |
MySQL 8.0.12 ou version ultérieure | Oui |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5 ou version ultérieure | Oui |
PostgreSQL version antérieure à 9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA 2 ou version ultérieure | Non |
SingleStore | Oui |
SingleStore 7+ | Oui |
Snowflake | Oui |
Teradata | Oui |
Trino | Oui |
Vecteur | 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 |
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 ou version ultérieure | Non |
Apache Hive 3.1.2 ou version ultérieure | Non |
Apache Spark 3 ou version ultérieure | Oui |
ClickHouse | Non |
Cloudera Impala 3.1 ou version ultérieure | Oui |
Cloudera Impala 3.1 ou version ultérieure avec pilote natif | Oui |
Cloudera Impala avec pilote natif | Oui |
DataVirtuality | Non |
Databricks | Oui |
Denodo 7 | Non |
Denodo 8 | Non |
Dremio | Non |
Dremio 11 ou version ultérieure | Non |
Exasol | Oui |
Flèche de feu | Oui |
Google BigQuery Legacy SQL | Oui |
SQL standard de 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 |
Microsoft Azure SQL Database | Oui |
Microsoft Azure Synapse Analytics | Oui |
Microsoft SQL Server 2008 ou version ultérieure | Oui |
Microsoft SQL Server 2012 ou version ultérieure | Oui |
Microsoft SQL Server 2016 | Oui |
Microsoft SQL Server 2017 ou version ultérieure | Oui |
MongoBI | Non |
MySQL | Non |
MySQL 8.0.12 ou version ultérieure | Non |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5 ou version ultérieure | Oui |
PostgreSQL version antérieure à 9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA 2 ou version ultérieure | Non |
SingleStore | Oui |
SingleStore 7+ | 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 le tri de votre requête avant de télécharger les résultats. Cette option peut accélérer le 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 pivoté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 BigQuery
allowLargeResults
est définie surtrue
pour la requête. - Les clauses
ORDER BY
de la requête sont supprimées. - La requête s'écrit dans un schéma temporaire PDT et nécessite une autorisation pour s'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 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 sur Ouvrir dans le navigateur pour l'afficher 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 de dossier 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 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 l'intégralité de votre tableau de bord au format PDF. Vous obtiendrez alors un fichier PDF affichant le titre du tableau de bord, 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 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 Taille du papier:
L'option Adapter la taille de la page au tableau de bord est sélectionnée par défaut. Elle ajuste 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é, certaines sorties PDF peuvent différer de la mise en page du tableau de bord lorsqu'elles sont affichées 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 d'autres problèmes de mise en forme et avoir besoin d'apporter des ajustements:
- Il est possible que vous deviez redimensionner les visualisations de grande taille ou les vignettes qui se chevauchent afin qu'elles s'affichent correctement dans le PDF.
- Il est possible que les cartes contenant des tableaux n'affichent pas toutes les colonnes du tableau dans le PDF.
- La largeur des cartes peut être réduite pour s'adapter au fichier PDF. De même, les cartes qui nécessitent un défilement dans l'application Looker peuvent ne pas s'étendre 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 moteur de rendu Chromium pour votre instance Looker.
Si vous sélectionnez une autre option que Adapter la page au tableau de bord dans le menu déroulant Format de 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 Développer les tables pour afficher toutes les lignes. Si vous sélectionnez cette option, pour les cartes 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 carte 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 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 tableaux pour afficher toutes les lignes est sélectionnée, les cartes de tableau de bord contenant des visualisations de tableaux peuvent sembler légèrement différentes dans les fichiers 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 colonnes et des lignes de sous-totaux.
- Si aucun thème personnalisé n'est défini, Tables s'affiche dans 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 avec la fonctionnalité Largeur de colonne optimale activée s'étendent sur toute la largeur de la carte.
De plus, pour les tableaux de plus de 20 000 cellules, les différences suivantes peuvent être visibles dans le fichier PDF:
- Les options de mise en forme conditionnelle autres que Couleur d'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.
Sélectionnez ou non l'option Placer les vignettes du tableau de bord dans une colonne unique. 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 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 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, telles que le paramétrage 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 aux limites de lignes 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 l'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 en tant que 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 la vignette, puis sélectionnez Télécharger les données:
Une boîte de dialogue s'ouvre et vous propose plusieurs options semblables à celles d'un look 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
Vous pouvez télécharger des données à partir des cartes 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, demandez à votre administrateur Looker d'installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.
Pour le format JSON, 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 de la communauté Modification de la mise en forme 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 tel qu'il est en mode Production, même si vous êtes en mode Développement.
Résultats
Dans la section Résultats, indiquez si vous souhaitez appliquer des paramètres de visualisation au téléchargement de vos données:
Si vous choisissez Avec application des options de visualisation, Looker applique certains paramètres de visualisation à votre téléchargement. Les paramètres suivants des menus Graphique, 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 ligne
- Limit Displayed Rows (Limiter les lignes affichées) : vous pouvez afficher ou masquer un maximum de 500 lignes.
- 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_name_short}} affiche les champs au format JSON, consultez l'article de la communauté Looker Changement de format JSON.
- Mise en forme conditionnelle pour le téléchargement de visualisations sous forme 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 l'ordre d'origine lors du téléchargement si la requête inclut 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 la fonctionnalité Remplissage de la dimension activée
- Trois champs pivoté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 dans la table 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 comment les résultats téléchargés doivent s'afficher:
- Si vous choisissez Formaté, les données ressembleront davantage à l'expérience Explorer dans Looker, même si certaines fonctionnalités (comme l'association) ne sont pas compatibles avec tous les formats de fichier.
- 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
Dans cette section, vous pouvez spécifier la quantité de données incluses dans votre téléchargement. Dans la plupart des cartes, cette section du pop-up de téléchargement s'intitule Nombre de lignes à inclure. Si la requête de la carte contient des dimensions pivotées, cette section s'intitule Nombre de lignes et de colonnes à inclure. Vous avez le choix entre plusieurs options:
- Tableau de résultats actuel: nombre de lignes spécifié par la limite de lignes (et la limite de colonnes, si la requête de carte contient au moins une dimension pivotée) du tableau de données sous-jacent de votre carte.
- Tous les résultats: tous les résultats renvoyés par la requête de carte, même si la table de données de la carte 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é" de cette page. Cette option n'est pas visible par les utilisateurs qui ne disposent pas des autorisations
download_without_limit
. - Personnalisé: nombre personnalisé de lignes à télécharger. Les utilisateurs disposant d'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 (voir le post de la communauté Ancienne fonctionnalité: Autoriser les téléchargements illimités (Looker 4.14 et versions ultérieures)).
É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 disposez des autorisations nécessaires pour télécharger des résultats au-delà d'une limite définie et que Looker détermine que l'ensemble de votre requête peut être téléchargé, l'option Tous les résultats s'affiche 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:
- Inclure les totaux des lignes
- Utilisez les types de mesures pourcentage du total, pourcentage de l'élément précédent ou totaux 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.
- Incluez les colonnes croisées dynamiques 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 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. Elles peuvent submerger la plupart des programmes de feuilles de calcul, 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é avec vos autorisations. Lorsque vous sélectionnez Personnalisée, vous pouvez spécifier un nombre de lignes de résultats à télécharger. Si votre requête contient des dimensions croisées, vous pouvez également spécifier un 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 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 importantes pour les administrateurs sur le processus de téléchargement:
- Autorisations des utilisateurs et téléchargements de tableaux de bord
- Affichage de formats basés sur des images à télécharger
- Formats de rendu 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 qui doivent être attribuées aux utilisateurs pour leur permettre de télécharger des applications, en particulier les autorisations download_with_limit
et download_without_limit
, consultez la page de documentation Rôles.