Descargando contenido

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

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

El proceso y las opciones para descargar contenido y aplicarle formato al contenido descargado varían según si realizas la descarga desde una vista o una exploración, desde un panel, desde un panel heredado o desde una consulta de resultados combinados.

Cómo descargar datos de un Look o Explorar

Para descargar datos de una página Apariencia o Explorar, haga clic en el menú de ajustes en la esquina superior derecha y seleccione Descargar.

Se abrirá una ventana Descargar en la que podrás asignarle un nombre a tu descarga y darle formato:

Las siguientes secciones te guiarán a través de cada campo en la ventana Descargar:

Formatos de archivo

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

Los datos se pueden descargar de las opciones de apariencia y exploración en los siguientes formatos:

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

Mientras eliges el formato de datos para la descarga, si no ves las opciones HTML o PNG (imagen de visualización) (para Look), consulta a tu administrador de Looker sobre la instalación de la versión adecuada del procesador de Chromium para tu instancia de Looker.

Para el formato JSON, Looker usa el campo labels como su valor procesado en su resultado JSON. Consulte el tema Cambio en el formato JSON para obtener más información sobre cómo Looker procesa los campos en formato JSON.

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

Para los desarrolladores de Looker, si usa el modo de desarrollo, las descargas de datos en la mayoría de los formatos de archivo consultan su modelo tal como está en el modo de desarrollo. Los formatos de archivo PDF y PNG son la excepción. Las descargas de datos en esos formatos siempre consultan el modelo como si estuviera en modo de producción.

Resultados

En la sección Resultados, elige si quieres aplicar la configuración de visualización a la 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 interfaz Apariencia o Explorar.

Valores

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

  • Si eliges Sin formato, Looker no aplicará ningún formato especial a los resultados de sus consultas, como redondear números largos o agregar caracteres especiales que sus desarrolladores de Looker implementaron. A menudo, esto es lo que se prefiere cuando se ingresan datos a otra herramienta para su procesamiento.
  • Si eliges Formateado, los datos se parecen más a la experiencia Explorar en Looker, aunque algunas funciones (como la vinculación) no son compatibles con todos los tipos de archivos.

Límites

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

  • Resultados en la tabla: Número de filas especificadas por el límite de filas del contenido.
  • Todos los resultados: Todos los resultados que muestra la consulta. Antes de seleccionar esta opción, consulte la sección Todos los resultados de esta página.
  • Personalizado: Es una cantidad personalizada de filas. Los usuarios con 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, a menos que tu administrador de Looker haya aumentado ese límite (consulta el tema Comunidad heredada: permite descargas ilimitadas (Looker 4.14+).

Todos los resultados

Cuando haces clic en Run en un Look o Explore, Looker verifica tus permisos y determina si la complejidad de la consulta y del dialecto de la base de datos permitirá descargar toda la consulta. Si tienes los permisos (para resultados superiores a 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 hacen lo siguiente:

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 Personalizado para especificar la cantidad máxima de filas permitidas con tus permisos.

Resultados de la consulta de transmisión

La transmisión se refiere a la capacidad de Looker para 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.

Looker transmite los resultados descargados a todos los formatos, excepto los formatos procesados (HTML, PNG).

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

  1. Cálculos de tablas: Los cálculos de tablas no se pueden transmitir. Por lo tanto, para descargar resultados ilimitados 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 si se incluyen pivotes en la consulta. Para estas bases de datos, debes quitar los elementos dinámicos a fin de descargar resultados ilimitados. Algunas bases de datos no pueden transmitir ningún resultado, lo que significa que no se pueden realizar descargas ilimitadas. A continuación, se muestra una lista de bases de datos que admiten la transmisión y una lista de bases de datos que admiten la transmisión con pivotes aplicados:

Quitar todo tipo de búsquedas

Cuando seleccionas Todos los resultados, es posible que también veas la opción Quitar todos los tipos de búsqueda. Esta opción evita que ordenes 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 base de datos.

La opción Remove all sorts from query no se admite para los resultados dinámicos.

Permitir resultados grandes

Cuando descargue un gran conjunto de resultados en Looker con Google BigQuery como dialecto de base de datos y seleccione Todos los resultados, es posible que vea 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 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 se establece en true para la consulta.
  • Se quitan las cláusulas ORDER BY en 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 de scratch con un nombre de tabla aleatorio durante una hora.

Nombre del archivo

Puede ingresar un nombre de archivo para la descarga o utilizar el nombre de archivo predeterminado que se completó previamente en el campo. Looker agregará automáticamente la extensión de archivo adecuada según su selección en el campo Formato del archivo.

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 la computadora o en 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 un PDF o como una colección de archivos CSV. Sin embargo, debes descargar todo el panel; no puedes descargar los datos de un solo mosaico que se basa en una consulta de resultados combinados.

Descarga datos de un panel

En esta sección, se describe cómo descargar paneles que usan la nueva experiencia de panel. Para obtener información sobre cómo descargar paneles heredados, consulta la sección Descarga datos desde un panel heredado.

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

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

Descarga un panel en formato PDF

Puede descargar todo su panel como un PDF, lo que significa que obtendrá una imagen en PDF del título del panel, los filtros del panel, 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.

Cuando descargas un panel como PDF, el PDF muestra la nueva experiencia del panel o un panel heredado, según el formato permanente del panel. En otras palabras, si visualizas temporalmente el panel en un formato diferente porque cambiaste la URL, las descargas reflejarán el formato permanente.

Las descargas en formato PDF siempre muestran datos del modelo como están en el 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 del menú desplegable Tamaño del papel. La opción Ajustar página al panel es la opción predeterminada, ya que ajusta el tamaño del PDF para que coincida con el diseño del panel en la pantalla. Otras opciones de tamaño de papel tienen tamaño en PDF que coincide con un tamaño de papel estándar y se ajusta al panel que contiene. Según el diseño del panel, es posible que deba cambiar el tamaño de las visualizaciones grandes o los grupos de mosaicos superpuestos para que se ajusten a un tamaño de página determinado.



    Si no ve la opción Tamaño del papel, hable con su administrador de Looker para instalar la versión más reciente del procesador de Chromium en su instancia de Looker.
  3. Si seleccionas algo que no es Ajustar página al panel en el menú desplegable Tamaño del papel, aparece la opción Orientación. Puede orientar el panel en posición vertical u horizontal.
  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 disponibles en la visualización de tablas, 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 sean visibles en la miniatura sin tener que desplazarte. Los filtros del panel y de la consulta se seguirán aplicando, al igual que los parámetros de configuración de visualización, como los límites de filas, los límites de columnas y la configuración que se hizo con la opción Limitar las filas mostradas. Si no ve la opción Expandir tablas para mostrar todas las filas, comuníquese con el administrador de Looker a fin de instalar la versión adecuada del procesador de Chromium para su instancia de Looker.
  5. Selecciona o deja selecciona 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 aparecerán como están organizados en el panel.
  6. Haga clic en Abrir en el navegador para ver una imagen del PDF en una pestaña nueva de su navegador. Desde allí, puedes optar por descargar el PDF mediante los controles del navegador.
  7. Haga clic en Cancelar si ya no desea descargar el panel.
  8. Haz clic en Descargar para iniciar la descarga. Se abrirá una nueva pestaña en su navegador que mostrará el estado de su descarga.

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

Descarga un panel como CSV

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

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

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

Looker genera archivos comprimidos mediante la codificación UTF-8. Si los caracteres de los nombres de archivo CSV aparecen confusos, es posible que exista 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 sugiere que use un extractor de archivos que reconozca UTF-8, como 7-Zip, y se asegure de que las aplicaciones de terceros estén configuradas para admitir UTF-8.

Cómo descargar datos de mosaicos de paneles

No puedes descargar los datos de los mosaicos de paneles según 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, haga clic en el ícono de tres puntos en el mosaico y seleccione Descargar:

Se abrirá un cuadro de diálogo con varias opciones similares a las opciones para Look o Explorar y para descarga de mosaicos de paneles heredados. Expande el menú Opciones avanzadas de datos para ver todas las opciones disponibles para tu descarga:

Dar formato

Los datos se pueden descargar desde los mosaicos de paneles en los siguientes formatos:

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

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

Si faltan 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 el campo labels como su valor procesado en su resultado JSON. Consulte el tema Cambio en el formato JSON para obtener más información sobre cómo Looker procesa los campos en formato JSON.

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

Las descargas en formato PNG siempre muestran 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 aplicar la configuración de visualización a la 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 interfaz Apariencia o Explorar.

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 serán más similares a los de 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 sus resultados, como redondear números largos o agregar caracteres especiales que sus desarrolladores de Looker hayan implementado. A menudo, esto es lo que se prefiere cuando se ingresan datos a otra herramienta para su procesamiento.

Número de filas y columnas que se incluirán

En esta sección, puedes especificar cuántos datos incluir en la descarga. En la mayoría de los mosaicos, esta sección de la ventana emergente de descarga se denomina Número de filas que se incluirán. Si la consulta de mosaicos contiene dimensiones dinámicas, esta sección se denomina Número de filas y columnas que se incluirán. Estas son sus opciones:

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

Looker verifica sus permisos y determina si la complejidad de la consulta y el dialecto de la base de datos permitirá descargar toda la consulta. Si tienes los permisos para descargar resultados que superen un límite establecido y si Looker determina que toda tu consulta se puede descargar, 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 hacen lo siguiente:

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 Personalizado para especificar la cantidad máxima de filas permitidas con tus permisos. Cuando seleccionas Personalizado, puedes especificar la cantidad de filas de resultados que quieres descargar. Si tu consulta contiene dimensiones dinámicas, también puedes especificar la cantidad de columnas que se descargarán.

Descarga datos de un panel heredado

En esta sección, se describen los paneles heredados. Para obtener información sobre cómo descargar paneles de control con la nueva experiencia del panel, consulte la sección Cómo descargar datos desde un panel.

Looker le permite descargar su panel heredado para que pueda almacenar o compartir los datos actuales. Puede descargar el panel de control heredado como PDF o como una colección comprimida de archivos CSV.

Descarga un panel heredado como PDF

Para descargar su panel heredado en formato PDF, siga estos pasos:

  1. Haz clic en el ícono de ajustes en la esquina superior derecha de la página.

  2. Selecciona Descargar como PDF.

    Se abrirá una ventana Descargar en la que podrás ponerle un nombre a la descarga y darle formato.

  3. De manera opcional, usa el cuadro Nombre de archivo para cambiar el nombre del archivo PDF.

  4. De manera opcional, expande el menú Opciones avanzadas para personalizar aún más tu PDF.

    Selecciona el cuadro Formato de una columna si deseas que el PDF muestre los mosaicos del panel heredados en una sola columna vertical. Deje la casilla sin seleccionar si desea que el PDF muestre los mosaicos según su disposición en el panel heredado.

    Si selecciona la opción Expandir tablas para mostrar todas las filas, en el caso de los mosaicos del panel que usen visualizaciones de tablas, el PDF mostrará todas las filas disponibles en la visualización de tablas, no solo las filas 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 tener que desplazarte. Los filtros del panel y de la consulta se seguirán aplicando, al igual que los parámetros de configuración de visualización, como los límites de filas, los límites de columnas y la configuración que se hizo con la opción Limitar las filas mostradas.

    También tienes la opción de especificar el tamaño y la orientación óptimos de tu PDF seleccionando el menú desplegable Tamaño del papel. Es posible que deba cambiar el tamaño de las visualizaciones grandes o los grupos de mosaicos superpuestos para que se ajusten correctamente a una página PDF.

    Si no ve las opciones Tamaño del papel o Expandir tablas para mostrar todas las filas, comuníquese con su administrador de Looker a fin de instalar la versión adecuada del procesador de Chromium para su instancia de Looker.

  5. Haz clic en Descargar o Abrir en el navegador.

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

Cuando descargues un panel como PDF, el PDF mostrará la nueva experiencia del panel o un panel heredado, según el formato permanente del panel. En otras palabras, si visualizas temporalmente el panel en un formato diferente porque cambiaste la URL, las descargas reflejarán el formato permanente.

Descarga un panel heredado como CSV

Para descargar un archivo CSV desde un panel de control heredado, haga clic en el ícono de ajustes en la esquina superior derecha del panel y seleccione Descargar como CSV:

El directorio comprimido tendrá un archivo CSV independiente para cada mosaico de panel. Cada archivo CSV incluye los datos con formato que se utilizan para crear el mosaico en el panel:

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

Looker genera archivos comprimidos mediante la codificación UTF-8. Si los caracteres de los nombres de archivo CSV aparecen confusos, es posible que exista 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 sugiere que use un extractor de archivos que reconozca UTF-8, como 7-Zip, y que se asegure de que las aplicaciones de terceros estén configuradas para admitir UTF-8.

Descarga datos de mosaicos heredados del panel

Para descargar los datos de un mosaico específico, haga clic en el ícono de tres puntos y seleccione Descargar datos:

La ventana de descarga de mosaicos y las opciones son similares a las de un estilo o una exploración. Consulta la sección Cómo descargar datos desde un estilo o una exploración a fin de obtener más información sobre las opciones disponibles para personalizar la descarga de datos. Si descargas Todos los resultados, no verás la opción para quitar ordenamientos de la consulta como lo harías para un estilo o una exploración.

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

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

Algunas opciones de descarga requieren que los administradores de implementaciones alojadas en el cliente de Looker 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 Administración de las funciones para usuarios empresariales contiene información importante para administradores sobre el proceso de descarga:

Para obtener más información sobre los permisos que se deben asignar a los usuarios para permitirles descargar, específicamente, los permisos download_with_limit y download_without_limit, visita la página de documentación de Funciones.

A fin de reducir el tiempo de procesamiento 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 Renderizar tablas largas.