Gérer un dépôt

Ce document vous explique comment effectuer les opérations suivantes dans Dataform:

Avant de commencer

  1. Créez un dépôt.
  2. Facultatif: Connectez votre dépôt à un dépôt Git tiers.
  3. Créez et initialisez un espace de travail de développement dans votre dépôt.

Rôles requis

Pour obtenir les autorisations nécessaires pour effectuer les tâches décrites dans ce document, demandez à votre administrateur de vous accorder les rôles IAM suivants:

  • Configurez les paramètres Dataform et gérez l'emplacement du package principal Dataform : Dataform Admin (roles/dataform.admin) dans les dépôts.
  • Mettez à jour le package principal Dataform et utilisez le contrôle des versions dans Dataform : É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.

Configurer les paramètres du workflow Dataform

Cette section explique comment modifier les paramètres de traitement du workflow Dataform pour un dépôt spécifique.

Vous pouvez modifier le fichier de paramètres pour renommer les schémas ou ajouter des variables de compilation personnalisées à votre dépôt.

À propos des paramètres du dépôt

Chaque dépôt Dataform contient un fichier de paramètres de workflow unique. Le fichier contient l'ID du projet Google Cloud et le schéma dans lequel Dataform publie des composants dans BigQuery. Dataform utilise des paramètres par défaut que vous pouvez remplacer pour répondre au mieux à vos besoins en modifiant le fichier de paramètres.

À partir de la version Dataform core 3.0.0, les paramètres de workflow sont stockés dans le fichier workflow_settings.yaml par défaut. Dans les versions antérieures du noyau Dataform, les paramètres de workflow sont stockés dans le fichier dataform.json. Le fichier workflow_settings.yaml du noyau Dataform 3.0 est rétrocompatible avec le fichier dataform.json. Vous pouvez continuer à utiliser le fichier dataform.json pour stocker les paramètres de workflow. Nous vous recommandons de migrer les paramètres de votre workflow de dépôt vers le format workflow_settings.yaml pour assurer la compatibilité à l'avenir.

À propos de workflow_settings.yaml

Le fichier workflow_settings.yaml, introduit dans Dataform Core 3.0, stocke les paramètres de workflow Dataform au format YAML.

L'exemple de code suivant montre un exemple de fichier workflow_settings.yaml:

  defaultProject: my-gcp-project-id
  defaultDataset: dataform
  defaultLocation: australia-southeast2
  defaultAssertionDataset: dataform_assertions

Dans l'exemple de code précédent, les paires clé-valeur sont décrites comme suit:

  • defaultProject: ID de votre projet Google Cloud BigQuery.
  • defaultDataset: ensemble de données BigQuery dans lequel Dataform crée des éléments, appelé dataform par défaut.
  • defaultLocation: région de votre ensemble de données BigQuery par défaut. À cet emplacement, Dataform traite votre code et stocke les données exécutées. Cette région de traitement doit correspondre à l'emplacement de vos ensembles de données BigQuery, mais pas nécessairement à la région du dépôt Dataform. Pour en savoir plus sur les emplacements des ensembles de données BigQuery, consultez la page Emplacements des ensembles de données.
  • defaultAssertionDataset: ensemble de données BigQuery dans lequel Dataform crée des vues avec des résultats d'assertion, appelé dataform_assertions par défaut.

Pour en savoir plus sur les propriétés workflow_settings.yaml, consultez WorkflowSettings sur GitHub.

Vous pouvez accéder aux propriétés définies dans workflow_settings.yaml dans votre code Dataform en tant que propriétés de l'objet dataform.projectConfig.

Les mappages suivants des options workflow_settings.yaml aux options dataform.projectConfig accessibles par le code s'appliquent:

  • defaultProject => defaultDatabase
  • defaultDataset => defaultSchema
  • defaultAssertionDataset => assertionSchema
  • projectSuffix => databaseSuffix
  • datasetSuffix => schemaSuffix
  • namePrefix => tablePrefix

L'exemple de code suivant montre l'objet dataform.projectConfig référencé dans une instruction SELECT dans une vue:

  config { type: "view" }
  SELECT ${when(
    !dataform.projectConfig.tablePrefix,
    "table prefix is set!",
    "table prefix is not set!"
  )}

À propos de dataform.json

Le fichier dataform.json stocke les paramètres de workflow Dataform au format JSON.

L'exemple de code suivant montre un exemple de fichier dataform.json:

  {
    "warehouse": "bigquery",
    "defaultDatabase": "my-gcp-project-id",
    "defaultSchema": "dataform",
    "defaultLocation": "australia-southeast2",
    "assertionSchema": "dataform_assertions"
  }

Dans l'exemple de code précédent, les paires clé-valeur sont décrites comme suit:

  • warehouse: pointeur vers BigQuery, où Dataform crée des éléments.
  • defaultDatabase: ID de votre projet Google Cloud BigQuery.
  • defaultSchema: ensemble de données BigQuery dans lequel Dataform crée des éléments.
  • defaultLocation: région de votre ensemble de données BigQuery par défaut. À cet emplacement, Dataform traite votre code et stocke les données exécutées. Cette région de traitement doit correspondre à l'emplacement de vos ensembles de données BigQuery, mais pas nécessairement à la région du dépôt Dataform. Pour en savoir plus sur les emplacements des ensembles de données BigQuery, consultez la page Emplacements des ensembles de données.
  • assertionSchema: ensemble de données BigQuery dans lequel Dataform crée des vues avec des résultats d'assertion, appelé dataform_assertions par défaut.

Vous pouvez accéder aux propriétés définies dans le fichier dataform.json dans le code de votre projet en tant que propriétés de l'objet dataform.projectConfig.

Configurer les noms de schéma

Pour configurer les noms de schéma, vous devez modifier les propriétés defaultDataset et defaultAssertionSchema dans le fichier workflow_settings.yaml, ou les propriétés defaultSchema et assertionSchema dans le fichier dataform.json.

Pour configurer le nom d'un schéma, procédez comme suit:

workflow_settings.yaml

  1. Dans votre espace de travail de développement, dans le volet Fichiers, cliquez sur le fichier workflow_settings.yaml.

  2. Modifiez la valeur de defaultDataset, defaultAssertionSchema ou les deux.

L'exemple de code suivant montre un nom defaultDataset personnalisé défini dans le fichier workflow_settings.yaml:

  ...
  defaultDataset: mytables
  ...

dataform.json

  1. Dans votre espace de travail de développement, dans le volet Fichiers, cliquez sur le fichier dataform.json.

  2. Modifiez la valeur de defaultSchema, assertionSchema ou les deux.

L'exemple de code suivant montre un nom defaultSchema personnalisé défini dans le fichier dataform.json:

{
  ...
  "defaultSchema": "mytables",
  ...
}

Créer des variables de compilation personnalisées

Les variables de compilation contiennent des valeurs que vous pouvez modifier à l'aide de forçages de compilation dans une configuration de version ou dans une requête d'API Dataform.

Après avoir défini une variable de compilation dans workflow_settings.yaml et l'avoir ajoutée à des tables sélectionnées, vous pouvez modifier sa valeur dans une configuration de version ou dans des forcements de compilation de l'API Dataform pour exécuter des tables de manière conditionnelle.

Pour en savoir plus sur l'exécution conditionnelle de tables à l'aide de variables de compilation, consultez la section Présentation du cycle de vie du code dans Dataform.

Pour créer une variable de compilation que vous pouvez utiliser dans un dépôt, procédez comme suit:

workflow_settings.yaml

  1. Accédez à votre espace de travail de développement Dataform.
  2. Dans le volet Fichiers, sélectionnez le fichier workflow_settings.yaml.

  3. Saisissez l'extrait de code suivant:

    "vars": {
  "VARIABLE":"VALUE"
}

    Remplacez les éléments suivants :

    • VARIABLE: nom de la variable
    • VALUE: valeur par défaut de la variable de compilation

L'exemple de code suivant montre la variable de compilation myVariableName définie sur myVariableValue dans le fichier workflow_settings.yaml:

...
vars:
  myVariableName: myVariableValue
...

L'exemple de code suivant montre le fichier workflow_settings.yaml avec la variable de compilation executionSetting définie sur dev:

defaultProject: default_bigquery_database
defaultLocation: us-west1
defaultDataset: dataform_data,
vars:
executionSetting: dev

dataform.json

  1. Accédez à votre espace de travail de développement Dataform.
  2. Dans le volet Fichiers, sélectionnez le fichier dataform.json.

  3. Saisissez l'extrait de code suivant:

    "vars": {
  "VARIABLE":"VALUE"
}

    Remplacez les éléments suivants :

    • VARIABLE: nom de la variable
    • VALUE: avec la valeur par défaut de la variable de compilation

L'exemple de code suivant montre la variable de compilation myVariableName définie sur myVariableValue dans le fichier dataform.json:

{
  ...
  "vars": {
    "myVariableName": "myVariableValue"
  },
  ...
}

L'exemple de code suivant montre le fichier dataform.json avec la variable de compilation executionSetting définie sur dev:

{
"warehouse": "bigquery",
"defaultSchema": "dataform_data",
"defaultDatabase": "default_bigquery_database".
"defaultLocation":"us-west-1",
"vars": {
"executionSetting":"dev"
}
}
Ajouter une variable de compilation à un tableau

Pour ajouter une variable de compilation à un fichier de définition de table SQLX, procédez comme suit:

  1. Accédez à votre espace de travail de développement Dataform.
  2. Dans le volet Fichiers, sélectionnez un fichier de définition de table SQLX.

  3. Dans le fichier, saisissez une clause when au format suivant:

    ${when(dataform.projectConfig.vars.VARIABLE === "SET_VALUE", "CONDITION")}

    Remplacez les éléments suivants :

    • VARIABLE: nom de votre variable (par exemple, executionSetting)
    • SET_VALUE: valeur de la variable (par exemple, staging)
    • CONDITION: condition d'exécution de la table

L'exemple de code suivant montre un fichier SQLX de définition de table avec une clause when et la variable executionSetting qui exécute 10% des données dans le paramètre d'exécution de préproduction:

  select
    *
  from ${ref("data")}
  ${when(
    dataform.projectConfig.vars.executionSetting === "staging",
    "where mod(farm_fingerprint(id) / 10) = 0",
  )}

L'exemple de code suivant montre un fichier SQLX de définition de vue avec une clause when et la variable myVariableName:

  config { type: "view" }
  SELECT ${when(
    dataform.projectConfig.vars.myVariableName === "myVariableValue",
    "myVariableName is set to myVariableValue!",
    "myVariableName is not set to myVariableValue!"
  )}

Migrer les paramètres de workflow vers workflow_settings.yaml

Pour vous assurer que votre fichier de paramètres de workflow est compatible avec les futures versions du framework de base Dataform, vous devez migrer vos paramètres de workflow du fichier dataform.json vers le fichier workflow_settings.yaml.

Le fichier workflow_settings.yaml remplace le fichier dataform.json.

Si le noyau Dataform est le seul package de dépendance de votre dépôt, le fichier workflow_settings.yaml remplace également le fichier package.json. Pour en savoir plus sur le remplacement du fichier package.json par le fichier workflow_settings.yaml, consultez la section Gérer le package principal Dataform.

Le tableau suivant montre la mise en correspondance des propriétés des paramètres de workflow du fichier dataform.json au fichier workflow_settings.yaml:

Propriété à dataform.json Propriété à workflow_settings.yaml Description
assertionSchema defaultAssertionDataset Obligatoire. Ensemble de données par défaut pour les assertions.
defaultDatabase defaultProject Obligatoire. Nom du projet Google Cloud par défaut.
defaultLocation defaultLocation Obligatoire. Emplacement BigQuery par défaut dans lequel Dataform créera des tables. Pour en savoir plus sur les emplacements BigQuery, consultez la page Emplacements des ensembles de données.
defaultSchema defaultDataset Obligatoire. Ensemble de données par défaut.
databaseSuffix projectSuffix Facultatif. Suffixe à ajouter à toutes les références de projet Google Cloud .
schemaSuffix datasetSuffix Facultatif. Suffixe à ajouter à tous les ensembles de données d'action.
tablePrefix namePrefix Facultatif. Préfixe à ajouter à tous les noms d'action.
vars vars Facultatif. Variables définies par l'utilisateur qui sont mises à la disposition du code du projet lors de la compilation. Objet contenant une liste de paires key: value.
warehouse - Obligatoire dans dataform.json. Doit être défini sur bigquery. Non disponible dans workflow_settings.yaml.
- dataformCoreVersion Non disponible dans dataform.json. Installé dans workflow_settings.yaml par défaut pour les nouveaux dépôts. Pour en savoir plus, consultez Gérer le package principal Dataform.

Pour migrer les paramètres de workflow vers workflow_settings.yaml, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Dataform page.

    Accéder à Dataform

  2. Sélectionnez un dépôt, puis un espace de travail.

  3. Dans le volet Fichiers, cliquez sur AjouterAjouter, puis sur Créer un fichier.

  4. Dans le champ Ajouter un chemin d'accès au fichier, saisissez workflow_settings.yaml.

  5. Cliquez sur Créer un fichier.

  6. Dans le fichier workflow_settings.yaml, ajoutez les paramètres de votre fichier dataform.json, mappés au format YAML.

  7. Dans le volet Fichiers, cliquez sur le menu Plus à côté de dataform.json, puis sur Supprimer.

  8. Pour confirmer la suppression de dataform.json, cliquez sur Supprimer.

L'exemple de code suivant montre les paramètres de workflow définis dans un fichier dataform.json:

{
  "warehouse": "bigquery",
  "defaultDatabase": "dataform-demos",
  "defaultLocation": "US",
  "defaultSchema": "dataform",
  "assertionSchema": "dataform_assertions"
  "vars": {
    "environmentName": "development"
  }
}

L'exemple de code suivant montre le fichier dataform.json précédent converti en workflow_settings.yaml:

defaultProject: dataform-demos
defaultLocation: US
defaultDataset: dataform
defaultAssertionDataset: dataform_assertions
vars:
    environmentName: "development"

Gérer le package principal Dataform

Cette section explique comment gérer le package de dépendances du framework de base Dataform et le mettre à jour vers la dernière version.

Le noyau Dataform est le framework Dataform Open Source permettant de développer des workflows avec SQL, SQLX et JavaScript. Il est recommandé de toujours utiliser la dernière version disponible du framework de base Dataform. Pour en savoir plus sur les versions du framework de base Dataform, consultez les versions de Dataform sur GitHub.

Gérer l'emplacement du package principal Dataform

Lorsque vous initialisez le premier espace de travail d'un dépôt, Dataform définit automatiquement le noyau Dataform comme package de dépendance. À partir de la version 3.0.0 du noyau Dataform, Dataform installe le package de base Dataform dans le fichier workflow_settings.yaml par défaut. Dans les versions précédentes du noyau Dataform, le noyau Dataform était défini dans le fichier package.json.

Dans Dataform core 3.0.0 et versions ultérieures, si Dataform core est le seul package de votre dépôt, vous devez le définir dans le fichier workflow_settings.yaml. Pour les dépôts créés avec des versions antérieures du noyau Dataform, déplacez le package de base Dataform vers workflow_settings.yaml.

Le fichier package.json est nécessaire pour installer des packages supplémentaires dans Dataform. Si votre dépôt utilise des packages supplémentaires, définissez le package de base Dataform dans package.json afin que tous les packages soient définis au même endroit. Si votre dépôt ne contient pas le fichier package.json, créez le fichier package.json et déplacez le package de base Dataform pour installer des packages supplémentaires.

Déplacer le noyau Dataform vers workflow_settings.yaml

Pour les dépôts créés avec des versions antérieures à 3.0.0 du noyau Dataform, si vous ne disposez d'aucun autre paquet de dépendance que le noyau Dataform, vous devez déplacer le paquet de noyau Dataform du fichier package.json vers le fichier workflow_settings.yaml, puis supprimer le fichier package.json redondant.

Pour migrer le package de base Dataform du fichier package.json vers le fichier workflow_settings.yaml, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Dataform page.

    Accéder à Dataform

  2. Sélectionnez un dépôt, puis un espace de travail.

  3. Dans le volet Fichiers, sélectionnez le fichier workflow_settings.yaml.

  4. Dans le fichier workflow_settings.yaml, ajoutez le package de base Dataform au format suivant:

    dataformCoreVersion: "VERSION"

    Remplacez VERSION par la dernière version de Dataform, par exemple 3.0.0.

  5. Dans le volet Fichiers, cliquez sur le menu Plus à côté du fichier package.json, puis sur Supprimer.

  6. Pour confirmer la suppression du fichier dataform.json, cliquez sur Supprimer.

  7. Cliquez sur Installer les packages.

Déplacer le noyau Dataform vers package.json

Le fichier package.json est nécessaire pour installer des packages supplémentaires dans un dépôt. Si votre dépôt utilise des packages supplémentaires, vous devez stocker tous les packages, y compris le package principal Dataform, dans le fichier package.json.

Si votre dépôt ne contient pas le fichier package.json, car le package de base Dataform est défini dans le fichier workflow_settings.yaml, vous devez créer le fichier package.json pour installer des packages supplémentaires, puis déplacer le package de base Dataform du fichier workflow_settings.yaml vers le fichier package.json nouvellement créé.

Pour créer le fichier package.json et déplacer le package de base Dataform, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Dataform page.

    Accéder à Dataform

  2. Sélectionnez un dépôt, puis un espace de travail.

  3. Dans le volet Fichiers, cliquez sur AjouterAjouter, puis sur Créer un fichier.

  4. Dans le champ Ajouter un chemin d'accès au fichier, saisissez package.json.

  5. Cliquez sur Créer un fichier.

  6. Dans le fichier package.json, ajoutez le package de base Dataform au format suivant:

    {
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}

    Remplacez VERSION par la dernière version de Dataform, par exemple 3.0.0.

  7. Cliquez sur Installer les packages.

  8. Dans le volet Fichiers, sélectionnez workflow_settings.yaml.

  9. Dans le fichier workflow_settings.yaml, supprimez la propriété dataformCoreVersion.

Mettre à jour le noyau de Dataform

Testez toujours les nouvelles versions de paquets dans un environnement hors production avant de les déployer dans votre environnement de production.

Pour mettre à jour le package de dépendance de base de Dataform, procédez comme suit:

  1. Recherchez la dernière version de @dataform/core sur la page des versions Dataform sur GitHub.

  2. Dans la console Google Cloud, accédez à la page Dataform page.

    Accéder à Dataform

  3. Sélectionnez un dépôt, puis un espace de travail.

  4. Dans le volet Fichiers, sélectionnez le fichier package.json ou le fichier workflow_settings.yaml.

    L'emplacement où le package de dépendance du noyau Dataform est défini dépend de votre version du noyau Dataform et de votre utilisation des packages. Pour en savoir plus, consultez la section Gérer l'emplacement du package principal Dataform.

  5. Mettez à jour le package de dépendances de base Dataform avec la dernière version:

    package.json

    {
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}

    Remplacez VERSION par la dernière version de Dataform, par exemple 3.0.0. Pour éviter les problèmes d'installation du package, spécifiez explicitement la version du package de base Dataform. N'utilisez pas d'autres options dependencies du fichier package.json, par exemple >version.

    workflow_settings.yaml

    dataformCoreVersion: "VERSION"

    Remplacez VERSION par la dernière version de Dataform, par exemple 3.0.0.

  6. Cliquez sur Installer les packages.

  7. Validez les modifications.

  8. Transférez les modifications vers votre dépôt.

L'exemple de code suivant montre la dépendance @dataform/core mise à jour vers la version 3.0.0 dans le fichier package.json:

{
    "dependencies": {
        "@dataform/core": "3.0.0"
    }
}

Contrôler les versions de votre code

Cette section vous 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 dans votre espace de travail de développement. Par exemple, Dataform n'affiche l'option de commit 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.

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 New commit (Nouveau commit), Dataform affiche les modifications non validées.

Pour valider les modifications apportées à 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 de fichier 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