Contrôler les versions de votre code

Ce document explique comment utiliser le contrôle des versions dans Dataform pour suivre le développement.

Dataform utilise Git pour suivre chaque modification apportée aux fichiers d'un dépôt.

Dans un dépôt Dataform, vous interagissez directement avec le dépôt Git.

Dans un dépôt connecté, vous interagissez avec la branche de suivi du dépôt distant que vous avez configurée lors de la connexion du dépôt.

Dataform affiche les options de contrôle des versions en fonction de l'état des modifications apportées à votre espace de travail de développement. Par exemple, Dataform n'affiche l'option de validation que lorsqu'il existe des modifications locales non validées dans votre espace de travail. Lorsque les fichiers de votre espace de travail sont une copie exacte de votre branche par défaut ou de suivi, Dataform affiche l'état L'espace de travail est à jour.

Dataform affiche les options de contrôle des versions suivantes:

Valider la ou les modifications X
Validez le nombre X de modifications locales dans votre espace de travail ou dans les fichiers modifiés sélectionnés. Dataform affiche les modifications non validées.
Transférer vers la branche par défaut
Transférez les modifications validées vers votre branche par défaut. Cette option est disponible dans un dépôt Dataform si vous n'avez pas de modifications non validées dans votre espace de travail.
Transférer vers your-branch-name
Transférez les modifications validées vers your-branch-name. Cette option est disponible dans un dépôt connecté à un dépôt Git tiers si vous n'avez pas de modifications non validées dans votre espace de travail.
Extraire de la branche par défaut
Mettez à jour vos espaces de travail avec les modifications récentes de votre branche par défaut. Cette option est disponible dans un dépôt Dataform si vous n'avez pas de modifications non validées ou non validées dans votre espace de travail.
Extraire de your-branch-name
Mettez à jour votre espace de travail avec les modifications récentes apportées par your-branch-name. Cette option est disponible dans un dépôt connecté à un dépôt Git tiers si vous n'avez pas de modifications non validées ou non transférées dans votre espace de travail.
Rétablir le dernier commit
Rétablissez les fichiers de votre espace de travail à leur état lors de votre dernier commit.

Avant de commencer

  1. Sélectionnez ou créez un dépôt.
  2. Facultatif: Connectez votre dépôt à un dépôt Git tiers.
  3. Sélectionnez ou créez un espace de travail de développement.

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser le contrôle des versions dans Dataform, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Dataform (roles/dataform.editor) sur les espaces de travail. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Extraire les modifications

Si votre espace de travail de développement n'est pas synchronisé avec votre dépôt, Dataform affiche l'option Pull (Extraire). Pour extraire les modifications de votre dépôt vers votre espace de travail de développement, procédez comme suit:

  1. Sur la page Dataform, sélectionnez un dépôt.
  2. Dans l'onglet Espaces de travail de développement, sélectionnez un espace de travail de développement.
  3. Sur la page de l'espace de travail de développement, procédez comme suit :
    1. Si vous vous trouvez dans un dépôt Dataform, cliquez sur Extraire de la branche par défaut.
    2. Si vous vous trouvez dans un dépôt connecté à un dépôt Git tiers, cliquez sur Extraire depuis your-branch-name.

Valider les modifications

Une fois que vous avez effectué une modification dans un espace de travail de développement, Dataform affiche l'option Commit (Valider). Vous pouvez valider toutes les modifications locales ou des fichiers sélectionnés.

Dans la boîte de dialogue Nouveau commit, Dataform affiche les modifications non validées.

Pour valider les modifications de votre espace de travail de développement dans votre dépôt, procédez comme suit:

  1. Sur la page Dataform, sélectionnez un dépôt.
  2. Sur la page du dépôt, sélectionnez un espace de travail de développement.
  3. Sur la page de l'espace de travail de développement, cliquez sur Commit (Ajouter).
  4. Dans le volet Nouveau commit, procédez comme suit:

    1. Dans le champ Ajouter un message de commit, saisissez une description de votre commit.
    2. Sélectionnez les fichiers modifiés que vous souhaitez valider.

      Si vous ne sélectionnez aucun fichier, Dataform valide toutes les modifications locales. Vous pouvez filtrer les fichiers modifiés par état, nom et chemin d'accès.

    3. Cliquez sur Valider toutes les modifications ou sur Valider les modifications X.

      Le nom du bouton dépend des fichiers que vous avez sélectionnés pour l'enregistrement.

Déployer les modifications

Dataform affiche l'option Push (Transférer) une fois les modifications validées. Pour transférer les modifications de votre espace de travail de développement vers votre dépôt, procédez comme suit:

  1. Sur la page Dataform, sélectionnez un dépôt.
  2. Sur la page du dépôt, sélectionnez un espace de travail de développement.
  3. Validez les modifications.
  4. Sur la page de l'espace de travail de développement, procédez comme suit :
    1. Si vous vous trouvez dans un dépôt Dataform, cliquez sur Transférer vers la branche par défaut.
    2. Si vous vous trouvez dans un dépôt connecté à un dépôt Git tiers, cliquez sur Push to your-branch-name (Transférer vers your-branch-name).

Annuler les modifications non validées

Pour annuler les modifications non validées, procédez comme suit:

  1. Sur la page Dataform, sélectionnez un dépôt.
  2. Sur la page du dépôt, sélectionnez un espace de travail de développement.
  3. Au-dessus du volet Fichiers, cliquez sur le menu Plus, puis sélectionnez Revenir au dernier commit.

Résoudre les conflits de fusion

Un conflit de fusion peut se produire lorsqu'une modification locale dans votre espace de travail de développement est incompatible avec une modification apportée à la branche de suivi par défaut de votre dépôt. Les conflits de fusion se produisent généralement lorsque plusieurs utilisateurs modifient simultanément le même fichier.

Un conflit de fusion se produit généralement lorsque vous extrayez une branche après qu'un autre utilisateur a poussé une modification en conflit sur la même branche. Vous devez résoudre manuellement un conflit de fusion en modifiant le fichier concerné.

L'exemple de code suivant montre un conflit de fusion affiché dans un fichier SQLX:

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

Pour résoudre un conflit de fusion, procédez comme suit:

  1. Dans votre espace de travail de développement, dans le volet Fichiers, sélectionnez un fichier concerné.
  2. Modifiez le fichier en apportant les modifications de votre choix.
  3. Validez les modifications.
  4. Facultatif: Transférer les modifications.

Étape suivante