Configure o OpenSharing para sua account (para provedores)
Esta página descreve como configurar o OpenSharing no Databricks para provedores de dados (organizações que desejam usar o OpenSharing para compartilhar dados com segurança).
Se você for um *destinatário de dados* (uma organização que recebe dados compartilhados usando o compartilhamento aberto), consulte Ler dados compartilhados usando o Databricks-to-Databricks OpenSharing (para destinatários).
OpenSharing requer um workspace preparado para o Unity Catalog. É possível criar um workspace habilitado para o Unity Catalog para o gerenciamento de compartilhamentos. Em algumas contas, os novos workspaces são habilitados para Unity Catalog automaticamente. Consulte Comece a usar o Unity Catalog.
Se a criação de um novo workspace habilitado para Unity Catalog não for uma opção, você pode usar o projeto OpenSharing de código aberto para implantar seu próprio servidor OpenSharing para compartilhar tabelas Delta de qualquer plataforma.
A configuração inicial do provedor inclui os seguintes passos:
- Habilitar o OpenSharing em um metastore do Unity Catalog.
- (Opcional) Instale a CLI do Unity Catalog.
- Conceda privilégios para criar e gerenciar compartilhamentos e destinatários.
- Configurar tempo de vida (TTL) da materialização de dados.
- Configure o acesso à rede de armazenamento.
Requisitos
Como provedor de dados que está configurando sua account Databricks para poder compartilhar dados, você deve ter:
-
Pelo menos um workspace Databricks que está habilitado para o Unity Catalog.
Não é necessário migrar todos os workspaces para o Unity Catalog para aproveitar o suporte da Databricks para provedores OpenSharing. Consulte Preciso do Unity Catalog para usar o OpenSharing?.
Os destinatários não precisam ter um workspace habilitado para Unity Catalog.
-
Função de administrador de conta para habilitar o OpenSharing para seu metastore do Unity Catalog.
-
Função de administrador do metastore ou os privilégios
CREATE SHAREeCREATE RECIPIENT. Consulte administradores do Metastore.
Se o seu workspace foi habilitado para o Unity Catalog automaticamente, você pode não ter um administrador de metastore. No entanto, os administradores de workspace nesses workspaces têm os privilégios CREATE SHARE e CREATE RECIPIENT no metastore por default.
Para obter mais informações, consulte Começar a usar o Unity Catalog e Privilégios de administrador do workspace quando os workspaces são ativados automaticamente para Unity Catalog.
- Uma configuração de armazenamento em cloud que permite acesso à rede do destinatário.
Ativar o OpenSharing em um metastore
Você não precisa habilitar o OpenSharing em seu metastore se pretende usar o OpenSharing apenas para compartilhar dados com usuários em outros metastores do Unity Catalog em sua account. O compartilhamento de metastore para metastore em uma única account do Databricks é habilitado por default.
Caso contrário, conclua os passos seguintes para cada metastore do Unity Catalog que gerencia dados que você planeja compartilhar usando o OpenSharing.
-
Como um administrador de conta Databricks, faça log in no console da conta.
-
Na barra lateral, clique em
Catálogo .
-
Clique no nome de um metastore para abrir seus detalhes.
-
Clique na caixa de seleção ao lado de **Permitir o OpenSharing com partes fora da sua organização**.
-
Defina a duração do token do destinatário.
Esta configuração define o período de tempo após o qual todos os tokens do destinatário expiram e devem ser regenerados. Tokens do destinatário são usados apenas no protocolo de compartilhamento Databricks-to-Open. Tokens são válidos por, no máximo, um ano após a criação.
A duração do token do destinatário para destinatários existentes não é atualizada automaticamente quando você altera a duração do token do destinatário default de um metastore. Para aplicar uma nova duração de token a um determinado destinatário, você deve rotacionar o token dele. Consulte Gerenciar tokens do destinatário.
Para definir a duração do token de destinatário default:
- Confirme se **Definir expiração** está ativado (este é o default).
- Insira um número de segundos, minutos, horas ou dias, e selecione a unidade de medida. Tokens são válidos por no máximo um ano após a criação.
- Clique em Ativar .
Para mais informações, consulte Considerações de segurança para tokens. 6. Ao compartilhar com um destinatário do Databricks que não está em sua account, insira um **Nome da organização**.
Especificar um nome de organização legível ajuda os destinatários a identificar seus provedores de compartilhamento e os objetos de provedor correspondentes na lista de provedores do destinatário.
- Clique em Ativar .
(Opcional) Instalar a CLI do Unity Catalog
Para gerenciar compartilhamentos e destinatários, você pode usar o Catalog Explorer, comandos SQL ou a CLI do Unity Catalog. A CLI é executada em seu ambiente local e não requer recursos de compute Databricks.
Para instalar a CLI, consulte Databricks CLI.
Conceder permissão para criar e gerenciar compartilhamentos e destinatários
Administradores de metastore têm a capacidade de criar e gerenciar compartilhamentos e destinatários, incluindo a concessão de compartilhamentos a destinatários. Muitas tarefas do provedor podem ser delegadas por um administrador do metastore usando os seguintes privilégios:
CREATE SHAREno metastore concede a capacidade de criar compartilhamentos.CREATE RECIPIENTno metastore concede a capacidade de criar destinatários.USE RECIPIENTconcede a capacidade de listar e view detalhes para todos os destinatários no metastore.USE SHAREno metastore concede a capacidade de listar e ver detalhes para todos os compartilhamentos no metastore.USE RECIPIENT,USE SHARE,eSET SHARE PERMISSIONcombinados concedem ao usuário a capacidade de conceder acesso de compartilhamento aos destinatários.- O administrador do metastore tem a capacidade de transferir a propriedade de qualquer compartilhamento.
- Os proprietários de compartilhamentos e de destinatários podem atualizar esses objetos e conceder compartilhamentos a destinatários. Os criadores de objetos recebem a propriedade por default, mas a propriedade pode ser transferida.
- Os proprietários de compartilhamento podem adicionar tabelas e volumes a compartilhamentos, contanto que tenham acesso
SELECTàs tabelas e acessoREAD VOLUMEaos volumes.
Para obter detalhes, consulte referência de privilégios do Unity Catalog e as permissões listadas para as tarefas do OpenSharing descritas.
Configurar TTL da materialização de dados
Como administrador de conta Databricks ou de metastore, é possível configurar o TTL da materialização de dados, que determina por quanto tempo um resultado materializado é armazenado em cache. As materializações ocorrem quando um destinatário consulta views dinâmicas compartilhadas, views materializadas, tabelas de transmissão e tabelas estrangeiras. Por default, o TTL é de oito horas. O próprio cache será despejado pela materialização após três horas adicionais, fornecendo tempo extra para que as consultas existentes sejam concluídas.
Para alterar este valor, faça o seguinte:
-
No seu workspace do Databricks, clique em
Catálogo para abrir o Catalog Explorer.
-
No topo do painel Catálogo , clique no ícone de
engrenagem e selecione OpenSharing .
Alternativamente, no canto superior direito, clique em **Share > OpenSharing**.
-
Na guia **Compartilhado comigo**, clique no nome da sua organização no canto superior direito.
-
Clique no canto superior direito
ícone de engrenagem.
-
Para **TTL de Materialização**, insira o valor de TTL desejado.
Permitir acesso de rede ao armazenamento
Se o armazenamento de nuvem subjacente estiver configurado com controles de acesso, adicione a rede do destinatário à lista de permissões para que possa ler tabelas compartilhadas.
Para obter detalhes, consulte VPC Service Controls.