Gerenciar Clean Rooms

Importante

Esse recurso está em uma versão prévia.

Este artigo descreve como gerenciar Clean Rooms, incluindo como:

• Atualizar um comentário e um proprietário de Clean Room
• Adicionar, remover e editar ativos de dados e notebooks
• Conceder acesso a uma Clean Room
• Monitorar a atividade da Clean Room
• Excluir uma Clean Room

Essas tarefas podem ser executadas por todos os colaboradores em uma Clean Room.

Antes de começar

O gerenciamento das Clean Rooms requer as seguintes permissões, dependendo da tarefa:

• Para exibir uma Clean Room na lista de Clean Rooms ou para exibir detalhes da Clean Room, você deve ser o proprietário da Clean Room, um administrador do metastore ou ter um dos seguintes privilégios na Clean Room: MODIFY CLEAN ROOM, EXECUTE CLEAN ROOM TASK ou BROWSE.
• Para atualizar o proprietário de uma Clean Room, você deve ser proprietário da Clean Room ou administrador do metastore.
• Para adicionar e remover ativos de dados e notebooks em uma Clean Room e atualizar um comentário, você deve ser proprietário da Clean Room ou ter o privilégio MODIFY CLEAN ROOM na Clean Room.
• Para conceder acesso a uma Clean Room, você deve ser o proprietário ou um administrador do metastore.
• Para excluir uma Clean Room, você deve ser o proprietário.

Observação

O criador é designado automaticamente como proprietário da Clean Room em sua conta do Databricks. O administrador do metastore da organização colaboradora é automaticamente designado como proprietário da Clean Room em sua conta do Databricks. Você pode transferir a propriedade. Consulta Gerenciar a propriedade do objeto do Catálogo do Unity.

Atualizar uma Clean Room

1. No workspace do Azure Databricks, clique em Catálogo.

2. Na página Acesso rápido, clique no botão Clean Rooms >.

   Como alternativa, clique no ícone de engrenagem na parte superior do painel Catálogo e selecione Clean Rooms.

3. Selecione a Clean Room na lista.

4. Você pode fazer as seguintes atualizações:

   • Editar comentário: clique no ícone de edição ao lado do comentário. As alterações de comentário se aplicam somente à Clean Room protegível no metastore do Catálogo do Unity. Ela não é propagada a outros colaboradores.

   • Transferir proprietário: clique no ícone de edição ao lado do nome do Proprietário.

   • Adicionar tabelas e volumes: consulte a Etapa 3. Adicionar ativos de dados e notebooks à Clean Room.

   • Remover tabelas e volumes: clique no menu kebab (também conhecido como menu de três pontos) na linha do ativo e selecione Remover ativo de dados.

   • Adicionar notebooks: consulte a Etapa 3. Adicionar ativos de dados e notebooks à Clean Room.

   • Atualizar notebooks: clique no menu kebab na linha do notebook e selecione Atualizar notebook. Na caixa de diálogo, procure e selecione o notebook atualizado.

     Faça atualizações diretamente no notebook antes de selecioná-lo na interface de Clean Rooms.

   • Remover notebooks: clique no menu kebab na linha do notebook e selecione Excluir notebook.

Conceder acesso a uma Clean Room

O proprietário da Clean Room tem todos os privilégios na Clean Room. O proprietário da Clean Room e o proprietário do metastore são as únicas funções que podem conceder a outras entidades de segurança acesso à Clean Room. O criador é designado automaticamente como proprietário da Clean Room em sua conta do Databricks. O administrador do metastore da organização colaboradora é automaticamente designado como proprietário da Clean Room em sua conta do Databricks. Você pode transferir a propriedade. Consulta Gerenciar a propriedade do objeto do Catálogo do Unity.

O proprietário pode conceder os seguintes privilégios em uma Clean Room:

• BROWSE, que permite listar a Clean Room e exibir detalhes como comentário, proprietário, ativos e histórico de execução.
• MODIFY CLEAN ROOM, que permite que você faça tudo o que BROWSE concede, além de adicionar e remover ativos de dados, adicionar e remover notebooks e atualizar comentários.
• EXECUTE CLEAN ROOM TASK, que permite que você faça tudo o que BROWSE concede, além de executar notebooks em uma Clean Room.

Para conceder privilégios de entidade de segurança em uma Clean Room:

1. No workspace do Azure Databricks, clique em Catálogo.

2. Na parte superior do painel Catálogo, clique no ícone de engrenagem e selecione Clean Rooms.

   Como alternativa, na página Acesso rápido, clique no botão Clean Rooms >.

3. Selecione a Clean Room na lista.

4. Acesse a guia Permissões.

5. Selecione o usuário, grupo ou entidade de serviço, clique em Conceder e selecione os privilégios que você deseja conceder.

Para obter mais informações sobre como conceder privilégios, veja Gerenciar privilégios no Catálogo do Unity.

Monitore as execuções do notebook de sala limpa

Todas as execuções de notebook de todos os colaboradores são registradas na guia Execuções na interface do usuário de Clean Rooms. Você pode filtrar execuções por status e pelo colaborador que executou a tarefa.

1. No workspace do Azure Databricks, clique em Catálogo.

2. Na página Acesso rápido, clique no botão Clean Rooms >.

   Como alternativa, clique no ícone de engrenagem na parte superior do painel Catálogo e selecione Clean Rooms.

3. Selecione a Clean Room na lista.

4. Acesse a guia Execuções.

Você também pode exibir execuções de um notebook específico selecionando o notebook na interface do usuário da Clean Room e acessando a guia Execuções na página de detalhes do notebook.

Monitorar logs da Clean Room

A tabela do sistema clean_room_events registra todos os eventos relacionados à Clean Room no metastore do Azure Databricks e permite exibir todas as ações que você e outros colaboradores realizadam nas Clean Rooms.

Para saber como usar essa tabela do sistema e obter informações sobre atividades da Clean Room, veja Referência de tabela do sistema de eventos da Clean Room.

Excluir uma Clean Room

Quando você exclui uma Clean Room, os colaboradores não podem usá-la, mas ela aparece na lista de Clean Rooms até que eles excluam o objeto da Clean Room. Quando você exclui uma Clean Room, as tarefas em execução são canceladas imediatamente.

1. No workspace do Azure Databricks, clique em Catálogo.

2. Na página Acesso rápido, clique no botão Clean Rooms >.

   Como alternativa, clique no ícone de engrenagem na parte superior do painel Catálogo e selecione Clean Rooms.

3. Selecione a Clean Room na lista.

4. Clique no menu de kebab no canto superior direito da página.

5. Selecione Excluir.

6. Confirme se deseja excluir a Clean Room e clique em Excluir.

Solucionar problemas de Clean Rooms

Você pode encontrar as seguintes mensagens de erro ou problemas ao trabalhar com Clean Rooms.

Outros colaboradores saíram da Clean Room, então a Clean Room não é mais utilizável. Exclua essa Clean Room protegível.

Em uma Clean Room sem confiança, qualquer colaborador pode excluir a Clean Room central. Essa mensagem de erro significa que o outro colaborador excluiu a Clean Room central e sua referência à Clean Room central não é mais válida. Você só pode excluir o objeto de Clean Room no workspace do Azure Databricks. Você não pode usá-lo.

O Colaborador X já tem uma Clean Room chamada Y

Nenhum colaborador pode alterar o nome da Clean Room. Isso garante que todos os colaboradores possam referenciar o nome da Clean Room sem ambiguidade. Esse erro significa que o outro colaborador já tem uma Clean Room com o mesmo nome que você escolheu. Escolha outro nome de Clean Room.

Aceite os termos de serviço sem servidor antes de usar as Clean Rooms

A computação sem servidor é necessária para Clean Rooms centrais. Você não precisa habilitar a computação sem servidor em seu próprio workspace para usar Clean Rooms. Mas você precisa aceitar os termos de serviço da computação sem servidor. Confira Habilitar a computação sem servidor. Se precisar de assistência, entre em contato com o representante do Databricks.

O colaborador convidado não pode ver a Clean Room

Somente um administrador do metastore pode exibir uma Clean Room quando é criada inicialmente no metastore de um colaborador convidado. Alguns workspaces habilitados para o Catálogo do Unity não têm um administrador metastore atribuído. Você deve atribuir a função de administrador do metastore para começar a trabalhar com a Clean Room. Confira Atribuir um administrador de metastore.