Contrôler les versions de votre code

Ce document explique comment utiliser le contrôle des versions dans Dataform pour suivre l'avancement du 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 dans votre espace de travail de développement. Par exemple, Dataform n'affiche l'option de commit que lorsque votre espace de travail comporte des modifications locales non validées. 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 X modification(s)

Validez le nombre de 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érer les modifications validées vers votre branche par défaut. Cette option est disponible dans un dépôt Dataform si votre espace de travail ne comporte aucune modification non validée.

Transférer vers your-branch-name

Transférer les modifications validées vers le your-branch-name. Cette option est disponible dans un dépôt connecté à un dépôt Git tiers si votre espace de travail ne comporte aucune modification non validée.

Extraire de la branche par défaut

Mettez à jour vos espaces de travail avec les modifications récentes apportées à votre branche par défaut. Cette option est disponible dans un dépôt Dataform si vous n'avez aucune modification non validée ou non validée 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 votre espace de travail ne contient aucune modification non validée ou non validée.

Rétablir le dernier commit

Restaurez les fichiers de votre espace de travail à l'état 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 dont vous avez besoin pour utiliser le contrôle des versions dans Dataform, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur de données (roles/dataform.editor) sur les espaces de travail. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

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 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 de your-branch-name.

Valider les modifications

Lorsque vous apportez une modification dans un espace de travail de développement, Dataform affiche l'option Valider. Vous pouvez effectuer un commit de 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 Valider.

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 de fichier et chemin d'accès.

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

      Le nom du bouton dépend de la sélection de fichiers à valider.

Déployer les modifications

Dataform affiche l'option Push (Transférer) après avoir validé les modifications. 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 Déployer sur la branche par défaut.
   2. Si vous vous trouvez dans un dépôt connecté à un dépôt Git tiers, cliquez sur Envoyer 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 Rétablir le dernier commit.

Résoudre les conflits de fusion

Un conflit de fusion peut se produire lorsqu'une modification locale de 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 des données d'une branche après qu'un autre utilisateur a déployé une modification incompatible 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 le volet Files (Fichiers) de votre espace de travail de développement, sélectionnez un fichier concerné.
2. Apportez les modifications souhaitées au fichier.
3. Validez les modifications.
4. Facultatif: Déployer les modifications

Étapes suivantes

• Pour savoir comment créer une table, consultez Créer une table.
• Pour en savoir plus sur Dataform, consultez la page Présentation de Dataform.