Descargar contenido

En esta página se describe cómo descargar contenido (visualizaciones o datos) de Looker.

Para descargar contenido, un administrador de Looker debe concederte el permiso download_with_limit o download_without_limit.

El proceso y las opciones para descargar contenido y darle formato varían en función de si lo descargas de un Look o de un Explorar, de un panel de control o de una consulta de resultados combinados.

Descargar datos de un Look o de un Explorar

Para descargar datos de un look o de una página Explorar, selecciona el menú de la rueda dentada situado en la parte superior derecha y, a continuación, Descargar.

Looker muestra la ventana Descargar, donde puedes asignar un nombre y un formato a la descarga.

En las siguientes secciones se explica cada campo de la ventana Descargar:

Formato

Las descargas en formatos que usan el renderizador (PNG y PDF) usarán los resultados del modo Producción. Si la descarga está en otro formato, se mostrarán los resultados del modo en el que te encuentres (desarrollo o producción).

Los datos se pueden descargar de los Looks y los Exploraciones en los siguientes formatos de archivo:

  • TXT (valores separados por tabulaciones)
  • Hoja de cálculo de Excel (Excel 2007 o versiones posteriores)
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG (imagen de la visualización)

Si no ves las opciones HTML o PNG (imagen de la visualización) al elegir el formato de datos para descargar un Look, habla con tu administrador de Looker para que instale la versión adecuada del renderizador Chromium en tu instancia de Looker.

En el formato JSON, Looker usa el campo labels como valor renderizado en su salida JSON. Consulta la publicación de la comunidad Cambio en el formato JSON para obtener más información sobre cómo representa Looker los campos en formato JSON.

Las tablas transpuestas solo se renderizarán en las descargas en formato PNG.

Si eres desarrollador de Looker y estás en modo Desarrollo, las descargas de datos en la mayoría de los formatos de archivo consultan tu modelo tal como está en el modo Desarrollo. Los formatos de archivo PDF y PNG son la excepción: las descargas de datos en esos formatos siempre consultan su modelo como si estuviera en el modo Producción.

Nombre del archivo

Puede introducir un nombre de archivo para la descarga o usar el nombre de archivo predeterminado que se rellena automáticamente en el campo. Looker añadirá automáticamente la extensión de archivo adecuada en función de lo que selecciones en el campo Formato.

Resultados

En la sección Resultados, elija si quiere que se apliquen los ajustes de visualización a los datos que descargue en formato TXT, Excel, CSV, JSON, HTML o Markdown.

Si elige Con las opciones de visualización aplicadas, Looker aplica algunos de los ajustes de visualización a la descarga. Cualquier ajuste de los menús Gráfico, Serie y Formato que se haya configurado para la visualización se aplicará a la descarga de datos:

El formato condicional se mostrará en las entregas de Excel de los looks y los Exploraciones con visualizaciones de gráficos de tabla solo si se aplica la regla de escala.

Algunos ajustes de visualización no se aplican a los resultados descargados. Por ejemplo:

  • El color de texto y el color de fondo del encabezado personalizado no se aplican a los resultados descargados, excepto en el caso de los archivos PNG.
  • En las tablas de resultados con dinamizaciones y varias métricas, cada valor de dinamización se repite en las columnas en lugar de representarse como una columna combinada. Las descargas en HTML y PNG son una excepción, por lo que la columna combinada se conserva.
  • Cuando descargas datos de un panel de control, el título de la baldosa del panel no se incluye en los resultados descargados.
  • Los valores de Totales y Totales de las filas se incluyen en los resultados descargados, pero las filas y columnas correspondientes no están etiquetadas.
  • Los subtotales no se descargarán en las consultas que no se puedan transmitir.

Las columnas de los gráficos de tabla que se hayan reorganizado manualmente aparecerán en el orden original en la descarga si la consulta incluye alguno de los siguientes elementos:

Si elige Tal como se muestra en la tabla de datos, no se aplicarán las opciones de visualización y la descarga se mostrará como la tabla de datos de la sección Datos del look o del informe Exploración.

Valores de datos

En la sección Valores de datos, elija cómo quiere que aparezcan los resultados de la consulta descargada:

  • Si elige Sin formato, Looker no aplicará ningún formato especial a los resultados de su consulta, como redondear números largos o añadir caracteres especiales que hayan podido incluir sus desarrolladores de Looker. Esta opción suele ser la más adecuada cuando los datos se envían a otra herramienta para su procesamiento.
  • Si eliges Formateado, el aspecto de los datos será similar al de la Exploración de Looker, aunque algunos formatos de archivo no admiten ciertas funciones (como la vinculación). Por ejemplo, el formato aplicado con el parámetro html no se aplicará a las descargas en formato TXT, CSV, Excel o JSON.

Número de filas y columnas que se van a incluir

Puedes elegir la cantidad de datos que quieras descargar de la siguiente forma:

  • Tabla de resultados actual: número de filas que se especifican en el límite de filas de su contenido.
  • Todos los resultados: todos los resultados que devuelve la consulta. Antes de seleccionar esta opción, consulta la sección Todos los resultados de esta página.
  • Personalizado: un número de filas personalizado. Los usuarios que tengan permisos de download_with_limit solo pueden ver 5000 filas. El límite para otros usuarios suele ser de 100.000.

Todos los resultados

Cuando selecciona Ejecutar en un look o una exploración, Looker comprueba sus permisos y determina si la complejidad de la consulta y el dialecto de la base de datos permitirán descargar toda la consulta. Si tienes los permisos necesarios (para obtener resultados que superen un límite establecido) y Looker determina que se puede descargar toda tu consulta, la opción Todos los resultados estará disponible en la ventana Descargar.

La opción Todos los resultados suele estar inhabilitada en las consultas que hacen lo siguiente:

Aunque esté disponible la opción Todos los resultados, debes tener cuidado al descargar todos los resultados. Algunas consultas son muy grandes y contienen miles o millones de filas, lo que puede sobrecargar la mayoría de los programas de hojas de cálculo o incluso tu instancia de Looker.

Si la opción Todos los resultados no está disponible, puede usar la opción Personalizado para especificar el número máximo de filas que se permiten con sus permisos.

Transmitir resultados de consultas

El streaming hace referencia a la capacidad de Looker para procesar datos en fragmentos, en lugar de hacerlo todo a la vez. Si Looker puede transmitir un conjunto de resultados, se pueden realizar descargas ilimitadas. La opción Todos los resultados depende de la capacidad de Looker para transmitir resultados, por lo que no estará disponible si no se pueden transmitir.

Además de las limitaciones de formato, hay dos casos en los que no se puede hacer streaming:

  1. Cálculos de tabla: no se pueden transmitir. Por lo tanto, para descargar un número ilimitado de resultados de una consulta, debes quitar los cálculos de tabla de la consulta.
  2. Limitaciones de la base de datos: algunas bases de datos no pueden transmitir datos si se incluyen en la consulta. En estas bases de datos, debe quitar las tablas dinámicas para descargar resultados ilimitados. Algunas bases de datos no pueden transmitir ningún resultado, lo que significa que no se pueden hacer descargas ilimitadas.

Estas bases de datos admiten el streaming:

Dialecto ¿Es compatible?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
No
Apache Druid 0.13+
No
Apache Druid 0.18+
No
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Exasol
Firebolt
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
No
Greenplum
HyperSQL
No
IBM Netezza
No
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
No
SAP HANA 2+
No
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

Estas son las bases de datos que admiten la transmisión con pivotes aplicados:

Dialecto ¿Es compatible?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
No
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
No
Apache Druid 0.13+
No
Apache Druid 0.18+
No
Apache Hive 2.3+
No
Apache Hive 3.1.2+
No
Apache Spark 3+
ClickHouse
No
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
No
Databricks
Denodo 7
No
Denodo 8 & 9
No
Dremio
No
Dremio 11+
No
Exasol
Firebolt
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud PostgreSQL
Google Cloud SQL
No
Google Spanner
No
Greenplum
HyperSQL
No
IBM Netezza
MariaDB
No
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
No
MySQL
No
MySQL 8.0.12+
No
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
No
SAP HANA 2+
No
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

Quitar todos los ordenamientos de la consulta

Si seleccionas Todos los resultados, también puede aparecer la opción Quitar todos los tipos de la consulta. Esta opción impide que se ordenen los resultados de la consulta antes de descargarlos. Si seleccionas esta opción, la descarga puede ser más rápida, ya que ordenar una consulta puede afectar al rendimiento de determinados tipos de bases de datos.

La opción Quitar todos los ordenamientos de la consulta no está disponible para los resultados dinamizados.

Permitir resultados grandes

Cuando descargas un conjunto de resultados grande en Looker usando Google BigQuery como dialecto de base de datos y seleccionas Todos los resultados, puede que veas la opción Permitir resultados grandes. Esto se debe a que Google BigQuery tiene un tamaño máximo de respuesta para los resultados de las consultas, tal como se describe en el tema de la documentación de Google Cloud Escribir resultados de consultas. Para descargar resultados que superen el tamaño máximo de respuesta de BigQuery, Looker debe seguir otro proceso.

Si seleccionas Permitir resultados grandes, el proceso de descarga se verá afectado de la siguiente manera:

  • La opción allowLargeResults de BigQuery está definida como true para la consulta.
  • Se eliminan las cláusulas ORDER BY de la consulta.
  • La consulta escribirá en un esquema temporal de PDT y requiere permiso para escribir en uno.
  • Los resultados de la consulta se almacenan en este esquema temporal con un nombre de tabla aleatorio durante una hora.

Descargar o abrir en el navegador

Una vez que hayas seleccionado las opciones, puedes hacer clic en el botón Descargar para descargar un archivo en tu ordenador o en Abrir en el navegador para ver el archivo en el navegador.

Descargar datos de una consulta de resultados combinados

Para descargar las consultas de resultados combinados, puedes guardar la consulta en un panel de control y, a continuación, descargar el panel de control como PDF o como colección de archivos CSV. Sin embargo, debes descargar todo el panel de control. No puedes descargar los datos de una sola tarjeta basada en una consulta de resultados combinados.

Descargar datos de un panel de control

Para descargar todo el panel de control, selecciona Descargar en el menú de tres puntos del panel de control.

Se abrirá un cuadro de diálogo en el que podrás seleccionar el formato de descarga (PDF o CSV).

Descargar un panel de control como PDF

Puede descargar todo el panel de control en formato PDF, lo que significa que obtendrá un PDF con el título del panel, los filtros que haya aplicado, algunas o todas las tarjetas del panel y la zona horaria en la que se haya ejecutado. El PDF también incluirá una marca de tiempo que indica cuándo se descargó el panel de control.

Las descargas en formato PDF siempre devuelven datos del modelo como si estuviera en modo Producción, aunque estés en modo Desarrollo.

Para descargar un panel de control como PDF, sigue estos pasos:

  1. Selecciona PDF en el menú desplegable Formato.
  2. Selecciona una opción en el menú desplegable Tamaño del papel:

    La opción Ajustar página al panel de control está activada de forma predeterminada, por lo que el PDF se ajusta al ancho predeterminado de los paneles de control (1260 px). Otras opciones de tamaño de papel ajustan el PDF a un tamaño de papel estándar y adaptan todo o parte del panel de control a él. En función del diseño del panel de control y del tamaño de papel seleccionado, es posible que algunos archivos PDF no tengan el mismo diseño que el panel de control cuando se vean en Looker. Por ejemplo, si el tamaño del papel seleccionado es más estrecho que el del panel de control, puede que haya problemas con el espaciado u otro formato, por lo que tendrás que hacer algunos ajustes:

    • Es posible que las visualizaciones grandes o los grupos de baldosas superpuestas deban cambiar de tamaño para ajustarse al PDF.
    • Es posible que las baldosas que contienen tablas no muestren todas las columnas de la tabla en el PDF.
    • Es posible que las baldosas se reduzcan para ajustarse al PDF. Del mismo modo, es posible que las baldosas que requieran desplazarse en la aplicación Looker no se amplíen para mostrar todo el contenido.

    Si no ves la opción Tamaño del papel, ponte en contacto con tu administrador de Looker para instalar la versión más reciente del renderizador Chromium en tu instancia de Looker.

  3. Si seleccionas una opción distinta de Ajustar página al panel de control en el menú desplegable Tamaño del papel, aparecerá la opción Orientación. Puedes elegir si quieres que el panel de control esté en posición vertical u horizontal.

  4. Selecciona o desmarca Desplegar las tablas para mostrar todas las filas. Si seleccionas esta opción, en las baldosas del panel de control que usen visualizaciones de tabla, el PDF mostrará todas las filas disponibles en la visualización de tabla, no solo las que se ven en la miniatura de la baldosa del panel de control. Si no seleccionas esta opción, en el PDF solo aparecerán las filas que se vean en la miniatura sin desplazarse. Los filtros de panel de control y de consulta se seguirán aplicando, al igual que los ajustes de visualización, como los límites de filas, los límites de columnas y los ajustes que se realicen con la opción Limitar filas mostradas.

    Si se selecciona la opción Desplegar las tablas para mostrar todas las filas, las baldosas del panel de control que contengan visualizaciones de tabla pueden tener un aspecto ligeramente diferente en los PDFs descargados que en Looker. Las siguientes diferencias pueden apreciarse en el PDF:

    • Las personalizaciones de los colores de fondo y los tamaños de fuente se eliminan de los encabezados de columna y de las filas de subtotales.
    • Si no se ha definido ningún tema personalizado, las tablas se mostrarán con el tema blanco. De lo contrario, el tema personalizado se aplicará cuando se descargue.
    • El icono de ordenación no aparece en las tablas dinamizadas que no se hayan ordenado manualmente.
    • Las tablas con la opción Ajustar columnas al tamaño habilitada se extienden a todo el ancho de la baldosa.

    Además, en las tablas con más de 20.000 celdas, pueden observarse las siguientes diferencias en el PDF:

    Si no ves la opción Ampliar tablas para mostrar todas las filas, habla con tu administrador de Looker para que instale la versión adecuada del renderizador Chromium en tu instancia de Looker.

  5. Selecciona o desmarca Organizar las tarjetas del panel de control en una sola columna. Si seleccionas esta opción, el PDF mostrará los recuadros del panel de control en una sola columna vertical. Si no selecciona esta opción, las tarjetas del panel de control aparecerán tal como estén dispuestas en el panel.

  6. Selecciona Abrir en el navegador para ver una imagen del PDF en una pestaña nueva del navegador. Desde ahí, puedes descargar el PDF con los controles de tu navegador.

  7. Selecciona Cancelar si ya no quieres descargar el panel de control.

  8. Selecciona Descargar para iniciar la descarga. Se abrirá una nueva pestaña en el navegador, donde se mostrará el estado de la descarga.

Descargar un panel de control como archivos CSV

Puedes descargar todas las baldosas de consulta de tu panel de control como una colección comprimida de archivos CSV. Los mosaicos de texto no se incluyen en el archivo ZIP. Para descargar un panel de control como una colección de archivos CSV, siga estos pasos:

  1. Selecciona CSV en el menú desplegable Formato.
  2. Selecciona Cancelar si ya no quieres descargar el panel de control.
  3. Selecciona Descargar para iniciar la descarga de tu colección de archivos CSV comprimidos.

Cuando descarga un panel de control como archivos CSV, no puede usar las opciones de formato de las descargas, como establecer límites de filas personalizados o elegir todos los resultados. Los límites de filas de los archivos descargados se corresponden con los límites de filas de las baldosas correspondientes.

Looker genera archivos comprimidos con la codificación UTF-8. Si los caracteres de los nombres de los archivos CSV aparecen codificados de forma incorrecta, puede que haya un conflicto entre la codificación UTF-8 de Looker y la codificación predeterminada del sistema operativo de tu máquina o de una aplicación de terceros. Looker recomienda que utilices un extractor de archivos que reconozca UTF-8, como 7-Zip, y que te asegures de que las aplicaciones de terceros estén configuradas para admitir UTF-8.

Descargar datos de las baldosas del panel de control

No puedes descargar los datos de las tarjetas del panel de control basadas en consultas de resultados combinados, pero los datos de las tarjetas de resultados combinados se incluyen si descargas un panel de control como PDF o como una colección de archivos CSV.

Para descargar los datos de una baldosa de un panel de control, selecciona el icono de tres puntos de la baldosa y, a continuación, Descargar datos:

Se abrirá un cuadro de diálogo con varias opciones similares a las de una petición o una exploración. Despliega el menú Opciones avanzadas de datos para ver todas las opciones disponibles para la descarga:

Formato

Los datos se pueden descargar de las tarjetas del panel de control en los siguientes formatos:

  • TXT (valores separados por tabulaciones)
  • Hoja de cálculo de Excel (Excel 2007 o versiones posteriores)
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG (imagen de la visualización)

En función del formato que selecciones, es posible que algunas opciones del menú Opciones avanzadas de datos no estén disponibles.

Si faltan las opciones HTML o PNG (imagen de la visualización), ponte en contacto con tu administrador de Looker para que instale la versión adecuada del renderizador Chromium en tu instancia de Looker.

En el formato JSON, Looker usa el campo labels como valor renderizado en su salida JSON. Consulta la publicación de la comunidad Cambio en el formato JSON para obtener más información sobre cómo representa Looker los campos en formato JSON.

Las visualizaciones de tabla transpuesta solo se renderizarán en las descargas en PDF y PNG.

Las descargas en formato PNG siempre devuelven datos del modelo tal como está en el modo Producción, aunque estés en el modo Desarrollo.

Resultados

En la sección Resultados, elija si quiere que se apliquen los ajustes de visualización a los datos que descargue:

Si elige Como se muestra en la tabla de datos, no se aplicarán las opciones de visualización y la descarga se mostrará como la tabla de datos de la sección Datos del look o del Exploración.

Valores de datos

En la sección Valores de datos, elija cómo quiere que se muestren los resultados descargados:

  • Si eliges Formateado, los datos se mostrarán de forma similar a la experiencia Exploración de Looker, aunque algunos formatos de archivo no admiten todas las funciones (como la vinculación).
  • Si elige Sin formato, Looker no aplicará ningún formato especial a los resultados, como redondear números largos o añadir caracteres especiales que hayan implementado sus desarrolladores de Looker. Esta opción suele ser la más adecuada cuando los datos se envían a otra herramienta para su procesamiento.

Número de filas y columnas que se van a incluir

En esta sección, puede especificar la cantidad de datos que se incluirán en la descarga. En la mayoría de los recuadros, esta sección de la ventana emergente de descarga se llama Número de filas que se incluirán. Si la consulta del recuadro contiene alguna dimensión dinamizada, esta sección se llama Número de filas y columnas que se incluirán. Entre las opciones disponibles se incluyen las siguientes:

Consideraciones al usar la opción Todos los resultados o Personalizado

Looker comprueba tus permisos y determina si la complejidad de la consulta y el dialecto de la base de datos permitirán descargar toda la consulta. Si tienes los permisos para descargar resultados por encima de un límite determinado y Looker determina que se puede descargar toda tu consulta, la opción Todos los resultados estará disponible en la ventana Descargar.

La opción Todos los resultados suele estar inhabilitada en las consultas que:

Aunque la opción Todos los resultados esté disponible, debes tener cuidado al descargar todos los resultados. Algunas consultas son muy grandes y contienen miles o millones de filas, lo que puede sobrecargar la mayoría de los programas de hojas de cálculo o incluso tu instancia de Looker.

Si la opción Todos los resultados no está disponible, puede usar la opción Personalizado para especificar el número máximo de filas permitido con sus permisos. Si selecciona Personalizado, puede especificar el número de filas de resultados que quiere descargar. Si tu consulta contiene alguna dimensión dinamizada, también puedes especificar el número de columnas que quieres descargar.

Para administradores: habilitar la descarga de datos en tu instancia de Looker

Para usar determinadas opciones de descarga, los administradores de las implementaciones de Looker alojadas por el cliente deben haber instalado la versión adecuada del renderizador Chromium. Si tu instancia está alojada en Looker, Chromium ya está instalado.

La página de documentación Gestión de funciones de usuario empresarial contiene información importante para administradores sobre el proceso de descarga:

Para obtener más información sobre los permisos que deben asignarse a los usuarios para que puedan descargar contenido (en concreto, los permisos download_with_limit y download_without_limit), consulta la página de documentación sobre roles.