Usa Hojas conectadas para Looker

Hojas conectadas para Looker permite a los usuarios explorar de forma interactiva los datos de los modelos de LookML a través de la conocida interfaz de hoja de cálculo de Hojas de cálculo de Google. Los usuarios de Hojas de cálculo tendrán acceso a los datos administrados de más de 50 bases de datos compatibles con Looker. La exploración es intuitiva, ya que Hojas conectadas presenta una vista organizada del modelo con vistas, campos y mediciones tal como se definieron en Looker. Los datos de Looker a través de Hojas conectadas pueden usarse en construcciones estándar de Hojas de cálculo, como tablas dinámicas, gráficos y fórmulas, lo que permite la flexibilidad de análisis mediante construcciones familiares.

Habilitando Hojas conectadas

Sigue estos pasos para usar Hojas conectadas:

  • En Looker (versión original), el administrador de Looker debe habilitar los conectores de IE de Looker o el botón de activación Hojas conectadas en el panel Conectores de IE en la sección Plataforma del menú Administrador de Looker. En Looker (Google Cloud Core), estas opciones están habilitadas de forma predeterminada.
  • Tu instancia de Looker debe estar alojada en Looker.
  • Tu instancia de Looker debe ejecutar Looker 22.20 o una versión posterior si está alojada en Google Cloud. Si tu instancia de Looker no está alojada en Google Cloud, debe ejecutar Looker 23.4 o una versión posterior.
  • Cada usuario que quiera conectarse a tu instancia de Looker desde Hojas de cálculo de Google debe usar la misma dirección de correo electrónico en su cuenta de usuario de Looker que en su cuenta de Google Workspace. Si las direcciones de correo electrónico de sus cuentas de Google Workspace y Looker son diferentes, recibirán un error cuando intenten conectarse a Looker desde Hojas de cálculo.
  • El acceso a los servicios que no se controlan de forma individual debe activarse en la Consola del administrador de Google Workspace. Esta opción suele estar habilitada de forma predeterminada. Para obtener más información, consulta el artículo de ayuda Administra el acceso a los servicios que no se controlan de forma individual.

Conéctate a Looker desde Hojas de cálculo de Google

  1. En el menú Datos de Hojas de cálculo de Google, selecciona Conectores de datos y, luego, Conectar a Looker.

  2. En el diálogo Conectar a Looker, ingresa el nombre de tu instancia de Looker o selecciona el nombre de una instancia a la que te conectaste recientemente y selecciona Continuar.

  3. En los siguientes diálogos, selecciona el model de Looker y la opción Explorar que quieres usar para tu consulta y, luego, elige Conectar.

Cuando Hojas de cálculo se conecte a tu instancia de Looker, Hojas de cálculo abrirá una hoja nueva que mostrará la estructura de la exploración seleccionada, incluidas las vistas, las dimensiones, las mediciones y las descripciones de campos que haya agregado tu desarrollador de Looker.

Crea consultas de Looker con Hojas de cálculo de Google

Las consultas de Looker se crean con una tabla dinámica de Hojas de cálculo. Para agregar datos de Looker a tu hoja, sigue estos pasos:

  1. En la hoja que muestra la función Explorar, selecciona Tabla dinámica.

  2. Selecciona si deseas insertar una nueva tabla dinámica en una hoja nueva o en una hoja existente y selecciona Crear.

    Se creará una tabla dinámica nueva y vacía, y se abrirá la ventana Editor de tabla dinámica. Puedes agregar filas, columnas, valores y filtros para crear tu consulta en función de las dimensiones y mediciones de tu exploración de Looker.

    Las filas, columnas, valores y filtros del editor de elementos dinámicos son equivalentes a tus dimensiones y mediciones de Looker de las siguientes maneras:

    • Las filas son equivalentes a las dimensiones de Looker.
    • Las columnas son equivalentes a las dimensiones dinámicas de Looker.
    • Los valores son equivalentes a las medidas de Looker. Para crear una medición personalizada, selecciona una dimensión de Looker y una función Resumir por de Hojas de cálculo.
    • Los filtros son equivalentes a los filtros de Looker.

    El editor de tabla dinámica también muestra una lista de las vistas que forman parte de Explorar, que puedes seleccionar para mostrar las dimensiones y mediciones que se incluyen en esa vista.

  3. Selecciona Agregar para agregar una fila, columna, valor o filtro. Las Hojas conectadas muestran una lista de las vistas que están disponibles en Explorar. Selecciona un nombre de vista para mostrar la lista de dimensiones y mediciones en ella y, luego, selecciona el campo que proporciona los datos para tu fila, columna, valor o filtro.

  4. Una vez que hayas agregado los campos y filtros de Looker para crear tu consulta, selecciona Aplicar. Esto propagará tu hoja con los datos de tu instancia de Looker.

Una vez que hayas agregado tus datos de Looker a una tabla dinámica, podrás usar Hojas de cálculo de Google para dar formato a tus datos o crear nuevas fórmulas de Hojas de cálculo basadas en tus datos de Looker.

Opciones de filtros

Desde el lanzamiento inicial de Hojas conectadas para Looker, se han agregado nuevas opciones de filtrado.

Filtrar por valor (agregado en agosto de 2023)

Es posible filtrar las dimensiones de Looker en Hojas conectadas para las tablas dinámicas de Looker viendo una lista de valores y seleccionando y anulando la selección de los valores de interés. Anteriormente, era necesario escribir los valores de filtro de forma manual cuando se utilizaba el filtrado por una condición.

Para utilizar esta función, agrega un campo a la sección Filtros de la tabla dinámica y haz clic en el menú desplegable Estado para abrir las opciones de filtro. Luego, haz clic en Agregar filtro:

Se abrirá una barra lateral y Hojas de cálculo recuperará los 500 valores más frecuentes de Looker.

A continuación, puedes buscar entre los elementos, seleccionarlos o borrarlos, o bien ordenarlos por frecuencia o alfabéticamente. Cuando hagas clic en Aceptar en la parte inferior, Hojas de cálculo almacenará tus elecciones. Luego, puedes hacer clic en Aplicar para actualizar la tabla dinámica como de costumbre, con el filtro nuevo aplicado.

Filtros que usan expresiones de filtro de Looker — agregado en septiembre de 2023

Puedes aplicar filtros de fechas relativos, así como muchos otros filtros avanzados, en Hojas conectadas por medio de las expresiones de filtro de Looker. Por ejemplo, puedes aplicar filtros como "está en los últimos 30 minutos" o "está en los últimos 10 días" en Hojas conectadas.

Para usar expresiones de filtro de Looker, sigue estos pasos:

  1. Agrega un campo a la sección de filtros de la tabla dinámica.

  2. Haz clic en el menú desplegable Estado para mostrar las opciones de filtro y selecciona Expresión de filtro.

  3. Ingresa cualquier expresión de filtro de Looker en el campo Valor.

    Por ejemplo, para filtrar los últimos 7 días, puedes escribir “7 días” o “últimos 7 días”.

  4. Haz clic en OK.

Además del filtrado por fechas relativo, otros ejemplos de filtrado que ahora son posibles incluyen los siguientes:

  • Una cadena que no comienza con -FOO%
  • Un rango numérico inclusivo y exclusivo: (12, 20]

Para ver todas las expresiones de filtro disponibles, consulta la página de documentación de las expresiones de filtro de Looker.

Uso de parámetros de Looker y campos de solo filtro (agregado en octubre de 2023)

Ahora puedes usar parámetros y campos de solo filtro en Hojas conectadas.

Los campos y parámetros de solo filtro aparecerán en la sección CAMPOS SOLO DE FILTROS del selector de campos en Hojas de cálculo, al igual que en Looker. Para usarlas, sigue estos pasos:

  1. Agrega o arrastra los parámetros seleccionados y los campos de solo filtro a la sección Filtros, tal como lo harías para filtrar una dimensión o medida.
  2. En el caso de los parámetros con valores permitidos, estos valores se mostrarán en un menú desplegable en el diálogo Filtrar por condición.
  3. Para los campos de solo filtro, puedes usar el diálogo habitual Filtrar por condición. Si el campo tiene sugerencias definidas en el modelo de Looker, también puedes usar la función Filtrar por valor.

Cómo actualizar tus datos en Hojas de cálculo de Google

Los datos de tu tabla dinámica son estáticos, pero se pueden actualizar en cualquier momento. Si actualizas tus datos, Looker consultará tu base de datos y actualizará la tabla dinámica con tus datos más recientes.

Tanto la tabla dinámica como la hoja de cálculo que muestra Explorar muestran la hora de actualización más reciente.

Selecciona Actualizar para actualizar los datos de la tabla dinámica.

Programa horarios de actualización habituales

Para programar actualizaciones automáticas de tus datos, selecciona el menú de tres puntos en la tabla dinámica y, luego, elige Opciones de actualización, o bien elige Opciones de actualización en la hoja Explorar. Looker muestra el diálogo Actualización programada.

Editar la configuración de la tabla dinámica

Para modificar qué filas, columnas, valores o filtros se incluyen en tu tabla dinámica, selecciona el ícono de lápiz junto al menú de tres puntos para abrir el panel del editor de tablas dinámicas.

Supervisa las Hojas conectadas

Un administrador de Looker puede ver el uso de Hojas conectadas a través del grupo de campos de Propiedades del cliente de la API de consulta en la Exploración del historial de actividad del sistema. Se crea una entrada en la exploración del historial cada vez que se ejecuta una consulta nueva.

En el grupo de campos Propiedades del cliente de la API de consulta, hay tres campos nuevos para Hojas conectadas:

  • Nombre del cliente de la API: Este campo siempre mostrará Connected Sheets para identificar las entradas de Hojas conectadas.
  • ID de la hoja de cálculo de Hojas conectadas: Este campo muestra el ID de la hoja, que se incluye en la URL de esa hoja de cálculo de Google.
  • Activador de Hojas conectadas: Este campo muestra si un usuario seleccionó el botón Actualizar en Hojas de cálculo o una actualización programada activó la consulta.

A continuación se incluye un ejemplo de una URL de actividad del sistema que muestra el uso de Hojas conectadas. Reemplaza <instance_name.looker.com> por la URL de la instancia.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

Qué debes saber

  • La distinción entre mayúsculas y minúsculas para los datos que se muestran en la tabla dinámica se determina mediante el parámetro de configuración de distinción de mayúsculas y minúsculas para el modelo. Sin embargo, los filtros de la tabla dinámica fuerzan la distinción entre mayúsculas y minúsculas cuando el filtro no distingue mayúsculas de minúsculas para los datos nativos de Hojas de cálculo.
  • Cualquier persona que tenga acceso de visualizador a la hoja podrá ver los datos almacenados en caché en una tabla dinámica.
  • Además del acceso de editor a la hoja, cualquier usuario que necesite editar o actualizar la tabla dinámica necesitará los permisos correctos en Looker para acceder al modelo de datos. Esto incluye el acceso al modelo en el que se basa la tabla dinámica, los permisos para ver los datos y el acceso adecuado a los datos a través de filtros de acceso o concesiones de acceso.
  • Si el usuario se autentica con OAuth en una base de datos de BigQuery, es posible que necesite otorgar permisos en la base de datos subyacente.

Límites de datos y fila de Hojas conectadas

Las consultas que se crean con Hojas conectadas tienen un límite máximo de 30,000 filas. Si el resultado de la consulta contiene más filas, Hojas de cálculo le mostrará un error al usuario. Si el usuario no tiene el permiso download_without_limit, el resultado se truncará a un máximo de 5,000 filas, independientemente del límite de Hojas de cálculo.

Además, las consultas de Hojas conectadas están sujetas a un límite de tamaño de datos. Las consultas que devuelven demasiados datos también darán como resultado un error.

Si ves alguno de estos errores, considera agregar filtros o usar menos dimensiones o dimensiones menos detalladas en tu consulta.

Solución de problemas de Hojas conectadas

Es posible que encuentres algunos problemas cuando intentes conectarte a Looker desde Hojas de cálculo de Google. En esta sección, se describen estos problemas y se explica cómo corregirlos.

Error: No se pudo establecer la conexión con tu instancia de Looker. Vuelve a intentarlo. Si el problema persiste, envíanos tus comentarios.

Este error puede ocurrir por varios motivos:

  • El nombre de la instancia de Looker se ingresó de manera incorrecta. En este caso, verifica el nombre de tu instancia de Looker y trata de conectarte de nuevo.
  • Hojas de cálculo no se puede conectar a la API de Looker. Esto puede ocurrir si tu instancia de Looker no usa la URL predeterminada del host de la API. Para corregirlo, deja en blanco el campo URL del host de la API del panel de administración de la API.

Error: La instancia de Looker no está configurada para usar esta función. Comunícate con el administrador de Looker para asegurarte de que sea apto.

Este error puede ocurrir por varios motivos:

  • Estás intentando conectarte a una instancia de Looker recién creada. Es posible que las instancias nuevas de Looker tarden hasta 24 horas en estar disponibles en Hojas conectadas.
  • Estás intentando conectarte a una instancia de Looker que no está alojada en Looker. Conéctate a otra instancia de Looker alojada en Looker.

No aparece ningún modelo después de conectarse a una instancia de Looker

Esto indica que no tienes los permisos necesarios para ver modelos en tu instancia.

Un usuario de Looker con el rol de visualizador no tiene permisos suficientes para crear conexiones en Hojas de cálculo, a la vez que no tiene permisos suficientes para usar la IU de Explorar en Looker. Si el usuario quiere usar Hojas conectadas para Looker, debe tener el permiso explore. Los roles de administrador, desarrollador y usuario incluyen el permiso explore. Un administrador de Looker puede otorgar al usuario el permiso explore, lo que debería permitirle ver los modelos de la instancia.

Error: La dirección de correo electrónico de tu cuenta de Looker vinculada es diferente de la de tu Cuenta de Google.

Esto indica que la dirección de correo electrónico de tu cuenta de Looker no coincide con la que se usa con tu Cuenta de Google. Asegúrate de haber accedido a una Cuenta de Google que tenga una dirección de correo electrónico que coincida con la de tu cuenta de Looker. Como alternativa, un administrador de Looker puede crear una nueva cuenta de usuario de Looker que use tu dirección de correo electrónico de Google actual.

Error: Solicitud incorrecta: no se encontró ningún cliente habilitado.

Este error indica que no se habilitó el conector de Hojas conectadas. Un administrador de Looker debe habilitar el botón de activación Conectores de IE de Looker o Hojas conectadas en el panel Conectores de IE en la sección Plataforma del menú Administrador de Looker.

Error 403: Prohibido

Si tu instancia de Looker tiene configurada una lista de entidades permitidas de IP, esta puede impedir que Hojas de cálculo se conecte a la API de Looker. Para determinar si la lista de entidades permitidas es la causa, intenta navegar a la URL de la instancia de Looker y ver si recibes el error La dirección IP no está en la lista de entidades permitidas.