Administra archivos y carpetas de LookML

Los archivos de proyecto de LookML se organizan en carpetas en la sección del navegador de archivos del IDE de Looker. En esta página, se proporcionan instrucciones para crear y administrar carpetas y archivos en un proyecto de LookML.

Para obtener información sobre la estructura y el propósito de cada tipo de archivo en un proyecto de LookML, consulta la página de documentación Tipos de archivos en un proyecto de LookML.

Antes de comenzar: Convenciones importantes de nomenclatura de archivos y carpetas

Cuando creas archivos y carpetas, es mejor tener en cuenta las siguientes convenciones de nombres:

• Distinción entre mayúsculas y minúsculas: LookML distingue entre mayúsculas y minúsculas. Asegúrate de cumplir con las convenciones del proyecto cuando les asignes un nombre a las carpetas. Por ejemplo, si tu convención es usar todas las letras minúsculas en tu proyecto, te recomendamos que asignes el nombre views a la carpeta en lugar de Views. Esto marca la diferencia, en especial cuando necesitas especificar la ruta de acceso de un archivo, como cuando incluyes archivos. En general, es una buena idea usar letras minúsculas de manera coherente cuando nombras objetos y carpetas de LookML.
• Espacios y caracteres especiales: Los nombres de archivo no pueden incluir espacios ni ninguno de los siguientes caracteres: / ? * : | " < > %
• Extensiones de archivo: Cuando crees archivos de LookML con el IDE de Looker, Looker agregará automáticamente la extensión .lkml al final del nombre del archivo si no la incluyes de forma manual. Por ejemplo, si ingresas el nombre de archivo flights_data_tests, Looker llamará al archivo flights_data_tests.lkml.
• Cambia el nombre que se muestra de un objeto de LookML: Si quieres cambiar el nombre que se muestra de un modelo o de un objeto de LookML, considera usar el parámetro label o el parámetro alias en lugar de cambiar el nombre del objeto o archivo. Los parámetros label y alias cambian el nombre que se muestra y, al mismo tiempo, conservan la URL subyacente que se usa para correos electrónicos y otros sistemas. En general, debes tomar las precauciones necesarias para realizar cambios en los modelos que no sean invasivos posibles. Si necesitas cambiar el nombre de un modelo o un objeto, usa el Validador de contenido para actualizar todas las referencias a estos objetos.

Crea carpetas

Puedes crear carpetas para diferentes tipos de archivos (como archivos de vista o archivos de modelos). Incluso puedes crear subcarpetas, lo que es muy útil si quieres include un subconjunto de tus vistas.

Nota: Cuando crees carpetas, ten en cuenta que LookML distingue entre mayúsculas y minúsculas. Asegúrate de cumplir con las convenciones del proyecto cuando les asignes un nombre a las carpetas. Esto es importante, en especial cuando necesitas especificar la ruta de acceso de un archivo, como cuando incluyes archivos. En general, es una buena idea usar letras minúsculas de manera coherente cuando nombras objetos y carpetas de LookML. Consulta las notas importantes sobre la creación de archivos y carpetas a fin de conocer las limitaciones y los lineamientos para nombrar tus archivos y carpetas.

Para crear una carpeta, haz lo siguiente:

1. Selecciona la opción Crear carpeta en el menú correspondiente:
   • Para crear una carpeta nueva en el nivel superior de la estructura de directorios, usa el menú Agregar archivo o carpeta. Para acceder a él, selecciona el ícono + (más) en la parte superior del panel Navegador de archivos.
   • Para crear una subcarpeta nueva en una carpeta existente, usa el menú de tres puntos Opciones de carpeta de la carpeta existente.
2. Ingresa un nombre para la carpeta nueva.
3. Seleccione Crear.

Se agregará la carpeta nueva al panel de navegación.

Creación de archivos

Puedes generar automáticamente un archivo de modelo y ver archivos basados en tu base de datos cuando creas un proyecto nuevo. Para proyectos existentes, puedes crear nuevos archivos manualmente.

Nota: Te recomendamos que uses el IDE de Looker para agregar archivos a tu proyecto de LookML. Para ello, puedes crearlos en el IDE de Looker como se describe a continuación en esta sección o subirlos en el IDE de Looker. Si, en cambio, creas archivos fuera del IDE de Looker y, luego, usas el IDE de Looker para extraer desde (rama de producción), asegúrate de usar las convenciones de nomenclatura correctas y de incluir la extensión .lkml en el nombre del archivo (o explore.lkml para los archivos de Explorar). Si el nombre de un archivo incluye caracteres no compatibles, el navegador de archivos del IDE de Looker mostrará el nombre del archivo en rojo, y no podrás ver el contenido del archivo hasta que lo cambies por caracteres compatibles. Además, el IDE de Looker no mostrará el archivo si este no tiene la extensión .lkml.

Para crear un archivo nuevo en tu proyecto de LookML, haz lo siguiente:

1. Selecciona el menú adecuado:

   • Para crear un archivo nuevo en el nivel superior de la estructura de directorios, usa el menú Agregar archivo o carpeta. Para acceder a él, selecciona el ícono + (más) en la parte superior del panel Navegador de archivos.
   • Para crear un archivo nuevo en una carpeta existente, usa el menú de tres puntos Opciones de carpeta para esa carpeta.

2. Selecciona el tipo de archivo de LookML que quieres crear. Selecciona los enlaces de la siguiente lista para obtener una descripción más detallada de cada tipo de archivo. Puedes crear los siguientes tipos de archivos:

   • Archivos de modelo con la extensión de archivo .model.lkml
   • Ver archivos con la extensión .view.lkml*
   • Archivos de manifiesto del proyecto que siempre se denominan manifest.lkml**
   • Archivos de panel con la extensión de archivo .dashboard.lookml
   • Archivos de documentos con la extensión de archivo .md
   • Archivos de cadenas de configuración regional con la extensión de archivo .strings.json***
   • Archivos genéricos de LookML, que se usan para los siguientes tipos de archivos:
     • Explora archivos con la extensión .explore.lkml****.
     • Archivos de prueba de datos con la extensión de archivo .lkml
     • Archivos de mejora con la extensión de archivo .lkml
     • Cualquier otro archivo que uses para alojar elementos de LookML
   Nota:

   ^* Consulta la sección Consideraciones para crear archivos de vista en esta página a fin de obtener instrucciones sobre métodos alternativos para crear archivos de vista, incluidas instrucciones para agregar archivos de vista basados en tablas de bases de datos.

   ^** Solo puedes crear archivos de manifiesto del proyecto seleccionando el ícono + (más) para abrir el menú Agregar archivo o carpeta en la parte superior del navegador de archivos en el IDE de Looker, y solo si el proyecto aún no tiene un archivo de manifiesto. Esto se debe a que un proyecto solo puede tener un archivo de manifiesto, y este debe estar ubicado en el nivel raíz de la estructura de directorios del proyecto.

   ^*** La opción Crear archivo de cadenas de configuración regional solo está disponible en el ícono Agregar archivo o carpeta + (más) que aparece en la parte superior del navegador de archivos en el IDE de Looker, pero, una vez que se crea (o sube) un archivo de cadenas de configuración regional, puedes mover el archivo a una carpeta. Si creas archivos de cadenas de configuración regional para localizar tu modelo y también quieres aprovechar la localización de la IU nativa de Looker, debes nombrar tus archivos de cadenas con códigos de configuración regional específicos que se encuentran en la sección Configuración regional de la página de documentación Usuarios.

   ^**** Cuando creas un archivo de exploración, este debe tener la extensión .explore.lkml al final de su nombre. Si subes el archivo, debes usar la extensión .explore.lkml completa. Si usas el IDE de Looker para crear el archivo con la opción Archivos genéricos de LookML, Looker agregará .lkml al final del nombre del archivo si la extensión no está allí, pero debes agregar manualmente la parte .explore de la extensión al nombre del archivo. Por ejemplo, para crear un archivo de Explorar llamado flights con el IDE de Looker, puedes ingresar flights.explore o flights.explore.lkml, y el archivo se llamará flights.explore.lkml.

3. En la ventana emergente Crear archivo, ingresa un nombre para el archivo nuevo. Consulta las notas importantes sobre la creación de archivos y carpetas para conocer las limitaciones y los lineamientos para nombrar tus archivos.

4. Seleccione Crear. El archivo nuevo se mostrará donde lo creaste. Si es necesario, puedes moverla a otra carpeta fácilmente.

Importante: Una vez que crees el archivo, asegúrate de usar el parámetro include si quieres hacer referencia a elementos del archivo en otros archivos de LookML de tu proyecto. Consulta la página de documentación del parámetro include para obtener más información.

Nota: Si el administrador de Looker habilitó la función de Labs de generación mejorada de LookML, el menú Agregar archivo o carpeta + (más) en la parte superior del panel Navegador de archivos mostrará una opción para Generar LookML a partir de la base de datos además de las opciones que aparecen aquí.

Consideraciones para crear 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 a partir de un conjunto de tablas en una base de datos. Sin embargo, además de los métodos descritos en esta página para crear archivos de vista en blanco y subir archivos, 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 en una base de datos:

  • Generar archivos de vista a partir de 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 en esta página

• Para crear un archivo de vista para una tabla derivada, haz lo siguiente:

  • Comienza con un archivo de vista en blanco mediante una de las opciones descritas en esta página y, luego, define manualmente tu 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 Crea tablas derivadas nativas
  • Hacer que Looker cree la tabla derivada de LookML a partir de una función Explorar, como se describe en la sección Cómo usar una exploración para comenzar a definir tus tablas derivadas nativas de la página de documentación Cómo crear tablas derivadas nativas
  • Hacer que Looker cree el LookML de tabla derivado a partir de una consulta del ejecutor de SQL, como se describe en la página de documentación Cómo usar el ejecutor de SQL para crear tablas derivadas

Para usar una vista nueva, agrégala a tu archivo de modelo con el parámetro explore o usa el parámetro join para unirla a una exploración existente en tu archivo de modelo.

Agrega una vista nueva a partir de una tabla de base de datos existente

Puedes crear un archivo de vista a partir de una tabla de base de datos existente mientras está en Modo de desarrollo.

1. En un proyecto, selecciona el menú Agregar archivo o carpeta seleccionando el signo + (más) en la parte superior de la lista de archivos del proyecto en el IDE de Looker, o bien puedes seleccionar el menú de una carpeta para crear el archivo dentro de la carpeta.

2. Selecciona Crear vista a partir de la tabla (Create View From Table).

3. Looker muestra una lista de tablas asociadas con una de tus conexiones. Para cambiar la conexión, usa el menú desplegable Conexión en la esquina superior izquierda.

4. Selecciona las tablas de las que deseas crear vistas. Para ello, marca la casilla que se encuentra a la izquierda del nombre de la tabla. Puedes contraer y expandir las bases de datos o los esquemas de esta lista para acceder a todas las tablas disponibles.

5. Desplázate hasta el final de la página y selecciona Crear vistas.

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

Cómo subir archivos

También puedes subir archivos a tu proyecto desde tu computadora. Esto es útil si creaste archivos de datos JSON o archivos de LookML localmente en tu computadora.

Nota: Consulta las notas importantes para crear archivos y carpetas a fin de conocer las limitaciones y los lineamientos para nombrar tus archivos.

Para subir un archivo a tu proyecto, usa la función de arrastrar y soltar en el IDE de Looker:

1. Navega a los archivos de tu proyecto.
2. Arrastra el archivo de tu computadora al IDE de Looker. El archivo se mostrará en la raíz de la estructura de tu directorio.
3. Cuando se suba el archivo, muévelo a otra carpeta.

Importante: Una vez que subas el archivo, asegúrate de usar el parámetro include si quieres hacer referencia al archivo o los elementos del archivo en otros archivos de LookML de tu proyecto. Consulta la página de documentación del parámetro include para obtener más información.

Cómo borrar archivos y carpetas

Para borrar una carpeta o un archivo, selecciona Delete en el menú File Options del elemento en el panel izquierdo del IDE.

Nota: Si borras una carpeta, también se borrará su contenido, por lo que debes tener cuidado cuando borres carpetas. Antes de borrar una carpeta, haz lo siguiente:

• Verifica que quieres borrar los archivos de la carpeta o muévelos a otra ubicación antes de borrarla.
• Verifica que la carpeta no contenga ningún archivo al que se haga referencia en las declaraciones include de tu proyecto. Consulta la sección Cómo usar include con carpetas de IDE de la página de documentación del parámetro include para obtener información sobre el uso de include con carpetas de IDE.

Cuando borras una carpeta, el IDE muestra una ventana emergente de confirmación. La ventana emergente especifica cuántos elementos se incluyen en la eliminación, lo que incluye la carpeta y los archivos que contenga.

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

Borra archivos y carpetas de forma masiva

Sigue estos pasos para borrar carpetas y archivos de forma masiva:

Nota: Si borras una carpeta, se borrará todo su contenido. Antes de borrar una carpeta, verifica que quieres borrar los archivos en ella. Si quieres conservarlos, muévelos a otra ubicación antes de borrar la carpeta.

1. Selecciona el ícono Bulk Edit en la parte superior del panel File Browser.

   

2. Selecciona los elementos que quieras borrar. La cantidad de archivos seleccionados se muestra junto al encabezado Seleccionar archivos.

   

   • Para seleccionar o anular la selección de archivos individuales, expande las carpetas y selecciona la casilla de verificación junto a los nombres de archivo.
   • Para seleccionar o anular la selección de carpetas enteras y su contenido, marca la casilla de verificación junto al nombre de cada carpeta.
   • Para seleccionar una sección completa de la lista de directorios, usa la tecla Mayús y hacer clic. Selecciona la casilla de verificación del elemento superior del rango y, a continuación, mantén presionada la tecla Mayús y selecciona la casilla de verificación del último elemento de la lista. Se seleccionarán ambos elementos, así como todos los que se encuentran en ese nivel. También puedes simplemente hacer clic con Mayúsculas y hacer clic en un elemento para seleccionarlo y todo lo que esté encima de él en la lista de directorios.

3. Selecciona el ícono de la papelera de Eliminar elementos. Luego, el IDE mostrará un menú emergente con los elementos seleccionados.

   

4. Selecciona Sí, Borrar para confirmar los elementos que deseas borrar, o bien haz clic en Cancelar para volver a la selección de elementos.

5. Selecciona la X del encabezado Seleccionar archivos para salir del modo de edición masiva.

Mueve elementos en un proyecto con carpetas

Para mover archivos, arrastra y suelta un archivo o una carpeta en otra carpeta.

No es necesario expandir la carpeta de destino para recibir otras carpetas o archivos. Las carpetas se expanden automáticamente cuando colocas el cursor sobre ellas.

Nota: Cuando cambies la ruta de acceso de un archivo, asegúrate de actualizar las sentencias include de tu proyecto para que coincidan con la ruta de acceso del archivo nueva. Consulta la sección Cómo usar include con carpetas de IDE de la página de documentación del parámetro include para obtener información sobre el uso de include con carpetas de IDE.

Además, ten en cuenta que, cuando cambias la ruta de acceso de un archivo, Git borra efectivamente el archivo y crea uno nuevo con la nueva ruta de acceso. Esto significa que el historial de Git del archivo estará vacío, porque Git lo considera un archivo nuevo. Para ver el historial de Git del archivo antes de moverlo, usa tu interfaz de Git para navegar al archivo en su ubicación original y ver el historial de Git desde allí. (La misma lógica se aplica a un archivo al que le cambiaste el nombre, ya que Git borra efectivamente el archivo y crea uno nuevo con un nombre diferente).

Mueve archivos y carpetas de forma masiva

Para mover carpetas y archivos de forma masiva, haz lo siguiente:

1. Selecciona el ícono Bulk Edit en la parte superior del panel File Browser.

   

2. Selecciona los elementos que quieras mover. La cantidad de archivos seleccionados se muestra junto al encabezado Seleccionar archivos.

   

   • Para seleccionar o anular la selección de archivos individuales, expande las carpetas y selecciona la casilla de verificación junto a los nombres de archivo.
   • Para seleccionar o anular la selección de carpetas enteras y su contenido, marca la casilla de verificación junto al nombre de cada carpeta.
   • Para seleccionar una sección completa de la lista de directorios, usa la tecla Mayús y hacer clic. Selecciona la casilla de verificación del elemento superior del rango y, a continuación, mantén presionada la tecla Mayús y selecciona la casilla de verificación del último elemento de la lista. Se seleccionarán ambos elementos, así como todos los que se encuentran en ese nivel. También puedes simplemente hacer clic con Mayúsculas y hacer clic en un elemento para seleccionarlo y todo lo que esté encima de él en la lista de directorios.

3. Selecciona el ícono de carpeta Mover elementos para seleccionar la opción. El IDE mostrará un menú emergente de selección de carpetas.

   

4. En el menú emergente Mover a, elige una carpeta para los elementos seleccionados o selecciona Carpeta nueva para crear una carpeta nueva. El nombre del proyecto mostrará la ruta de acceso del archivo de la carpeta que seleccionaste en la parte superior de la siguiente página del menú. Para mover elementos al directorio raíz de tu proyecto, selecciona Move sin una carpeta seleccionada.

5. Confirma el destino seleccionado seleccionando Mover, crea una carpeta nueva dentro de la carpeta seleccionada seleccionando Nueva carpeta o regresa al menú de opciones de la carpeta principal seleccionando el vínculo del nombre del proyecto en la ruta del archivo.

6. Selecciona la X del encabezado Seleccionar archivos para salir del modo de edición masiva.

Nota: Después de cambiar la ruta de acceso de un archivo, asegúrate de actualizar las sentencias include de tu proyecto para que coincidan con la ruta de acceso del archivo nuevo. Consulta la sección Cómo usar include con carpetas de IDE de la página de documentación del parámetro include para obtener información sobre el uso de include con carpetas de IDE.

Además, ten en cuenta que, cuando cambias la ruta de acceso de un archivo, Git borra efectivamente el archivo y crea uno nuevo con la nueva ruta de acceso. Esto significa que el historial de Git del archivo estará vacío, porque Git lo considera un archivo nuevo. Para ver el historial de Git del archivo antes de moverlo, usa tu interfaz de Git para navegar al archivo en su ubicación original y ver el historial de Git desde allí. (La misma lógica se aplica a un archivo al que le cambiaste el nombre, ya que Git borra efectivamente el archivo y crea uno nuevo con un nombre diferente).