Mettre à jour le package principal Dataform

Ce document explique comment mettre à jour Dataform Core vers la dernière version.

Dataform Core est le framework Dataform Open Source permettant de développer des workflows SQL avec SQLX et JavaScript.

Lorsque vous initialisez le premier espace de travail dans un dépôt, Dataform installe automatiquement Dataform Core en tant que package de dépendances dans le fichier package.json.

Nous vous recommandons de toujours utiliser la dernière version disponible du framework principal Dataform. Pour en savoir plus sur les versions du framework de base Dataform, consultez les versions de Dataform sur GitHub.

Pour éviter les problèmes liés à l'installation de packages dans votre environnement de production, nous vous recommandons de procéder comme suit:

  • Spécifiez explicitement la version du package principal Dataform dans package.json, par exemple 3.0.0. N'utilisez pas d'autres options dependencies de package.json, par exemple >version.

  • Testez de nouvelles versions de package dans un environnement hors production. Pour en savoir plus sur la configuration des différents environnements de cycle de vie du code, consultez la section Gérer le cycle de vie du code.

Avant de commencer

  1. Créez un dépôt.
  2. Créez et initialisez un espace de travail de développement.

Rôles requis

Pour obtenir les autorisations nécessaires pour mettre à jour Dataform, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur Dataform (roles/dataform.editor) pour 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.

Mettre à jour Dataform Core

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

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

    Accéder à la page Dataform

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

  4. Dans le volet Fichiers, ouvrez le fichier package.json.

  5. Mettez à jour la dépendance @dataform/core avec la dernière version de Dataform au format suivant:

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

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

  6. Cliquez sur Install packages (Installer les packages).

  7. Valider les modifications

  8. Déployez les modifications dans 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"
    }
}

Étapes suivantes