Cette page a été traduite par l'API Cloud Translation.

Gérer un dépôt

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

Configurez les paramètres du workflow Dataform.
Gérer le package Dataform Core
Contrôlez les versions de votre code.

Avant de commencer

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 Dataform Core : Administrateur Dataform (roles/dataform.admin) sur les dépôts.
Mettez à jour le package Dataform Core 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 Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Configurer les paramètres de workflow Dataform

Cette section vous 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 les composants dans BigQuery. Dataform utilise des paramètres par défaut que vous pouvez remplacer pour mieux répondre à vos besoins en modifiant le fichier de paramètres.

Depuis Dataform Core 3.0.0, les paramètres de workflow sont stockés par défaut dans le fichier workflow_settings.yaml. Dans les versions antérieures de Dataform Core, les paramètres de workflow sont stockés dans le fichier dataform.json. Le fichier Dataform Core 3.0 workflow_settings.yaml 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 workflow de votre dépôt au format workflow_settings.yaml pour assurer la compatibilité future.

À 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 BigQuery Google Cloud .
defaultDataset : ensemble de données BigQuery dans lequel Dataform crée des éléments, appelé dataform par défaut.
defaultLocation (facultatif) : emplacement de votre ensemble de données BigQuery par défaut. Dataform utilise cet emplacement pour traiter votre code et stocker les résultats. Cet emplacement de traitement doit correspondre à celui de vos ensembles de données BigQuery. Toutefois, il n'est pas nécessaire qu'il corresponde à l'emplacement du dépôt Dataform.

Si vous ne définissez pas le paramètre defaultLocation, Dataform détermine l'emplacement en fonction des ensembles de données auxquels votre requête SQL fait référence. Voici comment cela fonctionne :
- Si votre requête fait référence à des ensembles de données provenant du même emplacement, Dataform utilise cet emplacement.
- Si votre requête fait référence à des ensembles de données provenant de deux emplacements différents ou plus, une erreur se produit. Pour en savoir plus sur cette limitation, consultez Réplication interrégionale d'ensembles de données.
- Si votre requête ne fait référence à aucun ensemble de données, l'emplacement par défaut pour Dataform est la région multirégionale US. Pour choisir un autre emplacement, définissez l'emplacement par défaut. Vous pouvez également utiliser la variable système @@location dans votre requête. Pour en savoir plus, consultez Spécifier des zones.
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 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 BigQuery Google Cloud .
defaultSchema : ensemble de données BigQuery dans lequel Dataform crée des éléments.
defaultLocation (facultatif) : emplacement de votre ensemble de données BigQuery par défaut. Dataform utilise cet emplacement pour traiter votre code et stocker les résultats. Cet emplacement de traitement doit correspondre à celui de vos ensembles de données BigQuery. Toutefois, il n'est pas nécessaire qu'il corresponde à l'emplacement du dépôt Dataform.

Si vous ne définissez pas le paramètre defaultLocation, Dataform détermine l'emplacement en fonction des ensembles de données auxquels votre requête SQL fait référence. Voici comment cela fonctionne :
- Si votre requête fait référence à des ensembles de données provenant du même emplacement, Dataform utilise cet emplacement.
- Si votre requête fait référence à des ensembles de données provenant de deux emplacements différents ou plus, une erreur se produit. Pour en savoir plus sur cette limitation, consultez Réplication interrégionale d'ensembles de données.
- Si votre requête ne fait référence à aucun ensemble de données, l'emplacement par défaut pour Dataform est la région multirégionale US. Pour choisir un autre emplacement, définissez l'emplacement par défaut. Vous pouvez également utiliser la variable système @@location dans votre requête. Pour en savoir plus, consultez Spécifier des zones.
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émas

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`

Dans votre espace de travail de développement, dans le volet Fichiers, cliquez sur le fichier workflow_settings.yaml.
Modifiez la valeur de defaultDataset, de defaultAssertionSchema ou des deux.

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

  ...
  defaultDataset: mytables
  ...

`dataform.json`

Dans votre espace de travail de développement, dans le volet Fichiers, cliquez sur le fichier dataform.json.
Modifiez la valeur de defaultSchema, de assertionSchema ou des 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 remplacements de compilation dans une configuration de version ou dans une requête de l'API Dataform.

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

Pour en savoir plus sur l'exécution conditionnelle de tables à l'aide de variables de compilation, consultez 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`

Accédez à votre espace de travail de développement Dataform.
Dans le volet Fichiers, sélectionnez le fichier workflow_settings.yaml.
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`

Accédez à votre espace de travail de développement Dataform.
Dans le volet Fichiers, sélectionnez le fichier dataform.json.
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 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 :

Accédez à votre espace de travail de développement Dataform.
Dans le volet Fichiers, sélectionnez un fichier de définition de table SQLX.
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 intermédiaire :

  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 Dataform Core, 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 package Dataform Core est le seul package de dépendances de votre dépôt, le fichier workflow_settings.yaml remplace également le fichier package.json. Pour savoir comment remplacer le fichier package.json par le fichier workflow_settings.yaml, consultez Gérer le package Dataform Core.

Le tableau suivant montre le mappage 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`	Facultatif. Emplacement BigQuery par défaut dans lequel Dataform crée des tables. Si elle n'est pas définie, Dataform détermine l'emplacement en fonction des ensembles de données auxquels votre requête SQL fait référence. Pour en savoir plus, consultez Spécifier des zones.
`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'actions.
`vars`	`vars`	Facultatif. Variables définies par l'utilisateur et 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 Dataform Core.

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

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

Accéder à Dataform
Sélectionnez un dépôt, puis un espace de travail.
Dans le volet Fichiers, cliquez sur addAjouter, puis sur Créer un fichier.
Dans le champ Ajouter un chemin d'accès au fichier, saisissez workflow_settings.yaml.
Cliquez sur Créer un fichier.
Dans le fichier workflow_settings.yaml, ajoutez les paramètres de votre fichier dataform.json, mappés au format YAML.
Dans le volet Fichiers, cliquez sur le menu Plus à côté de dataform.json, puis sur Supprimer.
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 Dataform Core

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

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

Gérer l'emplacement du package Dataform Core

Lorsque vous initialisez le premier espace de travail dans un dépôt, Dataform définit automatiquement Dataform Core comme package de dépendances. Depuis Dataform Core 3.0.0, Dataform installe le package Dataform Core dans le fichier workflow_settings.yaml par défaut. Dans les versions antérieures de Dataform Core, Dataform Core é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 de Dataform Core, déplacez le package Dataform Core vers workflow_settings.yaml.

Le fichier package.json est requis pour installer des packages supplémentaires dans Dataform. Si votre dépôt utilise des packages supplémentaires, définissez le package Dataform Core 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 et déplacez le package Dataform Core pour installer des packages supplémentaires.package.json

Déplacer Dataform Core vers `workflow_settings.yaml`

Pour les dépôts créés avec des versions de Dataform Core antérieures à 3.0.0, si vous n'avez pas de packages de dépendances autres que Dataform Core, vous devez déplacer le package Dataform Core du fichier package.json vers le fichier workflow_settings.yaml, puis supprimer le fichier package.json redondant.

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

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

Accéder à Dataform
Sélectionnez un dépôt, puis un espace de travail.
Dans le volet Fichiers, sélectionnez le fichier workflow_settings.yaml.
Dans le fichier workflow_settings.yaml, ajoutez le package Dataform Core au format suivant :
```
dataformCoreVersion: "VERSION"
```
Remplacez VERSION par la dernière version de Dataform, par exemple 3.0.0.
Dans le volet Fichiers, cliquez sur le menu Plus à côté du fichier package.json, puis sur Supprimer.
Pour confirmer la suppression du fichier dataform.json, cliquez sur Supprimer.
Cliquez sur Installer les packages.

Déplacer Dataform Core 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 Dataform Core, dans le fichier package.json.

Si votre dépôt ne contient pas le fichier package.json, car le package Dataform Core 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 Dataform Core du fichier workflow_settings.yaml vers le fichier package.json que vous venez de créer.

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

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

Accéder à Dataform
Sélectionnez un dépôt, puis un espace de travail.
Dans le volet Fichiers, cliquez sur AjouterAjouter, puis sur Créer un fichier.
Dans le champ Ajouter un chemin d'accès au fichier, saisissez package.json.
Cliquez sur Créer un fichier.
Dans le fichier package.json, ajoutez le package Dataform Core au format suivant :
```
{
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}
```
Remplacez VERSION par la dernière version de Dataform, par exemple 3.0.0.
Cliquez sur Installer les packages.
Dans le volet Fichiers, sélectionnez workflow_settings.yaml.
Dans le fichier workflow_settings.yaml, supprimez la propriété dataformCoreVersion.

Mettre à jour Dataform Core

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

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

Recherchez la dernière version de @dataform/core sur la page des versions de Dataform sur GitHub.
Dans la console Google Cloud , accédez à la page Dataform.

Accéder à Dataform
Sélectionnez un dépôt, puis un espace de travail.
Dans le volet Fichiers, sélectionnez le fichier package.json ou le fichier workflow_settings.yaml.

L'emplacement où le package de dépendances Dataform Core est défini dépend de votre version de Dataform Core et de votre utilisation des packages. Pour en savoir plus, consultez Gérer l'emplacement du package Dataform Core.
Mettez à jour le package de dépendances Dataform Core 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 de packages, spécifiez explicitement la version du package Dataform Core. 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.
Cliquez sur Installer les packages.
Validez les modifications.
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 des 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 commit que lorsque des modifications locales non validées sont présentes 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 de X: Validez le nombre X de modifications locales dans votre espace de travail ou les fichiers modifiés sélectionnés. Dataform affiche les modifications non validées.
Transférer vers la branche par défaut: Transférez vos modifications validées vers votre branche par défaut. Cette option est disponible dans un dépôt Dataform si vous n'avez aucune modification non validée dans votre espace de travail.
Transférer vers your-branch-name: Transférez vos 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 aucune modification non validée dans votre espace de travail.
Extraire de la branche par défaut: Mettez à jour vos espaces de travail avec les dernières modifications apportées à votre branche par défaut. Cette option est disponible dans un dépôt Dataform si vous n'avez aucune modification validée ou envoyée dans votre espace de travail.
Extraire de your-branch-name: Mettez à jour votre espace de travail avec les modifications récentes apportées à your-branch-name. Cette option est disponible dans un dépôt connecté à un dépôt Git tiers si vous n'avez aucune modification validée ou non publiée dans votre espace de travail.
Rétablir le dernier commit: Restaurez les fichiers de votre espace de travail dans l'état 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 Extraire. Pour extraire les modifications de votre dépôt vers votre espace de travail de développement, procédez comme suit :

Sur la page Dataform, sélectionnez un dépôt.
Dans l'onglet Espaces de travail de développement, sélectionnez un espace de travail de développement.
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

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

Dans la boîte de dialogue 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 :

Sur la page Dataform, sélectionnez un dépôt.
Sur la page du dépôt, sélectionnez un espace de travail de développement.
Sur la page de l'espace de travail de développement, cliquez sur Commit.
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 X modifications.
  
  Le nom du bouton dépend des fichiers que vous avez sélectionnés pour le commit.

Appliquer les modifications

Dataform affiche l'option Envoyer une fois que vous avez 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 :

Sur la page Dataform, sélectionnez un dépôt.
Sur la page du dépôt, sélectionnez un espace de travail de développement.
Validez les modifications.
Sur la page de l'espace de travail de développement, procédez comme suit :
1. Si vous êtes 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 Déployer sur your-branch-name.

Annuler les modifications non validées

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

Sur la page Dataform, sélectionnez un dépôt.
Sur la page du dépôt, sélectionnez un espace de travail de développement.
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 apportée à 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 envoyé une modification incompatible à 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 :

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

Étapes suivantes

Pour en savoir plus sur les paramètres de projet Dataform, consultez la documentation de référence sur IProjectConfig.
Pour savoir comment installer des packages supplémentaires, consultez Installer un package dans Dataform.
Pour savoir comment créer une table, consultez Créer une table.

Gérer un dépôt Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Rôles requis

Configurer les paramètres de workflow Dataform

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

À propos de workflow_settings.yaml

À propos de dataform.json

Configurer les noms de schémas

workflow_settings.yaml

dataform.json

Créer des variables de compilation personnalisées

workflow_settings.yaml

dataform.json

Ajouter une variable de compilation à un tableau

Migrer les paramètres de workflow vers workflow_settings.yaml

Gérer le package Dataform Core

Gérer l'emplacement du package Dataform Core

Déplacer Dataform Core vers workflow_settings.yaml

Déplacer Dataform Core vers package.json

Mettre à jour Dataform Core

package.json

workflow_settings.yaml

Contrôler les versions de votre code

Extraire les modifications

Valider les modifications

Appliquer les modifications

Annuler les modifications non validées

Résoudre les conflits de fusion

Étapes suivantes

Gérer un dépôt

À propos de `workflow_settings.yaml`

À propos de `dataform.json`

`workflow_settings.yaml`

`dataform.json`

`workflow_settings.yaml`

`dataform.json`

Migrer les paramètres de workflow vers `workflow_settings.yaml`

Déplacer Dataform Core vers `workflow_settings.yaml`

Déplacer Dataform Core vers `package.json`

`package.json`

`workflow_settings.yaml`