gerenciamento de ações da Delta Sharing

Esta página descreve como view, atualizar e excluir compartilhamentos Delta Sharing existentes no Databricks. Um compartilhamento é um objeto protegível no Unity Catalog que agrupa tabelas, visualizações, volumes, Notebooks, modelos AI e outros dados ativos para compartilhamento com um ou mais destinatários.

Para criar um novo compartilhamento ou adicionar dados ativos a um compartilhamento existente, consulte Criar compartilhamentos para Delta Sharing. Para conceder acesso a um destinatário a uma partilha, consulte Gerenciar acesso a partilhas de dados Delta Sharing (para fornecedores). Para gerenciar os destinatários dos dados que você compartilha, consulte Gerenciar destinatários de dados para Delta Sharing.

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
O beneficiário da bolsa terá acesso a uma parte das ações.	Seja um administrador do metastore. ou Para ser um usuário com permissões delegadas ou propriedade tanto no objeto de compartilhamento quanto no objeto destinatário, o usuário deve atender aos dois requisitos a seguir: Ter privilégios USE SHARE e SET SHARE PERMISSION OU ser o proprietário da ação Ter privilégio USE RECIPIENT OU ser o proprietário destinatário
ver compartilhamentos	Seja um administrador do metastore (com permissão para view tudo). ou Seja um usuário com o privilégio USE SHARE (pode view tudo). ou Seja o proprietário do objeto compartilhado.
Atualizar proprietário da ação	Seja um administrador do metastore.
Atualizar nome de compartilhamento	Tenha o privilégio CREATE SHARE . Seja o proprietário da ação.
Atualizar outras propriedades de compartilhamento	Seja o proprietário da ação.
Excluir compartilhamentos	Seja o proprietário do objeto compartilhado.

Veja as ações e os detalhes das ações.

Verifique se você atende aos requisitos antes de visualizar ações e detalhes das ações.

Para view uma lista de ações ou detalhes sobre uma ação, use o Catalog Explorer, a CLI Databricks Unity Catalog ou o comando SQL em um Notebook Databricks ou no editor de consultas Databricks SQL .

Os detalhes do compartilhamento incluem o seguinte:

• Proprietário do compartilhamento, criador, data e hora da criação, pessoa que atualizou, data e hora da última atualização, comentários.
• Dados ativos na ação.
• Destinatários com acesso à parte.

Catalog Explorer

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

2. Na parte superior do painel Catálogo , clique em Clique no ícone de engrenagem e selecione Delta Sharing .

   Alternativamente, na página de acesso rápido , clique no botão Delta Sharing > .

3. Abra a tab Ações para view a lista de ações.

4. Veja os detalhes do compartilhamento na tab Detalhes .

SQL

Para view uma lista de ações, execute o seguinte comando em um Notebook ou no editor de consultas Databricks SQL . Opcionalmente, substitua <pattern> por um predicadoLIKE.

SQL

SHOW SHARES [LIKE <pattern>];

Para view detalhes sobre uma ação específica, execute o seguinte comando.

SQL

DESCRIBE SHARE <share-name>;

Para view detalhes sobre todas as tabelas, visualizações e volumes em um compartilhamento, execute o seguinte comando.

SQL

SHOW ALL IN SHARE <share-name>;

CLI

Para view uma lista de compartilhamentos, execute o seguinte comando usando a CLIDatabricks.

Bash

databricks shares list

Para view detalhes sobre uma ação específica, execute o seguinte comando.

Bash

databricks shares get <share-name>

Veja os destinatários que têm permissão para compartilhar um item.

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

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

Catalog Explorer

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

2. Na parte superior do painel Catálogo , clique em Clique no ícone de engrenagem e selecione Delta Sharing .

   Alternativamente, na página de acesso rápido , clique no botão Delta Sharing > .

3. Na tab "Compartilhado por mim" , encontre e selecione o destinatário.

4. Acesse a tab Destinatários para view 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 CLIDatabricks.

Bash

databricks shares share-permissions <share-name>

Ações atualizadas

Verifique se você atende aos requisitos antes de fazer alterações em um compartilhamento.

Você pode atualizar um compartilhamento das seguintes maneiras:

• Renomear uma ação.
• Remover tabelas, visualizações, volumes e esquemas de um compartilhamento.
• Adicione ou atualize um comentário em uma publicação.
• Renomear o alias de uma tabela (o nome da tabela exibido ao destinatário).
• Habilitar ou desabilitar o acesso aos dados de histórico de uma tabela, permitindo que os destinatários executem consultas de viagem do tempo ou leituras de transmissão da tabela.
• Adicionar, atualizar ou remover definições de partição.
• Alterar o proprietário da ação.

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

Catalog Explorer

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

2. Na parte superior do painel Catálogo , clique em Clique no ícone de engrenagem e selecione Delta Sharing .

   Alternativamente, na página de acesso rápido , clique no botão Delta Sharing > .

3. Na tab "Compartilhado por mim" , encontre o compartilhamento que deseja atualizar e clique no nome dele.

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

• Clique no Clique no ícone de edição ao lado do campo Proprietário ou Comentário para atualizar esses valores.
• Clique no menu de kebabs. botão em uma linha de ativo para removê-lo.
• Clique em gerenciamento ativo > Editar ativo 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 o seguinte comando em um Notebook ou no editor Databricks SQL .

Renomear uma ação:

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 uma ação compartilhada:

SQL

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

Adicione ou atualize um comentário em uma publicação:

SQL

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

Adicionar ou modificar partições para uma tabela em um compartilhamento:

SQL

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

Alterar o titular da ação:

SQL

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

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

Habilite história compartilhamento para uma mesa:

SQL

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

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

CLI

execute o seguinte comando usando a CLIDatabricks.

Renomear uma ação:

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 CLI Databricks 0.210 ou superior):

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 nenhum alias para o volume. Use string_shared_as se houver um alias.

Adicione ou atualize um comentário em uma publicação:

Bash

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

Alterar o titular da ação:

Bash

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

O usuário principal deve ter um endereço email ou nome de grupo no nível account .

Considerações ao atualizar a titularidade das ações

A identidade do proprietário da ação influencia a forma como os recursos de autorização e segurança, como as políticas ABAC, são avaliados. Transferir a propriedade compartilhada para um usuário com privilégios excessivos permite que os destinatários tenham acesso com privilégios elevados caso você tenha uma tabela ou esquema protegido por políticas ABAC.

Excluir compartilhamentos

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

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

Catalog Explorer

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

2. Na parte superior do painel Catálogo , clique em Clique no ícone de engrenagem e selecione Delta Sharing .

   Alternativamente, na página de acesso rápido , clique no botão Delta Sharing > .

3. Na tab "Compartilhado por mim" , encontre o compartilhamento que deseja excluir e clique no nome dele.

4. Clique no menu de 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 CLIDatabricks.

Bash

databricks shares delete <share-name>