Gérer les salles blanches

Cet article explique comment gérer les salles blanches, notamment comment :

• Mettre à jour un propriétaire de salle blanches et un commentaire.
• Ajouter, supprimer et modifier des ressources de données et des notebooks.
• Accorder l’accès à une salle blanche.
• Surveiller l’activité des salles blanches.
• Supprimer une salle blanche.

Ces tâches peuvent être effectuées par tous les collaborateurs dans une salle blanche.

Avant de commencer

La gestion des salles blanches nécessite les autorisations suivantes, en fonction de la tâche :

• Pour afficher une salle propre dans la liste des salles propres ou pour afficher les détails de la salle propre, vous devez être le propriétaire de la salle propre, un administrateur de metastore ou avoir l’un des privilèges suivants sur la salle propre : MANAGE, MODIFY CLEAN ROOM, EXECUTE CLEAN ROOM TASKou BROWSE.
• Pour mettre à jour le propriétaire d’une salle blanche, vous devez en être le propriétaire, être un administrateur du metastore ou disposer du privilège MANAGE sur celle-ci.
• Pour ajouter et supprimer des ressources de données et des notebooks dans une salle blanche et pour mettre à jour un commentaire, vous devez être le propriétaire de la salle blanche ou disposer du privilège MODIFY CLEAN ROOM sur la salle blanche.
• Pour accorder l’accès à une salle blanche, vous devez en être le propriétaire, être un administrateur du metastore ou disposer du privilège MANAGE sur celle-ci.
• Pour supprimer une salle propre, vous devez être le propriétaire ou avoir le privilège MANAGE sur la salle propre.

Remarque

Le créateur est automatiquement affecté comme propriétaire de la salle blanche dans son compte Databricks. L’administrateur(-trice) du metastore de l’organisation collaboratrice est automatiquement affecté comme propriétaire de la salle blanche dans son compte Databricks. Vous pouvez transférer la propriété. Consultez Gérer la propriété de l’objet Unity Catalog.

Mettre à jour une salle blanche

1. Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.

2. Sur la page Accès rapide, cliquez sur le bouton Salles blanches >.

   Vous pouvez également cliquer sur l’icône d’engrenage en haut du volet Catalogue et sélectionner Salles blanches.

3. Sélectionnez la salle blanche dans la liste.

4. Effectuez l’une des mises à jour suivantes :

   • Modifier un commentaire : cliquez sur l’icône de modification en regard du commentaire. Les modifications de commentaire s’appliquent uniquement à la salle blanche sécurisable dans votre metastore Unity Catalog. Elle ne sont pas propagées à d’autres collaborateurs.

   • Transférer le propriétaire : cliquez sur l’icône de modification en regard du nom du propriétaire.

   • Ajouter des tables, des volumes et des vues : consultez étape 3. Ajoutez des ressources de données et des notebooks à la salle blanche.

   • Supprimer des tables, des volumes et des vues: cliquez sur le menu menu kebab (également appelé menu à trois points) sur la ligne de ressource, puis sélectionnez Supprimer la ressource de données.

   • Ajouter des notebooks : consultez l’Étape 3. Ajouter des ressources de données et des notebooks à la salle blanche.

   • Mettre à jour des notebooks : cliquez sur le menu kebab sur la ligne du notebook, puis sélectionnez Update notebook. Dans la boîte de dialogue, recherchez et sélectionnez le notebook mis à jour.

     Effectuez les mises à jour directement dans le notebook avant de le sélectionner dans l’interface des salles blanches.

   • Supprimer des notebooks : cliquez sur le menu kebab sur la ligne du notebook, puis sélectionnez Delete notebook.

Accorder l’accès à une salle blanche.

Le propriétaire de la salle blanche dispose de tous les privilèges sur la salle blanche. Le propriétaire de la salle blanche et le propriétaire du metastore sont les seuls rôles qui peuvent accorder à d’autres principaux l’accès à la salle blanche. Le créateur est automatiquement affecté comme propriétaire de la salle blanche dans son compte Databricks. L’administrateur(-trice) du metastore de l’organisation collaboratrice est automatiquement affecté comme propriétaire de la salle blanche dans son compte Databricks. Vous pouvez transférer la propriété. Consultez Gérer la propriété de l’objet Unity Catalog.

Le propriétaire et les utilisateurs disposant du privilège MANAGE peuvent accorder les privilèges suivants sur une salle propre :

• BROWSE, qui vous permet de répertorier la salle blanche et d’afficher des détails tels que les commentaires, le propriétaire, les ressources et l’historique des exécutions.
• MODIFY CLEAN ROOM, qui vous permet d’effectuer toutes les opérations accordées par le privilège BROWSE, plus ajouter et supprimer des ressources de données, ajouter et supprimer des notebooks, et mettre à jour des commentaires.
• EXECUTE CLEAN ROOM TASK, qui vous permet d’effectuer toutes les opérations accordées par le privilègeBROWSE, plus exécuter des notebooks dans une salle blanche.

Pour accorder à un principal des privilèges sur une salle blanche :

1. Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.

2. En haut du volet Catalog, cliquez sur l’icône d’engrenage , puis sélectionnez Clean Rooms.

   Vous pouvez également, dans la page Quick access, cliquer sur le bouton Clean Rooms >.

3. Sélectionnez la salle blanche dans la liste.

4. Accédez à l’onglet Autorisations.

5. Sélectionnez l’utilisateur, le groupe ou le principal de service, cliquez sur Grant, puis sélectionnez les privilèges que vous souhaitez accorder.

Pour plus d’informations sur l’octroi de privilèges, consultez Gérer les privilèges dans Unity Catalog.

Surveiller les exécutions du bloc-notes de salle propre

Toutes les exécutions de notebook de tous les collaborateurs sont enregistrées sous l’onglet Runs de l’interface utilisateur des salles blanches. Vous pouvez filtrer les exécutions par état et collaborateur qui a exécuté la tâche.

1. Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.

2. Sur la page Accès rapide, cliquez sur le bouton Salles blanches >.

   Vous pouvez également cliquer sur l’icône d’engrenage en haut du volet Catalogue et sélectionner Salles blanches.

3. Sélectionnez la salle blanche dans la liste.

4. Accédez à l’onglet Runs.

Vous pouvez également afficher les exécutions pour un notebook spécifique en sélectionnant le notebook dans l’interface utilisateur des salles blanches et en accédant à l’onglet Runs de la page de détails du notebook.

Surveiller les journaux des salles blanches

La table système clean_room_events enregistre tous les événements liés aux salles blanches dans votre metastore Azure Databricks, et vous permet d’afficher toutes les actions que d’autres collaborateurs et vous-même avez effectuées sur vos salles blanches.

Pour savoir comment utiliser cette table système pour obtenir des informations sur les activités des salles blanches, consultez les informations de référence sur la table système des événements de salle blanche.

Supprimer une salle blanche.

Lorsque vous supprimez une salle blanche, les collaborateurs ne peuvent pas l’utiliser, mais elle apparaît dans leur liste de salles blanches jusqu’à ce qu’ils suppriment l’objet de salle blanche de leur côté. Lorsque vous supprimez une salle blanche, les tâches en cours d’exécution sont annulées immédiatement.

1. Dans votre espace de travail Azure Databricks, cliquez sur Catalogue.

2. Sur la page Accès rapide, cliquez sur le bouton Salles blanches >.

   Vous pouvez également cliquer sur l’icône d’engrenage en haut du volet Catalogue et sélectionner Salles blanches.

3. Sélectionnez la salle blanche dans la liste.

4. Cliquez sur le menu kebab dans le coin supérieur droit de la page.

5. Sélectionnez Supprimer.

6. Confirmez que vous souhaitez supprimer la salle blanche, puis cliquez sur Delete.

Résoudre les problèmes liés aux salles blanches

Vous pouvez rencontrer les messages d’erreur ou problèmes suivants lorsque vous travaillez avec des salles blanches.

D’autres collaborateurs ayant quitté la salle blanche, celle-ci n’est plus utilisable. Supprimez cette salle blanche sécurisable.

Dans une salle blanche sans confiance, n’importe quel collaborateur peut supprimer la salle blanche centrale. Ce message d’erreur signifie que l’autre collaborateur a supprimé la salle blanche centrale, et que votre référence à cette dernière n’est plus valide. Vous pouvez uniquement supprimer l’objet de salle blanche dans votre espace de travail Azure Databricks. Vous ne pouvez pas l’utiliser.

Le collaborateur X dispose déjà d’une salle blanche nommée Y

Aucun collaborateur ne peut modifier le nom de la salle blanche. Cela garantit que tous les collaborateurs peuvent référencer le nom de la salle blanche sans ambiguïté. Cette erreur signifie que l’autre collaborateur a déjà une salle blanche du même nom que celui que vous avez choisi. Choisissez un autre nom de salle blanche.

Veuillez accepter les conditions de service serverless avant d’utiliser les salles blanches

Le calcul serverless est requis pour les salles blanches centrales. Vous n’avez pas besoin d’activer le calcul serverless dans votre propre espace de travail pour utiliser des salles blanches. Toutefois, vous devez accepter les conditions de service de calcul serverless. Voir Activer le calcul serverless. Si vous avez besoin d’assistance, contactez votre représentant Databricks.

Un collaborateur invité ne peut pas voir la salle blanche

Seul un administrateur de metastore peut voir une salle blanche lorsqu’elle est initialement créée dans le metastore d’un collaborateur invité. Certains espaces de travail activés pour Unity Catalog n’ont pas d’administrateur de metastore affecté. Vous devez attribuer le rôle d’administrateur de metastore pour commencer à utiliser la salle blanche. Consultez Attribuer un administrateur de metastore.