vinculação de catálogo de espaço de trabalho

No Unity Catalog, todos os catálogos são acessíveis por default a partir de qualquer workspace conectado ao mesmo metastore. A vinculação de catálogo de espaço de trabalho permite que você substitua esse default para restringir um catálogo a um ou mais espaços de trabalho específicos. O acesso a partir de um workspace não vinculado é negado, mesmo para usuários com concessões de privilégios explícitas no catálogo.

Por que usar a vinculação de catálogo workspace ?

Os requisitos organizacionais e compliance frequentemente especificam que determinados dados devem permanecer acessíveis apenas em ambientes designados. Você também pode precisar de:

• Isolar os dados de produção dos ambientes de desenvolvimento ou teste.
• Impedir que determinados domínios de dados sejam unidos.
• Garanta que os dados sensíveis só possam ser processados em um espaço de trabalho específico.

No Databricks, o workspace é o principal ambiente de processamento de dados, e o catálogo é o principal domínio de dados. A vinculação espaço de trabalho-catálogo conecta esses dois conceitos, permitindo que os proprietários do catálogo e os usuários com o privilégio MANAGE definam qual espaço de trabalho pode acessar quais catálogos.

Como funciona a vinculação entre workspacee catálogo

Ao associar um catálogo a um espaço de trabalho específico, somente o espaço de trabalho atribuído poderá acessar o catálogo. Qualquer workspace que não esteja na lista atribuída gera um erro quando os usuários tentam acessar o catálogo, anulando quaisquer privilégios individuais concedidos a esses usuários.

Neste diagrama, prod_catalog está vinculado a dois espaços de trabalho de produção. Mesmo que um usuário possua uma concessão SELECT em uma tabela em prod_catalog, ele não poderá acessar essa tabela a partir do workspace Dev.

Acesso somente leitura

Ao vincular um catálogo a um workspace, você pode, opcionalmente, restringir o acesso desse workspace a somente leitura. Todas as operações de escrita desse workspace para o catálogo estão bloqueadas.

comportamento padrão do catálogo workspace

A exceção ao comportamento default de abertura é o catálogo workspace default criado automaticamente para todos os novos espaços de trabalho. Por default, este catálogo de workspace está vinculado apenas ao seu próprio workspace . Se você desvincular este catálogo ou estender o acesso a outros espaços de trabalho, deverá conceder manualmente todas as permissões necessárias, pois o grupo de administradores workspace é local workspacee não pode ser usado em outros espaços de trabalho.

Aplicação em toda a plataforma

As associações entre espaço de trabalho e catálogo são aplicadas de forma consistente em toda a plataforma:

• As consultas ao esquema de informações retornam apenas os catálogos acessíveis no workspace atual.
• A linhagem de dados e o Catalog Explorer mostram apenas os catálogos que estão atribuídos ao workspace atual.

O que pode ser vinculado ao espaço de trabalho?

A vinculação de espaço de trabalho aplica-se além dos catálogos. Você também pode vincular:

• Locais externos : restrinja quais espaços de trabalho podem acessar caminhos específicos de armazenamento cloud . Consulte Atribuir um local externo a um espaço de trabalho específico.
• Credenciais de armazenamento : restrinja qual espaço de trabalho pode usar credenciais específicas cloud . Consulte Atribuir uma credencial de armazenamento a um espaço de trabalho específico.

Vincule um catálogo a um ou mais espaços de trabalho.

Para atribuir um catálogo a um espaço de trabalho específico, você pode usar o Catalog Explorer ou a CLI Databricks .

Permissões necessárias: administrador do metastore, proprietário do catálogo ou MANAGE no catálogo.

nota

Independentemente de um catálogo estar atribuído ao workspace atual, os administradores do metastore podem ver todos os catálogos em um metastore, e os proprietários de catálogos podem ver todos os catálogos que possuem em um metastore. Catálogos que não estão atribuídos ao workspace aparecem acinzentados, e nenhum objeto filho é visível ou consultável.

Catalog Explorer

1. Efetue login em um workspace vinculado ao metastore.

2. Clique Catálogo .

3. No painel Catálogo , à esquerda, clique no nome do catálogo.

   O painel principal do Explorador de Catálogos exibe por padrão a lista de Catálogos . Você também pode selecionar o catálogo lá.

4. Na guia Workspaces , desmarque a caixa de seleção Todos os workspaces têm acesso .

   Se o seu catálogo já estiver vinculado a um ou mais espaços de trabalho, esta caixa de seleção já estará desmarcada.

5. Clique em Atribuir a workspaces e digite ou localize os workspaces que deseja atribuir.

6. (Opcional) Limitar o acesso workspace a somente leitura.

   No menu Nível de acesso , selecione Alterar acesso para somente leitura .

   Você pode reverter essa seleção a qualquer momento editando o catálogo e selecionando Alterar acesso para leitura e gravação .

Para revogar o acesso, vá para a tab Workspaces , selecione o workspace e clique em Revogar .

CLI

São necessários dois grupos de comandos CLIDatabricks e duas etapas do sistema operacional para atribuir um catálogo a um workspace.

Nos exemplos a seguir, substitua <profile-name> pelo nome do seu perfil de configuração de autenticação do Databricks. Deve incluir o valor de um access token pessoal, além do nome da instância workspace e do ID do workspace workspace onde você gerou o access token pessoal. Consulte Autenticação access token pessoal (legado).

1. Use o comando update do grupo de comandos catalogs para definir o isolation mode do catálogo para ISOLATED:

   Bash

   databricks catalogs update <my-catalog> \
   --isolation-mode ISOLATED \
   --profile <profile-name>

   O padrão isolation-mode é OPEN para todos os workspaces anexados ao metastore.

2. Use o comando update-bindings do grupo de comandos workspace-bindings para atribuir o espaço de trabalho ao catálogo:

   Bash

   databricks workspace-bindings update-bindings catalog <my-catalog> \
   --json '{
     "add": [{"workspace_id": <workspace-id>, "binding_type": <binding-type>}...],
     "remove": [{"workspace_id": <workspace-id>, "binding_type": "<binding-type>}...]
   }' --profile <profile-name>

   Use as propriedades "add" e "remove" para adicionar ou remover associações de workspace . O <binding-type> pode ser "BINDING_TYPE_READ_WRITE" (default) ou "BINDING_TYPE_READ_ONLY".

Para listar todas as atribuições de workspace para um catálogo, use o comando get-bindings do grupo de comandos workspace-bindings :

Bash

databricks workspace-bindings get-bindings catalog <my-catalog> \
--profile <profile-name>

Desvincular um catálogo de um workspace

As instruções para revogar o acesso workspace a um catálogo usando o Catalog Explorer ou o grupo de comandos CLI workspace-bindings estão incluídas em Vincular um catálogo a um ou mais espaços de trabalho.

importante

Se o seu workspace foi habilitado automaticamente para Unity Catalog e você possui um catálogo workspace default , os administradores workspace são os proprietários desse catálogo e têm todas as permissões apenas para ele no workspace . Se você desvincular esse catálogo ou vinculá-lo a outros catálogos, deverá conceder manualmente todas as permissões necessárias aos membros do grupo de administradores do workspace como usuários individuais ou usando grupos em nível account , pois o grupo de administradores workspace é um grupo local workspace . Para obter mais informações sobre grupos account versus grupos locais workspace , consulte Fontes de grupo.