Crear entornos de desarrollo
En esta guía de inicio rápido, se explican los pasos para crear desarrollos individuales entornos en Dataform, para que cada desarrollador pueda trabajar en su propio de entorno de desarrollo:
- Crea un Dataform Cloud Storage.
Otorga acceso a Dataform a BigQuery
Configura anulaciones de compilación que Dataform aplicará a todas espacios de trabajo en tu repositorio, con lo cual estos se convierten en lugares entornos de desarrollo de aplicaciones.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Habilita las API de BigQuery and Dataform.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Habilita las API de BigQuery and Dataform.
Roles obligatorios
A fin de obtener los permisos que necesitas para realizar todas las tareas de este instructivo, solicita a tu administrador que te otorgue el los siguientes roles de IAM en tu proyecto:
-
Administrador de Dataform (
roles/dataform.admin
): Repositorios -
Editor de Dataform (
roles/dataform.editor
): invocaciones del flujo de trabajo y lugares de trabajo
Si quieres obtener más información para otorgar roles, consulta Administra el acceso.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Crea un repositorio de Dataform
En la consola de Google Cloud, ve a la página Dataform.
Haz clic en
Crear repositorio.En la página Crear repositorio, haz lo siguiente:
En el campo ID del repositorio, ingresa
quickstart-dev
.En la lista Región, selecciona
europe-west4
.Haz clic en Crear.
Haz clic en Listo.
Otorga acceso de Dataform a BigQuery
Para ejecutar flujos de trabajo en BigQuery, la API de Dataform la cuenta de servicio debe tener los siguientes roles obligatorios:
- Editor de datos de BigQuery en proyectos para los que Dataform necesita acceso de lectura y escritura. Ellas suelen incluir el proyecto que aloja tu repositorio de Dataform.
- Visualizador de datos de BigQuery en los proyectos a los que Dataform necesita acceso de solo lectura.
- Usuario de trabajo de BigQuery en el proyecto que aloja tu repositorio de Dataform.
Para otorgar estos roles, sigue estos pasos:
En la consola de Google Cloud, ve a la página IAM.
Haz clic en Agregar.
En el campo Principales nuevas, ingresa tu servicio de Dataform. ID de la cuenta.
En la lista desplegable Seleccionar un rol, selecciona Rol Usuario del trabajo de BigQuery.
Haz clic en Agregar otro rol y, luego, en el menú desplegable Selecciona un rol. selecciona el rol Editor de datos de BigQuery.
Haz clic en Agregar otro rol y, luego, en el menú desplegable Selecciona un rol. selecciona el rol Visualizador de datos de BigQuery.
Haz clic en Guardar.
Configura anulaciones de compilación de lugares de trabajo
Para crear entornos de desarrollo aislados con el lugar de trabajo de Dataform anulaciones de compilación, sigue estos pasos:
En la consola de Google Cloud, ve a la página Dataform.
Haz clic en
quickstart-dev
.Haz clic en Configuración y, luego, en Editar.
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 adjuntará el archivo nombre del lugar de trabajo como sufijo del esquema predeterminado establecido en 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
.Haz clic en Guardar.
Dataform aplica anulaciones de compilación de lugares de trabajo a todos los lugares de trabajo de tu repositorio.
Con esta configuración, cuando ejecutas manualmente un flujo de trabajo de SQL en un
, 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 y convierte el
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
en BigQuery.
Para ejecutar flujos de trabajo de SQL sin anulaciones de compilación de lugares de trabajo, pero mantén
anulaciones de compilación de Workspace para entornos de desarrollo, puedes crear
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.
Borrar conjuntos de datos creados en BigQuery
Para evitar que se apliquen cargos por los recursos de BigQuery, borra los conjuntos de datos
con nombres que comienzan con dataform
, por ejemplo, dataform-sasha
.
En la consola de Google Cloud, ve a la página de BigQuery.
En el panel Explorador, expande tu proyecto y selecciona un conjunto de datos.
Haz clic en el menú
Acciones y, luego, selecciona Borrar.En el 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: pasos:
En la consola de Google Cloud, ve a la página Dataform.
Para
quickstart-dev
, haz clic en el menú Más . y, luego, selecciona Borrar.- En la ventana Borrar repositorio, ingresa el nombre del repositorio para confirmar su eliminación.
Para confirmar la acción, haz clic en Borrar.
¿Qué sigue?
Para obtener más información sobre el ciclo de vida del código en Dataform, consulta Introducción. al ciclo de vida del código en Dataform.
Para obtener más información sobre las prácticas recomendadas para el ciclo de vida del código en Dataform, consulta Administra el ciclo de vida del código.
Para obtener más información sobre las anulaciones de compilación de lugares de trabajo en Dataform, Consulta Cómo crear una compilación del lugar de trabajo anuladas.
Para aprender a programar ejecuciones de producción en Dataform, consulta Programar producción ejecuciones.