Descargando contenido

En esta página, se describe la descarga de contenido (visualizaciones o datos) desde Looker.

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

El proceso y las opciones para descargar contenido y darle formato al contenido descargado varían en función de si lo 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 Explorar, selecciona el menú de ajustes en la esquina superior derecha y selecciona Descargar.

Looker muestra la ventana Download, en la que puedes asignar un nombre a tu descarga y aplicarle formato.

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

Formato

Las descargas en formatos que usan el renderizador (PNG y PDF) usarán los resultados del Modo de producción. Si la descarga tiene otro formato, esta mostrará los resultados del modo en que se encuentre (desarrollo o producción).

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

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

Mientras eliges el formato de datos para descargarlo, si no ves las opciones (para Vistas) HTML o PNG (imagen de visualización), comunícate con tu administrador de Looker para instalar la versión adecuada del procesador de Chromium para tu instancia de Looker.

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

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

En el caso de los desarrolladores de Looker, si están en Modo de desarrollo, los datos descargados en la mayoría de los formatos de archivo consultan tu modelo, ya que está 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 predeterminado que aparece prepropagado 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 se aplique la configuración de visualización a tu descarga de datos en TXT, Excel, CSV, JSON, HTML o Markdown.

Si eliges Con las 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 se hayan definido para la visualización se aplicará a la descarga de datos:

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

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

  • El color de texto del encabezado personalizado y el color de fondo no se aplican a los resultados descargados, excepto a los archivos PNG.
  • Para las tablas de resultados con tablas dinámicas y mediciones múltiples, cada valor de tabla dinámica se repite en columnas en lugar de representarse como una columna combinada. Las descargas HTML y PNG son una excepción, por lo que se conserva la columna combinada.
  • Cuando descargas desde un panel, el título del mosaico del panel no se incluye en los resultados descargados.
  • Los valores Totales y Totales de filas se incluyen en los resultados descargados, pero las filas y columnas correspondientes no están etiquetadas.
  • No se descargarán los subtotales 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 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 de las consultas descargadas:

  • Si eliges Sin formato, Looker no aplicará ningún formato especial a los resultados de la consulta, como redondear números largos o agregar caracteres especiales que los desarrolladores de Looker hayan 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, la apariencia de los datos será similar a la experiencia Explorar en Looker, aunque algunas funciones (como la vinculación) no son compatibles con todos los tipos de archivos. Por ejemplo, el formato que se aplique con el parámetro html no se aplicará a las descargas de TXT, CSV, Excel o JSON.

Cantidad de filas y columnas que se incluirán

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

  • Tabla de resultados actual: Es 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 de esta página.
  • Personalizada: Es una cantidad personalizada de filas. Los usuarios con permisos de 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 toda la consulta. Si tienes los permisos (para resultados que superan un límite establecido) y si Looker determina que se puede descargar la consulta completa, 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 cuando descargues todos los resultados. Algunas consultas son muy grandes y contienen miles o millones de filas, lo que puede abrumar 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 Personalizado para especificar la cantidad máxima de filas que se permiten con tus permisos.

Transmisión de los resultados de la consulta

Transmisión se refiere a la capacidad de Looker para procesar datos en fragmentos, en lugar de todos a la vez. Si Looker puede transmitir un conjunto de resultados, entonces, hay descargas ilimitadas. La opción Todos los resultados se basa en la capacidad de Looker para transmitir los resultados, y la opción Todos los resultados no estará disponible si no es posible transmitir los resultados.

Además de las limitaciones de formato, hay dos casos en los que la transmisión no es posible:

  1. Cálculos basados en tablas: No se pueden transmitir los cálculos basados en tablas. Por lo tanto, si quieres descargar resultados ilimitados 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 las tablas dinámicas se incluyen en la consulta. Para estas bases de datos, debes quitar los pivotes 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 transmisiones:

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 Druid 0.18 y versiones posteriores
No
Apache Hive 2.3 y versiones posteriores
Sí
Apache Hive 3.1.2 y 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 controlador nativo
Sí
Cloudera Impala con controlador nativo
Sí
DataVirtuality
Sí
Databricks
Sí
Denodo 7
Sí
Denodo 8
Sí
Dremio
Sí
Dremio 11 y versiones posteriores
Sí
Exasol
Sí
Bola de fuego
Sí
SQL heredado de Google BigQuery
Sí
SQL estándar de Google BigQuery
Sí
PostgreSQL en Google Cloud
Sí
Google Cloud SQL
Sí
Google Spanner
No
Greenplum
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 y versiones posteriores
Sí
Oracle
Sí
Oracle ADWC
Sí
PostgreSQL 9.5 y versiones posteriores
Sí
PostgreSQL anterior a 9.5
Sí
PrestoDB
Sí
PrestoSQL
Sí
SAP HANA 2 y versiones posteriores
No
SingleStore
Sí
SingleStore 7 y versiones posteriores
Sí
Snowflake
Sí
Teradata
Sí
Trino
Sí
Vector
Sí
Vertica
Sí

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

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 Druid 0.18 y versiones posteriores
No
Apache Hive 2.3 y versiones posteriores
No
Apache Hive 3.1.2 y 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 controlador nativo
Sí
Cloudera Impala con controlador nativo
Sí
DataVirtuality
No
Databricks
Sí
Denodo 7
No
Denodo 8
No
Dremio
No
Dremio 11 y versiones posteriores
No
Exasol
Sí
Bola de fuego
Sí
SQL heredado de Google BigQuery
Sí
SQL estándar de Google BigQuery
Sí
PostgreSQL en Google Cloud
Sí
Google Cloud SQL
No
Google Spanner
No
Greenplum
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 y versiones posteriores
No
Oracle
Sí
Oracle ADWC
Sí
PostgreSQL 9.5 y versiones posteriores
Sí
PostgreSQL anterior a 9.5
Sí
PrestoDB
Sí
PrestoSQL
Sí
SAP HANA 2 y versiones posteriores
No
SingleStore
Sí
SingleStore 7 y versiones posteriores
Sí
Snowflake
Sí
Teradata
Sí
Trino
Sí
Vector
Sí
Vertica
Sí

Quitar todos los tipos de ordenamientos de la consulta

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

La opción Remove all ordens from query no es compatible con los resultados dinámicos.

Permitir resultados grandes

Cuando descargues un conjunto de resultados grande en Looker con Google BigQuery como dialecto de tu base de datos y selecciones 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 las consultas, como se describe en el tema de la documentación de Google Cloud Cómo escribir resultados de consultas. 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

Luego de seleccionar las opciones, puedes seleccionar el botón Descargar para descargar un archivo en tu computadora o 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 base en una consulta de resultados combinados.

Descarga 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 en el que podrás seleccionar PDF o CSV como el formato de descarga.

Cómo descargar un panel como PDF

Puedes descargar todo el panel como PDF, lo que significa que obtendrás 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 panel. El PDF también incluirá una marca de tiempo que muestra cuándo se descargó el panel.

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

Para descargar un panel 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 es la opción predeterminada. Cambia el tamaño del PDF al ancho predeterminado de los paneles (1260 px). Otras opciones de tamaño de papel tienen el tamaño del PDF para que coincida con un tamaño de papel estándar y se adapten a todo o parte del panel dentro de él. Según el diseño del panel y el tamaño del papel seleccionado, algunos resultados en PDF pueden diferir del diseño del panel cuando se visualizan en Looker. Por ejemplo, si el tamaño del papel seleccionado es más angosto que el panel, es posible que haya problemas con el espaciado u otro formato y que debas realizar algunos ajustes:

    • Puede que sea necesario cambiar el tamaño de las grandes visualizaciones o los grupos de mosaicos superpuestos para que se ajusten al PDF.
    • Es posible que los mosaicos que contienen tablas no muestren todas las columnas de la tabla en el PDF.
    • Es posible que el ancho de los mosaicos se reduzca para que se ajuste al PDF. Del mismo modo, es posible que los mosaicos 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 un elemento distinto de Ajustar página al panel en el menú desplegable Tamaño del papel, aparecerá la opción Orientación. Puedes optar por 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 del panel que usan visualizaciones de tabla, el PDF mostrará todas las filas que están disponibles en la visualización de la tabla, no solo las filas que están visibles en la miniatura del mosaico del panel. Si no seleccionas esta opción, solo aparecerán en el PDF las filas que se vean en la miniatura sin necesidad de desplazarse. Se seguirán aplicando los filtros del panel y de las consultas, al igual que la configuración de visualización, como los límites de filas y los límites de columnas, y los parámetros que se realizan con la opción Limitar filas que se muestran.

    Si se selecciona la opción Expand Tables to Show All Rows, los mosaicos del panel que contienen visualizaciones de tablas pueden verse un poco diferentes en los PDF descargados que en Looker. Es posible que se noten las siguientes diferencias en el PDF:

    • Las personalizaciones de colores de fondo y tamaños de fuente se quitan de los encabezados de columna y de las filas de subtotales.
    • Si no se configura ningún 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 se extienden a todo el ancho del mosaico.

    Además, en el caso de las tablas con más de 20,000 celdas, es posible que se noten las siguientes diferencias en el PDF:

    Si no ves la opción Expande las tablas para mostrar todas las filas, habla con tu administrador de Looker sobre cómo instalar 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 y como están organizados 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 nueva pestaña en tu navegador que mostrará el estado de tu descarga.

Descarga un panel como archivos CSV

Puedes descargar todos los mosaicos de consultas de tu panel como una colección comprimida de archivos CSV. El archivo ZIP no incluye mosaicos de texto. 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 tu colección de CSV comprimida.

Cuando descargas un panel como archivos CSV, no están disponibles las opciones para formatear las descargas, como establecer límites de filas personalizados o elegir todos los resultados. Los límites de filas de los archivos descargados se correlacionan con los límites de filas en los mosaicos correspondientes.

Looker genera archivos comprimidos con la codificación UTF-8. Si los caracteres de los nombres de tus archivos CSV parecen ilegibles, puede haber 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 usar un extractor de archivos que reconozca UTF-8, como 7-Zip, y asegurarse de que las aplicaciones de terceros estén configuradas para admitir UTF-8.

Descarga datos de mosaicos de paneles

No puedes descargar los datos de los mosaicos del panel en función de 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, seleccione el ícono de tres puntos del mosaico y, luego, Descargar datos:

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

Formato

Los datos se pueden descargar de los mosaicos del panel en los siguientes formatos:

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

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

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

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

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

Las descargas en formato PNG siempre muestran datos del modelo tal como se encuentran en Modo de producción, incluso si estás en Modo de desarrollo.

Resultados

En la sección Resultados, elija si desea que se aplique la configuración de visualización a su descarga de datos:

Si eliges 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 verán más similares a la experiencia Explorar en Looker, aunque algunas funciones (como la vinculación) no son compatibles con todos los formatos de archivo.
  • Si eliges Sin formato, Looker no aplicará ningún formato especial a tus resultados, como redondear números largos o agregar caracteres especiales que los desarrolladores de Looker hayan 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 cuántos datos se incluyen en la descarga. En la mayoría de los mosaicos, esta sección de la ventana emergente de descarga se denomina Number of rows to include. Si la consulta de mosaicos contiene alguna dimensión dinámica, esta sección se denomina Number of rows and columns to include. Sus opciones son las siguientes:

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

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 los permisos para descargar los resultados que superen un límite establecido y si Looker determina que se puede descargar la consulta completa, 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:

Incluso si la opción Todos los resultados está disponible, debes tener cuidado cuando descargues todos los resultados. Algunas consultas son muy grandes y contienen miles o millones de filas, lo que puede abrumar 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 Personalizado para especificar la cantidad máxima 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 una 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 clientes hayan instalado 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 de los usuarios empresariales contiene información importante para administradores sobre el proceso de descarga:

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

Para reducir el tiempo de renderización de las descargas de PDF para paneles que contienen visualizaciones de tablas con muchas filas, los administradores de Looker pueden habilitar la función de Labs de Renderizar tablas largas.