Créer et gérer des dossiers

Le document suivant explique comment créer et gérer des dossiers dans BigQuery. Vous pouvez utiliser des dossiers pour organiser et contrôler l'accès aux éléments de code à fichier unique, tels que les notebooks, les requêtes enregistrées, les canevas de données et les fichiers de préparation des données. BigQuery propose des dossiers utilisateur permettant aux utilisateurs de gérer leurs propres éléments de code, ainsi que des dossiers d'équipe pour gérer les éléments de code d'une équipe.

Les dossiers BigQuery sont fournis par Dataform.

Avant de créer des dossiers, découvrez comment fonctionnent les dossiers BigQuery en lisant Organiser les éléments de code avec des dossiers.

Avant de commencer

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Rôles requis

Pour obtenir les autorisations nécessaires pour effectuer les tâches décrites dans ce document, demandez à votre administrateur de vous accorder les rôles IAM appropriés sur le projet, le dossier ou la ressource.

Pour obtenir les autorisations nécessaires pour utiliser l'explorateur de fichiers BigQuery, demandez à votre administrateur de vous accorder le rôle Utilisateur BigQuery (roles/bigquery.user) ou Utilisateur BigQuery Studio (roles/bigquery.studioUser) sur le projet.

Les autorisations accordées sur un dossier se propagent à tous les fichiers et dossiers qu'il contient.

Les règles suivantes s'appliquent aux fichiers et aux dossiers qui les contiennent :

Rôle	Accordée le	Autorisations et cas d'utilisation
Propriétaire de code (roles/dataform.codeOwner)	Fichier ou dossier	Accorde un contrôle total sur une ressource dans le système de fichiers et de dossiers. Un utilisateur doté de ce rôle peut effectuer toutes les actions, y compris supprimer la ressource, définir sa stratégie IAM et la déplacer.
Éditeur de code (roles/dataform.codeEditor)	Fichier ou dossier	Permet de modifier et de gérer le contenu. Un utilisateur disposant de ce rôle peut ajouter du contenu à des dossiers, modifier des fichiers et obtenir la stratégie IAM d'un fichier ou d'un dossier. Ce rôle est également requis sur le dossier de destination lors du déplacement d'une ressource.
Commentateur de code (roles/dataform.codeCommenter)	Fichier ou dossier	Permet de commenter des éléments ou des dossiers de code.
Lecteur de code (roles/dataform.codeViewer)	Fichier ou dossier	Fournit un accès en lecture seule. Un utilisateur disposant de ce rôle peut interroger le contenu des fichiers et des dossiers.
Créateur de code (roles/dataform.codeCreator)	Projet	Permet de créer des fichiers et des dossiers dans un projet.

Les rôles suivants sont spécifiques à la gestion des dossiers d'équipe :

Rôle	Accordée le	Autorisations et cas d'utilisation
Propriétaire de dossier d'équipe (roles/dataform.teamFolderOwner)	Dossier d'équipe	Accorde un contrôle total sur un dossier d'équipe dans le système de fichiers et de dossiers. Un utilisateur disposant de ce rôle peut supprimer le dossier de l'équipe et définir sa stratégie IAM.
Contributeur de dossier d'équipe (roles/dataform.teamFolderContributor)	Dossier d'équipe	Permet de gérer le contenu d'un dossier d'équipe. Un utilisateur disposant de ce rôle peut modifier un dossier d'équipe.
Commentateur de dossier d'équipe (roles/dataform.teamFolderCommenter)	Dossier d'équipe	Permet de commenter un dossier d'équipe et les assets de code qu'il contient.
Lecteur de dossier d'équipe (roles/dataform.teamFolderViewer)	Dossier d'équipe	Fournit un accès en lecture seule à un dossier d'équipe et à son contenu. Un utilisateur disposant de ce rôle peut afficher un dossier d'équipe et obtenir sa stratégie IAM.
Créateur de dossier d'équipe (roles/dataform.teamFolderCreator)	Projet	Autorise la création de dossiers d'équipe dans un projet.

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour effectuer les tâches décrites dans ce document. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

• Créez un dossier :
  • folders.create sur le dossier utilisateur, le dossier d'équipe ou le projet parent
  • folders.addContents sur le dossier parent ou le dossier d'équipe
• Récupérer les propriétés d'un dossier : folders.get sur le dossier
• Interroger le contenu d'un dossier ou d'un dossier d'équipe : folders.queryContents sur le dossier
• Mettre à jour un dossier : folders.update sur le dossier
• Supprimer un dossier : folders.delete sur le dossier
• Obtenir la stratégie IAM d'un dossier : folders.getIamPolicy sur le dossier
• Définir la stratégie IAM d'un dossier : folders.setIamPolicy sur le dossier
• Déplacer un dossier :
  • folders.move sur le dossier en cours de déplacement
  • folders.addContents sur le dossier de destination ou le dossier d'équipe (non requis si vous déplacez vers un dossier racine)
• Créer un dossier d'équipe : teamFolders.create sur le projet
• Supprimer un dossier d'équipe : teamFolders.delete sur le dossier d'équipe
• Obtenir la stratégie IAM pour un dossier d'équipe : teamFolders.getIamPolicy sur le dossier d'équipe
• Définissez la stratégie IAM pour un dossier d'équipe : teamFolders.setIamPolicy sur le dossier d'équipe.
• Récupérez les propriétés d'un dossier d'équipe : teamFolders.get sur le dossier d'équipe.
• Mettre à jour un dossier d'équipe : teamFolders.update sur le dossier d'équipe

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour obtenir un accès complet à tous les dossiers et fichiers de votre projet, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

• Administrateur Dataform (roles/dataform.admin)
• Éditeur Dataform (roles/dataform.editor)
• Lecteur Dataform (roles/dataform.viewer)

Afficher les ressources

Pour afficher les dossiers et les éléments de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

   Si le volet de gauche ne s'affiche pas, cliquez sur Développer le volet de gauche pour l'ouvrir.

3. Effectuez l'une des opérations suivantes pour afficher les dossiers et les éléments de code dans le projet et la région de code sélectionnés :

   • Développez le nœud Utilisateur (votre adresse e-mail) pour afficher les dossiers et les fichiers que vous avez créés.
   • Développez le nœud Dossiers d'équipe pour afficher tous les dossiers d'équipe auxquels vous avez accès.
   • Développez le nœud Partagés avec moi pour afficher tous les dossiers et fichiers que d'autres utilisateurs ont partagés avec vous.

Remarque : Lorsque vous ouvrez un dossier, le fil d'Ariane en haut de la vue du dossier affiche le chemin d'accès complet à votre emplacement actuel. Le chemin d'accès est visible jusqu'au niveau du dossier pour lequel vous disposez d'autorisations.

Définir la région par défaut des composants de code

Vous pouvez avoir des dossiers et des éléments de code dans différentes régions de code.

Tous les nouveaux composants de code de votre projet Google Cloud utilisent une région par défaut. Une fois l'élément créé, vous ne pouvez plus modifier sa région.

Important : Si vous modifiez la région lors de la création d'un composant de code, cette région devient la région par défaut pour tous les composants de code suivants. Les composants de code existants ne sont pas affectés.

Pour définir la région par défaut des nouveaux composants de code, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. À côté du nom du projet, cliquez sur Afficher les actions du panneau des fichiers > Changer de région de code.

4. Sélectionnez la région de code que vous souhaitez utiliser par défaut.

5. Cliquez sur Enregistrer.

Pour obtenir la liste des régions compatibles, consultez Emplacements BigQuery Studio.

Actualiser le contenu du dossier

Pour vous assurer que les modifications récentes que vous avez apportées ou que d'autres personnes ont partagées sont visibles dans l'explorateur de fichiers, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le dossier que vous souhaitez actualiser, par exemple votre nœud racine utilisateur, une racine de dossier d'équipe ou un dossier individuel.

4. Cliquez sur Afficher les actions > Actualiser le contenu.

Créer un dossier ou un élément de code

Suivez cette procédure pour créer l'une des ressources suivantes :

• Un dossier utilisateur ou un élément de code à n'importe quel niveau.
• un sous-dossier d'un dossier d'équipe ;
• Un composant de code dans le sous-dossier d'un dossier d'équipe.

Pour en savoir plus sur la création d'un dossier d'équipe, consultez Créer un dossier d'équipe.

Pour créer un dossier ou un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le nœud racine de l'utilisateur ou le dossier dans lequel vous souhaitez créer la ressource.

4. Cliquez sur Afficher les actions > Créer, puis sélectionnez le type de ressource que vous souhaitez créer.

5. Dans le volet de création de ressource, saisissez un nom pour la nouvelle ressource.

6. Cliquez sur Enregistrer.

Créer un dossier d'équipe

Pour créer un dossier d'équipe dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le nœud racine du dossier d'équipe.

4. Cliquez sur Afficher les actions > Créer un dossier d'équipe.

5. Dans la boîte de dialogue Créer un dossier d'équipe, saisissez un nom pour le dossier d'équipe.

6. Cliquez sur Créer.

Importer un composant de code

Pour importer un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le dossier dans lequel vous souhaitez importer l'asset de code.

4. Cliquez sur Afficher les actions > Importer, puis sélectionnez le type d'asset de code que vous souhaitez importer.

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

   • Cliquez sur la case d'option Importation de fichier, puis recherchez et sélectionnez un fichier local.
   • Cliquez sur la case d'option URL, puis saisissez l'URL d'un fichier d'élément de code qui se trouve dans un dépôt GitHub.

6. Saisissez un nom pour l'asset de code.

7. Facultatif : sélectionnez une région dans laquelle stocker le composant de code.

   Remarque : Si vous sélectionnez une région différente de la valeur par défaut, la région que vous sélectionnez devient la région par défaut dans laquelle tous les nouveaux composants de code sont créés.

8. Cliquez sur Enregistrer.

Télécharger un asset de code

Pour télécharger un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez l'asset de code que vous souhaitez télécharger.

4. Cliquez sur Afficher les actions > Télécharger.

Renommer un dossier ou un asset de code

Pour renommer un dossier ou un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le dossier ou l'élément de code que vous souhaitez renommer.

4. Cliquez sur Afficher les actions > Renommer.

5. Dans la boîte de dialogue de changement de nom de la ressource, saisissez un nouveau nom pour la ressource.

6. Cliquez sur Renommer.

Partager un dossier ou un asset de code

Pour partager un dossier ou un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le dossier ou l'élément de code que vous souhaitez partager.

4. Dans le volet Autorisations de partage, cliquez sur Ajouter un utilisateur/groupe.

5. Dans le champ Nouveaux comptes principaux, saisissez un compte principal.

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

   • Dans la liste Rôle, sélectionnez l'un des rôles suivants pour partager un élément de code, y compris un dossier utilisateur :

     • roles/dataform.codeOwner : peut effectuer n'importe quelle action sur l'élément de code, y compris le supprimer ou le partager.
     • roles/dataform.codeEditor : peut effectuer n'importe quelle action sur l'élément de code, sauf le supprimer ou le partager.
     • roles/dataform.codeCommenter : peut afficher l'élément de code et ajouter des commentaires.
     • roles/dataform.codeViewer : peut afficher l'asset de code.

   • Dans la liste Rôle, sélectionnez l'un des rôles suivants pour partager un dossier d'équipe :

     • roles/dataform.teamFolderOwner : peut effectuer n'importe quelle action sur le dossier d'équipe, y compris le supprimer ou le partager.
     • roles/dataform.teamFolderContributor : peut effectuer n'importe quelle action sur le dossier d'équipe, sauf le supprimer ou le partager.
     • roles/dataform.teamFolderCommenter : peut afficher le dossier d'équipe et les éléments de code qu'il contient, et ajouter des commentaires.
     • roles/dataform.teamFolderViewer : peut afficher le dossier d'équipe et les éléments de code qu'il contient.

7. Cliquez sur Enregistrer.

8. Pour revenir à la page d'informations sur le notebook, cliquez sur Fermer.

Déplacer un dossier ou un asset de code

Pour déplacer un dossier ou un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Selon le nombre de ressources que vous souhaitez déplacer, effectuez l'une des opérations suivantes :

   • Déplacer une seule ressource : dans l'explorateur de fichiers, sélectionnez le dossier ou l'élément de code que vous souhaitez déplacer, puis cliquez sur Afficher les actions > Déplacer.
   • Déplacer plusieurs ressources : dans la vue du dossier, cochez la case à côté de chaque ressource que vous souhaitez déplacer, puis cliquez sur Déplacer.

4. Dans la boîte de dialogue de déplacement de ressource, sélectionnez le dossier utilisateur ou le dossier d'équipe vers lequel vous souhaitez déplacer la ressource.

5. Cliquez sur Déplacer.

Remarque : Les opérations de déplacement groupé sont indépendantes. Si une ressource ne peut pas être déplacée, l'opération tente tout de même de déplacer toutes les autres ressources sélectionnées.

Copier un composant de code

Pour copier un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez l'asset de code que vous souhaitez copier.

4. Cliquez sur Afficher les actions > Copier.

5. Dans la boîte de dialogue de copie de la ressource, sélectionnez le dossier de l'utilisateur ou de l'équipe dans lequel vous souhaitez copier la ressource.

6. Cliquez sur Copier.

Supprimer un dossier ou un élément de code

Pour supprimer un dossier ou un élément de code dans BigQuery, procédez comme suit :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Selon le nombre de ressources que vous souhaitez supprimer, effectuez l'une des opérations suivantes :

   • Supprimer une seule ressource : dans l'explorateur de fichiers, sélectionnez le dossier ou l'élément de code que vous souhaitez supprimer, puis cliquez sur Afficher les actions > Supprimer.
   • Supprimer plusieurs ressources : dans la vue des dossiers, cochez la case à côté de chaque ressource que vous souhaitez supprimer, puis cliquez sur Supprimer.

4. Dans la boîte de dialogue de suppression de la ressource, cliquez sur Supprimer.

Remarque : Lorsque vous supprimez plusieurs ressources, les dossiers sélectionnés doivent être vides pour que l'opération aboutisse. Les opérations de suppression groupée sont indépendantes. Si la suppression d'une ressource échoue, l'opération tente tout de même de supprimer toutes les autres ressources sélectionnées.

Étapes suivantes

• Organiser les composants de code dans des dossiers
• Créer des notebooks
• Créer des requêtes enregistrées
• Créer des canevas de données
• Créer des préparations de données