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:
- Mediante la opción Create Model File a fin de crear el archivo con el IDE de Looker (consulte la sección de documentación Cómo crear archivos en la página de documentación Cómo trabajar con carpetas en el IDE)
- Utilice la función de arrastrar y soltar para subir el archivo desde su computadora (consulte la sección de documentación Subir archivos de la página de documentación Cómo trabajar con carpetas en el IDE). Asegúrate de usar la extensión de archivo
.model.lkml
para el archivo que estás subiendo.
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
oalias
para cambiar el nombre que se muestra del objeto o archivo. Los parámetroslabel
yalias
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:
Crea archivos de vista basados en tablas de una base de datos:
- Generación de archivos de vista desde tablas de bases de datos la primera vez que te conectas a tu base de datos, como se describe en la página de documentación Genera un modelo.
- Generar archivos de vista a partir de tablas de base de datos para un proyecto que ya está conectado a una base de datos, como se describe en la sección Cómo agregar una vista nueva desde una tabla de base de datos existente a continuación en esta página.
Cómo crear archivos de vista en blanco:
- Mediante la opción Crear archivo de vista en el IDE de Looker, como se describe en la sección Crear archivos de la página de documentación Trabajar con carpetas en el IDE
- Usar la función de arrastrar y soltar para subir el archivo desde la computadora, como se describe en la sección Subir archivos de la página de documentación Trabajar con carpetas en el IDE. Asegúrate de usar la extensión de archivo
.view.lkml
para el archivo que estás subiendo.
Crea un archivo de vista para una tabla derivada:
- Comience con un archivo de vista en blanco con una de las opciones anteriores y, luego, defina manualmente su tabla derivada, como se describe en la sección Cómo definir una tabla derivada nativa en LookML de la página de documentación Cómo crear tablas derivadas nativas.
- Haz que Looker cree la tabla derivada LookML a partir de Explore, como se describe en la sección Usa una exploración para comenzar a definir tus tablas derivadas nativas de la página de documentación Crea tablas derivadas nativas.
- Hacer que Looker cree la tabla de derivada LookML a partir de una consulta de SQL Runner, como se describe en la página de documentación Usa SQL Runner para crear tablas derivadas
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.
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.
Haz clic en Crear vista desde tabla.
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.
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.
Desplázate hasta el final de la página y haz clic en Crear vistas.
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.