Créer un espace de travail de développement Dataform

Sur cette page, vous allez :

Lorsque vous créez un espace de travail de développement dans un nouveau dépôt pour la première fois, Dataform vous invite à l'initialiser avec un ensemble de fichiers de configuration nécessaires au fonctionnement de Dataform.

Un espace de travail de développement initialisé contient les répertoires et les fichiers suivants:

  • definitions/: répertoire des définitions d'éléments, au format Dataform Core ou JavaScript.

  • includes/: répertoire vide pour les scripts et les variables que vous pouvez réutiliser dans le dépôt.

  • dataform.json: fichier de configuration Dataform par défaut contenant l'ID de projet Google Cloud et le schéma BigQuery dans lesquels publier les éléments. Vous pouvez remplacer les paramètres par défaut pour les personnaliser en fonction de vos besoins, mais vous n'êtes pas obligé de commencer à utiliser Dataform.

  • package.json: fichier de configuration des dépendances Dataform par défaut avec la dernière version de @dataform/core. Vous pouvez utiliser ce fichier pour importer des packages.

  • definitions/sample.sqlx: exemple de fichier SQLX pour vous aider à démarrer.

Avant de commencer

Si vous ne l'avez pas déjà fait, créez un dépôt Dataform.

Rôles requis

Afin d'obtenir les autorisations nécessaires pour créer, initialiser et supprimer un espace de travail de développement, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur de données (roles/dataform.editor) sur ces 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.

Créer un espace de travail de développement Dataform

Pour créer un espace de travail de développement Dataform, procédez comme suit:

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

    Accéder à Dataform

  2. Sélectionnez le dépôt dans lequel vous souhaitez créer le nouvel espace de travail de développement.

  3. Sur la page de votre dépôt, cliquez sur Créer un espace de travail de développement.

  4. Dans la fenêtre Créer un espace de travail de développement, procédez comme suit:

    1. Dans le champ ID de l'espace de travail, saisissez un identifiant unique pour l'espace de travail de développement.

      Les ID ne peuvent contenir que des chiffres, des lettres, des traits d'union et des traits de soulignement.

    2. Cliquez sur Créer.

Initialiser le premier espace de travail de développement dans un dépôt Dataform

Pour initialiser un espace de travail de développement Dataform, procédez comme suit:

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

    Accéder à Dataform

  2. Sélectionnez le dépôt dans lequel vous souhaitez initialiser l'espace de travail vide.

  3. Dans l'onglet Espaces de travail de développement, cliquez sur le nom de l'espace de travail vide que vous souhaitez initialiser.

  4. Sur la page de l'espace de travail de développement, cliquez sur Initialiser l'espace de travail.

Supprimer un espace de travail de développement Dataform

La création d'espaces de travail de développement Dataform n'entraîne aucuns frais. Toutefois, si vous souhaitez supprimer un espace de travail de développement, procédez comme suit:

  1. Sur la page Dataform, cliquez sur le dépôt contenant l'espace de travail que vous souhaitez supprimer.

  2. Pour éviter de supprimer des modifications non validées, validez et déployez les modifications dans votre dépôt Git.

  3. Dans l'onglet Espaces de travail de développement, sélectionnez l'espace de travail de développement que vous souhaitez supprimer, puis cliquez sur Supprimer les espaces de travail sélectionnés.

    Vous pouvez supprimer plusieurs espaces de travail à la fois.

  4. Pour confirmer l'opération, cliquez sur Supprimer.

Étapes suivantes