Pular para o conteúdo principal

Criar e gerenciar compartilhamentos para o Delta Sharing

Esta página explica como criar e gerenciar compartilhamentos para o Delta Sharing.

Um compartilhamento é um objeto protegível no Unity Catalog que você usa para compartilhar os seguintes dados ativos com um ou mais destinatários:

  • Tabelas e partições de tabela
  • Tabelas de streaming
  • gerenciar Iceberg tables
  • Esquemas e tabelas estrangeiros
  • visualização, incluindo a visualização dinâmica que restringe o acesso em nível de linha e coluna
  • Visualizações materializadas
  • Volumes
  • cadernos
  • AI modelos

Se o senhor compartilhar um esquema inteiro (banco de dados), o destinatário poderá acessar todas as tabelas, tabelas de transmissão, visualizações, visualizações materializadas, modelos e volumes no esquema no momento em que o senhor o compartilhar, juntamente com quaisquer dados e AI ativo adicionados ao esquema no futuro.

Um compartilhamento pode conter dados e AI ativo de apenas um metastore Unity Catalog. O senhor pode adicionar ou remover dados e AI ativo de um compartilhamento a qualquer momento.

Antes de criar um compartilhamento, certifique-se de que o senhor configurou Delta Sharing para o seu account (para provedores).

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

Requisitos​

Certifique-se de atender aos requisitos listados para cada tarefa que deseja concluir.

Tarefa

Requisitos

Criar um compartilhamento

  • Seja um administrador de metastore ou tenha o privilégio CREATE SHARE para o metastore do Unity Catalog onde os dados que o senhor deseja compartilhar estão registrados.
  • Crie o compartilhamento usando um Databricks workspace que tenha o metastore Unity Catalog anexado.

Adicione o seguinte a um compartilhamento:

  • tabelas
  • Tabelas de streaming
  • gerenciar Iceberg tables
  • Mesas estrangeiras
  • Exibições
  • Visualizações materializadas
  • Seja o acionista.
  • Tenha o privilégio USE CATALOG e USE SCHEMA no catálogo e no esquema que contêm o ativo de dados.
  • Tenha o privilégio SELECT no ativo de dados. Você deve manter esse privilégio para que o ativo continue a ser compartilhado. Se você perdê-lo, o destinatário não poderá acessar o ativo por meio do compartilhamento. A Databricks recomenda que você use um grupo como proprietário do compartilhamento.

Compartilhe um esquema inteiro ou um esquema estrangeiro

  • Seja o proprietário do compartilhamento e o proprietário do esquema ou tenha USE SCHEMA.
  • Tenha SELECT no esquema para compartilhar tabelas.
  • Tenha READ VOLUME no esquema para compartilhar volumes.

Adicionar volumes a um compartilhamento

  • Seja o acionista.
  • Tenha os privilégios USE CATALOG e USE SCHEMA no catálogo e no esquema que contêm o volume ou a propriedade do catálogo ou esquema.
  • Tenha o privilégio READ VOLUME no volume. Você deve manter esse privilégio para que o volume continue sendo compartilhado. Se você perdê-lo, o destinatário não poderá acessar o volume por meio do compartilhamento. A Databricks recomenda que o senhor use um grupo como proprietário do compartilhamento.

Adicionar modelos a um compartilhamento

  • Seja o acionista.
  • Tenha os privilégios USE CATALOG e USE SCHEMA no catálogo e no esquema que contêm o modelo ou a propriedade do catálogo ou esquema.
  • Tenha o privilégio EXECUTE no modelo. Você deve manter esse privilégio para que o modelo continue sendo compartilhado. Se você perdê-lo, o destinatário não poderá acessar o modelo por meio do compartilhamento. A Databricks recomenda que o senhor use um grupo como proprietário do compartilhamento.

Adicionar arquivos do Notebook a um compartilhamento

  • Seja o proprietário das ações, com permissão CAN READ no Notebook.

Conceder ao destinatário acesso a um compartilhamento

  • Seja um administrador do metastore.

ou

  • Seja um usuário com permissões delegadas ou propriedade nos objetos de compartilhamento e destinatário, o que significa que o usuário deve atender aos dois requisitos a seguir:

  • Tenha 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 do metastore (pode 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 do compartilhamento

  • Seja um administrador do metastore.

Atualizar nome do compartilhamento

  • Tenha o privilégio CREATE SHARE .
  • Seja o acionista.

Atualizar outras propriedades de compartilhamento

  • Seja o acionista.

Excluir compartilhamentos

  • Seja o proprietário do objeto compartilhado.

requisitos de computação​

  • Se o senhor usar um notebook Databricks para criar o compartilhamento, seu recurso compute deverá usar Databricks Runtime 11.3 LTS ou acima e ter um modo de acesso padrão ou dedicado (anteriormente compartilhado e usuário único).
  • Se o senhor usar as instruções SQL para adicionar um esquema a um compartilhamento (ou atualizar ou remover um esquema), deverá usar um SQL warehouse ou compute executando Databricks Runtime 13.3 LTS ou acima. Fazer o mesmo usando o Catalog Explorer não tem requisitos do site compute.

Criar um objeto de compartilhamento​

Certifique-se de atender aos requisitos antes de criar um objeto de compartilhamento.

Para criar um compartilhamento, use o Catalog Explorer, o Databricks Unity Catalog CLI ou o comando SQL CREATE SHARE em um Databricks Notebook ou no editor de consulta Databricks SQL .

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, clique no botão Share data (Compartilhar dados ).

  4. Na página Criar compartilhamento , insira o Nome do compartilhamento e um comentário opcional.

  5. Clique em Salvar e continuar .

    O senhor pode continuar a adicionar dados ativos ou pode parar e voltar mais tarde.

  6. Na tab Adicionar dados ativos , selecione os dados ativos que você deseja compartilhar.

    Para obter instruções detalhadas, requisitos adicionais e limitações relacionadas, consulte:

  7. Clique em Salvar e continuar .

  8. Em Add Notebook tab, selecione o Notebook que deseja compartilhar.

    Para obter instruções detalhadas, consulte Adicionar arquivos do Notebook a um compartilhamento.

  9. Clique em Salvar e continuar .

  10. Em Add recipients (Adicionar destinatários ) tab, selecione os destinatários com os quais deseja compartilhar.

    Para obter instruções detalhadas, consulte gerenciar o acesso aos compartilhamentos de dados do Delta Sharing (para provedores).

  11. Clique em Compartilhar dados para compartilhar os dados com os destinatários.

Adicionar tabelas a um compartilhamento​

Certifique-se de atender aos requisitos antes de adicionar tabelas a um compartilhamento.

Se o senhor for um administrador do workspace e tiver herdado as permissões USE SCHEMA e USE CATALOG no esquema e no catálogo que contêm a tabela do grupo de administradores workspace, não poderá adicionar a tabela a um compartilhamento. Você deve primeiro conceder a si mesmo as permissões USE SCHEMA e USE CATALOG no esquema e no catálogo.

nota

Comentários de tabela, comentários de coluna e restrições primárias de key são incluídos em compartilhamentos que são compartilhados com um destinatário usando Databricks-to-Databricks compartilhamento em ou após 25 de julho de 2024. Se o senhor quiser começar a compartilhar comentários e restrições por meio de um compartilhamento que foi compartilhado com um destinatário antes da data de liberação, deverá revogar e conceder novamente o acesso ao destinatário para acionar o compartilhamento de comentários e restrições.

Para adicionar tabelas a um compartilhamento, use o Catalog Explorer, o Databricks Unity Catalog CLI ou o comando SQL em um Databricks Notebook ou o editor de consulta Databricks SQL .

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. No Shared by me tab, localize o compartilhamento ao qual deseja adicionar uma tabela e clique em seu nome.

  4. Clique em gerenciar ativo > Add data ativo .

  5. Na página Adicionar tabelas , selecione um esquema inteiro (banco de dados) ou tabelas individuais.

    • Para selecionar uma tabela ou view, primeiro selecione o catálogo, depois o esquema que contém a tabela e, em seguida, a própria tabela ou view.

      O senhor pode pesquisar tabelas por nome, nome da coluna ou comentário usando a pesquisa workspace. Consulte Search for workspace objects.

    • Para selecionar um esquema, primeiro selecione o catálogo e depois o esquema.

      Para obter informações detalhadas sobre esquemas de compartilhamento, consulte Adicionar esquemas a um compartilhamento.

  6. história : Compartilhe a história da tabela para permitir que os destinatários realizem consultas de viagem do tempo ou leiam a tabela com Spark transmissão estructurada. Para os compartilhamentos Databricks-to-Databricks, o Delta log da tabela também é compartilhado para melhorar o desempenho. Veja a tabela Improve ler desempenho com história compartilhamento. história compartilhamento requer Databricks Runtime 12.2 LTS ou superior.

nota

Se você também quiser que seus clientes possam consultar o feed de dados de alteração (CDF) de uma tabela usando a função table_changes (), você deve habilitar o CDF na tabela antes de compartilhá-la WITH HISTORY.

  1. (Opcional) Clique Balão de fala mais ícone. nas colunas Alias ou Partição para adicionar um alias ou partição. Alias e partições não estão disponíveis se você selecionar um esquema inteiro. A tabela história é incluída por default se você selecionar um esquema inteiro.

  2. Clique em Salvar .

Para obter informações sobre como remover tabelas de um compartilhamento, consulte Atualizar compartilhamentos.

Especifique partições de tabela para compartilhar​

Para compartilhar apenas parte de uma tabela ao adicioná-la a um compartilhamento, forneça uma especificação de partição. Especifique partições ao adicionar uma tabela a um compartilhamento ou atualizar um compartilhamento usando o Catalog Explorer, o Databricks Unity Catalog CLI ou o comando SQL em um Databricks Notebook ou o editor de consulta Databricks SQL . Consulte Adicionar tabelas a um compartilhamento e Atualizar compartilhamentos.

Exemplo​

O exemplo SQL a seguir compartilha parte dos dados da tabela inventory, particionada pelas colunas year, month e date:

  • Dados do ano de 2021.
  • Dados de dezembro de 2020.
  • Dados de 25 de dezembro de 2019.
SQL
ALTER SHARE share_name
ADD TABLE inventory
PARTITION (year = "2021"),
          (year = "2020", month = "Dec"),
          (year = "2019", month = "Dec", date = "2019-12-25");

Use as propriedades do destinatário para fazer a filtragem de partições​

O senhor pode compartilhar uma partição de tabela que corresponda às propriedades do destinatário de dados, também conhecido como compartilhamento de partição parametrizada.

As propriedades padrão incluem:

  • databricks.accountId: O Databricks account ao qual um destinatário de dados pertence (somenteDatabricks-to-Databricks compartilhamento).
  • databricks.metastoreId: O Unity Catalog metastore ao qual um destinatário de dados pertence (somenteDatabricks-to-Databricks compartilhamento).
  • databricks.name: O nome do destinatário dos dados.

Você pode criar qualquer propriedade personalizada ao criar ou atualizar um destinatário.

A filtragem por propriedade do destinatário permite que o senhor compartilhe as mesmas tabelas, usando o mesmo compartilhamento, em várias contas, espaços de trabalho e usuários do site Databricks, mantendo os limites de dados entre eles.

Por exemplo, se suas tabelas incluírem uma coluna Databricks account ID, o senhor poderá criar um único compartilhamento com partições de tabela definidas por Databricks account ID. Quando o senhor compartilha, o Delta Sharing fornece dinamicamente a cada destinatário apenas os dados associados ao seu Databricks account.

Diagrama de compartilhamento de partição dinâmica baseada em parâmetros no Delta Sharing

Sem a capacidade de particionar dinamicamente por propriedade, você precisaria criar um compartilhamento separado para cada destinatário.

Para especificar uma partição que filtre por propriedades do destinatário ao criar ou atualizar um compartilhamento, o senhor pode usar o Catalog Explorer ou a função CURRENT_RECIPIENT SQL em um Notebook Databricks ou o editor de consultas Databricks SQL:

nota

As propriedades do destinatário estão disponíveis no Databricks Runtime 12.2e acima.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, localize o compartilhamento que deseja atualizar e clique em seu nome.

  4. Clique em gerenciar ativo > Add data ativo .

  5. Na página Adicionar tabelas , selecione o catálogo e o banco de dados que contêm a tabela e, em seguida, selecione a tabela.

    Se não tiver certeza de qual catálogo e banco de dados contém a tabela, o senhor pode procurá-la por nome, nome da coluna ou comentário usando workspace search. Consulte Search for workspace objects.

  6. (Opcional) Clique na Balão de fala mais ícone. coluna Partição para adicionar uma partição.

    Na caixa de diálogo Adicionar partição à tabela , adicione a especificação de partição baseada em propriedades usando a seguinte sintaxe:

    (<column-name> = CURRENT_RECIPIENT().<property-key>)

    Por exemplo,

    (country = CURRENT_RECIPIENT().'country')

  7. Clique em Salvar .

Adicionar tabelas com vetores de exclusão ou mapeamento de colunas a um compartilhamento​

info

Visualização

Esse recurso está em Public Preview.

Os vetores de exclusão são um recurso de otimização de armazenamento que o senhor pode ativar nas tabelas Delta. Consulte O que são vetores de exclusão? .

O Databricks também oferece suporte ao mapeamento de colunas para tabelas Delta. Consulte Renomear e soltar colunas com o mapeamento de colunas do Delta Lake.

Para compartilhar uma tabela com vetores de exclusão ou mapeamento de colunas, o senhor deve compartilhá-la com a história. Consulte Adicionar tabelas a um compartilhamento.

Quando o senhor compartilha uma tabela com vetores de exclusão ou mapeamento de coluna, os destinatários podem consultar a tabela usando um SQL warehouse, um compute que esteja executando o Databricks Runtime 14.1 ou acima, ou um compute que esteja executando o código aberto delta-sharing-spark 3.1 ou acima. Consulte Ler tabelas com vetores de exclusão ou mapeamento de colunas habilitado e Ler tabelas com vetores de exclusão ou mapeamento de colunas habilitado.

Adicionar esquemas a um compartilhamento​

Certifique-se de atender aos requisitos antes de adicionar esquemas a um compartilhamento.

Adicionar um esquema inteiro a um compartilhamento fornece aos destinatários acesso a todos os dados ativos no esquema no momento em que você cria o compartilhamento, bem como a quaisquer ativos que sejam adicionados ao esquema ao longo do tempo. Isso inclui todas as tabelas, visualizações e volumes no esquema. As tabelas compartilhadas dessa forma sempre incluem a história completa.

Compartilhe esquemas com um destinatário​

Para adicionar um esquema a um compartilhamento, siga as instruções em Adicionar tabelas a um compartilhamento, prestando atenção ao conteúdo que especifica como adicionar um esquema.

Adicionar, atualizar ou remover um esquema usando SQL requer um SQL warehouse ou compute executando Databricks Runtime 13.3 LTS ou acima. Fazer o mesmo usando o Catalog Explorer não tem requisitos do site compute.

Limitações​

  • Aliases de tabela, partições e aliases de volume não estarão disponíveis se você compartilhar um esquema inteiro. Se você tiver criado aliases ou partições para qualquer ativo no esquema, eles serão removidos quando você adicionar o esquema inteiro ao compartilhamento.

  • Se quiser especificar opções avançadas para uma tabela ou volume no esquema, você deve compartilhar a tabela ou volume usando SQL e dar à tabela ou volume um alias com um nome de esquema diferente.

Adicione tabelas e esquemas protegidos pelas políticas ABAC a um compartilhamento​

info

Beta

Este recurso está em fase beta.

O controle de acesso baseado em atributos (ABAC) é um modelo de governança de dados que fornece controle de acesso flexível, escalável e centralizado no Databricks.

Você pode compartilhar uma tabela ou esquema protegido por políticas ABAC, como tabelas padrão. Para saber como aplicar políticas ABAC aos seus dados ativos, consulte Criar e gerenciar políticas de controle de acesso baseado em atributos (ABAC).

No entanto, você deve ser um usuário privilegiado . Um usuário privilegiado é o proprietário do compartilhamento e um usuário que é excluído das políticas ABAC aplicadas ao ativo de dados. A política não rege o acesso do destinatário. Os destinatários têm acesso total ao ativo compartilhado. Aplicam-se limitações ABAC .

Adicionar tabelas de transmissão a um compartilhamento​

As tabelas de transmissão são tabelas Delta regulares com suporte extra para transmissão ou processamento de dados incrementais. As tabelas de transmissão são projetadas para fontes de dados apenas anexadas e processam entradas apenas uma vez. Consulte Usar tabelas de transmissão em Databricks SQL.

Certifique-se de atender aos requisitos antes de adicionar tabelas de transmissão a um compartilhamento.

Requisitos adicionais​

  • O senhor deve ativar o compute sem servidor para fluxo de trabalho, Notebook e LakeFlow Declarative pipeline no account onde o compartilhamento da tabela de transmissão está configurado. Consulte Conectar-se a serverless compute .

  • Se o seu workspace tiver workspace-catalog bindings ativados, certifique-se de que o workspace tenha acesso de leitura e gravação ao catálogo em que a tabela de transmissão está. Para obter mais informações, consulte Limitar o acesso do catálogo a um espaço de trabalho específico.

  • As tabelas de transmissão compartilháveis devem ser definidas nas tabelas Delta ou em outras tabelas ou visualizações de transmissão compartilháveis.

  • O senhor deve usar um SQL warehouse ou um compute em Databricks Runtime 13.3 LTS ou acima quando adicionar uma tabela de transmissão a um compartilhamento.

Limitações​

  • A tabela de transmissão não pode ter filtros de linha e máscaras de coluna.

    • A tabela base da tabela de transmissão pode ter filtros de linha e máscaras de coluna.

  • A tabela transmissão não pode ter filtros de partição. Em vez disso, crie uma restrição de exclusão ( view ) no topo da tabela transmissão.

Compartilhe tabelas de transmissão com um destinatário​

Para adicionar tabelas de transmissão a um compartilhamento:

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. No Shared by me (Compartilhado por mim ) tab, localize o compartilhamento ao qual deseja adicionar uma tabela de transmissão e clique em seu nome.

  4. Clique em gerenciar ativo > Edit ativo .

  5. Na página Editar ativo , pesquise ou procure a tabela de transmissão que o senhor deseja compartilhar e selecione-a.

  6. (Opcional) Na coluna Alias , clique em Balão de fala mais ícone. para especificar um alias ou nome alternativo da tabela de transmissão, para tornar o nome da tabela de transmissão mais legível. O alias é o nome que o destinatário vê e deve usar nas consultas. Os destinatários não poderão usar o nome real da tabela de transmissão se um alias for especificado.

  7. Clique em Salvar .

Para obter informações sobre como remover tabelas de transmissão de um compartilhamento, consulte Atualizar compartilhamentos.

Adicionar tabelas do gerenciar Iceberg a um compartilhamento​

info

Visualização

Esse recurso está em Public Preview.

Apache Iceberg é um formato de tabela de código aberto para cargas de trabalho analíticas. No Databricks, você pode criar tabelasIceberg no Unity Catalog, conhecidas como gerenciar tabelas Iceberg.

Certifique-se de atender aos requisitos antes de adicionar tabelas do Gerenciar Iceberg a um compartilhamento.

A tabela Iceberg e as limitações da tabela Iceberg se aplicam. Veja as limitações da tabela Iceberg.

Para adicionar tabelas do gerenciar Iceberg a um compartilhamento:

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. No Shared by me tab, localize o compartilhamento ao qual deseja adicionar uma tabela gerenciar Iceberg e clique em seu nome.

  4. Clique em gerenciar ativo > Edit ativo .

  5. Na página Edit ativo , pesquise ou procure a tabela gerenciar Iceberg que o senhor deseja compartilhar e selecione-a.

  6. (Opcional) Na coluna Alias , clique em Balão de fala mais ícone. para especificar um alias ou nome alternativo da tabela gerenciar Iceberg, para tornar o nome mais legível. O alias é o nome que o destinatário vê e deve usar nas consultas. Os destinatários não podem usar o nome real da tabela gerenciar Iceberg se um alias for especificado.

  7. Clique em Salvar .

Adicionar esquemas ou tabelas estrangeiras a um compartilhamento​

info

Beta

Este recurso está em fase beta.

Lakehouse Federation permite que você use Databricks para executar consultas em fontes de dados externas. Você pode criar esquemas e tabelas estrangeiros, que contêm dados e metadados gerenciados por sistemas externos, com Unity Catalog adicionando governança de dados para consultar essas tabelas. Para saber mais sobre como se conectar a fontes externas, consulte O que é a Lakehouse Federation?.

O Delta Sharing permite que você compartilhe dados estrangeiros com segurança de seu local original, sem copiar dados para o Databricks, configurações de rede complexas ou transferências de credenciais.

Certifique-se de atender aos requisitos antes de adicionar esquemas ou tabelas externas a um compartilhamento.

Requisitos adicionais​

  • O senhor deve ativar o compute sem servidor para fluxo de trabalho, Notebook e LakeFlow Declarative pipeline no account onde o compartilhamento de esquema ou tabela estrangeira está configurado. Consulte Conectar-se a serverless compute .

  • Se você optar por usar o armazenamento default , deverá habilitar a visualização do Delta Sharing para Armazenamento padrão – Acesso Expandido no nível account . Veja as prévias do gerenciar Databricks.

Local de armazenamento dos dados materializados​

Ao compartilhar esquemas e tabelas estrangeiros, os dados são consultados e temporariamente materializados no lado do provedor. Por default, os dados materializados são armazenados em um esquema oculto usando o armazenamento padrão Databricks default Visualização Privada). Certifique-se de atender aos requisitos e observar as limitações de armazenamento default .

O armazenamento padrão tem disponibilidade regional limitada. Ele só está disponível nas seguintes regiões: us-central1, us-east1, europe-west3, asia-south1. '

Para cancelar o uso do armazenamento default Databricks e usar seu próprio armazenamento para materialização temporária, abra um caso de suporte.

Padrões de uso recomendados​

Os resultados da consulta são gerados sob demanda para cada consulta, portanto, o compartilhamento de tabelas estrangeiras e esquemas pode não ser tão econômico em comparação com o compartilhamento de tabelas ou visualizações materializadas. A Databricks recomenda o seguinte para melhorar o desempenho:

  • Mantenha o tamanho dos resultados de consultas típicos em menos de 10 GB.
  • Use consultas exploratórias ad-hoc em vez de despejos de dados frequentes.
  • Ao usar o compartilhamento de cloud-tokens, considere a visão materializada de compartilhamento criada sobre tabelas estrangeiras para obter eficiência de custo e melhor desempenho.

Compartilhe o esquema ou a tabela externa com um destinatário​

Para adicionar esquemas ou tabelas externas a um compartilhamento, use o Catalog Explorer, o Databricks Unity Catalog CLI ou o comando SQL em um Databricks Notebook ou o editor de consulta Databricks SQL .

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, localize o compartilhamento ao qual deseja adicionar uma tabela ou esquema externo e clique em seu nome.

  4. Clique em gerenciar ativo > Edit ativo .

  5. Na página Editar ativo , pesquise ou procure a tabela ou o esquema externo que deseja compartilhar e selecione-o.

  6. (Opcional) Na coluna Alias , clique Balão de fala mais ícone. para especificar um alias, um esquema externo alternativo ou nome da tabela, para tornar o esquema externo ou o nome da tabela mais legível. O alias é o nome que o destinatário vê e deve usar nas consultas. Os destinatários não podem usar o esquema externo real ou o nome da tabela se um alias for especificado.

  7. Clique em Salvar .

Adicionar visualização a um compartilhamento​

são objetos somente leitura criados a partir de uma ou mais tabelas ou outra visualização. Um view pode ser criado a partir de tabelas e outras visualizações contidas em vários esquemas e catálogos em um metastore Unity Catalog. Consulte Criar e gerenciar a visualização.

Certifique-se de atender aos requisitos antes de adicionar uma visualização a um compartilhamento.

Requisitos adicionais​

  • O senhor deve habilitar o compute serverless para fluxo de trabalho, Notebook e LakeFlow Declarative pipeline no account onde o view compartilhamento está configurado. Consulte Conectar-se a serverless compute .

  • A exibição compartilhável deve ser definida nas tabelas Delta, em outra exibição compartilhável ou na exibição materializada local e nas tabelas de transmissão. A visualização compartilhável não pode ser definida em tabelas externas.

  • O senhor não pode compartilhar visualizações que façam referência a tabelas compartilhadas ou visualizações compartilhadas.

  • O senhor deve usar um SQL warehouse ou um compute em Databricks Runtime 13.3 LTS ou acima quando adicionar um view a um compartilhamento.

  • Se o seu workspace tiver workspace-catalog bindings ativados, certifique-se de que o workspace tenha acesso de leitura e gravação ao catálogo. Para obter mais informações, consulte Limitar o acesso do catálogo a um espaço de trabalho específico.

Compartilhar visualização com um destinatário​

Esta seção descreve como adicionar uma visualização a um compartilhamento usando o Catalog Explorer, Databricks CLI, ou SQL comando em um Databricks Notebook ou o editor de consultas Databricks SQL. Se o senhor preferir usar a API REST do Unity Catalog, consulte PATCH /api/2.1/unity-catalog/shares/ na referência da API REST.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. No Shared by me tab, localize o compartilhamento ao qual deseja adicionar um view e clique em seu nome.

  4. Clique em gerenciar ativo > Add data ativo .

  5. Na página Add tables (Adicionar tabelas ), pesquise ou procure o site view que deseja compartilhar e selecione-o.

  6. (Opcional) Clique em Balão de fala mais ícone. na coluna Alias para especificar um nome alternativo view, ou Alias , para tornar o nome view mais legível. O alias é o nome que o destinatário vê e deve usar nas consultas. Os destinatários não poderão usar o nome real de view se um alias for especificado.

  7. Clique em Salvar .

Para obter informações sobre como remover a visualização de um compartilhamento, consulte Atualizar compartilhamentos.

Adicionar visualização dinâmica a um compartilhamento para filtrar linhas e colunas​

O senhor pode usar a exibição dinâmica para configurar o controle de acesso refinado aos dados da tabela, inclusive:

  • Segurança no nível de colunas ou linhas.
  • mascaramento de dados.

Ao criar um site view dinâmico que usa a função CURRENT_RECIPIENT(), o senhor pode limitar o acesso do destinatário de acordo com as propriedades especificadas na definição do destinatário.

Esta seção fornece exemplos de restrição do acesso do destinatário aos dados da tabela no nível da linha e da coluna usando um view dinâmico.

Requisitos​

  • Certifique-se de atender aos requisitos para adicionar uma view a um compartilhamento.
  • Databricks Runtime versão : A função CURRENT_RECIPIENT é compatível com Databricks Runtime 14.2 e acima.

Limitações​

  • Todas as limitações para view compartilhada se aplicam.
  • Quando um provedor compartilha um view que usa a função CURRENT_RECIPIENT, o provedor não pode consultar o view diretamente devido ao contexto de compartilhamento. Para testar esse view dinâmico, o provedor deve compartilhar o view consigo mesmo e consultar o view como destinatário.
  • Os provedores não podem criar um view que faça referência a um view dinâmico.

Definir uma propriedade do destinatário​

Nesses exemplos, a tabela a ser compartilhada tem uma coluna chamada country, e somente os destinatários com uma propriedade country correspondente podem view determinadas linhas ou colunas.

O senhor pode definir as propriedades do destinatário usando o Catalog Explorer ou SQL comando em um Databricks Notebook ou no editor de consultas SQL.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Recipients (Destinatários ) tab, localize o destinatário ao qual deseja adicionar as propriedades e clique em seu nome.

  4. Clique em Editar propriedades .

  5. Na caixa de diálogo Edit recipient properties (Editar propriedades do destinatário ), digite o nome da coluna como key (nesse caso, country) e o valor pelo qual o senhor deseja filtrar como o valor (por exemplo, CA).

  6. Clique em Salvar .

Criar um view dinâmico com permissão em nível de linha para os destinatários​

Neste exemplo, somente os destinatários com uma propriedade country correspondente podem acessar view determinadas linhas.

SQL
CREATE VIEW my_catalog.default.view1 AS
  SELECT * FROM my_catalog.default.my_table
  WHERE country = CURRENT_RECIPIENT('country');

Outra opção é que o provedor de dados mantenha uma tabela de mapeamento separada que mapeia os campos da tabela de fatos para as propriedades do destinatário. Isso permite que as propriedades do destinatário e os campos da tabela de fatos sejam desacoplados para maior flexibilidade.

Criar um site dinâmico view com permissão em nível de coluna para os destinatários​

Neste exemplo, somente os destinatários que correspondem à propriedade country podem view determinadas colunas. Outros veem os dados retornados como REDACTED:

SQL
CREATE VIEW my_catalog.default.view2 AS
  SELECT
  CASE
    WHEN CURRENT_RECIPIENT('country') = 'US' THEN pii
    ELSE 'REDACTED'
  END AS pii
  FROM my_catalog.default.my_table;

Compartilhe a dinâmica view com um destinatário​

Para compartilhar o view dinâmico com um destinatário, use o mesmo comando SQL ou procedimento de UI que o senhor usaria para um view padrão. Consulte Adicionar visualização a um compartilhamento.

Adicionar visualização materializada a um compartilhamento​

Assim como a visualização, a visualização materializada é o resultado de uma consulta e o senhor pode acessá-la como faria com uma tabela. Diferentemente da visualização regular, os resultados de uma view materializada refletem o estado dos dados quando a view materializada foi atualizada pela última vez. Para obter mais detalhes sobre a visualização materializada, consulte Use materialized view in Databricks SQL.

Certifique-se de atender aos requisitos antes de adicionar uma visualização materializada a um compartilhamento.

Requisitos adicionais​

  • O senhor deve habilitar o serverless compute para fluxo de trabalho, Notebook e LakeFlow Declarative pipeline no account local onde o compartilhamento materializado view está configurado. Consulte Conectar-se a serverless compute .

  • Se o seu workspace tiver workspace-catalog bindings habilitados, certifique-se de que o workspace tenha acesso de leitura e gravação ao catálogo que contém o view materializado. Para obter mais informações, consulte Limitar o acesso do catálogo a um espaço de trabalho específico.

  • A visualização materializada compartilhável deve ser definida nas tabelas Delta ou em outras tabelas, visualizações ou visualizações materializadas de transmissão compartilhável.

  • O senhor deve usar um SQL warehouse ou um compute em Databricks Runtime 13.3 LTS ou acima quando adicionar um view materializado a um compartilhamento.

Limitações​

  • A view materializada não pode ter filtros de linha, mas a tabela base da view materializada pode ter filtros de linha e máscaras de coluna.
  • A expressão materializada ( view ) não pode conter filtros de partição. Em vez disso, crie um objeto de tipo " view " sobre o objeto materializado " view".

Compartilhe a visualização materializada com um destinatário​

Esta seção descreve como adicionar uma visualização materializada a um compartilhamento usando o Catalog Explorer, Databricks CLI, ou SQL comando em um Databricks Notebook ou o editor de consultas Databricks SQL. Se o senhor preferir usar a API REST do Unity Catalog, consulte PATCH /api/2.1/unity-catalog/shares/ na referência da API REST.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. No Shared by me tab, localize o compartilhamento ao qual deseja adicionar um view materializado e clique em seu nome.

  4. Clique em gerenciar ativo > Edit ativo .

  5. Na página Edit ativo , pesquise ou procure o materializado view que o senhor deseja compartilhar e selecione-o.

  6. (Opcional) Na coluna Alias , clique em Balão de fala mais ícone. para especificar um alias ou nome alternativo materializado view, para tornar o nome materializado view mais legível. O alias é o nome que o destinatário vê e deve usar nas consultas. Os destinatários não podem usar o nome view materializado real se um alias for especificado.

  7. Clique em Salvar .

Para obter informações sobre como remover a visualização materializada de um compartilhamento, consulte Atualizar compartilhamentos.

Adicionar volumes a um compartilhamento​

Volumes são objetos do Unity Catalog que representam um volume lógico de armazenamento em um local de armazenamento de objetos na nuvem. Eles se destinam principalmente a fornecer governança sobre dados não tabulares ativos. Consulte O que são volumes do Unity Catalog?

Certifique-se de atender aos requisitos antes de adicionar volumes a um compartilhamento.

Requisitos adicionais​

  • O compartilhamento de volumes é suportado somente em Databricks-to-Databricks compartilhamento.
  • O senhor deve usar um recurso SQL warehouse na versão 2023.50 ou acima ou um recurso compute em Databricks Runtime 14.1 ou acima quando adicionar um volume a um compartilhamento.
  • Se o volume de armazenamento no lado do provedor tiver configurações de rede personalizadas (como firewall ou link privado), o provedor deverá garantir que os endereços do plano de controle e do plano de dados do destinatário estejam devidamente listados para poder se conectar ao local de armazenamento do volume.
nota

Os comentários de volume são incluídos em compartilhamentos que são compartilhados com um destinatário usando o compartilhamento Databricks-to-Databricks em ou após 25 de julho de 2024. Se o senhor quiser começar a compartilhar comentários por meio de um compartilhamento que foi compartilhado com um destinatário antes da data de liberação, deverá revogar e conceder novamente o acesso ao destinatário para acionar o compartilhamento de comentários.

Compartilhe volumes com um destinatário​

Esta seção descreve como adicionar volumes a um compartilhamento usando o Catalog Explorer, o Databricks CLI, ou o SQL comando em um Databricks Notebook ou SQL editor de consultas. Se o senhor preferir usar a API REST do Unity Catalog, consulte PATCH /api/2.1/unity-catalog/shares/ na referência da API REST.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, localize o compartilhamento ao qual deseja adicionar um volume e clique em seu nome.

  4. Clique em gerenciar ativo > Edit ativo .

  5. Na página Edit ativo , pesquise ou procure o volume que deseja compartilhar e selecione-o.

    Como alternativa, você pode selecionar todo o esquema que contém o volume. Consulte Adicionar esquemas a um compartilhamento.

  6. (Opcional) Clique na Balão de fala mais ícone. coluna Alias para especificar um nome de volume alternativo, ou Alias , para tornar o nome do volume mais legível.

    Os aliases não estarão disponíveis se você selecionar um esquema inteiro.

    O alias é o nome que o destinatário vê e deve usar nas consultas. Se um alias for especificado, os destinatários não poderão usar o nome real do volume.

  7. Clique em Salvar .

Para obter informações sobre como remover volumes de um compartilhamento, consulte Atualizar compartilhamentos.

Adicionar modelos a um compartilhamento​

Certifique-se de atender aos requisitos antes de adicionar modelos a um compartilhamento.

nota

Os comentários do modelo e os comentários da versão do modelo são incluídos nos compartilhamentos que são compartilhados usando Databricks-to-Databricks compartilhamento.

Requisitos adicionais​

  • O compartilhamento de modelos é suportado somente em Databricks-to-Databricks compartilhamento.
  • O senhor deve usar um recurso SQL warehouse na versão 2023.50 ou acima ou um recurso compute em Databricks Runtime 14.0 ou acima quando adicionar um modelo a um compartilhamento.

Compartilhe modelos com um destinatário​

Esta seção descreve como adicionar modelos a um compartilhamento usando o Catalog Explorer, o Databricks CLI, ou SQL comando em um Databricks Notebook ou SQL editor de consultas. Se o senhor preferir usar a API REST do Unity Catalog, consulte PATCH /api/2.1/unity-catalog/shares/ na referência da API REST.

Para adicionar modelos a um compartilhamento:

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, localize o compartilhamento ao qual deseja adicionar um modelo e clique em seu nome.

  4. Clique em gerenciar ativo > Edit ativo .

  5. Na página Editar ativo , pesquise ou procure o modelo que deseja compartilhar e selecione-o.

    Como alternativa, você pode selecionar todo o esquema que contém o modelo. Consulte Adicionar esquemas a um compartilhamento.

  6. (Opcional) Clique na Balão de fala mais ícone. coluna Alias para especificar um nome de modelo alternativo, ou Alias , para tornar o nome do modelo mais legível.

    Os aliases não estarão disponíveis se você selecionar um esquema inteiro.

    O alias é o nome que o destinatário vê e deve usar nas consultas. Os destinatários não podem usar o nome real do modelo se um alias for especificado.

  7. Clique em Salvar .

Para obter informações sobre como remover modelos de um compartilhamento, consulte Atualizar compartilhamentos.

Adicionar arquivos do Notebook a um compartilhamento​

Certifique-se de atender aos requisitos antes de adicionar arquivos do Notebook a um compartilhamento.

Use o Catalog Explorer para adicionar um arquivo do Notebook a um compartilhamento.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

  3. No Shared by me (Compartilhado por mim ) tab, localize o compartilhamento ao qual deseja adicionar um Notebook e clique em seu nome.

  4. Clique em gerenciar ativo e selecione Add Notebook file .

  5. Na página Add Notebook file (Adicionar arquivo do Notebook ), clique no ícone de arquivo para procurar o Notebook que deseja compartilhar.

    • Clique no arquivo que você deseja compartilhar e clique em Selecionar .
    • (Opcionalmente) especifique um alias amigável para o arquivo no campo Compartilhar como . Este é o identificador que os destinatários veem.
    • Em Local de armazenamento , insira o local externo no armazenamento cloud onde você deseja armazenar o Notebook. Você pode especificar um subcaminho no local externo definido. Se você não especificar um local externo, o Notebook será armazenado no local de armazenamento em nível de metastore (ou “local raiz do metastore”). Se nenhum local raiz for definido para o metastore, você deverá inserir um local externo aqui. Consulte Adicionar armazenamento gerenciar a um metastore existente.

  6. Clique em Salvar .

O arquivo compartilhado do Notebook agora aparece na lista de arquivosNotebook no ativo tab.

Remover arquivos do Notebook dos compartilhamentos​

Para remover um arquivo do Notebook de um compartilhamento:

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, localize o compartilhamento que inclui o Notebook e clique no nome do compartilhamento.

  4. No ativo tab, localize o arquivo do Notebook que deseja remover do compartilhamento.

  5. Clique no menu Ícone do menu Kebab. kebab à direita da linha e selecione Delete Notebook file (Excluir arquivo do Notebook ).

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

Atualizar arquivos do Notebook em compartilhamentos​

Para atualizar um Notebook que já tenha sido compartilhado, o senhor deve adicioná-lo novamente, atribuindo-lhe um novo alias no campo Compartilhar como . Databricks Recomenda-se que o senhor use um nome que indique o status revisado do Notebook, como <old-name>-update-1. Talvez seja necessário notificar o destinatário sobre a alteração. O destinatário deve selecionar e clonar o novo Notebook para aproveitar a sua atualização.

Conceder aos destinatários acesso a um compartilhamento​

Certifique-se de atender aos requisitos antes de conceder aos destinatários acesso a um compartilhamento.

Para obter instruções, consulte gerenciar acesso aos compartilhamentos de dados Delta Sharing (para provedores). Esta página também explica como revogar o acesso de um destinatário a um compartilhamento.

visualizar ações e detalhes das ações​

Certifique-se de atender aos requisitos antes de visualizar os compartilhamentos e seus detalhes.

Para view uma lista de compartilhamentos ou detalhes sobre um compartilhamento, use o Catalog Explorer, o Databricks Unity Catalog CLI ou o comando SQL em um Databricks Notebook ou o editor de consulta Databricks SQL .

Os detalhes do compartilhamento incluem o seguinte:

  • O proprietário, o criador, o carimbo de data e hora de criação, o atualizador, o carimbo de data/hora atualizado e os comentários do compartilhamento.
  • Dados ativos no compartilhamento.
  • Destinatários com acesso ao compartilhamento.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Abra a seção Shares (Ações ) tab para view uma lista de ações.

  4. Veja os detalhes das ações no site Details tab.

visualizar os destinatários que têm permissões em um compartilhamento​

Certifique-se de atender 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, o Databricks Unity Catalog CLI ou o comando SQL SHOW GRANTS TO RECIPIENT em um Databricks Notebook ou no editor de consulta Databricks SQL .

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. No Shared by me tab, localize e selecione o destinatário.

  4. Vá para Recipients (Destinatários ) tab para view a lista de destinatários que podem acessar o compartilhamento.

Atualizar compartilhamentos​

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

Você pode atualizar um compartilhamento das seguintes maneiras:

  • Renomeie um compartilhamento.
  • Remover tabelas, visualizações, volumes e esquemas de um compartilhamento.
  • Adicione ou atualize um comentário em um compartilhamento.
  • Renomeie o alias de uma tabela (o nome da tabela exibido para o destinatário).
  • Ativar ou desativar o acesso aos dados históricos de uma tabela, permitindo que os destinatários realizem consultas de viagem do tempo ou leituras de transmissão da tabela.
  • Adicione, atualize ou remova definições de partição.
  • Altere o proprietário do compartilhamento.

Para fazer essas atualizações nos compartilhamentos, use o Catalog Explorer, o Databricks Unity Catalog CLI ou o comando SQL em um Databricks Notebook ou o editor de consulta Databricks SQL . No entanto, você não pode usar o Catalog Explorer para renomear o compartilhamento.

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, localize o compartilhamento que deseja atualizar e clique em seu nome.

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

  • Clique no ícone de Ícone de edição edição ao lado do campo Proprietário ou Comentário para atualizar esses valores.
  • Clique no botão do menu kebab Ícone do menu Kebab. em uma linha ativa para removê-lo.
  • Clique em gerenciar ativo > Edit 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 .

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

O proprietário da ação influencia a forma como a autorização e os recursos de segurança, como as políticas ABAC, são avaliados. Transferir a propriedade de ações para um usuário com privilégios excessivos permite que os destinatários tenham acesso com excesso de privilégios se você tiver uma tabela ou esquema protegido pelas políticas do ABAC.

Excluir compartilhamentos​

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

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

  1. Em seu site Databricks workspace, clique em Ícone de dados. Catalog .

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

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

  3. Em Shared by me (Compartilhado por mim ) tab, localize o compartilhamento que deseja excluir e clique em seu nome.

  4. Ícone do menu Kebab. Clique no menu kebab e selecione Excluir.

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

Última atualização em