Créer et utiliser des espaces de travail

Ce document explique comment utiliser les espaces de travail dans BigQuery, y compris les tâches suivantes:

• Créer des espaces de travail
• Supprimer des espaces de travail
• Utiliser des fichiers dans des espaces de travail
• Effectuer un contrôle des versions sur les fichiers dans les espaces de travail

Avant de commencer

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

Rôles requis

L'accès aux espaces de travail est déterminé par les rôles accordés à leur dépôt parent. Pour en savoir plus, consultez la section Rôles requis.

Créer un espace de travail

La création d'un espace de travail est gérée différemment selon que vous utilisez un dépôt BigQuery ou un dépôt tiers.

Créer un espace de travail dans un dépôt BigQuery

Pour créer un espace de travail dans un dépôt BigQuery, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt dans lequel vous souhaitez créer un espace de travail.

4. Dans l'éditeur, cliquez sur Ajouter un espace de travail.

5. Dans le volet Create workspace (Créer un espace de travail), dans le champ Workspace ID (ID de l'espace de travail), saisissez un ID unique pour l'espace de travail.

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

6. Cliquez sur Créer.

Créer un espace de travail dans un dépôt tiers

Pour créer un espace de travail dans un dépôt tiers, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt dans lequel vous souhaitez créer un espace de travail.

4. Dans l'éditeur, cliquez sur Ajouter un espace de travail. Le volet Créer un espace de travail s'ouvre.

5. Sélectionnez le bouton radio Branche distante existante ou Nouvelle branche, selon que vous souhaitez utiliser une branche existante ou une nouvelle branche pour l'espace de travail.

6. Spécifiez la branche à utiliser:

   1. Si vous avez sélectionné la case d'option Branche distante existante, choisissez une branche existante dans le champ Branche distante.

   2. Si vous avez sélectionné le bouton radio Nouvelle branche, saisissez un nom de branche dans le champ ID de l'espace de travail. Le nom de la branche créé dans le dépôt tiers est identique à l'ID de l'espace de travail BigQuery.

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

7. Cliquez sur Créer.

Créer un répertoire dans un espace de travail

Pour créer un répertoire dans un espace de travail, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail et cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Cliquez sur l'option add Ajouter.

6. Cliquez sur Créer dans le dépôt > Répertoire.

7. Dans le champ Ajouter un chemin d'accès au répertoire, saisissez un chemin d'accès au répertoire.

8. Cliquez sur Créer un annuaire.

Gérer les fichiers dans un espace de travail

Vous pouvez créer des fichiers dans un espace de travail ou importer des fichiers existants.

Vous pouvez créer ou importer les types de fichiers suivants dans un dépôt:

• Requêtes SQL
• Notebooks Python
• Canevas de données
• Préparation des données
• Fichiers de tout autre type

Créer un fichier

Pour créer un fichier dans un espace de travail, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail, puis cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Effectuez l'une des opérations suivantes :

   • Cliquez sur l'option add Ajouter.
   • Sélectionnez un répertoire existant, puis cliquez sur l'option more_vert Actions.

6. Cliquez sur Créer dans le dépôt, puis sur le type de fichier que vous souhaitez créer.

7. Dans le champ Name (Nom), saisissez un nom de fichier.

8. (Facultatif) Dans le champ Répertoire parent, saisissez le chemin d'accès au répertoire dans lequel créer le fichier.

9. Cliquez sur Enregistrer.

Importer un fichier

Pour importer un fichier dans un espace de travail, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail, puis cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Effectuez l'une des opérations suivantes :

   • Cliquez sur l'option add Ajouter.
   • Sélectionnez un répertoire existant, puis cliquez sur l'option more_vert Actions.

6. Cliquez sur Importer dans le dépôt, puis sur le type de fichier que vous souhaitez importer.

7. Dans le volet d'importation, effectuez l'une des opérations suivantes:

   • Dans le champ Importation de fichier, cliquez sur Parcourir, sélectionnez un fichier, puis cliquez sur Ouvrir.
   • Dans le champ URL, saisissez l'URL du fichier.

8. Facultatif: dans le champ Répertoire parent, saisissez le chemin d'accès au répertoire dans lequel créer le fichier.

9. Cliquez sur Importer.

Supprimer un fichier

Pour supprimer un fichier d'un espace de travail, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail, puis cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Sélectionnez le fichier que vous souhaitez supprimer, cliquez sur l'option more_vert Actions, puis sur Supprimer.

6. Cliquez sur Supprimer.

Utiliser le contrôle des versions avec un fichier

Cette section explique comment utiliser le contrôle des versions dans BigQuery pour suivre les fichiers dans les espaces de travail.

BigQuery utilise Git pour suivre chaque modification apportée aux fichiers d'un dépôt. Dans un dépôt BigQuery, vous interagissez directement avec le dépôt Git. Dans un dépôt connecté, vous interagissez avec la branche par défaut du dépôt distant que vous avez configurée lorsque vous avez connecté le dépôt.

BigQuery affiche les options de contrôle des versions en fonction de l'état des modifications dans votre espace de travail. Par exemple, BigQuery n'affiche l'option de validation que lorsqu'il existe des modifications locales non validées dans votre espace de travail. Lorsque les fichiers de votre espace de travail sont une copie exacte de votre branche par défaut ou par défaut, BigQuery affiche l'état À jour.

BigQuery affiche les options de contrôle des versions suivantes:

Valider la ou les modifications X

Validez le nombre X de modifications locales dans votre espace de travail ou dans les fichiers modifiés sélectionnés. BigQuery affiche les modifications non validées.

Transférer vers la branche par défaut

Transférez les modifications validées vers votre branche par défaut. Cette option est disponible dans un dépôt si vous n'avez pas de modifications non validées dans votre espace de travail et qu'il existe des commits non poussés.

Transférer vers your-branch-name

Transférez les modifications validées vers your-branch-name. Cette option est disponible dans un dépôt connecté à un dépôt Git tiers si vous n'avez aucune modification non validée dans votre espace de travail. Le nom de la branche distante dans le dépôt tiers est identique à l'ID de l'espace de travail BigQuery.

Extraire de la branche par défaut

Mettez à jour vos espaces de travail avec les modifications récentes de votre branche par défaut. Cette option est disponible dans un dépôt si vous n'avez pas de modifications non validées dans votre espace de travail.

Extraire de your-branch-name

Mettez à jour votre espace de travail avec les modifications récentes apportées par your-branch-name. Cette option est disponible dans un dépôt connecté à un dépôt Git tiers si vous n'avez aucune modification non validée dans votre espace de travail. Le nom de la branche distante dans le dépôt tiers est identique à l'ID de l'espace de travail BigQuery.

Rétablir le dernier commit

Rétablissez les fichiers de votre espace de travail à leur état lors de votre dernier commit.

Extraire les modifications

Si votre espace de travail n'est pas synchronisé avec votre dépôt, BigQuery affiche l'option Pull (Extraire).

Pour extraire les modifications de votre dépôt vers votre espace de travail, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail et cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Dans le volet de l'espace de travail, procédez comme suit:

   1. Si vous vous trouvez dans un dépôt BigQuery, cliquez sur Extraire à partir de la branche par défaut.

   2. Si vous vous trouvez dans un dépôt connecté à un dépôt Git tiers, procédez comme suit:

      1. Cliquez sur Extraire de la branche par défaut pour extraire la branche par défaut du dépôt tiers.
      2. Cliquez sur Extraire de your-branch-name pour extraire la branche du dépôt tiers qui correspond à l'espace de travail actuel.

Valider les modifications

Une fois que vous avez effectué une modification dans un espace de travail, BigQuery affiche l'option Commit (Valider). Vous pouvez valider toutes les modifications locales ou des fichiers sélectionnés. Les fichiers que vous avez ajoutés ou modifiés sont identifiés par un point bleu à côté d'eux dans le volet de l'espace de travail.

Pour valider les modifications apportées à votre espace de travail dans votre dépôt, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail et cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Dans le volet de l'espace de travail, cliquez sur Valider les modifications X.

6. Dans le volet Commit changes (Valider les modifications), procédez comme suit:

   1. Sélectionnez les fichiers modifiés que vous souhaitez valider.

      Si vous ne sélectionnez aucun fichier, BigQuery valide toutes les modifications locales. Vous pouvez filtrer les fichiers modifiés par état, nom de fichier et chemin d'accès.

   2. Dans le champ Ajouter un message de commit, saisissez une description de votre commit.

   3. Cliquez sur Valider toutes les modifications ou sur Valider les modifications X.

      Le nom du bouton dépend des fichiers que vous avez sélectionnés pour l'enregistrement.

Déployer les modifications

BigQuery affiche l'option Push (Transférer) une fois les modifications validées.

Pour transférer les modifications de votre espace de travail vers votre dépôt, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail et cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Dans le volet de l'espace de travail, procédez comme suit:

   1. Si vous vous trouvez dans un dépôt BigQuery, cliquez sur Transférer vers la branche par défaut.

   2. Si vous vous trouvez dans un dépôt connecté à un dépôt Git tiers, procédez comme suit:

      1. Cliquez sur Transférer vers la branche par défaut pour transférer vers la branche par défaut du dépôt tiers.
      2. Cliquez sur Push to your-branch-name (Transférer vers your-branch-name) pour transférer vers la branche du dépôt tiers qui correspond à l'espace de travail actuel.

Annuler les modifications non validées

Pour annuler les modifications non validées, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail et cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Dans le volet de l'espace de travail, cliquez sur la flèche du menu déroulant arrow_drop_down sur le bouton de contrôle des versions, puis sur Revenir au dernier commit.

Résoudre les conflits de fusion

Un conflit de fusion peut se produire lorsqu'une modification locale dans votre espace de travail est incompatible avec une modification apportée à la branche par défaut de votre dépôt. Les conflits de fusion se produisent généralement lorsque plusieurs utilisateurs modifient simultanément le même fichier.

Un conflit de fusion se produit généralement lorsque vous extrayez une branche après qu'un autre utilisateur a poussé une modification en conflit sur la même branche. Vous devez résoudre manuellement un conflit de fusion en modifiant le fichier concerné.

L'exemple de code suivant montre un conflit de fusion affiché dans un fichier SQL:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Pour résoudre un conflit de fusion, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail et cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Sélectionnez le fichier concerné, puis apportez les modifications de votre choix.

6. Validez les modifications.

7. Facultatif: Transférer les modifications.

Afficher l'historique des validations

Pour afficher l'historique des commits, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, développez le dossier Dépôts.

3. Sélectionnez le dépôt contenant l'espace de travail avec lequel vous souhaitez travailler.

4. Dans l'éditeur, recherchez l'espace de travail et cliquez sur Ouvrir.

   Le volet de l'espace de travail s'ouvre:

   

5. Dans le volet de l'espace de travail, cliquez sur la flèche du menu déroulant arrow_drop_down sur le bouton de contrôle des versions, puis sur Afficher l'historique des commits.

Supprimer un espace de travail

Pour supprimer un espace de travail et tout son contenu, procédez comme suit:

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

   Accéder à BigQuery

2. Dans le volet Explorer, cliquez sur le dossier Dépôts.

3. Dans le volet Dépôts Git, sélectionnez l'espace de travail que vous souhaitez supprimer.

4. Cliquez sur l'option more_vert Actions, puis sur Supprimer.

5. Cliquez sur Supprimer.

Étape suivante

• Découvrez comment créer des dépôts.