Introduction au développement dans un espace de travail

Ce document vous aide à comprendre le concept des espaces de travail dans Dataform, ainsi que leurs capacités.

Dans Dataform, vous interagissez avec le code de votre workflow SQL dans un espace de travail de développement. Un espace de travail de développement est votre propre copie modifiable d'un dépôt. Dans un espace de travail, vous pouvez créer, modifier ou supprimer le contenu du dépôt sans affecter les autres utilisateurs qui travaillent sur le même dépôt, puis valider et transférer vos modifications dans le dépôt.

Vous pouvez développer votre workflow SQL avec Dataform Core ou JavaScript. Dataform compile votre code dans des requêtes SQL en temps réel.

Dans un espace de travail de développement, vous pouvez effectuer les tâches suivantes:

Composants d'un espace de travail de développement

Un espace de travail de développement Dataform comprend les onglets suivants:

Code
Contient un environnement de développement dans lequel vous pouvez explorer des fichiers, développer des requêtes, contrôler les versions de vos modifications et déclencher l'exécution dans BigQuery.
Graphique compilé
Affiche le workflow SQL compilé défini dans votre espace de travail sous la forme d'un graphe orienté acyclique (DAG) interactif. Si votre workflow SQL comporte des erreurs de compilation, l'onglet affiche un message d'erreur au lieu du graphique.
Executions
Affiche les journaux de toutes les exécutions déclenchées dans l'espace de travail. Vous pouvez également afficher les actions et leurs détails pour une exécution sélectionnée. Pour en savoir plus, consultez Inspecter les journaux d'exécution de l'espace de travail.

Composants de l'onglet Code

L'onglet Code d'un espace de travail de développement contient les composants suivants, qui vous permettent de développer des workflows SQL:

Volet "Fichiers"
Affiche la structure de fichiers de votre espace de travail. Enregistre automatiquement vos modifications dans la structure de fichiers. Les fichiers sélectionnés s'ouvrent dans des onglets du volet de développement. Dans le champ Saisissez un terme à rechercher, vous pouvez rechercher des fichiers ou des répertoires dans votre espace de travail en fonction de leur chemin d'accès.
Volet de contrôle des versions
Affiche l'état du contrôle des versions de votre espace de travail et les options de contrôle des versions.
Volet de développement
Affiche les fichiers ouverts dans les onglets. Enregistre automatiquement les modifications apportées aux fichiers modifiés.
Bouton d'exécution
Exécute un aperçu de la requête SQL compilée.
Bouton "Format"
Formate votre code Dataform Core ou JavaScript.
État de compilation
Affiche l'état de compilation du code dans votre espace de travail.
Volet des métadonnées
Affiche les métadonnées du fichier en cours de modification.
Volet des requêtes compilées
Compile les requêtes du fichier actuellement modifié au format SQL. Si la compilation des requêtes échoue, affiche les erreurs de compilation. Si la compilation des requêtes aboutit, affiche les requêtes compilées et les valide via des simulations sur BigQuery. Si la validation de la requête échoue, affiche les erreurs de validation. Si la validation de la requête aboutit, il affiche le nombre d'octets que l'exécution des requêtes vers BigQuery utiliserait.
Menu déroulant "Démarrer l'exécution"
Affiche les options permettant de déclencher l'exécution de l'ensemble du workflow dans votre espace de travail ou dans les éléments sélectionnés.

Composants de l'onglet du graphique compilé

L'onglet "Graphiques compilés" affiche un graphique interactif de votre workflow SQL compilé. Le graphique montre toutes les actions de votre workflow SQL et les relations entre elles.

Vous pouvez faire un zoom avant ou arrière, et naviguer dans le graphique en faisant glisser la souris.

Vous pouvez filtrer le graphique selon les propriétés suivantes:

  • Nom
  • Tag
  • Type
    • Assertion
    • Déclaration
    • Table incrémentielle
    • Vue matérialisée
    • Opérations
    • Table
    • Inconnu
    • Afficher

Vous pouvez sélectionner plusieurs filtres à la fois. Dataform les appliquera avec la condition OR.

Vous pouvez cliquer sur une action dans le graphique pour en afficher les détails dans les volets suivants:

Volet des métadonnées
Affiche le nom complet, le type, les dépendances et les dépendances de l'action sélectionnée.
Volet de requête
Affiche la requête SQL compilée pour l'action sélectionnée.

Contrôle des versions dans un espace de travail

Dans un espace de travail, vous interagissez avec le dépôt via le contrôle des versions basé sur Git. Les modifications que vous apportez aux fichiers de votre espace de travail sont d'abord des modifications locales non validées, que vous pouvez valider. Elles sont ensuite transférées vers votre dépôt afin qu'elles soient disponibles pour tous les utilisateurs du dépôt.

Si votre dépôt est connecté à un fournisseur Git distant, vous déployez les modifications depuis votre espace de travail vers votre branche de développement principale. Vous sélectionnez la branche principale lorsque vous connectez votre dépôt au fournisseur Git distant. Dans un dépôt Dataform non connecté, vous déployez les modifications dans la branche par défaut.

Vous pouvez également extraire les modifications du dépôt Dataform ou du dépôt distant, et les fusionner avec les modifications locales dans votre espace de travail de développement. Pour en savoir plus sur le contrôle des versions dans Dataform, consultez la page Contrôler les versions de votre code.

Étapes suivantes