Cette page décrit le téléchargement de contenu (visualisation ou données) à partir de 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 de contenu et de mise en forme varient selon que le téléchargement s'effectue à partir d'une présentation 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 les données d'une page de présentation ou d'exploration, sélectionnez le menu en forme de roue dentée en haut à droite, puis cliquez sur Télécharger.
Looker affiche la fenêtre Télécharger, dans laquelle vous pouvez nommer et formater 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) utiliseront les résultats du mode Production. Si votre téléchargement est dans un autre format, les résultats s'affichent, quel que soit le mode que vous utilisez (développement ou production).
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 visualisation)
Lorsque vous sélectionnez le format de données à télécharger, si vous ne voyez pas les options HTML ou PNG (image de visualisation) (pour les Looks), contactez votre administrateur Looker afin d'installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.
Pour le format JSON, Looker utilise les étiquettes de champ comme valeur de rendu dans sa sortie JSON. Consultez le post destiné à la communauté Modification du format 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 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 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 au téléchargement de données au format TXT, Excel, CSV, JSON, HTML ou Markdown.
Si vous choisissez Avec les options de visualisation appliquées, Looker applique certains paramètres de visualisation au téléchargement. Les paramètres suivants des menus Trace, Série et Mise en forme configurés pour la visualisation s'appliquent au téléchargement des données:
- Afficher les numéros de lignes
- Afficher les totaux
- Afficher les totaux des lignes
- Limitez les lignes affichées à un maximum de 500 lignes affichées ou masquées.
- Afficher le nom complet du champ
- Des étiquettes personnalisées pour chaque colonne (Looker utilise les étiquettes de champ comme valeur de rendu dans sa sortie JSON. Consultez le post destiné à la communauté Looker Modification du format JSON pour en savoir plus sur la façon dont Looker affiche les champs au format JSON.
- Mise en forme conditionnelle pour le téléchargement de visualisations de tableaux au format Excel
La mise en forme conditionnelle ne s'affiche dans les envois Excel de Looks 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 de texte d'en-tête et la couleur d'arrière-plan personnalisées ne sont pas appliquées aux résultats téléchargés, à l'exception des fichiers PNG.
- Pour les tableaux de résultats comportant des tableaux croisés dynamiques et plusieurs mesures, chaque valeur de tableau croisé dynamique est répétée sur plusieurs colonnes au lieu d'être représentées par une colonne fusionnée. Les téléchargements HTML et PNG font exception, de sorte que la colonne fusionnée est préservée.
- Lorsque vous téléchargez à 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 respectives ne sont pas libellées.
- Les sous-totaux ne sont pas téléchargés pour les requêtes qui ne peuvent pas être diffusées en flux continu.
Dans les tableaux, les colonnes qui ont été réorganisées manuellement apparaissent dans leur ordre d'origine dans le téléchargement si la requête inclut l'un des éléments suivants:
- des champs délibérément masqués dans la visualisation.
Champs présents dans le SQL sous-jacent, mais absents de la visualisation, tels que les suivants:
- Une dimension présente dans la visualisation et contenant un paramètre
link
qui fait référence à un autre champ absent de 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 et contenant un paramètre
Un ou plusieurs champs pour lesquels le remplissage des dimensions est activé
Au moins trois champs croisés
Nombre total de lignes activé
un ou plusieurs champs incluant le paramètre LookML
order_by_field
dans la définition des champs ;
Si vous choisissez Comme indiqué dans le tableau de données, les options de visualisation ne seront pas appliquées et le téléchargement s'affichera comme le tableau 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 la manière dont vous souhaitez que les résultats de requête téléchargés s'affichent:
- Si vous sélectionnez Sans mise en forme, Looker n'applique aucune mise en forme spéciale pour les résultats de vos requêtes, 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 choisissez Avec mise en forme, l'apparence des données sera semblable à celle de l'expérience Explorer dans Looker, même si certaines fonctionnalités (telles que la liaison) ne sont pas compatibles avec tous les types de fichiers. Par exemple, la mise en forme appliquée avec le paramètre
html
ne s'applique pas 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 actuels: nombre de lignes spécifiées par le nombre maximal de lignes de votre contenu.
- All results (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 sur cette page.
- Personnalisé: nombre personnalisé de lignes. Les utilisateurs disposant de l'autorisation
download_with_limit
sont limités à 5 000 lignes. Pour les autres utilisateurs,la limite 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 permettent le téléchargement de la requête complète. Si vous disposez des autorisations (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 est 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 opérations suivantes:
- Intégrer des totaux des lignes ou des calculs de tables
- Utilisez les types de mesures pourcentage total, pourcentage des précédents ou totaux 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 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 tableaux croisés dynamiques
Même lorsque l'option Tous les résultats est disponible, vous devez toujours 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 avec vos autorisations.
Flux de résultats de requête
Le traitement par flux fait référence à la capacité de Looker à traiter les données par blocs, 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. L'option Tous les résultats ne sera pas disponible si l'insertion 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 diffusées en flux continu si la requête inclut 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 diffuser de résultats, ce qui signifie que les téléchargements illimités ne sont pas possibles.
Ces bases de données sont compatibles avec la diffusion en flux continu:
Dialecte | Compatible ? |
---|---|
Actian Avalanche | Oui |
Amazon Athena | Oui |
Amazon Aurora MySQL | Oui |
Amazon Redshift | Oui |
Apache Druid | Non |
Apache Druid 0.13 et versions ultérieures | Non |
Apache Druid 0.18 et versions ultérieures | Non |
Apache Hive 2.3 et versions ultérieures | Oui |
Apache Hive 3.1.2+ | 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 et versions ultérieures | Oui |
Exasol | Oui |
Boulon | 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 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 et versions ultérieures | Oui |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5 ou version ultérieure | Oui |
PostgreSQL antérieur à la version 9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA 2+ | Non |
SingleStore | Oui |
SingleStore 7+ | Oui |
Snowflake | Oui |
Teradata | Oui |
Trino | Oui |
Vecteur | Oui |
Vertica | Oui |
Voici les bases de données qui prennent en charge la diffusion par flux avec des tableaux croisés dynamiques appliqués:
Dialecte | Compatible ? |
---|---|
Actian Avalanche | Oui |
Amazon Athena | Oui |
Amazon Aurora MySQL | Non |
Amazon Redshift | Oui |
Apache Druid | Non |
Apache Druid 0.13 et versions ultérieures | Non |
Apache Druid 0.18 et versions ultérieures | Non |
Apache Hive 2.3 et versions ultérieures | Non |
Apache Hive 3.1.2+ | 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 et versions ultérieures | Non |
Exasol | Oui |
Boulon | 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 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 et versions ultérieures | Non |
Oracle | Oui |
Oracle ADWC | Oui |
PostgreSQL 9.5 ou version ultérieure | Oui |
PostgreSQL antérieur à la version 9.5 | Oui |
PrestoDB | Oui |
PrestoSQL | Oui |
SAP HANA 2+ | 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, vous pouvez également voir l'option Supprimer tous les tris de la requête. Cette option empêche le tri de votre requête avant de télécharger les résultats. Sélectionner cette option peut accélérer votre téléchargement, car le tri d'une requête peut coûter cher aux performances 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 dynamiquement.
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 offre une taille de réponse maximale pour les résultats de requête, comme décrit dans l'article Écrire des 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 une autorisation pour écrire dans un schéma.
- Les résultats de la requête sont stockés dans ce schéma temporaire 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 sélectionner le bouton Télécharger pour télécharger un fichier sur votre ordinateur ou sélectionner 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 des requêtes de résultats fusionnés, vous pouvez les enregistrer 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 vignette 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
.La boîte de dialogue qui s'ouvre vous permet de sélectionner PDF ou CSV comme format de téléchargement.
Téléchargement d'un tableau de bord au format PDF
Vous pouvez télécharger l'intégralité de votre tableau de bord au format PDF. Cela signifie que vous obtiendrez un PDF contenant le titre du tableau de bord, les éventuels filtres de 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 comprend également un horodatage indiquant le moment où 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 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 de papier:
L'option Adapter la page au tableau de bord est utilisée par défaut ; elle adapte le PDF à la largeur par défaut des tableaux de bord (1 260 pixels). D'autres options de format de papier permettent de formater le PDF pour qu'il corresponde à un format de papier standard et s'adapte à tout ou partie du tableau de bord. En fonction de la disposition du tableau de bord et du format de papier sélectionné, certains résultats PDF peuvent différer de la disposition du tableau de bord lorsqu'ils sont affichés dans Looker. Par exemple, lorsque le format de papier sélectionné est plus étroit que celui du tableau de bord, vous risquez de rencontrer des problèmes d'espacement ou d'autre mise en forme. Vous devrez alors procéder à quelques ajustements:
- Il peut être nécessaire de redimensionner les visualisations volumineuses ou les groupes de tuiles qui se chevauchent afin de tenir dans le PDF.
- Les vignettes qui contiennent 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 cartes qui nécessitent un défilement dans l'application Looker peuvent ne pas se développer pour afficher tout le contenu.
Si l'option Taille du papier ne s'affiche pas, contactez votre administrateur Looker pour installer la dernière version du moteur de rendu Chromium pour votre instance Looker.
Si vous sélectionnez autre chose que Adapter 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 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 la 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 de requête et de tableau de bord s'appliqueront toujours, de même 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 qui contiennent 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 notables dans le PDF:
- La personnalisation des couleurs d'arrière-plan et de la taille de police est supprimée des en-têtes de colonne et des lignes de sous-total.
- 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é une fois téléchargé.
- L'icône de tri ne s'affiche pas pour les tableaux croisés dynamiques qui n'ont pas été triés manuellement.
- Les tables pour lesquelles l'option Adapter la taille des colonnes est activée s'étendent sur toute la largeur de la tuile.
En outre, pour les tableaux de 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 des cellules sur des colonnes numériques ne s'affichent plus.
Si l'option Développer les tables pour afficher toutes les lignes ne s'affiche pas, contactez votre administrateur Looker pour installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.
Sélectionnez ou conservez l'option Organiser les vignettes du tableau de bord en une seule colonne non sélectionnée. 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 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 Télécharger pour lancer le téléchargement. Un nouvel onglet s'ouvre dans votre navigateur et indique l'état du téléchargement.
Téléchargement d'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 collection de fichiers CSV compressés.
Lorsque vous téléchargez un tableau de bord au format CSV, les options de mise en forme du téléchargement, telles que la personnalisation du nombre maximal de lignes ou la sélection de tous les résultats, ne sont pas disponibles. Le nombre maximal de lignes dans les fichiers téléchargés est lié à celui des vignettes correspondantes.
Looker génère des fichiers compressés en utilisant le codage UTF-8. Si les caractères de vos noms de fichiers CSV sont indéchiffrables, il peut y avoir un conflit entre l'encodage UTF-8 de Looker et l'encodage par défaut du système d'exploitation de votre machine ou d'une application tierce. Looker vous conseille 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 de vignettes de tableau de bord basées sur des requêtes de résultats fusionnés, mais 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 en tant que collection de fichiers CSV.
Pour télécharger les données d'une vignette de tableau de bord, sélectionnez l'icône à trois points de la vignette, puis cliquez sur Télécharger les données:
Cela ouvre une boîte de dialogue contenant plusieurs options semblables à celles pour une présentation ou une exploration. Développez le menu Options avancées des données afin de voir toutes les options disponibles pour votre téléchargement:
Format
Les données peuvent être téléchargées à partir de vignettes du 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 visualisation)
Selon le format sélectionné, 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 afin d'installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.
Pour le format JSON, Looker utilise les étiquettes de champ comme valeur de rendu dans sa sortie JSON. Consultez le post destiné à la communauté Modification du format JSON pour en savoir plus sur la façon dont Looker affiche les champs au format JSON.
Les visualisations de tableau transposée ne s'affichent qu'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 des paramètres de visualisation au téléchargement des données:
Si vous choisissez Avec les options de visualisation appliquées, Looker applique certains paramètres de visualisation au téléchargement. Les paramètres suivants des menus Trace, Série et Mise en forme configurés pour la visualisation s'appliquent au téléchargement des données:
- Afficher les numéros de lignes
- Masquer les totaux
- Masquer les totaux de lignes
- Limitez les lignes affichées à un maximum de 500 lignes affichées ou masquées.
- Afficher le nom complet du champ
- Des étiquettes personnalisées pour chaque colonne (Looker utilise les étiquettes de champ comme valeur de rendu dans sa sortie JSON. Consultez le post destiné à la communauté Looker Modification du format JSON pour en savoir plus sur la manière dont {looker_name_short}} affiche les champs au format JSON.
- Mise en forme conditionnelle pour le téléchargement de visualisations de tableaux au format Excel.
La mise en forme conditionnelle ne s'affichera 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.
Dans les tableaux, les colonnes qui ont été réorganisées manuellement apparaissent dans leur ordre d'origine dans le 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 pour lesquels le remplissage des dimensions est activé
- Au moins trois champs croisés
- Nombre total de lignes activé
Si vous choisissez Comme affiché 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 dans la section Données du Look 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 téléchargés s'affichent:
- Si vous choisissez Formaté, les données ressembleront davantage à l'expérience Explorer dans Looker, même si certaines fonctionnalités (telles que l'association) ne sont pas compatibles avec tous les formats de fichiers.
- Si vous choisissez Sans mise en forme, Looker n'applique aucune mise en forme particulière de 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 incluses dans votre téléchargement. Dans la plupart des tuiles, cette section du pop-up de téléchargement est nommée Nombre de lignes à inclure. Si la requête de tuile contient des dimensions croisées dynamiquement, cette section est intitulée Nombre de lignes et de colonnes à inclure. Vous disposez des options suivantes:
- Tableau des résultats actuels: nombre de lignes spécifiées par le nombre maximal de lignes (et de colonnes, si la requête de la vignette contient au moins une dimension croisé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 tuile, même si la table de données d'une 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 lors de l'utilisation de 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 des autorisations
download_with_limit
sont limités à 5 000 lignes. Pour les autres utilisateurs, la limite est généralement de 100 000, sauf si votre administrateur Looker a augmenté cette limite (consultez le post destiné à 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 le téléchargement de la requête complète. Si vous êtes autorisé à télécharger des 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 est 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:
- Inclure le nombre total de lignes
- Utilisez les types de mesures pourcentage total, pourcentage des précédents ou totaux 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 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 tableaux croisés dynamiques
Même lorsque l'option Tous les résultats est disponible, vous devez toujours 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 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 pour les utilisateurs professionnels 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 pour le téléchargement
- 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 à attribuer aux utilisateurs pour qu'ils puissent effectuer des téléchargements (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 fichiers PDF téléchargés pour les tableaux de bord contenant des visualisations de tables comportant de nombreuses lignes, les administrateurs Looker peuvent activer la fonctionnalité Labs Afficher les tables longues.