Présentation du développement dans un espace de travail

Ce document vous aide à comprendre le concept d'espaces de travail dans Dataform et leurs fonctionnalité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 créez, modifiez ou supprimez le contenu du dépôt sans affecter les autres utilisateurs qui travaillent sur le même dépôt, puis vous validez et transférez vos modifications vers le dépôt.

Vous pouvez développer votre workflow SQL avec le noyau Dataform ou JavaScript. Dataform compile votre code en 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 se compose des 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.
Exécutions
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 la section Surveiller les journaux d'exécution.

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 Tapez pour 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 des 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"
Met en forme votre code JavaScript ou de base Dataform.
État de compilation
Affiche l'état de compilation du code dans votre espace de travail.
Volet "Métadonnées"
Affiche les métadonnées du fichier actuellement en cours de modification.
Volet des requêtes compilées
Compile les requêtes du fichier actuellement en cours de modification en SQL. Si la compilation de la requête échoue, affiche des 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 des erreurs de validation. Si la validation de la requête aboutit, affiche le nombre d'octets que l'exécution des requêtes vers BigQuery utiliserait.
Menu déroulant "Début de l'exécution"
Affiche les options permettant de déclencher l'exécution de l'ensemble du workflow dans votre espace de travail ou ses éléments sélectionnés.

Composants de l'onglet "Graphique compilé"

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

Vous pouvez faire un zoom avant ou arrière, et utiliser la fonction glisser-déposer pour naviguer dans le graphique.

Vous pouvez filtrer le graphique en fonction des propriétés suivantes:

  • Nom
  • Tag
  • Type
    • Assertion
    • Déclaration
    • Table incrémentielle
    • Vue matérialisée
    • Opérations
    • Tableau
    • 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 afficher ses détails dans les volets suivants:

Volet "Métadonnées"
Affiche le nom complet, le type, les dépendances et les dépendants de l'action sélectionnée.
Volet de requête
Affiche la requête SQL compilée de 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 commencent par être des modifications locales non validées que vous pouvez valider, puis envoyer à 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 transférez les modifications de 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 poussez les modifications vers la branche par défaut.

Vous pouvez également extraire toutes les modifications du dépôt Dataform ou du dépôt distant, puis 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 section Contrôler les versions de votre code.

Étape suivante