Crea un espacio de trabajo de desarrollo de Dataform

Este documento te muestra cómo hacer lo siguiente:

Cuando creas un espacio de trabajo de desarrollo en un repositorio nuevo por primera vez, Dataform te solicita que lo inicialices con un conjunto de archivos de configuración necesarios para que Dataform funcione.

Un espacio de trabajo de desarrollo inicializado contiene los siguientes directorios y archivos:

  • definitions/: Es un directorio para las definiciones de recursos, en el núcleo de Dataform o en JavaScript.

  • includes/: Es un directorio vacío para secuencias de comandos y variables que puedes volver a usar en el repositorio.

  • workflow_settings.yaml: Es el archivo de configuración predeterminado de Dataform que contiene el ID del proyecto de Google Cloud y el esquema de BigQuery en el que se publican los recursos. Puedes anular la configuración predeterminada para personalizarla según tus necesidades, pero no es un requisito para comenzar a usar Dataform.

  • package.json: El archivo de configuración de dependencias predeterminadas de Dataform con la versión más reciente de @dataform/core. Puedes usar este archivo para importar paquetes.

  • definitions/sample.sqlx: Un archivo SQLX de ejemplo para ayudarte a comenzar.

Antes de comenzar

Si aún no lo hiciste, crea un repositorio de Dataform.

Roles obligatorios

Para obtener los permisos que necesitas para crear, inicializar y borrar un espacio de trabajo de desarrollo, pídele a tu administrador que te otorgue el rol de IAM de editor de Dataform (roles/dataform.editor) en los espacios de trabajo. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Crea un espacio de trabajo de desarrollo de Dataform

Para crear un nuevo lugar de trabajo de desarrollo de Dataform, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Dataform.

    Ir a Dataform

  2. Selecciona el repositorio en el que deseas crear el nuevo lugar de trabajo de desarrollo.

  3. En la página del repositorio, haz clic en Crear lugar de trabajo de desarrollo.

  4. En la ventana Crear espacio de trabajo de desarrollo, haz lo siguiente:

    1. En el campo ID del lugar de trabajo, ingresa un ID único para el lugar de trabajo de desarrollo.

      Los IDs solo pueden incluir números, letras, guiones y guiones bajos.

    2. Haz clic en Crear.

Inicializa el primer lugar de trabajo de desarrollo en un repositorio de Dataform

Para inicializar un lugar de trabajo de desarrollo de Dataform, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Dataform.

    Ir a Dataform

  2. Selecciona el repositorio en el que deseas inicializar el lugar de trabajo vacío.

  3. En la pestaña Lugares de trabajo de desarrollo, haz clic en el nombre del lugar de trabajo vacío que deseas inicializar.

  4. En la página del espacio de trabajo de desarrollo, haz clic en Inicializar espacio de trabajo.

Borra un lugar de trabajo de desarrollo de Dataform

La creación de lugares de trabajo de desarrollo de Dataform no tiene costos asociados. Sin embargo, si deseas borrar un lugar de trabajo de desarrollo, sigue estos pasos:

  1. En la página Dataform, haz clic en el repositorio que contiene el espacio de trabajo que deseas borrar.

  2. Para evitar borrar los cambios sin confirmar, confirma y envía los cambios a tu repositorio de Git.

  3. En la pestaña Lugares de trabajo de desarrollo, selecciona el lugar de trabajo de desarrollo que quieres borrar y, luego, haz clic en Borrar lugares de trabajo seleccionados.

    Puedes borrar varios espacios de trabajo a la vez.

  4. Para confirmar la acción, haz clic en Borrar.

¿Qué sigue?