Genera 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 tu proyecto: puedes crear un proyecto en blanco y crear su modelo de forma manual o clonar un repositorio de Git público existente, consulta la página de documentación Cómo crear un nuevo proyecto de LookML.

Genera un modelo de forma automática 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 Proyectos de LookML, selecciona Nuevo proyecto de LookML:

    • En la página LookML Projects, puedes ver todos tus proyectos junto con sus respectivos modelos. Usarás esta página para crear, ver y configurar tus proyectos.

  4. En el cuadro de diálogo New Project, especifica las opciones para tu proyecto:

    • Nombre del proyecto: Asígnale un nombre a tu proyecto. Elige el nombre del proyecto con cuidado y considéralo un ID permanente, ya que Looker usa el nombre del proyecto de las siguientes maneras:

      • Para identificar el proyecto en las llamadas a la API que tienen el parámetro project_id.
      • Identificar el proyecto en la base de datos interna de la instancia de Looker.
      • A fin de identificar el proyecto para su importación de proyecto local.
      • Mostrar el proyecto en la página Proyectos de Looker.
      • Mostrar el proyecto en la sección Desarrollar del panel de navegación de Looker.
      • Como parte de la URL para los archivos del proyecto. Por ejemplo, en una instancia de Looker con una URL example.looker.com, el archivo de manifiesto del proyecto llamado ecommerce se puede encontrar en esta URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.
    • Punto de partida: Elige Generar modelo a partir del esquema de la base de datos.

    • Conexión: En el menú desplegable, selecciona el nombre de la conexión de base de datos.

    • Compilar vistas desde: Selecciona una de las siguientes opciones:

      • 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 en tu base de datos. Si eliges esta opción, ingresa el nombre de la tabla de la base de datos.
    • Esquemas: A fin de generar archivos para 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.

    • Ignorar prefijos: Para dejar los prefijos de las tablas fuera de los nombres de archivo de las vistas, ingresa los prefijos de la base de datos en el campo Ignorar prefijos. Este campo distingue mayúsculas de minúsculas. Puedes enumerar varios prefijos separados por comas. Por ejemplo, tus 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 de la base de datos (a menos que se especifique lo contrario). Luego, Looker abrirá el nuevo proyecto en el IDE de Looker.
    • El generador de LookML crea carpetas de 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.

Para las conexiones de BigQuery, si generas un proyecto de LookML a partir de tu base de datos, Looker propaga automáticamente las descripciones de los campos con las descripciones de los metadatos de tu 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 y selecciona el nombre de una función Explorar.

Para cambiar el nombre de tu proyecto después de haberlo creado, consulta la sección Cómo cambiar el nombre de un proyecto de la página de documentación Cómo acceder y editar la información del proyecto.

Puedes crear modelos nuevos de forma manual para tu proyecto como se describe en la página de documentación Descripción de los archivos de modelos y vistas, configurarlos para usarlos en producción como se explica en la sección Cuándo debes configurar modelos de esta página y encontrar más instrucciones en la página de documentación Crea un nuevo proyecto de LookML.

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. Puedes registrar cambios en tus archivos de LookML y administrar versiones de tus archivos.

Generación de LookML mejorada

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

  • Looker agrega un archivo README al nuevo proyecto. 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 de comentarios intercalados 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 cadena id en su nombre, Looker crea una medida de type: sum y una medida de type: average, las cuales se basan en la primera dimensión alfabéticamente de type: number que no incluye la cadena id en su nombre.

Cuando necesitas configurar modelos

Configurar un modelo es útil por los siguientes motivos:

  • Especifica que un nombre de modelo dado se refiere a un modelo particular de un proyecto en particular.
  • Establece las conexiones que el modelo puede usar.

Los administradores (o los desarrolladores con los permisos manage_models o manage_project_models) mientras se encuentran en Modo de desarrollo no necesitan una configuración del modelo. Esto permite que los desarrolladores de LookML trabajen en Modo de desarrollo. Sin embargo, si existe una configuración de modelo, todas las consultas estarán limitadas por esa configuración incluso en Modo de desarrollo.

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

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

  • Cuando un modelo se envía a producción por primera vez Si el modelo no está configurado, todas las consultas en ese modelo fallarán una vez que el modelo esté en modo de producción. Cuando un modelo pasa del Modo de desarrollo a producción por primera vez, Looker lo configura automáticamente si su nombre es único para la instancia de Looker. Sin embargo, si tienes un modelo configurado con el mismo nombre en otro proyecto, Looker no configurará el modelo 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) o el permiso manage_project_models, el modelo debe configurarse para que esos desarrolladores puedan ejecutar consultas en él. 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 con éxito.

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