Administrar archivos y carpetas de LookML

Los archivos del 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 sobre tipos de archivos en un proyecto de LookML.

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

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 de tu proyecto cuando asignes nombres a tus carpetas. Por ejemplo, si tu convención es usar todas las letras minúsculas en tu proyecto, debes asignar el nombre views a la carpeta en lugar de Views. Esto marca la diferencia, en especial, cuando necesita especificar la ruta de un archivo, como cuando se incluyen archivos. En general, es recomendable usar letras minúsculas de forma coherente cuando nombras objetos y carpetas LookML.
• Espacios y caracteres especiales: Los nombres de archivo no pueden incluir espacios ni ninguno de los siguientes caracteres: / ? * : | " < > %
• Extensiones de archivo: Cuando creas archivos LookML con el IDE de Looker, Looker agrega automáticamente la extensión .lkml al final del nombre de archivo si no la incluyes manualmente. Por ejemplo, si ingresas el nombre del archivo flights_data_tests, Looker asignará el nombre flights_data_tests.lkml.
• Cambia el nombre que se muestra de un objeto LookML: Si deseas cambiar el nombre que se muestra de un modelo o de un objeto LookML, considera usar el parámetro label o el parámetro alias en lugar de cambiar el nombre del archivo o del objeto. 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 en el modelo no sean tan invasivos. Si necesitas cambiar el nombre de un modelo o de un objeto, usa el Validador de contenido para actualizar todas las referencias al objeto o modelo.

Crea carpetas

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

Nota: Cuando crees carpetas, ten en cuenta que LookML distingue mayúsculas de minúsculas. Asegúrate de cumplir con las convenciones de tu proyecto cuando asignes nombres a tus carpetas. Esto es importante, especialmente cuando necesita especificar la ruta de un archivo, como cuando incluye archivos. En general, es recomendable usar letras minúsculas de forma coherente cuando nombras objetos y carpetas LookML. Consulta las notas importantes sobre cómo crear archivos y carpetas a fin de conocer las limitaciones y los lineamientos para asignarles nombres.

Para crear una carpeta, haz lo siguiente:

1. Selecciona la opción Crear carpeta del menú correspondiente:
   • Para crear una carpeta nueva en el nivel superior de la estructura del directorio, usa el menú Add file or folder. Para ello, selecciona el ícono + (más) ubicado en la parte superior del panel File Browser.
   • Para crear una subcarpeta 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 un archivo de modelo y ver archivos según tu base de datos automáticamente cuando creas un proyecto nuevo. Para proyectos existentes, puedes crear archivos nuevos de forma manual.

Nota: Te recomendamos que uses el IDE de Looker para agregar archivos a tu proyecto de LookML, ya sea creándolos en el IDE de Looker como se describe a continuación en esta sección o subiéndolos en el IDE de Looker. Si, en cambio, creas archivos fuera del IDE de Looker y, luego, usas el IDE de Looker para extraer (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 Explorar). Si un nombre de archivo incluye caracteres no compatibles, el navegador de archivos de IDE del Looker mostrará el nombre del archivo en rojo, y no podrás ver el contenido del archivo hasta que le cambies el nombre con 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 del directorio, usa el menú Add file or folder. Para ello, selecciona el ícono + (más) ubicado en la parte superior del panel File Browser.
   • Para crear un archivo nuevo en una carpeta existente, usa el menú de tres puntos Opciones de carpeta de la carpeta existente.

2. Selecciona el tipo de archivo de LookML que quieras crear. Selecciona los vínculos 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
   • Visualice archivos con la extensión de archivo .view.lkml*
   • Archivos de manifiesto del proyecto que siempre se denominan manifest.lkml**
   • Archivos del panel con la extensión de archivo .dashboard.lookml
   • Archivos de documentos con la extensión .md
   • Archivos de strings 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 mejoras 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 y obtén instrucciones sobre cómo crear métodos de creación de archivos de vista alternativos, incluido cómo agregar archivos de vista basados en tablas de bases de datos.

   ^** Los archivos de manifiesto del proyecto solo se pueden crear si seleccionas el ícono + (más) para abrir el menú Agregar archivo o carpeta en la parte superior del navegador de archivos del 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 debe ubicarse en el nivel raíz de la estructura del directorio del proyecto.

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

   ^**** Cuando creas un archivo Explorar, 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 .explore la parte de la extensión de forma manual. Por ejemplo, para crear un archivo 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. Consulte las notas importantes sobre cómo crear archivos y carpetas a fin de conocer las limitaciones y los lineamientos para asignarles nombres.

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

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

Nota: Si tu administrador de Looker habilitó la función de Labs de generación de LookML mejorada, el menú Agregar carpeta o archivo + (más) en la parte superior del panel Navegador de archivos mostrará una opción para Generar LookML desde Database, 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:

• Creación de archivos de vista basados en tablas en una base de datos:

  • Generación de archivos de vista a partir de tablas de bases de datos la primera vez que te conectas a la base de datos, como se describe en la página de documentación Cómo generar un modelo
  • Generar archivos de vista desde tablas de bases 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

• Cómo crear un archivo de vista para una tabla derivada:

  • Comience con un archivo de vista en blanco mediante una de las opciones que se describen en esta página 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.
  • Cómo hacer que Looker cree la LookML de tabla derivada a partir de Explore, 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
  • Cómo hacer que Looker cree la tabla derivada de LookML a partir de una consulta de SQL Runner, como se describe en la página de documentación Cómo usar 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 Explorar del 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 el modo de desarrollo.

1. En un proyecto, para seleccionar el menú Add file or folder, selecciona el signo + (más) en la parte superior de la lista de archivos del proyecto en el IDE de Looker. También puedes seleccionar el menú de una carpeta para crear el archivo dentro de ella.

2. Selecciona Create View From Table.

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

4. Para seleccionar las tablas a partir de las que desea crear vistas, marque la casilla que se encuentra a la izquierda del nombre de la tabla. Puede contraer y expandir bases de datos o 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 LookML localmente en tu computadora.

Nota: Consulta las notas importantes sobre cómo crear archivos y carpetas a fin de conocer las limitaciones y los lineamientos para asignarles nombres.

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 del directorio.
3. Una vez que se suba el archivo, mueva el elemento a otra carpeta.

Importante: Una vez que subas el archivo, asegúrate de usar el parámetro include si deseas hacer referencia al archivo o a los elementos del archivo en otros archivos 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ú de tres puntos File Options del elemento, que se encuentra 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 borrar la carpeta.
• 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 del IDE de la página de documentación del parámetro include para obtener información sobre el uso de include con las carpetas del IDE.

Cuando borras una carpeta, el IDE muestra una ventana emergente de confirmación. La ventana emergente especifica cuántos elementos se incluirán en la eliminación, lo que incluye la carpeta y cualquier archivo dentro de ella.

Nota: Si borras un archivo de modelo, este no se quita de ningún conjunto de modelos al que pertenecía el modelo. 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 provocar el acceso no deseado al nuevo archivo del modelo. Los administradores de Looker pueden editar conjuntos de modelos y quitar un modelo borrado para evitar este problema.

Cómo borrar archivos y carpetas de forma masiva

Para borrar carpetas y archivos de forma masiva, sigue estos pasos:

Nota: Si borras una carpeta, se borrará todo su contenido. Antes de borrar una carpeta, verifica si quieres borrar sus archivos. Si quieres conservarlos, mueve los archivos a otra ubicación antes de borrar la carpeta.

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

   

2. Selecciona los elementos que quieras borrar. El número de archivos seleccionados se muestra junto al encabezado Seleccionar archivos.

   

   • Para seleccionar o anular la selección de archivos individuales, expande sus carpetas y selecciona la casilla de verificación junto a los nombres de los archivos.
   • Para seleccionar o anular la selección de carpetas completas y su contenido, marca la casilla de verificación junto al nombre de la carpeta.
   • Para seleccionar una sección completa de la lista de directorios, usa la tecla Mayúsculas y haz clic. Selecciona la casilla de verificación del elemento principal del rango, mantén presionada la tecla Mayúsculas y selecciona la casilla de verificación del último elemento de la lista. Se seleccionarán tanto los elementos como todos los demás. También puedes presionar Mayúsculas y hacer clic en un elemento para seleccionarlo y todo lo que aparece encima de él en la lista de directorios.

3. Selecciona el ícono de la papelera Borrar elementos. Luego, el IDE mostrará un menú emergente en el que se mostrarán los elementos seleccionados.

   

4. Selecciona Sí, Borrar para confirmar los elementos que quieres borrar o Cancelar para volver a la selección del elemento.

5. Selecciona X en el encabezado Select Files para salir del modo de edición masiva.

Mueve elementos en un proyecto en carpeta

Puedes arrastrar y soltar un archivo o una carpeta completa con todo su contenido en ubicaciones nuevas:

Arrastra y suelta un archivo o una carpeta en otra carpeta. No es necesario expandir la carpeta de destino para recibir otros archivos o carpetas. Una carpeta se expande automáticamente cuando te desplazas sobre ella.

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

Además, ten en cuenta que, cuando cambias la ruta de un archivo, Git lo borra de manera efectiva y crea un archivo nuevo con la ruta de acceso nueva. Esto significa que el historial de Git del archivo estará vacío, ya que Git lo considera un archivo nuevo. Para ver el historial de Git antes de transferirlo, use la interfaz de Git a fin de 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 se le cambia el nombre, ya que Git borra el archivo de manera efectiva y crea un archivo nuevo con un nombre diferente).

Cómo mover archivos y carpetas de forma masiva

Para mover carpetas y archivos de forma masiva:

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

   

2. Selecciona los elementos que quieras mover. El número de archivos seleccionados se muestra junto al encabezado Seleccionar archivos.

   

   • Para seleccionar o anular la selección de archivos individuales, expande sus carpetas y selecciona la casilla de verificación junto a los nombres de los archivos.
   • Para seleccionar o anular la selección de carpetas completas y su contenido, marca la casilla de verificación junto al nombre de la carpeta.
   • Para seleccionar una sección completa de la lista de directorios, usa la tecla Mayúsculas y haz clic. Selecciona la casilla de verificación del elemento principal del rango, mantén presionada la tecla Mayúsculas y selecciona la casilla de verificación del último elemento de la lista. Se seleccionarán tanto los elementos como todos los demás. También puedes presionar Mayúsculas y hacer clic en un elemento para seleccionarlo y todo lo que aparece encima de él en la lista de directorios.

3. Selecciona el ícono de la carpeta Mover elementos para seleccionar la opción. Luego, el IDE mostrará un menú emergente para seleccionar una carpeta.

   

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

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

6. Selecciona X en el encabezado Select Files para salir del modo de edición masiva.

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

Además, ten en cuenta que, cuando cambias la ruta de un archivo, Git lo borra de manera efectiva y crea un archivo nuevo con la ruta de acceso nueva. Esto significa que el historial de Git del archivo estará vacío, ya que Git lo considera un archivo nuevo. Para ver el historial de Git antes de transferirlo, use la interfaz de Git a fin de 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 se le cambia el nombre, ya que Git borra el archivo de manera efectiva y crea un archivo nuevo con un nombre diferente).