Aplica el control de versiones en tu código

En este documento, se muestra cómo usar el control de versión en Dataform para realizar un seguimiento del desarrollo.

Dataform usa Git para realizar un seguimiento de cada cambio que se realiza en los archivos dentro de un repositorio.

En un repositorio de Dataform, interactúas directamente con el repositorio de Git.

En un repositorio conectado, interactúas con la rama de seguimiento del repositorio remoto que configuraste durante la conexión del repositorio.

Dataform muestra opciones de control de versión según el estado de los cambios en tu lugar de trabajo de desarrollo. Por ejemplo, Dataform muestra la opción de confirmación solo cuando hay cambios locales sin confirmar en tu lugar de trabajo. Cuando los archivos de tu lugar de trabajo son una copia exacta de tu rama predeterminada o de seguimiento, Dataform muestra el estado El lugar de trabajo está actualizado.

Dataform muestra las siguientes opciones de control de versión:

Confirma los cambios de X
Confirma la cantidad X de cambios locales en tu espacio de trabajo o en los archivos modificados seleccionados. Dataform muestra los cambios no confirmados.
Enviar a la rama predeterminada
Envía los cambios confirmados a la rama predeterminada. Esta opción está disponible en un repositorio de Dataform si no tienes cambios sin confirmar en tu lugar de trabajo.
Enviar a your-branch-name
Envía los cambios confirmados a your-branch-name. Esta opción está disponible en un repositorio conectado a un repositorio de Git de terceros si no tienes cambios sin confirmar en tu espacio de trabajo.
Extraer de la rama predeterminada
Actualiza tus espacios de trabajo con los cambios recientes de tu rama predeterminada. Esta opción está disponible en un repositorio de Dataform si no tienes cambios confirmados o no enviados en tu lugar de trabajo.
Extraer de your-branch-name
Actualiza tu espacio de trabajo con los cambios recientes de your-branch-name. Esta opción está disponible en un repositorio conectado a un repositorio de Git de terceros si no tienes cambios confirmados sin enviar ni confirmar en tu espacio de trabajo.
Volver a la última confirmación
Restaura los archivos de tu espacio de trabajo al estado de tu última confirmación.

Antes de comenzar

  1. Selecciona o crea un repositorio.
  2. Opcional: Conecta tu repositorio a un repositorio de Git de terceros.
  3. Selecciona o crea un lugar de trabajo de desarrollo.

Roles obligatorios

Para obtener los permisos que necesitas para usar el control de versiones en Dataform, pídele a tu administrador que te otorgue el rol de IAM 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.

Extraer cambios

Si tu lugar de trabajo de desarrollo no está sincronizado con tu repositorio, Dataform mostrará la opción Pull. Para extraer cambios de tu repositorio a tu lugar de trabajo de desarrollo, sigue estos pasos:

  1. En la página Dataform, selecciona un repositorio.
  2. En la pestaña Lugares de trabajo de desarrollo, selecciona un lugar de trabajo de desarrollo.
  3. En la página del lugar de trabajo de desarrollo, haz lo siguiente:
    1. Si estás en un repositorio de Dataform, haz clic en Extraer de la rama predeterminada.
    2. Si estás en un repositorio conectado a un repositorio de Git de terceros, haz clic en Extraer desde your-branch-name.

Confirmar cambios

Después de realizar un cambio en un lugar de trabajo de desarrollo, Dataform muestra la opción Confirmar. Puedes confirmar todos los cambios locales o los archivos seleccionados.

En el diálogo New commit, Dataform muestra los cambios no confirmados.

Para confirmar los cambios de tu lugar de trabajo de desarrollo en tu repositorio, sigue estos pasos:

  1. En la página Dataform, selecciona un repositorio.
  2. En la página del repositorio, selecciona un lugar de trabajo de desarrollo.
  3. En la página del lugar de trabajo de desarrollo, haz clic en Confirmar.

  4. En el panel Comit nuevo, haz lo siguiente:

    1. En el campo Agregar un mensaje de confirmación, ingresa una descripción para la confirmación.

    2. Selecciona los archivos modificados que deseas confirmar.

      Si no seleccionas ningún archivo, Dataform confirmará todos los cambios locales. Puedes filtrar los archivos modificados por estado, nombre y ruta de acceso.

    3. Haz clic en Confirmar todos los cambios o Confirmar cambios de X.

      El nombre del botón depende de la selección de archivos que deseas confirmar.

Cómo enviar cambios

Dataform muestra la opción Push después de que confirmas los cambios. Para enviar los cambios de tu lugar de trabajo de desarrollo a tu repositorio, sigue estos pasos:

  1. En la página Dataform, selecciona un repositorio.
  2. En la página del repositorio, selecciona un lugar de trabajo de desarrollo.
  3. Confirma los cambios.
  4. En la página del lugar de trabajo de desarrollo, haz lo siguiente:
    1. Si estás en un repositorio de Dataform, haz clic en Push to default branch.
    2. Si estás en un repositorio conectado a un repositorio de Git de terceros, haz clic en Push to your-branch-name.

Revertir los cambios no confirmados

Para deshacer los cambios no confirmados, sigue estos pasos:

  1. En la página Dataform, selecciona un repositorio.
  2. En la página del repositorio, selecciona un lugar de trabajo de desarrollo.
  3. Sobre el panel Files, haz clic en el menú More y, luego, selecciona Revert to last commit.

Cómo resolver conflictos de combinación

Un conflicto de combinación puede ocurrir cuando un cambio local en tu lugar de trabajo de desarrollo es incompatible con un cambio que se realizó en la rama de seguimiento predeterminada de tu repositorio. Los conflictos de combinación suelen ocurrir cuando varios usuarios editan el mismo archivo de forma simultánea.

Por lo general, se produce un conflicto de combinación cuando extraes de una rama después de que un usuario diferente envió un cambio conflictivo a la misma rama. Para resolver un conflicto de combinación, debes editar el archivo afectado de forma manual.

En la siguiente muestra de código, se muestra un conflicto de combinación que se muestra en un archivo SQLX:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Para resolver un conflicto de combinación, sigue estos pasos:

  1. En el panel Files de tu lugar de trabajo de desarrollo, selecciona un archivo afectado.
  2. Edita el archivo con los cambios que elegiste.
  3. Confirma los cambios.
  4. Opcional: Envía los cambios.

¿Qué sigue?