Introducción al desarrollo en un lugar de trabajo

Este documento te ayuda a comprender el concepto de lugares de trabajo en Dataform y sus funciones.

En Dataform, interactúas con el código del flujo de trabajo de SQL en un lugar de trabajo de desarrollo. Un lugar de trabajo de desarrollo es tu propia copia editable de un repositorio. En un lugar de trabajo, puedes crear, editar o borrar el contenido del repositorio sin afectar a otras personas que trabajan en el mismo repositorio. Luego, confirmas y envías los cambios al repositorio.

Puedes desarrollar tu flujo de trabajo de SQL con Dataform Core o JavaScript. Dataform compila tu código en consultas en SQL en tiempo real.

En un lugar de trabajo de desarrollo, puedes realizar las siguientes tareas:

Componentes de un lugar de trabajo de desarrollo

Un lugar de trabajo de desarrollo de Dataform consta de las siguientes pestañas:

Código
Contiene un entorno de desarrollo en el que puedes explorar archivos, desarrollar consultas, control de versión de los cambios y activar la ejecución de BigQuery.
Gráfico compilado
Muestra el flujo de trabajo de SQL compilado que se define en tu lugar de trabajo como un grafo acíclico dirigido (DAG) interactivo. Si hay errores de compilación en tu flujo de trabajo de SQL, la pestaña mostrará un mensaje de error en lugar del gráfico.
Ejecuciones
Muestra registros de todas las ejecuciones activadas en el lugar de trabajo. También puedes ver las acciones y sus detalles para una ejecución seleccionada. Para obtener más información, consulta Inspecciona registros de ejecución del lugar de trabajo.

Componentes de la pestaña Código

La pestaña Código de un lugar de trabajo de desarrollo contiene los siguientes componentes que te permiten desarrollar flujos de trabajo de SQL:

Panel de archivos
Muestra la estructura de archivos de tu lugar de trabajo. Guarda automáticamente las modificaciones en la estructura de archivos. Los archivos seleccionados se abren en pestañas del panel de desarrollo. En el campo Escribe para buscar, puedes buscar archivos o directorios en el lugar de trabajo por su ruta de acceso.
Panel de control de versión
Muestra el estado del control de versión de tu lugar de trabajo y las opciones de control de versión.
Panel de desarrollo
Muestra los archivos abiertos en pestañas. Guarda automáticamente tus cambios en los archivos editados.
Botón Ejecutar
Ejecuta una vista previa de la consulta en SQL compilada.
Botón de formato
Formatea tu código principal de Dataform o JavaScript.
Estado de compilación
Muestra el estado de compilación del código en tu lugar de trabajo.
Panel de metadatos
Muestra los metadatos del archivo editado actualmente.
Panel de consultas compiladas
Compila las consultas en el archivo editado en ese momento en SQL. Si la compilación de la consulta falla, se muestran errores de compilación. Si la compilación de la consulta se realiza de forma correcta, muestra las consultas compiladas y las valida mediante ejecuciones de prueba en BigQuery. Si la validación de la consulta falla, muestra errores de validación. Si la validación de consultas es exitosa, muestra cuántos bytes usaría la ejecución de las consultas a BigQuery.
Menú desplegable Iniciar ejecución
Muestra las opciones para activar la ejecución de todo el flujo de trabajo en tu lugar de trabajo o los elementos seleccionados.

Componentes de la pestaña Gráfico compilado

En la pestaña Gráfico compilado, se muestra un gráfico interactivo del flujo de trabajo de SQL compilado. El gráfico muestra todas las acciones en tu flujo de trabajo de SQL y las relaciones entre ellas.

Puedes acercar y alejar la imagen, y usar la función de arrastrar para navegar por el gráfico.

Puedes filtrar el gráfico según las siguientes propiedades:

  • Nombre
  • Tag (Etiqueta)
  • Tipo
    • Aserción
    • Declaración
    • Tabla incremental
    • Vista materializada
    • Operaciones
    • Tabla
    • Desconocido
    • Ver

Puedes seleccionar varios filtros a la vez. Dataform las aplicará con la condición OR.

Puedes hacer clic en una acción del gráfico para ver sus detalles en los siguientes paneles:

Panel de metadatos
Muestra el nombre completo, el tipo, las dependencias y las dependencias de la acción seleccionada.
Panel de consultas
Muestra la consulta en SQL compilada de la acción seleccionada.

Control de versiones en un lugar de trabajo

En un lugar de trabajo, interactúas con el repositorio a través del control de versión basado en Git. Las ediciones que realizas en los archivos en tu lugar de trabajo comienzan como cambios locales no confirmados que puedes confirmar y, luego, se envían al repositorio para que estén disponibles para todos los usuarios del repositorio.

Si tu repositorio está conectado a un proveedor de Git remoto, envías cambios desde tu lugar de trabajo a tu rama de desarrollo principal. Selecciona la rama principal cuando conectes tu repositorio al proveedor de Git remoto. En un repositorio de Dataform no conectado, envías los cambios a la rama predeterminada.

También puedes extraer cualquier cambio desde el repositorio de Dataform o el repositorio remoto y combinarlos con cambios locales en tu lugar de trabajo de desarrollo. Para obtener más información sobre el control de versión en Dataform, consulta Control de versiones de tu código.

¿Qué sigue?