Créer des environnements de développement

Créer des environnements de développement

Ce guide de démarrage rapide vous explique comment créer des environnements de développement individuels dans Dataform afin que chaque développeur puisse travailler dans son propre environnement de développement :

• Créez un dépôt Dataform.

• Accorder à Dataform l'accès à BigQuery

  • Configurez des remplacements de compilation d'espace de travail.

  Configurez les remplacements de compilation que Dataform appliquera à tous les espaces de travail de votre dépôt, transformant ainsi les espaces de travail en environnements de développement isolés.

• Nettoyer les composants créés

Avant de commencer

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Enable the APIs

Rôles requis

Pour obtenir les autorisations nécessaires pour effectuer toutes les tâches de ce tutoriel, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Administrateur Dataform (roles/dataform.admin) : dépôts
• Éditeur Dataform (roles/dataform.editor) : espaces de travail et appels de workflows

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.

Créer un dépôt Dataform

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

   Accéder à Dataform

2. Cliquez sur Créer un dépôt.

3. Sur la page CRÉER UN DÉPÔT, procédez comme suit :

   1. Dans le champ ID du dépôt, saisissez quickstart-dev.

   2. Dans la liste Région, sélectionnez europe-west4.

   3. Cliquez sur Créer.

4. Cliquez sur OK.

Accorder à Dataform l'accès à BigQuery

Pour exécuter des workflows dans BigQuery, le compte de service Dataform ou votre compte Google (aperçu) doivent disposer des rôles requis suivants :

• Éditeur de données BigQuery sur les projets pour lesquels Dataform a besoin d'un accès en lecture et en écriture. Ils incluent généralement le projet hébergeant votre dépôt Dataform.
• Lecteur de données BigQuery sur les projets auxquels Dataform doit avoir accès en lecture seule.
• Utilisateur de job BigQuery sur le projet hébergeant votre dépôt Dataform.

Pour attribuer ces rôles, procédez comme suit :

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

   Accéder à la page IAM

2. Cliquez sur Ajouter.

3. Dans le champ Nouveaux comptes principaux, saisissez l'ID de votre compte de service Dataform ou l'adresse e-mail de votre compte Google (aperçu).

4. Dans le menu Sélectionner un rôle, sélectionnez le rôle Utilisateur de tâche BigQuery.

5. Cliquez sur Ajouter un autre rôle, puis sélectionnez le rôle Éditeur de données BigQuery dans le menu Sélectionner un rôle.

6. Cliquez sur Ajouter un autre rôle, puis sélectionnez le rôle Lecteur de données BigQuery dans le menu Sélectionner un rôle.

7. Cliquez sur Enregistrer.

Configurer des remplacements de compilation d'espace de travail

Pour créer des environnements de développement isolés avec des remplacements de compilation d'espace de travail Dataform, procédez comme suit :

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

   Accéder à Dataform

2. Cliquez sur quickstart-dev.

3. Cliquez sur Paramètres, puis sur Modifier.

4. Dans le volet Remplacements de compilation d'espace de travail, saisissez ${workspaceName} dans le champ Suffixe du schéma.

   Lorsque vous déclenchez l'exécution dans un espace de travail, Dataform ajoute le nom de l'espace de travail en tant que suffixe au schéma par défaut défini dans les paramètres du workflow. Ce guide de démarrage rapide utilise les paramètres Dataform par défaut avec le schéma par défaut dataform.

5. Cliquez sur Enregistrer.

Dataform applique des remplacements de compilation d'espace de travail à tous les espaces de travail de votre dépôt.

Avec cette configuration, lorsque vous exécutez manuellement un workflow dans un espace de travail, Dataform l'exécute avec des remplacements de compilation d'espace de travail. Par conséquent, Dataform exécute le workflow dans le schéma dataform_workspaceName dans BigQuery, transformant l'espace de travail en environnement de développement isolé.

Par exemple, lorsque vous déclenchez manuellement l'exécution dans un espace de travail sasha, Dataform exécute votre workflow dans le schéma dataform_sasha de BigQuery.

Pour exécuter des workflows sans remplacement de compilation d'espace de travail tout en conservant les remplacements de compilation pour les environnements de développement, vous pouvez créer des configurations de version afin de configurer d'autres environnements d'exécution, par exemple staging et production.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud , procédez comme suit :

Supprimer les ensembles de données créés dans BigQuery

Pour éviter que des frais liés aux éléments BigQuery ne vous soient facturés, supprimez les ensembles de données dont le nom commence par dataform (par exemple, dataform-sasha).

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

   Accéder à BigQuery

2. Dans le panneau Explorateur, développez votre projet et sélectionnez un ensemble de données.

3. Cliquez sur le menu Actions, puis sélectionnez Supprimer.

4. Dans la boîte de dialogue Supprimer l'ensemble de données, saisissez delete dans le champ, puis cliquez sur Supprimer.

Supprimer le dépôt Dataform

La création de dépôts Dataform n'entraîne aucuns frais. Toutefois, si vous souhaitez supprimer un dépôt et tout son contenu, procédez comme suit :

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

   Accéder à Dataform

2. À côté de quickstart-dev, cliquez sur le menu Plus, puis sélectionnez Supprimer.

   1. Dans la fenêtre Supprimer le dépôt, saisissez le nom du dépôt pour confirmer la suppression.

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

Étapes suivantes

• Pour en savoir plus sur le cycle de vie du code dans Dataform, consultez Présentation du cycle de vie du code dans Dataform.

• Pour en savoir plus sur les bonnes pratiques concernant le cycle de vie des workflows dans Dataform, consultez Bonnes pratiques concernant le cycle de vie des workflows.

• Pour en savoir plus sur les remplacements de compilation d'espace de travail dans Dataform, consultez Créer des remplacements de compilation d'espace de travail.

• Pour savoir comment planifier des exécutions en production dans Dataform, consultez Planifier des exécutions en production.