Descargando contenido

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

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

El proceso, las opciones para descargar contenido y el formato del contenido descargado varían en función de si las descargas desde una vista o una exploración, desde un panel o desde una consulta de resultados combinados.

Cómo descargar datos de una vista o una exploración

Para descargar datos de una vista o página de Explorar, selecciona el menú de ajustes en la esquina superior derecha y, luego, Descargar.

Looker mostrará la ventana Descarga, en la que puedes asignarle un nombre y formato a tu descarga.

En las siguientes secciones, se te guiará por cada campo de la ventana Download:

Formato

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

Los datos se pueden descargar de las vistas y las exploraciones en los siguientes formatos de archivo:

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

Cuando eliges el formato de datos para descargar, si no ves las opciones HTML o PNG (imagen de visualización) (para vistas), habla con el administrador de Looker sobre cómo instalar la versión adecuada del procesador de Chromium para tu instancia de Looker.

En el formato JSON, Looker usa etiquetas de campo como su valor renderizado en su resultado en JSON. Consulta la publicación de Comunidad Cambio en el formato JSON para obtener más información sobre cómo Looker renderiza campos en formato JSON.

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

Para los desarrolladores de Looker, si estás en Modo de desarrollo, los datos descargados en la mayoría de los formatos de archivo consultan tu modelo mientras se encuentra en Modo de desarrollo. Los formatos de archivo PDF y PNG son la excepción; las descargas de datos en esos formatos de archivo siempre consultan tu modelo como si estuviera en modo de producción.

Nombre del archivo

Puedes ingresar un nombre de archivo para la descarga o usar el nombre de archivo predeterminado que se prepropaga en el campo. Looker agregará automáticamente la extensión de archivo adecuada según tu selección en el campo Formato.

Resultados

En la sección Resultados, elige si quieres que la configuración de visualización se aplique a la descarga de datos en formato TXT, Excel, CSV, JSON, HTML o Markdown.

Si eliges Con opciones de visualización aplicadas, Looker aplicará algunos de los parámetros de configuración de visualización a tu descarga. Cualquiera de los siguientes parámetros de configuración de los menús Trama, Serie y Formato que estén configurados para la visualización se aplicará a la descarga de datos:

El formato condicional se mostrará en las entregas de Excel de vistas y exploraciones con visualizaciones de gráficos de tablas solo si se aplica la Regla A lo largo de una escala.

Algunos parámetros de configuración de visualización no se aplican a los resultados descargados. Por ejemplo:

  • El color de texto y de fondo personalizados del encabezado no se aplican a los resultados descargados, excepto los archivos PNG.
  • Para las tablas de resultados con tablas dinámicas y múltiples medidas, cada valor dinámico se repite en columnas en lugar de representarse como una sola columna combinada. Las descargas de HTML y PNG son una excepción, por lo que se conserva la columna combinada.
  • Cuando descargas contenido de un panel, el título del mosaico del panel no se incluye en los resultados descargados.
  • Los valores Totales y Totales de fila se incluyen en los resultados descargados, pero las filas y columnas respectivas no están etiquetadas.
  • Los subtotales no se descargarán para las consultas que no se pueden transmitir.

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

Si eliges Tal como se muestra en la tabla de datos, no se aplicarán las opciones de visualización y la descarga aparecerá como la tabla de datos en la sección Datos de la vista o exploración.

Valores de datos

En la sección Valores de datos, elige cómo deseas que aparezcan los resultados de la consulta descargados:

  • Si eliges Sin formato, Looker no aplicará ningún formato especial de los resultados de las consultas, como redondear los números largos o agregar caracteres especiales que los desarrolladores de Looker podrían haber establecido. Por lo general, esto es lo que se prefiere cuando los datos se ingresan a otra herramienta para su procesamiento.
  • Si eliges Con formato, el aspecto de los datos será similar a la experiencia de Explorar en Looker, aunque algunas funciones (como los vínculos) no son compatibles con todos los tipos de archivos. Por ejemplo, cualquier formato que se aplique con el parámetro html no se aplicará a las descargas de archivos TXT, CSV, Excel ni JSON.

Cantidad de filas y columnas que se incluirán

Puedes elegir la cantidad de datos que deseas descargar de la siguiente manera:

  • Tabla de resultados actual: Se refiere a la cantidad de filas especificadas por el límite de filas de tu contenido.
  • Todos los resultados: Todos los resultados que muestra la consulta. Antes de seleccionar esta opción, consulta la sección Todos los resultados en esta página.
  • Personalizada: Una cantidad personalizada de filas. Los usuarios que tienen permisos download_with_limit tienen un límite de 5,000 filas. Por lo general, el límite para otros usuarios es de 100,000.

Todos los resultados

Cuando seleccionas Ejecutar en una vista o exploración, Looker verifica tus permisos y determina si la complejidad de la consulta y el dialecto de la base de datos permitirán que se descargue la consulta completa. Si tienes los permisos (para los resultados que superan un límite establecido) y si Looker determina que se puede descargar toda tu consulta, la opción Todos los resultados estará disponible en la ventana Descargar.

Por lo general, la opción Todos los resultados está inhabilitada para las consultas que realizan alguna de las siguientes acciones:

Incluso si 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, puedes usar la opción Personalizados para especificar el número máximo de filas permitidas con tus permisos.

Transmite los resultados de las consultas

La transmisión hace referencia a la capacidad de Looker de procesar datos en fragmentos, en lugar de hacerlo todos a la vez. Si Looker puede transmitir un conjunto de resultados, es posible realizar descargas ilimitadas. La opción Todos los resultados se basa en la capacidad de Looker de transmitir resultados. Todos los resultados no estará disponible si no es posible transmitir resultados.

Looker transmite los resultados descargados en todos los formatos, excepto los renderizados (HTML, PNG).

Además de las limitaciones de formato, existen dos casos en los que no es posible transmitir:

  1. Cálculos basados en tablas: No se pueden transmitir los cálculos basados en tablas. Por lo tanto, si quieres descargar una cantidad ilimitada de resultados para una consulta, debes quitar los cálculos basados en tablas de la consulta.
  2. Limitaciones de la base de datos: Algunas bases de datos no pueden transmitir si se incluyen tablas dinámicas en la consulta. Para estas bases de datos, debes quitar las tablas dinámicas para descargar resultados ilimitados. Algunas bases de datos no pueden transmitir ningún resultado, lo que significa que no es posible realizar descargas ilimitadas.

Estas bases de datos admiten la transmisión:

Dialecto ¿Es compatible?
Avalancha de Actian
Sí
Amazon Athena
Sí
Amazon Aurora MySQL
Sí
Amazon Redshift
Sí
Apache Druid
No
Apache Druid 0.13 y versiones posteriores
No
Apache Drued 0.18 y versiones posteriores
No
Apache Hive 2.3 o versiones posteriores
Sí
Apache Hive 3.1.2 o versiones posteriores
Sí
Apache Spark 3 y versiones posteriores
Sí
ClickHouse
Sí
Cloudera Impala 3.1 y versiones posteriores
Sí
Cloudera Impala 3.1+ con Native Drive
Sí
Cloudera Impala con Native Driver
Sí
DataVirtuality
Sí
Databricks
Sí
Denodo 7
Sí
Denodo 8
Sí
Dremio
Sí
Dremio 11 y versiones posteriores
Sí
Exasol
Sí
Rayo de fuego
Sí
SQL heredado de Google BigQuery
Sí
SQL estándar de Google BigQuery
Sí
Google Cloud PostgreSQL
Sí
Google Cloud SQL
Sí
Google Spanner
No
Ciruela verde
Sí
HyperSQL
No
IBM Netezza
No
MariaDB
Sí
Microsoft Azure PostgreSQL
Sí
Base de datos de Microsoft Azure SQL
Sí
Microsoft Azure Synapse Analytics
Sí
Microsoft SQL Server 2008 y versiones posteriores
Sí
Microsoft SQL Server 2012 y versiones posteriores
Sí
Microsoft SQL Server 2016
Sí
Microsoft SQL Server 2017 y versiones posteriores
Sí
MongoBI
Sí
MySQL
Sí
MySQL 8.0.12 o versiones posteriores
Sí
Oracle
Sí
ADWC de Oracle
Sí
PostgreSQL 9.5 y versiones posteriores
Sí
PostgreSQL anterior a la 9.5
Sí
PrestoDB
Sí
PrestoSQL
Sí
SAP HANA 2 y versiones posteriores
No
SingleStore
Sí
SingleStore 7+
Sí
Snowflake
Sí
Teradata
Sí
Trino
Sí
Vector
Sí
Vertica
Sí

Estas son las bases de datos que admiten la transmisión con tablas dinámicas aplicadas:

Dialecto ¿Es compatible?
Avalancha de Actian
Sí
Amazon Athena
Sí
Amazon Aurora MySQL
No
Amazon Redshift
Sí
Apache Druid
No
Apache Druid 0.13 y versiones posteriores
No
Apache Drued 0.18 y versiones posteriores
No
Apache Hive 2.3 o versiones posteriores
No
Apache Hive 3.1.2 o versiones posteriores
No
Apache Spark 3 y versiones posteriores
Sí
ClickHouse
No
Cloudera Impala 3.1 y versiones posteriores
Sí
Cloudera Impala 3.1+ con Native Drive
Sí
Cloudera Impala con Native Driver
Sí
DataVirtuality
No
Databricks
Sí
Denodo 7
No
Denodo 8
No
Dremio
No
Dremio 11 y versiones posteriores
No
Exasol
Sí
Rayo de fuego
Sí
SQL heredado de Google BigQuery
Sí
SQL estándar de Google BigQuery
Sí
Google Cloud PostgreSQL
Sí
Google Cloud SQL
No
Google Spanner
No
Ciruela verde
Sí
HyperSQL
No
IBM Netezza
Sí
MariaDB
No
Microsoft Azure PostgreSQL
Sí
Base de datos de Microsoft Azure SQL
Sí
Microsoft Azure Synapse Analytics
Sí
Microsoft SQL Server 2008 y versiones posteriores
Sí
Microsoft SQL Server 2012 y versiones posteriores
Sí
Microsoft SQL Server 2016
Sí
Microsoft SQL Server 2017 y versiones posteriores
Sí
MongoBI
No
MySQL
No
MySQL 8.0.12 o versiones posteriores
No
Oracle
Sí
ADWC de Oracle
Sí
PostgreSQL 9.5 y versiones posteriores
Sí
PostgreSQL anterior a la 9.5
Sí
PrestoDB
Sí
PrestoSQL
Sí
SAP HANA 2 y versiones posteriores
No
SingleStore
Sí
SingleStore 7+
Sí
Snowflake
Sí
Teradata
Sí
Trino
Sí
Vector
Sí
Vertica
Sí

Quitar todos los tipos de ordenamientos de la consulta

Si seleccionas Todos los resultados, es posible que también veas la opción Quitar todos los tipos de orden de la consulta. Esta opción evita que se ordene la consulta antes de descargar los resultados. Seleccionar esta opción puede acelerar tu descarga, ya que ordenar una consulta puede ser costoso para el rendimiento para ciertos tipos de bases de datos.

La opción Quitar todos los ordenamientos de la consulta no es compatible con los resultados dinámicos.

Permitir resultados grandes

Cuando descargues un conjunto de resultados grande en Looker mediante Google BigQuery como el dialecto de tu base de datos y seleccionas Todos los resultados, es posible 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 la consulta, como se describe en el tema de la documentación de Google Cloud Escribe los resultados de la consulta. Para descargar resultados que superen el tamaño máximo de respuesta de BigQuery, Looker debe realizar un proceso diferente.

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

  • La opción allowLargeResults de BigQuery está configurada en true para la consulta.
  • Se quitan 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 temporal bajo un nombre de tabla aleatorio durante una hora.

Descargar o abrir en el navegador

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

Descarga datos de una consulta de resultados combinados

Para descargar consultas de resultados combinados, puedes guardar la consulta en un panel y, luego, descargar el panel como PDF o como una colección de archivos CSV. Sin embargo, debes descargar el panel completo; no puedes descargar los datos de un solo mosaico que se basa en una consulta de resultados combinados.

Descarga de datos de un panel

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

Se abrirá un cuadro de diálogo que te permitirá seleccionar PDF o CSV como el formato de descarga.

Descargando un panel como PDF

Es posible que las descargas de PDF no coincidan exactamente con el diseño o el tamaño del panel, como se ve en Looker.

Puede descargar todo su panel como PDF, lo que significa que obtendrá un PDF que muestra el título del panel, los filtros del panel, algunos o todos los mosaicos del panel y la zona horaria en la que se ejecutó. El PDF también incluirá una marca de tiempo que muestra cuándo se descargó el panel.

Las descargas en formato PDF siempre muestran los datos del modelo como están en Modo de producción, incluso si estás en Modo de desarrollo.

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

  1. Selecciona PDF en el menú desplegable Formato.

  2. Seleccione una opción del menú desplegable Tamaño del papel:

    La opción Ajustar página al panel es la predeterminada, ya que ajusta el tamaño del PDF al ancho predeterminado de los paneles (1260 px). Otras opciones de tamaño de papel pueden dimensionar el PDF para que coincida con un tamaño de papel estándar y caber todo el panel o parte de él. Según el diseño del panel y el tamaño de papel seleccionado, algunos resultados de PDF pueden diferir del diseño del panel cuando se visualizan en Looker. Por ejemplo, cuando el tamaño de papel seleccionado es más estrecho que el del panel, es posible que tengas problemas con el espaciado o con otro formato, y tengas que hacer algunos ajustes:

    • Es posible que sea necesario cambiar el tamaño de las visualizaciones grandes o los grupos de mosaicos superpuestos para que entren en el PDF.
    • Es posible que los mosaicos que contienen tablas no muestren todas las columnas de las tablas en el PDF.
    • Es posible que los mosaicos se reduzcan para que se ajusten al PDF. Del mismo modo, es posible que las tarjetas que requieren desplazamiento en la app de Looker no se expandan para mostrar todo el contenido.

    Si no ves la opción Tamaño del papel, habla con tu administrador de Looker sobre cómo instalar la versión más reciente del procesador de Chromium para tu instancia de Looker.

  3. Si seleccionas otro elemento que no sea Ajustar página al panel en el menú desplegable Tamaño del papel, aparecerá la opción Orientación. Puedes elegir orientar el panel en posición horizontal o vertical.

  4. Selecciona o deja sin seleccionar Expandir tablas para mostrar todas las filas. Si seleccionas esta opción, para los mosaicos de los paneles que usan visualizaciones de tablas, el PDF mostrará todas las filas que están disponibles en la visualización de tablas, no solo las filas que son visibles en la miniatura del mosaico del panel. Si no seleccionas esta opción, solo aparecerán en el PDF las filas que sean visibles en la miniatura sin necesidad de desplazarse. Se seguirán aplicando los filtros del panel y de la consulta, al igual que la configuración de visualización, como los límites de filas, los límites de columnas y la configuración que se realiza con la opción Limitar las filas que se muestran.

    Si la opción Expandir tablas para mostrar todas las filas está seleccionada, los mosaicos del panel que contienen visualizaciones de tablas pueden verse un poco diferentes en los PDF descargados que en Looker. Las siguientes diferencias pueden notarse en el PDF:

    • Las personalizaciones de los colores de fondo y los tamaños de fuente se quitan de los encabezados de columna y de las filas de subtotal.
    • Si no se establece un tema personalizado, las tablas aparecerán en el tema blanco. De lo contrario, el tema personalizado se aplicará cuando se descargue.
    • El ícono de ordenar no aparece en las tablas dinámicas que no se ordenaron manualmente.
    • Las tablas con la opción Ajustar el tamaño de las columnas para ajustar se extienden hasta el ancho completo del mosaico.

    Además, en las tablas con más de 20,000 celdas, se pueden observar las siguientes diferencias en el PDF:

    Si no ves la opción Expandir tablas para mostrar todas las filas, pídele a tu administrador de Looker que instale la versión adecuada del procesador de Chromium para tu instancia de Looker.

  5. Selecciona o deja sin seleccionar la opción Organizar los mosaicos del panel en una sola columna. Si seleccionas esta opción, el PDF mostrará los mosaicos del panel en una sola columna vertical. Si no seleccionas esta opción, los mosaicos del panel aparecerán tal como se organizan en el panel.

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

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

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

Si el administrador de Looker habilitó la función de Labs para renderizar tablas largas y está seleccionada la opción Expandir tablas para mostrar todas las filas, los mosaicos que contienen visualizaciones de tablas pueden verse un poco diferentes en los PDF descargados que en Looker. Para obtener más información sobre las diferencias, visita la página de documentación de Labs.

Descargando un panel como archivos CSV

Puedes descargar todos los mosaicos de consultas desde tu panel como una colección comprimida de archivos CSV. Los mosaicos de texto no se incluyen en el archivo ZIP. Para descargar tu panel como una colección de archivos CSV, sigue estos pasos:

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

Cuando descargas un panel como archivos CSV, no están disponibles las opciones para dar formato a las descargas, como la configuración de límites de filas personalizados o la elección de todos los resultados. Los límites de filas en los archivos descargados se correlacionan con los límites de filas de los mosaicos correspondientes.

Looker genera archivos comprimidos con codificación UTF-8. Si los caracteres de los nombres de tus archivos CSV parecen ilegibles, es posible 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 una aplicación de terceros. Looker sugiere que uses 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.

Descarga de datos de los mosaicos del panel

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

Para descargar los datos de un mosaico del panel, selecciona el ícono de tres puntos en el mosaico y elige Descargar datos:

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

Formato

Los datos pueden descargarse de mosaicos de panel en los siguientes formatos:

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

Según el formato que selecciones, es posible que algunas opciones del menú Opciones de datos avanzados no estén disponibles.

Si faltan las opciones de HTML o PNG (imagen de visualización), comunícate con el administrador de Looker para instalar la versión adecuada del Procesador de Chromium para tu instancia de Looker.

En el formato JSON, Looker usa etiquetas de campo como su valor renderizado en su resultado en JSON. Consulta la publicación de Comunidad Cambio en el formato JSON para obtener más información sobre cómo Looker renderiza campos en formato JSON.

Las visualizaciones de tablas transpuestas solo se renderizarán en descargas de PDF y PNG.

Las descargas en formato PNG siempre devuelven los datos del modelo como están en el Modo de producción, incluso si estás en Modo de desarrollo.

Resultados

En la sección Resultados, elige si quieres que la configuración de visualización se aplique a la descarga de datos:

Si eliges Tal como se muestra en la tabla de datos, no se aplicarán las opciones de visualización y la descarga aparecerá como la tabla de datos en la sección Datos de la vista o exploración.

Valores de datos

En la sección Valores de datos, elige cómo quieres que aparezcan los resultados descargados:

  • Si eliges Con formato, los datos se parecerán más a la experiencia de Explorar en Looker, aunque algunas funciones (como los vínculos) no son compatibles con todos los formatos de archivo.
  • Si eliges Sin formato, Looker no aplicará ningún formato especial de tus resultados, como redondear los números largos o agregar caracteres especiales que los desarrolladores de Looker podrían haber establecido. Por lo general, esto es lo que se prefiere cuando los datos se ingresan a otra herramienta para su procesamiento.

Cantidad de filas y columnas que se incluirán

En esta sección, puedes especificar la cantidad de datos que se incluyen en tu descarga. En la mayoría de los mosaicos, esta sección de la ventana emergente de descarga se llama Number of rows to include. Si la consulta de mosaicos contiene dimensiones dinámicas, esta sección se llama Number of rows and columns to include. Sus opciones incluyen:

Consideraciones para tener en cuenta al utilizar las opciones Todos los resultados o Personalizado

Looker verifica tus permisos y determina si la complejidad de la consulta y el dialecto de la base de datos permitirán que se descargue toda la consulta. Si tienes permisos para descargar los resultados que superen un límite establecido y si 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 para las consultas que tienen las siguientes características:

Incluso cuando 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, puedes usar la opción Personalizados para especificar el número máximo de filas permitidas con tus permisos. Cuando seleccionas Personalizado, puedes especificar una cantidad de filas de resultados para descargar. Si tu consulta contiene dimensiones dinámicas, también puedes especificar la cantidad de columnas para descargar.

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

Algunas opciones de descarga requieren que los administradores de las implementaciones de Looker alojadas por el cliente tengan instalada la versión adecuada del procesador de Chromium. Si tu instancia está alojada en Looker, Chromium ya está instalado.

La página de documentación Cómo administrar las funciones del usuario empresarial incluye información importante de administrador sobre el proceso de descarga:

Si quieres obtener más información sobre los permisos que se deben asignar a los usuarios para permitirles descargar contenido (específicamente, los permisos download_with_limit y download_without_limit), consulta la página de documentación Roles.

Para reducir el tiempo de renderización de las descargas de PDF en los paneles que contienen visualizaciones de tablas con muchas filas, los administradores de Looker pueden habilitar la función de labs Render Long Tables.