Crea un lugar de trabajo de desarrollo de Dataform

Este documento te muestra cómo hacer lo siguiente:

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

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

  • definitions/: Es un directorio para las definiciones de elementos, en Dataform Core o JavaScript.

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

  • dataform.json: 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 publicarán los recursos. Puedes anular la configuración predeterminada para personalizarla según tus necesidades, pero no es obligatorio para comenzar a usar Dataform.

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

  • definitions/sample.sqlx: Es un archivo de SQLX de muestra para ayudarte a comenzar.

Antes de comenzar

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

Funciones obligatorias

Si quieres obtener los permisos que necesitas para crear, inicializar y borrar un lugar 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 lugares de trabajo. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios mediante funciones personalizadas, o bien otras funciones predefinidas.

Crea un lugar 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 lugar 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 ID 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 Espacios de trabajo de desarrollo, haz clic en el nombre del lugar de trabajo vacío que quieras inicializar.

  4. En la página del lugar de trabajo de desarrollo, haz clic en Inicializar lugar 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 quieres borrar un lugar de trabajo de desarrollo, sigue estos pasos:

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

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

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

    Puedes borrar varios lugares de trabajo a la vez.

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

¿Qué sigue?