Administrar 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.

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

Cuando crees archivos y carpetas, es mejor tener 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 al nombrar 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 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 incluyes la extensión de forma manual. Por ejemplo, si ingresas el nombre de archivo flights_data_tests, Looker le asignará el nombre flights_data_tests.lkml.
• Cambiar 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 de modelo sean lo más no 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 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. Escribe un nombre para la carpeta nueva.
3. Seleccione Crear.

La carpeta nueva se agregará al panel de navegación.

Creación de archivos

Puedes generar automáticamente un archivo de modelo y ver archivos en función de tu base de datos cuando creas un proyecto nuevo. Para los proyectos existentes, puedes crear nuevos archivos de forma manual.

Sigue estos pasos para crear un archivo nuevo en tu proyecto de LookML:

1. Selecciona el menú correspondiente:

   • 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:

   • Archivos de modelo con la extensión de archivo .model.lkml
   • Ver archivos con la extensión de archivo .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
   • Configuración regional de archivos de cadenas 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 de archivo .explore.lkml****
     • Archivos de prueba de datos con la extensión de archivo .lkml
     • Archivos de restricción con la extensión de archivo .lkml
     • Cualquier otro archivo que uses para alojar elementos de LookML

3. En la ventana emergente Create File, ingresa un nombre para el archivo nuevo. Consulta las notas importantes para crear archivos y carpetas para conocer las limitaciones y los lineamientos para asignar nombres a tus archivos.

4. Seleccione Crear. Se mostrará el archivo nuevo en el lugar en que lo creaste. Si es necesario, puedes moverlo a otra carpeta fácilmente.

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:

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

  • Generar archivos de vista a partir de tablas de base de datos cuando te conectas por primera vez a tu base de datos, como se describe en la página de documentación Cómo generar 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 a partir de una tabla de base de datos existente en esta página

• Crea un archivo de vista para una tabla derivada:

  • Comenzar con un archivo de vista en blanco con una de las opciones que se describen en esta página y, luego, definir manualmente tu tabla derivada, como se describe en la sección Definir una tabla derivada nativa en LookML de la página de documentación Cómo crear tablas derivadas nativas
  • Hacer que Looker cree la tabla derivada de LookML a partir de una Exploración, 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
  • Pedirle a Looker que cree el LookML de tabla derivada a partir de una consulta de ejecutor de SQL, como se describe en la página de documentación Usa 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 en Modo de desarrollo.

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

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 esquina 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 las bases de datos o los esquemas de esta lista para acceder a todas las tablas disponibles.

5. Desplázate hasta 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 de LookML de manera local en tu computadora.

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

1. Navega hasta 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

Para borrar una carpeta o un archivo, selecciona Delete en el menú de tres puntos File Options del elemento en el panel izquierdo del 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, incluida la carpeta y todos sus archivos.

Cómo borrar archivos y carpetas de forma masiva

Para borrar 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 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 marca 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, mantén presionada la tecla Mayúsculas y haz clic. Selecciona la casilla de verificación del primer elemento del intervalo 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 tanto los elementos como los que estén intermedios. También puedes mantener presionada la tecla Mayúsculas y hacer clic en un elemento para seleccionarlo y todo lo que esté por encima de él en la lista del directorio.

3. Selecciona el ícono de papelera Borrar elementos. Luego, el IDE mostrará un menú emergente con 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 y suéltalos en 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.

Mueve archivos y carpetas de forma masiva

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

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 sus carpetas y marca 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, mantén presionada la tecla Mayúsculas y haz clic. Selecciona la casilla de verificación del elemento superior del rango, mantén presionada la tecla Mayús y selecciona la casilla de verificación del último elemento de la lista. Se seleccionarán tanto los elementos como los que estén intermedios. También puedes presionar la tecla Mayúsculas y hacer clic en un elemento para seleccionar el elemento y todo lo que se encuentra por encima de él en la lista de directorios.

3. Selecciona el ícono de carpeta Mover elementos para seleccionar la opción. A continuació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 Nueva carpeta 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 página del menú siguiente. 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 Carpeta nueva o vuelve al menú principal de opciones de carpeta seleccionando el vínculo del nombre del proyecto en la ruta de acceso del archivo.

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