Créer et gérer des dossiers

Preview

Cette fonctionnalité est soumise(s) aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Remarque : Pour envoyer des commentaires ou demander de l'aide concernant cette fonctionnalité, envoyez un e-mail à l'adresse [e-mail].

Le document suivant explique comment créer et gérer des dossiers dans BigQuery. Vous pouvez utiliser des dossiers pour organiser les composants de code à fichier unique et contrôler leur accès, comme 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 personnes de gérer leurs propres composants de code, et des dossiers d'équipe permettant de gérer les composants de code d'une équipe.

Les dossiers BigQuery sont fournis par Dataform.

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

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.

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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 sont propagées à 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 complet sur une ressource dans le système de fichiers et de dossiers. Un utilisateur disposant 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 pour un fichier ou un dossier. Ce rôle est également requis dans le dossier de destination lorsque vous déplacez une ressource.
Commentateur de code (roles/dataform.codeCommenter)	Fichier ou dossier	Permet de commenter des composants 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 d'é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 composants de code qu'il contient.
Lecteur de dossiers 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	Permet de créer des 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

• Pour créer un dossier :
  • folders.create sur le dossier utilisateur parent, le dossier d'équipe ou le projet
  • 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 pour un dossier : folders.getIamPolicy sur le dossier
• Définissez la stratégie IAM pour un dossier : folders.setIamPolicy sur le dossier.
• Déplacer un dossier :
  • folders.move sur le dossier à déplacer
  • folders.addContents sur le dossier de destination ou le dossier d'équipe (inutile si vous déplacez le fichier 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 d'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érer 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 accéder à 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 n'apparaît pas, cliquez sur Développer le volet de gauche pour l'ouvrir.

3. Pour afficher les dossiers et les éléments de code dans la région de code et le projet sélectionnés, procédez comme suit :

   • 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.

Modifier la région du code

Vous pouvez avoir des dossiers et des composants de code dans différentes régions de code. Pour modifier la région de code que vous consultez :

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 de fichiers > Changer de région de code.

4. Sélectionnez la région de code que vous souhaitez afficher.

5. Cliquez sur Enregistrer.

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

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

• Dossier utilisateur ou code de ressource à n'importe quel niveau.
• Sous-dossier d'un dossier d'équipe.
• Un composant de code dans le sous-dossier d'un dossier d'équipe.

Pour savoir comment créer un dossier d'équipe, consultez Créer un dossier d'équipe.

Pour créer un dossier ou un composant 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 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 "Créer une ressource", saisissez le nom de 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 le nom du dossier d'équipe.

6. Cliquez sur Créer.

Importer un élément 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 le composant de code.

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

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

   • Cliquez sur le bouton radio Importation de fichier, puis recherchez et sélectionnez un fichier local.
   • Cliquez sur le bouton radio URL, puis saisissez l'URL d'un fichier d'asset de code qui se trouve dans un dépôt GitHub.

6. Saisissez un nom pour l'élément de code.

7. Facultatif : Sélectionnez une région dans laquelle stocker le composant de code. Si vous sélectionnez une région différente de la valeur par défaut, celle-ci devient la région par défaut dans laquelle tous les nouveaux composants de code seront créés à l'avenir.

8. Cliquez sur Enregistrer.

Télécharger un élément 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 composant 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 élément 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 le composant 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 composant de code, y compris un dossier utilisateur :

     • roles/dataform.codeOwner : peut effectuer n'importe quelle action sur le composant de code, y compris le supprimer ou le partager.
     • roles/dataform.codeEditor : peut effectuer n'importe quelle action sur le composant de code, à l'exception de la suppression ou du partage.
     • roles/dataform.codeCommenter : peut afficher et commenter le composant de code.
     • roles/dataform.codeViewer : peut afficher le composant 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, à l'exception de la suppression ou du partage.
     • roles/dataform.teamFolderCommenter : peut afficher et commenter le dossier d'équipe et les composants de code qu'il contient.
     • roles/dataform.teamFolderViewer : peut afficher le dossier de l'équipe et les composants 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 composant 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. Sélectionnez le dossier ou l'élément de code que vous souhaitez déplacer.

4. Cliquez sur Afficher les actions > Déplacer.

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

6. Cliquez sur Déplacer.

Copier un dossier ou un élément de code

Pour copier 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 le composant de code que vous souhaitez copier.

4. Cliquez sur Afficher les actions > Copier.

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

6. Cliquez sur Copier.

Supprimer un dossier ou un composant 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. Sélectionnez le dossier ou le composant de code que vous souhaitez supprimer.

4. Cliquez sur Afficher les actions > Supprimer.

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

Étapes suivantes

• Organiser les composants de code avec 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