Información sobre los archivos de modelos y vistas

En esta página, se proporciona una descripción general de los archivos de vista y modelo, que son componentes clave de la mayoría de los proyectos de Looker. Los otros tipos de archivos de proyecto se describen en la página de documentación Información sobre otros archivos de proyecto. Para obtener información sobre cómo acceder a los archivos de un proyecto, consulta la página de documentación Cómo acceder a la información del proyecto y editarla.

Archivos de modelo

Un archivo de modelo especifica una conexión de base de datos y el conjunto de Exploraciones que usan esa conexión. Un archivo de modelo también define los objetos Explores y sus relaciones con otras vistas.

Explorar es un punto de partida para consultar sus datos. En términos de SQL, una exploración es la cláusula FROM de una consulta. Los usuarios pueden ver las exploraciones que defines en el modelo cuando consultan el menú Explorar de Looker. (Consulta la página de documentación Cómo funciona un proyecto en Looker para obtener más información sobre Explorar).

En otras palabras, el archivo del modelo es donde define qué tablas de datos se deben usar (como las vistas incluidas) y cómo deben unirse, si es necesario.

Por lo general, las exploraciones se definen dentro de un archivo de modelo. Sin embargo, a veces necesitas un archivo Explorar independiente para una tabla derivada o para extender o definir mejor un Explorar en todos los modelos.

Estructura y sintaxis general

Dentro de las llaves, { }, debes definir los parámetros para Explorar. Puedes usar parámetros join para unir otras vistas a Explorar en un archivo de modelo.

Arriba, vemos el explore llamado inventory_items en el archivo del modelo, junto con sus vistas unidas. Esta definición de LookML hace que los elementos de inventario aparezcan en el menú Explorar y une los datos de inventory_items a products y distribution_centers.

Para obtener información más específica sobre las estructuras de LookML en un archivo de modelo, consulta la página de documentación de Términos y conceptos de LookML.

Crea archivos de modelo

La mayoría de los desarrolladores de LookML comienzan con uno o más archivos de modelo que se crean automáticamente cuando el proyecto de LookML se genera a partir de un conjunto de tablas en una base de datos.

Como alternativa, un desarrollador de Looker en modo de desarrollo puede crear un archivo de modelo en blanco de las siguientes maneras:

Puedes modificar cualquier archivo de modelo si agregas o quitas Exploraciones, especificas las uniones y agregas otras funciones.

Si necesitas cambiar el nombre de un modelo o de cualquier objeto del modelo, no cambies el nombre del archivo ni el objeto en sí. En su lugar, usa el parámetro label o alias para cambiar el nombre que se muestra del objeto o archivo. Los parámetros label y alias cambian el nombre que se muestra y conservan la URL subyacente que se usa para los correos electrónicos o para otros sistemas.

En general, debes tomar precauciones para que los cambios del modelo sean lo más invasivos posible. Si necesitas cambiar el nombre de un modelo o de un objeto, usa el Validador de contenido para actualizar todas las referencias al modelo o al objeto.

Si borras un archivo de modelo, este no se quita de los conjuntos de modelos a los que pertenecía. Si se crea un archivo de modelo nuevo con el mismo nombre que un modelo borrado, el modelo nuevo se incluye en cualquier conjunto de modelos que incluya el modelo borrado. Esto puede dar como resultado el acceso no deseado al nuevo archivo de modelo. Los administradores de Looker pueden editar conjuntos de modelos y quitar un modelo borrado para evitar este problema.

Más información sobre los parámetros de los archivos de modelos

Lea las páginas de documentación Parámetros de modelo, Explorar parámetros y Unir parámetros para obtener más información sobre los parámetros de LookML en el archivo del modelo.

Ver archivos

Por lo general, un archivo de vista define una sola vista en Looker. Una vista corresponde a una sola tabla en tu base de datos o a una sola tabla derivada.

El archivo de vista especifica una tabla para consultar y los campos (dimensiones y medidas) que se incluirán de esa tabla.

Estructura y sintaxis general

Dentro de cada llave de vista, { }, son definiciones de campo que, por lo general, corresponden a una columna en la tabla subyacente o a un cálculo en Looker. Looker clasifica la mayoría de ellas como dimensiones o medidas.

Arriba vemos la dimensión id definida como un campo en la vista Order Items. Esta definición expone el campo ID para las consultas en Explorar artículos del pedido.

También puede crear varias dimensiones basadas en el tiempo a la vez mediante los grupos de dimensiones o especificar un filtro para sus usuarios con campos de filtro. Consulte la página de documentación Ver parámetros para obtener más información sobre los parámetros de LookML en los archivos de vista.

Para obtener información más específica sobre las estructuras de LookML en un archivo de vista, consulta la página de documentación de términos y conceptos de LookML.

Dimensiones

Los campos de Looker se dividen en dimensiones y medidas. Una dimensión puede ser una de dos opciones:

  • Una columna en la tabla subyacente
dimension: first_name {
  sql: ${TABLE}.first_name ;;
}
  • Un valor calculado basado en otros campos
dimension: full_name {
  sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}

En Looker, las dimensiones siempre aparecen en la cláusula GROUP BY del SQL que genera Looker.

En LookML, puede definir diferentes tipos de dimensiones que correspondan a diferentes tipos de datos o formatos.

Medidas

Una medida calcula valores en varias filas. Esto equivale a funciones agregadas de SQL, como COUNT(), SUM(), AVG(), MIN() y MAX(). Las medidas también pueden realizar transformaciones simples en otras medidas. Consulte nuestra documentación sobre los tipos de medición para obtener más información.

En la parte superior, podemos ver las dimensiones y medidas definidas en el archivo de vista products.

Crea archivos de vista

La mayoría de los desarrolladores de LookML comienzan con uno o más archivos de vista que se crean automáticamente cuando el proyecto de LookML se genera desde un conjunto de tablas en una base de datos. Sin embargo, hay muchas formas en que un desarrollador de Looker en modo de desarrollo puede agregar archivos de vista a un proyecto de LookML:

Para usar una vista nueva, agrégala al archivo del modelo con el parámetro explore o usa el parámetro join para unirlo a un archivo existente en el archivo del modelo.

Agrega una vista nueva desde una tabla de base de datos existente

Puedes crear un archivo de vista a partir de una tabla de base de datos existente en modo de desarrollo.

  1. En un proyecto, haz clic en + en la parte superior de la lista de archivos del proyecto en el IDE de Looker o haz clic en el menú de una carpeta para crear el archivo dentro de la carpeta.

  2. Haz clic en Crear vista desde tabla.

  3. Looker muestra una lista de tablas asociadas a una de sus conexiones. Para cambiar la conexión, usa el menú desplegable Conexión ubicado en la parte superior izquierda.

  4. Para seleccionar las tablas para las que desea crear vistas, marque la casilla a la izquierda del nombre de la tabla. Puedes contraer y expandir bases de datos o esquemas en esta lista para acceder a todas las tablas disponibles.

  5. Desplázate hasta el final de la página y haz clic en Crear vistas.

  6. Looker genera vistas que contienen LookML para todas las columnas de la tabla.

Más información sobre los parámetros de los archivos de vista

Puedes obtener más información sobre los parámetros de vista en la página de documentación Parámetros de vista.

Obtenga más información sobre los parámetros de LookML para las dimensiones, las medidas, los grupos de dimensiones y los campos de filtro en la página de documentación Parámetros de campo.