Controla la versión de 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 realizado 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:

Confirmar X cambios
Confirma la cantidad X de cambios locales en tu lugar de trabajo o los archivos modificados seleccionados. Dataform muestra los cambios no confirmados.
Enviar a la rama predeterminada
Envía los cambios confirmados a tu 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 lugar de trabajo.
Extraer de la rama predeterminada
Actualiza tus lugares 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 no confirmados o no enviados en tu lugar de trabajo.
Extraer de your-branch-name
Actualiza tu lugar 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 confirmar o no enviados en tu lugar de trabajo.
Volver a la última confirmación
Restablece los archivos de tu lugar de trabajo a su estado desde la ú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.

Funciones obligatorias

Si quieres obtener los permisos que necesitas para usar el control de versión en Dataform, 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.

Extraer cambios

Si tu lugar de trabajo de desarrollo no está sincronizado con tu repositorio, Dataform muestra la opción Extraer. Para extraer cambios del 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 Espacios 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 de 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 cuadro de diálogo Confirmación nueva, Dataform muestra los cambios no confirmados.

Para confirmar los cambios de tu lugar de trabajo de desarrollo al 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 Confirmación nueva, haz lo siguiente:

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

    2. Selecciona los archivos modificados que deseas confirmar.

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

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

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

Aplicar cambios

Dataform muestra la opción Enviar después de confirmar los cambios. Para enviar cambios de tu lugar de trabajo de desarrollo al 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 Enviar a la rama predeterminada.
    2. Si estás en un repositorio conectado a un repositorio de Git de terceros, haz clic en Enviar a your-branch-name.

Revertir los cambios no confirmados

Para revertir 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. Arriba del panel Files, haz clic en el menú Más y, luego, selecciona Revert to last commit (Revertir a la última confirmación).

Resolver conflictos de combinación

Un conflicto de combinación puede ocurrir cuando un cambio local en tu lugar de trabajo de desarrollo no es compatible con un cambio que se realizó en la rama de seguimiento predeterminada de tu repositorio. Por lo general, los conflictos de combinación se producen cuando varios usuarios editan el mismo archivo de forma simultánea.

Por lo general, encuentras 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. Debes resolver un conflicto de fusión manualmente editando el archivo afectado.

En la siguiente muestra de código, aparece un conflicto de combinación 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 lugar de trabajo de desarrollo, en el panel Archivos, 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?