Cómo generar un modelo

En esta página, se proporcionan los pasos para crear un proyecto nuevo y generar automáticamente un modelo básico a partir de tu base de datos.

Existen otras opciones para crear los archivos de su proyecto: puede crear un proyecto en blanco y crear su modelo de forma manual, o clonar un repositorio de Git público existente, consulte la página de documentación Cómo crear un nuevo proyecto de LookML.

Genera automáticamente un modelo a partir de tu base de datos

  1. Haz clic en Develop, en la barra de menú, y verifica que estés en Development Mode.

  2. Selecciona Projects en la sección Develop del panel de navegación.

  3. En la página LookML Projects, selecciona New LookML Project:

    • La página Proyectos de LookML te permite ver todos tus proyectos junto con sus respectivos modelos. Usarás esta página para crear, ver y configurar tus proyectos.

  4. En el diálogo New Project, especifique las opciones para su proyecto:

    • Asigna un nombre a tu proyecto.
    • En Punto de partida, elige Generate Model from Database Schema.
    • En el menú desplegable Conexión, selecciona el nombre de tu conexión de base de datos.
    • En Build Views From, selecciona una opción:
      • Todas las tablas: El generador de LookML crea un archivo de vista para cada tabla de tu base de datos.
      • Tabla única: El generador de LookML crea una vista para una tabla de tu base de datos. Si eliges esta opción, ingresa el nombre de la tabla de la base de datos.
    • Para generar archivos de un solo esquema en tu base de datos, ingresa el nombre del esquema en el campo de texto Esquemas. Puedes enumerar varios esquemas, separados por comas.
    • Para dejar los prefijos de la tabla fuera de los nombres de los archivos de vista, ingresa los prefijos de tu base de datos en el campo de texto Ignore Prefixes. Este campo distingue mayúsculas de minúsculas. Puedes enumerar varios prefijos, separados por comas. Por ejemplo, sus tablas se titulan dwh_orders y DBS_users. Si ingresas dwh, DBS en el campo de texto Ignore Prefixes, Looker creará archivos de vista llamados orders y users.
  5. Haz clic en Crear proyecto.

    • El generador de LookML crea un archivo de modelo para el proyecto y un archivo de vista para cada tabla en la base de datos (a menos que se especifique lo contrario). Luego, Looker abrirá el proyecto nuevo en el IDE de Looker.
    • El generador de LookML crea carpetas IDE para tus archivos de vista y modelo. Si tu base de datos tiene más de un esquema, el generador de LookML crea una carpeta para los esquemas.

En el caso de las conexiones de BigQuery, si generas un proyecto de LookML a partir de tu base de datos, Looker propaga automáticamente las descripciones de campo con las descripciones de tus metadatos de columna de BigQuery, si las hubiera.

El generador también crea una exploración para cada tabla de la base de datos. Para comenzar a consultar tus datos, usa el panel Explorar a fin de seleccionar el nombre de la función.

Para cambiar el nombre de un proyecto después de crearlo, consulte la sección Cómo cambiar el nombre de un proyecto de la página de documentación Cómo acceder a la información del proyecto y editarla.

Puedes crear nuevos modelos manualmente para tu proyecto, como se describe en la página de documentación Información sobre el modelo y los archivos de vista, configurarlos para su uso en producción como se explica en la sección Cuando necesites configurar modelos de esta página y encontrar instrucciones adicionales en la página de documentación Crea un proyecto de LookML nuevo.

Después de generar o crear manualmente los archivos de tu modelo, consulta la página de documentación Configura y prueba una conexión de Git para obtener información sobre cómo conectar tu proyecto de Looker a Git. Puede registrar cambios en sus archivos LookML y administrar versiones de ellos.

Generación mejorada de LookML

Si el administrador de Looker habilitó la función de labs de generación de LookML mejorada, Looker agregará elementos adicionales a tu proyecto cuando lo generes a partir de la base de datos:

  • Looker agrega un archivo README al proyecto nuevo. El archivo README contiene una introducción a LookML junto con vínculos y recursos para ayudar a los nuevos desarrolladores de LookML.
  • Looker agrega varias explicaciones intercaladas de comentarios al archivo del modelo y a cada archivo de vista.
  • Si una vista tiene al menos una dimensión de type: number que no contiene la string id en su nombre, Looker crea una medida de type: sum y una medida de type: average, que se basan en la primera dimensión alfabética de type: number que no contiene la string id en su nombre.

Cuando necesita configurar modelos

Configurar un modelo es útil por los siguientes motivos:

  • Especifica que un nombre de modelo determinado hace referencia a un modelo en particular de un proyecto en particular.
  • Establece las conexiones que el modelo puede usar.

No es necesario configurar el modelo para los administradores (o para los desarrolladores con el permiso manage_models) mientras están en modo de desarrollo. Esto permite a los desarrolladores de LookML trabajar fácilmente en modo de desarrollo. Sin embargo, si existe una configuración del modelo, cualquier consulta estará restringida por esa configuración, incluso en modo de desarrollo.

Aunque un desarrollador de LookML especifica la conexión deseada en el archivo de modelo, un administrador controla las conexiones permitidas en la página Proyectos de LookML. Si un modelo especifica el uso de una conexión no permitida en la configuración del modelo, entonces la conexión no está permitida.

Un modelo debe tener una configuración en las siguientes situaciones:

  • Cuando se envía un modelo a producción por primera vez. Si el modelo no está configurado, cualquier consulta en él fallará una vez que esté en modo de producción. Cuando un modelo se envía del modo de desarrollo a producción por primera vez, Looker configura el modelo automáticamente si el nombre del modelo es único para la instancia de Looker. Sin embargo, si tienes un modelo configurado con el mismo nombre en otro proyecto, Looker no lo configurará automáticamente.
  • Durante el desarrollo. Si tienes desarrolladores a los que no se les otorgó el permiso manage_models (que se incluye en el rol admin), el modelo debe configurarse antes de que esos desarrolladores puedan ejecutar consultas en ese modelo. Puedes configurar el modelo antes de que exista o antes de que exista el proyecto. Luego, cuando un desarrollador de LookML crea el proyecto y el modelo, las conexiones permitidas del modelo ya están configuradas y el desarrollador puede ejecutar consultas de forma correcta.

Looker permite que los desarrolladores con el permiso manage_models ejecuten consultas en un modelo no configurado en el modo de desarrollo. Para ello, Looker busca proyectos con un nombre con ese nombre. El primer modelo que se encuentra con ese nombre se usa para ejecutar la consulta.