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 les composants de code à fichier unique et contrôler leur accès, 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 individuels de gérer leurs propres composants de code, ainsi que 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

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.

   Go to project selector

2. Verify that billing is enabled for your Cloud de Confiance project.

3. 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 :

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

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 :

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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

   Si le volet de gauche n'apparaît pas, cliquez sur last_page Développer le volet de gauche pour l'ouvrir.

3. Pour afficher les dossiers et les composants de code dans la région de code et le projet sélectionnés, procédez de l'une des manières suivantes :

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

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

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

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

Pour définir la région par défaut des nouveaux composants de code :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

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

   

3. À côté du nom du projet, cliquez sur more_vert Afficher les actions du panneau de 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 d'un dossier

Pour vous assurer que les modifications récentes que vous avez apportées ou que d'autres utilisateurs 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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

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

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

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 folder 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 more_vert 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 ressources, 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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

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

4. Cliquez sur more_vert 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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le dossier dans lequel vous souhaitez importer le composant de code.

4. Cliquez sur more_vert 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.

8. Cliquez sur Enregistrer.

Télécharger un composant 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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

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

4. Cliquez sur more_vert 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 folder 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 more_vert 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 folder 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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Selon le nombre de ressources que vous souhaitez déplacer, procédez de l'une des manières suivantes :

   • Déplacer une seule ressource : dans l'explorateur de fichiers, sélectionnez le dossier ou le composant de code que vous souhaitez déplacer, puis cliquez sur more_vert Afficher les actions > Déplacer.
   • Déplacer plusieurs ressources : dans la vue 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 "Déplacer la ressource", sélectionnez le dossier utilisateur ou le dossier d'équipe vers lequel vous souhaitez déplacer la ressource.

5. 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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Sélectionnez le dossier ou le composant de code que vous souhaitez copier.

4. Cliquez sur more_vert 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 folder Fichiers pour ouvrir l'explorateur de fichiers :

   

3. Selon le nombre de ressources que vous souhaitez supprimer, procédez de l'une des manières suivantes :

   • Supprimer une seule ressource : dans l'explorateur de fichiers, sélectionnez le dossier ou le composant de code que vous souhaitez supprimer, puis cliquez sur more_vert Afficher les actions > Supprimer.
   • Supprimer plusieurs ressources : dans la vue Dossier, 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.

É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