Gerenciar compartilhamentos para OpenSharing

Esta página descreve como visualizar, atualizar e excluir compartilhamentos do OpenSharing existentes no Databricks. Um *compartilhamento* é um objeto protegido no Unity Catalog que agrupa tabelas, views, volumes, notebooks, modelos de AI e outros ativos de dados para compartilhamento com um ou mais destinatários.

Para criar um novo compartilhamento ou adicionar ativos de dados a um compartilhamento existente, consulte Criar compartilhamentos para OpenSharing. Para conceder acesso a um compartilhamento a um destinatário, consulte Gerenciar acesso a compartilhamentos de dados do OpenSharing (para provedores). Para gerenciar os destinatários de dados com os quais você compartilha, consulte Gerenciar destinatários de dados para OpenSharing.

Para saber mais sobre o modelo de compartilhamento, consulte Compartilhamentos, provedores e destinatários.

Requisitos

Verifique se você atende aos requisitos listados para cada tarefa que deseja concluir.

Tarefa	Requisitos
Conceder acesso ao destinatário a um compartilhamento	Seja um administrador do metastore. ou Ser um usuário com permissões delegadas ou propriedade sobre os objetos de compartilhamento e destinatário, o que significa que o usuário deve atender a ambos os requisitos a seguir: Tenha ambos os privilégios USE SHARE e SET SHARE PERMISSION OU seja o proprietário do compartilhamento. Ter privilégio USE RECIPIENT OU ser o proprietário do destinatário
Ver compartilhamentos	Seja um administrador de metastore (pode visualizar tudo). ou Ser um usuário com o privilégio USE SHARE (pode visualizar tudo). ou Seja o proprietário do objeto de compartilhamento.
Atualizar proprietário do compartilhamento	Seja um administrador do metastore.
Atualizar nome do compartilhamento	Tenha o privilégio CREATE SHARE. Seja o proprietário do compartilhamento.
Atualizar outras propriedades de compartilhamento	Seja o proprietário do compartilhamento.
Excluir compartilhamentos	Seja o proprietário do objeto de compartilhamento.

Visualizar compartilhamentos e detalhes do compartilhamento

Verifique se você atende aos requisitos antes de visualizar compartilhamentos e detalhes do compartilhamento.

Para visualizar uma lista de compartilhamentos ou detalhes sobre um compartilhamento, use o Catalog Explorer, a CLI do Databricks Unity Catalog ou comandos SQL em um Notebook do Databricks ou no editor de consultas do Databricks SQL.

Os detalhes do compartilhamento incluem o seguinte:

• O proprietário do compartilhamento, criador, carimbo de data/hora de criação, atualizador, carimbo de data/hora de atualização, comentários.
• Ativos de dados no compartilhamento.
• Destinatários com acesso ao compartilhamento.

Catalog Explorer

1. No seu Databricks workspace, clique em Catálogo .

2. No topo do painel Catálogo , clique no ícone de engrenagem e selecione OpenSharing .

   Como alternativa, na página de acesso rápido , clique no botão OpenSharing > .

3. Abra a guia Compartilhamentos para visualizar uma lista de compartilhamentos.

4. View detalhes do compartilhamento na tab **Detalhes**.

SQL

Para exibir uma lista de compartilhamentos, execute o seguinte comando em um Notebook ou no editor de consultas do Databricks SQL. Opcionalmente, substitua <pattern> por um LIKE predicado.

SQL

SHOW SHARES [LIKE <pattern>];

Para visualizar detalhes sobre um compartilhamento específico, execute o seguinte comando.

SQL

DESCRIBE SHARE <share-name>;

Para visualizar detalhes sobre todas as tabelas, views e volumes em um compartilhamento, execute o seguinte comando.

SQL

SHOW ALL IN SHARE <share-name>;

CLI

Para visualizar uma lista de compartilhamentos, execute o seguinte comando usando a CLI do Databricks.

Bash

databricks shares list

Para visualizar detalhes sobre um compartilhamento específico, execute o seguinte comando.

Bash

databricks shares get <share-name>

Visualize os destinatários que têm permissões em um compartilhamento.

Verifique se atende aos requisitos antes de visualizar os destinatários.

Para visualizar a lista de compartilhamentos aos quais um destinatário recebeu acesso, use o Catalog Explorer, a CLI do Databricks Unity Catalog ou o comando SQL SHOW GRANTS TO RECIPIENT em um Notebook do Databricks ou o editor de consultas do Databricks SQL.

Catalog Explorer

1. No seu Databricks workspace, clique em Catálogo .

2. No topo do painel Catálogo , clique no ícone de engrenagem e selecione OpenSharing .

   Como alternativa, na página de acesso rápido , clique no botão OpenSharing > .

3. Na tab **Compartilhado por mim**, localize e selecione o destinatário.

4. Vá para a **tab** Destinatários para visualizar a lista de destinatários que podem acessar o compartilhamento.

SQL

Execute o seguinte comando em um notebook ou no editor de consultas SQL do Databricks.

SQL

SHOW GRANTS ON SHARE <share-name>;

CLI

Execute o seguinte comando usando a CLI do Databricks.

Bash

databricks shares share-permissions <share-name>

Atualizar compartilhamentos

Certifique-se de atender aos requisitos antes de fazer atualizações em um compartilhamento.

Você pode atualizar um compartilhamento das seguintes maneiras:

• Renomear um compartilhamento.
• Remova tabelas, views, volumes e esquemas de um compartilhamento.
• Adicionar ou atualizar um comentário em um compartilhamento.
• Renomeie o alias de uma tabela (o nome da tabela exibido ao destinatário).
• Habilite ou desabilite o acesso aos dados de histórico de uma tabela, permitindo que os destinatários realizem query de viagem do tempo ou leituras por transmissão da tabela.
• Adicionar, atualizar ou remover definições de partição.
• Altere o proprietário do compartilhamento.

Para fazer essas atualizações nos compartilhamentos, use o Catalog Explorer, a CLI do Databricks Unity Catalog ou comandos SQL em um Notebook do Databricks ou o editor de consultas Databricks SQL. No entanto, não é possível usar o Catalog Explorer para renomear o compartilhamento.

Catalog Explorer

1. No seu Databricks workspace, clique em Catálogo .

2. No topo do painel Catálogo , clique no ícone de engrenagem e selecione OpenSharing .

   Como alternativa, na página de acesso rápido , clique no botão OpenSharing > .

3. Na tab Compartilhados por mim, localize o compartilhamento que você deseja atualizar e clique no nome dele.

Na página de detalhes do compartilhamento, faça o seguinte:

• Clique no ícone de edição ao lado do campo Proprietário ou Comentário para atualizar esses valores.
• Clique no botão de menu kebab em uma linha de ativo para removê-lo.
• Clique em Gerenciar ativos > Editar ativos para atualizar todas as outras propriedades:
  • Para remover um ativo, desmarque a caixa de seleção ao lado do ativo.
  • Para adicionar, atualizar ou remover definições de partição, clique em **Opções avançadas**.

SQL

Execute os comandos a seguir em um Notebook ou no editor do Databricks SQL.

Renomear um compartilhamento:

SQL

ALTER SHARE <share-name> RENAME TO <new-share-name>;

Remover tabelas de um compartilhamento:

SQL

ALTER SHARE share_name REMOVE TABLE <table-name>;

Remover volumes de um compartilhamento:

SQL

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Adicionar ou atualizar um comentário em um compartilhamento:

SQL

COMMENT ON SHARE <share-name> IS '<comment>';

Adicione ou modifique partições para uma tabela em um compartilhamento:

SQL

ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);

Alterar proprietário do compartilhamento:

SQL

ALTER SHARE <share-name> OWNER TO  '<principal>'

-- Principal must be an account-level user email address or group name.

Habilitar compartilhamento de histórico para uma tabela:

SQL

ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;

Para obter detalhes sobre os parâmetros de ALTER SHARE, consulte ALTER SHARE.

CLI

Execute os seguintes comandos usando a CLI do Databricks.

Renomear um compartilhamento:

Bash

databricks shares update <share-name> --name <new-share-name>

Remover tabelas de um compartilhamento:

Bash

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

Remover volumes de um compartilhamento (usando a CLI do Databricks 0.210 ou acima):

Bash

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<volume-full-name>",
          "data_object_type": "VOLUME",
          "string_shared_as": "<volume-alias>"
        }
      }
    ]
  }'

nota

Use a propriedade name se não houver um alias para o volume. Use string_shared_as se houver um alias.

Adicionar ou atualizar um comentário em um compartilhamento:

Bash

databricks shares update <share-name> --comment '<comment>'

Alterar proprietário do compartilhamento:

Bash

databricks  shares update <share-name> --owner '<principal>'

A entidade principal deve ser um endereço de email de usuário no nível da conta ou um nome de grupo.

Considerações ao atualizar o proprietário do compartilhamento

A identidade do proprietário do compartilhamento afeta como os recursos de autorização e segurança, como políticas ABAC, são avaliados. A transferência da propriedade do compartilhamento para um usuário com privilégios excessivos permite que os destinatários tenham acesso com privilégios excessivos, caso exista uma tabela ou esquema protegido por políticas ABAC.

Excluir compartilhamentos

Quando você exclui um compartilhamento, os destinatários não podem mais acessar os dados compartilhados. Verifique se você atende aos requisitos antes de excluir um objeto de compartilhamento.

Para excluir um compartilhamento, use o Catalog Explorer, a CLI do Databricks Unity Catalog, ou o comando SQL DELETE SHARE em um Notebook do Databricks ou no editor de consultas SQL do Databricks. Você deve ser o proprietário do compartilhamento.

Catalog Explorer

1. No seu Databricks workspace, clique em Catálogo .

2. No topo do painel Catálogo , clique no ícone de engrenagem e selecione OpenSharing .

   Como alternativa, na página de acesso rápido , clique no botão OpenSharing > .

3. Na **tab Compartilhado por mim**, localize o compartilhamento que você deseja excluir e clique no nome dele.

4. Clique no menu kebab e selecione Excluir .

5. Na caixa de diálogo de confirmação, clique em Excluir .

SQL

Execute o seguinte comando em um notebook ou no editor de consultas SQL do Databricks.

SQL

DROP SHARE [IF EXISTS] <share-name>;

CLI

Execute o seguinte comando usando a CLI do Databricks.

Bash

databricks shares delete <share-name>