Introducción al desarrollo en un lugar de trabajo

Este documento te ayuda a comprender el concepto de espacios de trabajo en Dataform y sus capacidades.

En Dataform, interactúas con el código de tu flujo de trabajo de SQL en un lugar de trabajo de desarrollo. Un espacio 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 y, luego, confirmar y enviar los cambios al repositorio.

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

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

Componentes de un espacio de trabajo de desarrollo

Un espacio 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, controlar las versiones de tus cambios y activar la ejecución en BigQuery.
Gráfico compilado
Muestra el flujo de trabajo de SQL compilado definido 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 los 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 Supervisa los registros de ejecución.

Componentes de la pestaña Código

La pestaña Code de un espacio 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 espacio de trabajo. Guarda automáticamente tus ediciones en la estructura del archivo. Los archivos seleccionados se abren en pestañas en el panel de desarrollo. En el campo Escribe para buscar, puedes buscar archivos o directorios en tu espacio de trabajo por su ruta.
Panel de control de versiones
Muestra el estado del control de versión de tu espacio de trabajo y las opciones de control de versión.
Panel de desarrollo
Muestra los archivos abiertos en pestañas. Guarda automáticamente los cambios en los archivos editados.
Botón Ejecutar
Ejecuta una vista previa de la consulta de SQL compilada.
Botón de formato
Da formato al 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 que se está editando.
Panel de consultas compiladas
Compila las consultas del archivo editado actualmente en SQL. Si falla la compilación de la consulta, se muestran errores de compilación. Si la compilación de la consulta se realiza correctamente, se muestran las consultas compiladas y se validan mediante pruebas sin conexión en BigQuery. Si falla la validación de la consulta, se muestran errores de validación. Si la validación de la consulta se realiza correctamente, se muestra cuántos bytes usaría la ejecución de las consultas a BigQuery.
Menú desplegable Iniciar ejecución
Muestra opciones para activar la ejecución de todo el flujo de trabajo en tu espacio de trabajo o sus elementos seleccionados.

Componentes de la pestaña Gráfico compilado

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

Puedes acercar y alejar la imagen, y usar el arrastre para navegar por el gráfico.

Puedes filtrar el gráfico por las siguientes propiedades:

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

Puedes seleccionar varios filtros a la vez. Dataform los 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 los elementos dependientes de la acción seleccionada.
Panel de consultas
Muestra la consulta de SQL compilada de la acción seleccionada.

Control de versiones en un espacio de trabajo

En un espacio de trabajo, interactúas con el repositorio a través del control de versiones basado en Git. Las ediciones que realices en los archivos de tu espacio de trabajo comienzan como cambios locales no confirmados que puedes confirmar y, luego, enviar a tu 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 los cambios de tu espacio de trabajo a tu rama de desarrollo principal. Seleccionas la rama principal cuando conectas 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 del repositorio de Dataform o del repositorio remoto y combinarlos con los cambios locales en tu espacio de trabajo de desarrollo. Para obtener más información sobre el control de versión en Dataform, consulta Controla la versión de tu código.

¿Qué sigue?