Usando configuración de zona horaria

Looker puede convertir datos basados en el tiempo en diferentes zonas horarias para facilitar su comprensión. Los usuarios pueden ver los resultados de las consultas y crear filtros con datos basados en el tiempo que se convierten en sus zonas horarias locales. Por ejemplo, un usuario de Nueva York que visualiza datos de California creados en California no tiene que restar tres horas manualmente para filtrar o interpretar sus consultas.

Looker convierte datos basados en el tiempo cuando genera SQL durante una consulta para una apariencia, una exploración o un panel. Los datos subyacentes no se ven afectados; más bien, los resultados de las consultas se convierten mediante la configuración de la zona horaria de Looker. Esto también significa que las consultas que se ejecutan con SQL Runner no convierten datos basados en el tiempo.

Varios parámetros de configuración de Looker especifican cómo convertir datos basados en el tiempo:

Zona horaria del sistema

La zona horaria del sistema es la zona horaria para la que se configuró el servidor que ejecuta Looker. La base de datos interna de Looker, que almacena la información disponible en las exploraciones de i__looker y Actividad del sistema, almacena datos basados en el tiempo en la zona horaria del sistema.

La zona horaria del sistema no se puede configurar a través de la aplicación de Looker. Para las instancias alojadas en Looker, la zona horaria del sistema siempre está configurada en UTC. Las instancias alojadas por el cliente pueden estar en una zona horaria del sistema diferente. No se recomienda cambiar la zona horaria del sistema. Si necesitas ajustar las marcas de tiempo en una i__looker o en una exploración del sistema, Looker recomienda usar cálculos de tablas para crear columnas ajustadas según la hora. Por ejemplo, para convertir de UTC a EST, puedes crear una columna con el cálculo de la tabla add_hours(-5, ${time}).

zona horaria de la base de datos

Cuando agregas una conexión a una base de datos, estableces el valor para la Zona horaria de la base de datos en la página Configuración de conexión:

Esta configuración representa la zona horaria en la que se encuentra tu base de datos, que suele ser el tiempo universal coordinado (UTC). Si estableces este valor en un valor diferente de la zona horaria en la que se encuentra tu base de datos, pueden generarse resultados inesperados.

zonas horarias elegidas por los usuarios

La configuración más importante para la conversión de datos basados en el tiempo es la opción Zonas horarias específicas del usuario, que se encuentra en la página Configuración general de la sección Administrador de Looker:

Puedes habilitar o inhabilitar Zonas horarias específicas del usuario:

  • Cuando se habilita, cada usuario de Looker se asigna a una zona horaria, y esa zona horaria especifica la apariencia de los resultados de sus consultas.
  • Si se inhabilita, los usuarios no tendrán zonas horarias individuales asignadas a sus cuentas. En cambio, todas las consultas se ejecutan con el valor Query Time Zone.

Cuando las Zonas horarias específicas de usuario están habilitadas, los usuarios pueden configurarlas en la página de su Cuenta, o bien los administradores de Looker pueden asignarlas a los usuarios en la página de Usuarios. Si no se configuró una zona horaria para un usuario, su cuenta se configurará de forma predeterminada con la configuración de Zona horaria de la aplicación de Looker.

Cuando un usuario crea una consulta, esa consulta se crea en la zona horaria del usuario. Como resultado, cuando una consulta muestra datos basados en el tiempo, Looker convierte los datos de la Zona horaria de la base de datos en la zona horaria del usuario. Cuando un usuario usa valores de filtro relacionados con el tiempo en una consulta, Looker los convierte en la Zona horaria de la base de datos.

Además, cuando habilita esta opción, Looker muestra un menú desplegable en Exploraciones, Paneles heredados y Diseños:

Las opciones de este menú desplegable son las siguientes:

  • Zona horaria de cada mosaico (solo paneles): Todas las consultas se ejecutan en la zona horaria con la que se guardaron.
  • Viewer Time Zone: todas las consultas se ejecutan con la configuración de zona horaria actual del usuario.
  • Una lista de cada zona horaria individual, que los usuarios pueden elegir manualmente si lo desean.

Todas las consultas se establecen de forma predeterminada en la zona horaria con la que se creó la consulta. En otras palabras, si Alice crea una consulta con la zona horaria "América/Los Ángeles" y la envía a Bob, Bob verá la consulta con la zona horaria "América/Los Ángeles", incluso si la zona horaria de Bob es "América/Nueva York". De manera similar, la perforación siempre establece de forma predeterminada la zona horaria con la que se creó la consulta.

Cuando ven una consulta, los usuarios pueden utilizar el menú desplegable para anular la zona horaria y elegir la Zona horaria del usuario, o cualquier zona horaria diferente de esa consulta o ese panel de consultas.

Aspectos para tener en cuenta con las zonas horarias específicas de los usuarios

Cuando habilitas Zonas horarias específicas del usuario, los usuarios que se encuentran en zonas horarias diferentes ven los datos de forma distinta según cómo se apliquen los filtros en cada zona horaria. Por ejemplo, la siguiente consulta tiene un filtro de last month y se ejecutó en la zona horaria de Nueva York:

La misma consulta ejecutada en la zona horaria de Seúl muestra resultados diferentes:

Los datos subyacentes no son diferentes; las horas exactas que conforman el período last month son levemente distintas.

zona horaria de la aplicación

El parámetro de configuración Zona horaria de la aplicación se encuentra en la página Configuración general, en la sección Administrador de Looker:

La zona horaria de la aplicación es la zona horaria predeterminada para las entregas de contenido. La zona horaria que se usa para las entregas de contenido no afecta los datos basados en el tiempo que muestra una consulta, solo afecta el momento en que se envía una entrega de datos.

Si habilita la opción Zonas horarias específicas del usuario, la Zona horaria de la aplicación será la predeterminada para los usuarios que no hayan configurado un valor de zona horaria para sus cuentas.

zona horaria de la consulta

La opción Zona horaria de consulta solo se muestra si inhabilitas las Zonas horarias específicas del usuario. En ese caso, debes establecer el valor Query Time Zone cuando agregas una conexión a una base de datos en la página Connection Settings:

Si inhabilitas las Zonas horarias específicas del usuario,todas las consultas de datos basados en el tiempo usarán la Zona horaria de consulta y Looker convertirá todos los datos basados en el tiempo de la Zona horaria de la base de datos a la Zona horaria de la consulta.

Parámetro de LookML convert_tz

Looker realiza la conversión de zona horaria de forma predeterminada. Para inhabilitar la conversión de zona horaria en un campo individual, puedes usar el parámetro de LookML convert_tz. Por ejemplo:

dimension_group: created {
  type: time
  timeframes: [time, date]
  convert_tz: no
}

Para obtener más información, consulta la página de documentación del parámetro convert_tz.

Parámetro de LookML sql

También puedes definir manualmente la conversión de zona horaria mediante las funciones de dialecto de tu base de datos dentro del parámetro sql en una dimensión de LookML. Por ejemplo, para definir manualmente la conversión de zona horaria en MySQL, puedes usar el siguiente LookML:

dimension_group: created {
 type: time
 timeframes: [time, date]
 sql: CONVERT_TZ(${TABLE}.created_at,'UTC','PST') ;;
}

Notas del dialecto MySQL

MySQL requiere una tabla de zona horaria antes de que funcione la función de conversión de zona horaria. Un administrador puede realizar esta tarea. Puedes obtener más información en la documentación de MySQL.

Notas de dialecto de Postgres

Looker usa la configuración del controlador para seleccionar la zona horaria objetivo. Esto puede afectar la forma en que se procesan las consultas en SQL Runner en comparación con pgAdmin, ya que Looker usará la fecha y hora actual en la zona horaria seleccionada.

Compatibilidad de dialecto con la base de datos para la conversión de zona horaria

Para que Looker convierta las zonas horarias en tu proyecto de Looker, el dialecto de tu base de datos debe admitir la conversión de zona horaria. En la siguiente tabla, se muestran los dialectos que admiten la conversión de zonas horarias en la versión más reciente de Looker: