Administra archivos y carpetas de LookML

Los archivos de proyectos 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.

Convenciones de nomenclatura importantes de archivos y carpetas

Cuando crees archivos y carpetas, ten en cuenta las siguientes convenciones de nombres:

  • Distinción entre mayúsculas y minúsculas: LookML distingue mayúsculas de minúsculas. Asegúrate de cumplir con las convenciones de tu proyecto cuando asignes nombres a las carpetas. Por ejemplo, si tu convención es usar todas las letras minúsculas en tu proyecto, deberías nombrar tu carpeta views en lugar de Views. Esto marca la diferencia, en especial, cuando necesitas especificar la ruta de un archivo, como cuando incluyes archivos. En general, es conveniente usar letras minúsculas de forma coherente cuando nombres 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 le asignará el nombre flights_data_tests.lkml.
  • Cambia el nombre visible de un objeto de LookML: Si deseas cambiar el nombre visible de un modelo o un objeto de 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, al mismo tiempo, conservan la URL subyacente que se usa para los correos electrónicos y otros sistemas. En general, debes tomar precauciones para que los cambios en el modelo sean lo menos invasivos posible. Si necesitas cambiar el nombre de un modelo o un objeto, usa el Validador de contenido para actualizar todas las referencias al modelo o al objeto.

Crea carpetas

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

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, al que puedes acceder seleccionando el ícono + (más) en la parte superior del panel Explorador 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.

La carpeta nueva se agrega al panel de navegación.

Creación de archivos

Looker crea automáticamente un archivo de modelo y archivos de vista que se basan en tu base de datos cuando generas un modelo. En el caso de los proyectos existentes, puedes crear archivos nuevos de forma manual.

Para crear un archivo nuevo en tu proyecto de LookML, sigue estos pasos:

  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, al que puedes acceder seleccionando el ícono + (más) en la parte superior del panel Explorador de archivos.
    • 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 LookML que deseas 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:

  3. En el diálogo Create File, ingresa un nombre para el archivo nuevo. Consulta la sección Convenciones importantes de nombres de archivos y carpetas para conocer las limitaciones y los lineamientos para asignar nombres a tus archivos.

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

Consideraciones para crear archivos

Ten en cuenta las siguientes consideraciones cuando crees archivos:

  • 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 o subiéndolos al 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 nombres correctas y de incluir la extensión .lkml en el nombre del archivo (o explore.lkml para los archivos de Explore). Si un nombre de archivo incluye caracteres no admitidos, el navegador de archivos del IDE de Looker mostrará el nombre de archivo en rojo y no podrás ver el contenido del archivo hasta que cambies el nombre del archivo con caracteres admitidos. Además, el IDE de Looker no mostrará el archivo en absoluto si no tiene la extensión .lkml.
  • Una vez que crees un archivo, asegúrate de usar el parámetro include si deseas 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.
  • Si creas un archivo anidado en siete o más carpetas, el Explorador de archivos no lo mostrará.
  • Para crear archivos de manifiesto del proyecto, solo debes seleccionar el ícono + (más) para abrir el menú Add file or folder 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 puede tener un solo archivo de manifiesto, y este debe estar ubicado en el nivel raíz de la estructura de directorios del proyecto.
  • La opción Create Locale Strings File solo está disponible en el ícono Add file or folder + (más) en la parte superior del navegador de archivos del IDE de Looker. Sin embargo, una vez que se crea un archivo de cadenas de configuración regional (o se sube), puedes mover el archivo a una carpeta. Si creas archivos de cadenas de configuración regional para localizar tu modelo y también deseas aprovechar la localización de la IU integrada de Looker, debes asignarles nombres a los archivos de cadenas con códigos de configuración regional específicos, que puedes encontrar en la sección Configuración regional de la página de documentación Usuarios.
  • Cuando creas un archivo de 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 de LookML genéricos, Looker agregará .lkml al final del nombre del archivo si no está la extensión, pero aún debes agregar manualmente la parte .explore de la extensión al nombre del archivo. Por ejemplo, para crear un archivo de exploración llamado flights con el IDE de Looker, puedes ingresar flights.explore o flights.explore.lkml, y el archivo se llamará flights.explore.lkml.

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 que se describen en esta página para crear archivos de vista en blanco y para subir archivos, existen muchas formas en que un desarrollador de Looker en Modo de desarrollo puede agregar archivos de vista a un proyecto de LookML:

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 función Explorar existente en tu archivo de modelo.

Cómo agregar una vista nueva a partir de una tabla de base de datos existente

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

  1. Dentro de un proyecto, selecciona el menú Add file or folder haciendo clic en 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.

  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 parte superior izquierda.

  4. Para seleccionar las tablas a partir de las cuales deseas crear vistas, marca 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.

  5. Ve a la parte inferior de la página y selecciona Crear vista.

  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 de forma local en tu computadora.

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

  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 directorios.
  3. Una vez que se suba el archivo, muévelo a otra carpeta.

Cómo borrar archivos y carpetas

Si borras una carpeta, también se borra su contenido, así que ten cuidado. Antes de borrar una carpeta, sigue estos pasos:

  • Verifica que deseas borrar los archivos de la carpeta o mover los archivos 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 sentencias 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.

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

Cuando borras una carpeta, el IDE muestra un diálogo de confirmación. El diálogo especifica cuántos elementos se incluyen en la eliminación, lo que incluye la carpeta y los archivos que contiene.

Si borras un archivo de modelo, este no se quitará de ningún conjunto 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 incluye en cualquier conjunto de modelos que incluya el modelo borrado. Esto puede dar acceso no deseado al archivo del modelo nuevo. 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

Si borras una carpeta, también se borra su contenido, así que ten cuidado. Antes de borrar una carpeta, sigue estos pasos:

  • Verifica que deseas borrar los archivos de la carpeta o mover los archivos 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 sentencias 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.

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

  1. Selecciona el ícono Editar en bloque en la parte superior del panel Explorador de archivos.

  2. Selecciona los elementos que quieres borrar. La cantidad 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 archivo.
    • 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, mantén presionada la tecla Mayúsculas y haz clic. Selecciona la casilla de verificación del primer elemento del rango y, luego, mantén presionada la tecla Mayúsculas y selecciona la casilla de verificación del último elemento de la lista. Se seleccionarán ambos elementos, así como todos los elementos que se encuentren entre ellos. También puedes mantener presionada la tecla Mayúsculas y hacer clic en un elemento para seleccionarlo y todos los elementos que lo preceden en la lista del directorio.

  3. Selecciona el ícono de papelera Borrar elementos. Luego, el IDE mostrará un diálogo con la lista de los elementos seleccionados.

  4. Para confirmar los elementos que se borrarán, selecciona Sí, borrar o Cancelar para volver a la selección de elementos.

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

Cómo mover elementos en un proyecto con carpetas

Para mover archivos, arrástralos a otra carpeta.

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

Cuando cambies la ruta de un archivo, asegúrate de actualizar las instrucciones include de tu proyecto para que coincidan con la nueva ruta. 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 un archivo, Git lo borra de forma efectiva y crea uno nuevo con la ruta 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 del archivo antes de que se moviera, usa la 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 cuyo nombre se cambió, ya que Git borra el archivo y crea uno nuevo con un nombre diferente).

Cómo mover archivos y carpetas de forma masiva

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

  1. Selecciona el ícono Editar en bloque en la parte superior del panel Explorador de archivos.

  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 sus carpetas y selecciona la casilla de verificación junto a los nombres de archivo.
    • 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, mantén presionada la tecla Mayúsculas y haz clic. Selecciona la casilla de verificación del primer elemento del rango y, luego, mantén presionada la tecla Mayúsculas y selecciona la casilla de verificación del último elemento de la lista. Se seleccionarán ambos elementos, así como todos los elementos que se encuentren entre ellos. También puedes mantener presionada la tecla Mayúsculas y hacer clic en un elemento para seleccionarlo y todos los archivos anteriores en la lista del directorio.

  3. Selecciona el ícono de carpeta Mover elementos para elegir la opción. Luego, el IDE mostrará un diálogo de selección de carpetas.

  4. En el cuadro de diálogo Mover a, elige una carpeta para los elementos seleccionados o selecciona Nueva carpeta para crear una nueva. El nombre del proyecto mostrará la ruta de acceso 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 Mover sin seleccionar una carpeta.

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

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

Después de cambiar la ruta de un archivo, asegúrate de actualizar las instrucciones include de tu proyecto para que coincidan con la nueva ruta. 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 un archivo, Git lo borra de forma efectiva y crea uno nuevo con la ruta 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 del archivo antes de que se moviera, usa la 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 cuyo nombre se cambió, ya que Git borra el archivo y crea uno nuevo con un nombre diferente).