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 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 de base Dataform. Pour en savoir plus sur les versions le framework de base Dataform, consultez les versions de Dataform sur GitHub.

Pour éviter les problèmes d’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. Ne pas utiliser d'autres dependencies options 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 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 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 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 le 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. Exemple : 3.0.0.

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

  7. Validez 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"
    }
}

Étape suivante