Crear entornos de desarrollo

En esta guía de inicio rápido, se explican los pasos para crear entornos de desarrollo individuales en Dataform, de modo que cada desarrollador pueda trabajar en su propio entorno de desarrollo:

Antes de comenzar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery and Dataform APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the BigQuery and Dataform APIs.

    Enable the APIs

    8.

Roles obligatorios

Para obtener los permisos que necesitas para realizar todas las tareas de este instructivo, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

  • Administrador de Dataform (roles/dataform.admin): Repositorios
  • Editor de Dataform (roles/dataform.editor): invocaciones de flujos de trabajo y lugares 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 repositorio de Dataform

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

    Ir a Dataform

  2. Haz clic en Crear repositorio.

  3. En la página Crear repositorio, haz lo siguiente:

    1. En el campo ID del repositorio, ingresa quickstart-dev.

    2. En la lista Región, selecciona europe-west4.

    3. Haz clic en Crear.

  4. Haz clic en Listo.

Otorga acceso de Dataform a BigQuery

Para ejecutar flujos de trabajo en BigQuery, la cuenta de servicio de Dataform debe tener los siguientes roles obligatorios:

Para otorgar estos roles, sigue estos pasos:

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

    Ve a la página IAM

  2. Haz clic en Agregar.

  3. En el campo Principales nuevas, ingresa el ID de tu cuenta de servicio de Dataform.

  4. En la lista desplegable Seleccionar un rol, selecciona el rol Usuario de trabajo de BigQuery.

  5. Haz clic en Agregar otro rol y, luego, en la lista desplegable Selecciona un rol, selecciona el rol Editor de datos de BigQuery.

  6. Haz clic en Agregar otro rol y, luego, en la lista desplegable Selecciona un rol, elige el rol Visualizador de datos de BigQuery.

  7. Haz clic en Guardar.

Configura anulaciones de compilación de espacios de trabajo

Para crear entornos de desarrollo aislados con anulaciones de compilación de lugares de trabajo de Dataform, sigue estos pasos:

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

    Ir a Dataform

  2. Haz clic en quickstart-dev.

  3. Haz clic en Configuración y, luego, en Editar.

  4. En el panel Anulaciones de compilación de lugares de trabajo, en el campo Sufijo de esquema, ingresa ${workspaceName}.

    Cuando actives la ejecución en un lugar de trabajo, Dataform agregará el nombre del lugar de trabajo como sufijo al esquema predeterminado que se establece en la configuración del flujo de trabajo. En esta guía de inicio rápido, se usa la configuración predeterminada de Dataform con el esquema predeterminado dataform.

  5. Haz clic en Guardar.

Dataform aplica anulaciones de compilación de lugares de trabajo a todos los lugares de trabajo en tu repositorio.

Con esta configuración, cuando ejecutas un flujo de trabajo de SQL de forma manual en un lugar de trabajo, Dataform lo ejecuta con anulaciones de compilación del lugar de trabajo. Como resultado, Dataform ejecuta el flujo de trabajo de SQL en el esquema dataform_workspaceName en BigQuery, lo que convierte el lugar de trabajo en un entorno de desarrollo aislado.

Por ejemplo, cuando activas de forma manual la ejecución en un lugar de trabajo sasha, Dataform ejecuta tu flujo de trabajo de SQL en el esquema dataform_sasha en BigQuery.

Para ejecutar flujos de trabajo de SQL sin anulaciones de compilación de lugares de trabajo, pero conservar las anulaciones de compilación de lugares de trabajo para entornos de desarrollo, puedes crear configuraciones de lanzamiento para configurar otros entornos de ejecución, por ejemplo, staging y production.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Borra los conjuntos de datos creados en BigQuery

Para evitar que se apliquen cargos por los recursos de BigQuery, borra los conjuntos de datos que tengan nombres que comiencen en dataform, por ejemplo, dataform-sasha.

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

    Ir a BigQuery

  2. En el panel Explorador, expande tu proyecto y selecciona un conjunto de datos.

  3. Haz clic en el menú Acciones y, luego, selecciona Borrar.

  4. En el cuadro de diálogo Borrar conjunto de datos, ingresa delete en el campo y, luego, haz clic en Borrar.

Borra el repositorio de Dataform

Crear repositorios de Dataform no genera costos. Sin embargo, si deseas borrar un repositorio y todo su contenido, sigue estos pasos:

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

    Ir a Dataform

  2. Para las quickstart-dev, haz clic en el menú Más y, luego, selecciona Borrar.

    1. En la ventana Borrar repositorio, ingresa el nombre del repositorio para confirmar su eliminación.

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

¿Qué sigue?