Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Esta página explica como acessar dados compartilhados com você usando o OpenSharing. O OpenSharing dá suporte a vários modelos de compartilhamento:
- Compartilhamento Databricks para Databricks para usuários do workspace do Azure Databricks com Unity Catalog
- Compartilhamento da Databricks para ambiente aberto, com qualquer destinatário usando qualquer ferramenta
- Compartilhamento aberto para Databricks, para provedores que usam o compartilhamento de protocolo OpenSharing de código aberto com destinatários usando Azure Databricks
OpenSharing e destinatários de dados
O OpenSharing é um padrão aberto para compartilhamento seguro de dados. Um usuário do Databricks, conhecido como um provedor de dados nesse contexto, pode usar o OpenSharing no Azure Databricks para compartilhar dados com uma pessoa ou grupo fora de sua organização, chamado de destinatário de dados.
Protocolos de compartilhamento
A forma de acessar os dados depende de você ser ou não um usuário do Databricks e de o provedor de dados ter configurado ou não os dados compartilhados com você para compartilhamento Databricks-to-Databricks, Databricks-to-Open ou Open-to-Databricks.
No modelo Databricks-to-Databricks, você deve ser usuário em um workspace do Databricks habilitado para o Catálogo do Unity. Um membro da sua equipe fornece ao provedor de dados um identificador exclusivo para o metastore do Catálogo do Unity, e o provedor de dados usa isso para criar uma conexão de compartilhamento segura. Os dados compartilhados ficam disponíveis para acesso em seu workspace. Se necessário, um membro da sua equipe configura o controle de acesso granular nesses dados.
No modelo de compartilhamento Databricks-to-Open, você pode usar qualquer ferramenta desejada (incluindo o Databricks) para acessar os dados compartilhados. O provedor de dados envia uma URL de ativação ou um link do portal por um canal seguro. Siga as instruções para baixar um arquivo de credenciais ou URL que permita acessar os dados compartilhados com você.
Os dados compartilhados não são fornecidos diretamente pelo Databricks, mas por provedores de dados em execução no Azure Databricks.
No modelo Open-to-Databricks, você pode usar Azure Databricks para acessar dados compartilhados por um provedor de dados usando o protocolo OpenSharing de software livre. Seu provedor de dados envia um arquivo de credencial por meio de um canal seguro que você carrega para Azure Databricks. Usando o Gerenciador de Catálogos ou um notebook, você pode acessar os dados compartilhados com você.
Note
O Databricks pode coletar informações sobre o uso e o acesso dos destinatários de dados aos dados compartilhados (incluindo a identificação de qualquer indivíduo ou empresa que acessa os dados usando o arquivo de credencial em conexão com essas informações) e pode compartilhá-los com o provedor de dados aplicável.
Tenha acesso aos dados compartilhados com você
Como você acessa os dados depende de qual protocolo de compartilhamento seu provedor usou.
Obter acesso no modelo Databricks-to-Databricks
No modelo Databricks-para-Databricks, você acessa os dados de maneira diferente, dependendo de como seu provedor compartilhou esses dados com você.
Depois de ter acesso aos dados, você ou alguém da sua equipe pode configurar o acesso granular desses dados para seus usuários. Consulte Ler dados compartilhados usando o OpenSharing Databricks-to-Databricks (para destinatários).
Acesso por e-mail
Importante
Esse recurso está em Beta.
Se seu provedor compartilhou dados por e-mail, a Databricks envia um e-mail com o assunto "<A organização> compartilhou dados com você". O e-mail inclui um link de ativação seguro. Se seu provedor permitiu tanto o Azure Databricks quanto o compartilhamento aberto, você pode escolher como acessar os dados.
Para aceitar estas ações:
- Abra o e-mail e clique em Usar uma conta Databricks existente ou Criar uma conta Databricks gratuita.
- Faça login ou crie sua conta Azure Databricks usando o mesmo endereço de e-mail que recebeu o e-mail do OpenSharing.
- Você deve ter o privilégio CREATE PROVIDER no nível do metastore no Azure Databricks. Peça permissão se necessário e espere que um administrador da metastore conceda o privilégio.
- Especifique a metastore onde as ações devem estar.
Acesso usando identificador de compartilhamento
Se um provedor pedir para compartilhar dados com você usando um identificador de compartilhamento, você deve encontrar o identificador de uma metastore do Unity Catalog anexada ao espaço de trabalho de sua escolha. Envie para seu provedor para que ele crie um objeto destinatário que te represente. Depois que eles criam compartilhamentos e concedem acesso a você, você automaticamente passa a ter acesso somente para leitura aos dados.
O identificador de compartilhamento é uma cadeia de caracteres que consiste na nuvem, região e UUID do metastore (o identificador exclusivo do metastore), no formato <cloud>:<region>:<uuid>.
Por exemplo, na captura de tela a seguir, o identificador de compartilhamento completo é aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016.
Encontre seu identificador de compartilhamento usando o Explorador de Catálogo, a CLI do Databricks Unity Catalog ou a função SQL CURRENT_METASTORE em um notebook do Databricks ou em uma consulta do Databricks SQL.
Gerenciador de Catálogos
No workspace Azure Databricks, clique em
Catalog.Na parte superior do painel Catálogo , clique no
Ícone de engrenagem e selecione OpenSharing.Como alternativa, no canto superior direito, clique em Compartilhar > OpenSharing.
Na guia Compartilhado comigo, clique no nome da organização de compartilhamento do Databricks no canto superior direito e selecione Copiar identificador de compartilhamento.
SQL
Seu notebook ou consulta deve ser executado em um ambiente computacional com modo de acesso padrão ou dedicado no espaço de trabalho que você pretende usar para acessar os dados compartilhados.
Execute o seguinte comando em um notebook ou no editor de consultas SQL do Databricks:
SELECT CURRENT_METASTORE();
CLI
Execute o comando a seguir usando a CLI do Databricks. O identificador de compartilhamento é retornado como o global_metastore_id.
databricks metastores summary
Obter acesso no modelo de compartilhamento Databricks-to-Open
No modelo de compartilhamento Databricks-to-Open:
O provedor de dados envia uma URL de ativação ou um portal por um canal seguro, ou o Databricks envia um e-mail. Um convite por e-mail não pode ser encaminhado. Siga o link para baixar um arquivo de credencial ou acessar os dados compartilhados com você.
Há suporte para tokens de portador e credenciais de cliente OAuth.
Importante
Não compartilhe o link de ativação com ninguém. Você pode baixar um arquivo de credenciais apenas uma vez. Se você acessar o link de ativação novamente depois de já ter baixado o arquivo de credenciais, o botão Baixar Arquivo de Credenciais estará desabilitado.
Caso perca o link de ativação antes de usá-lo, entre em contato com o provedor de dados.
Armazene o arquivo de credenciais em um local seguro.
Não compartilhe o arquivo de credencial com ninguém fora do grupo de usuários que devem ter acesso aos dados compartilhados. Caso você precise compartilhá-lo com alguém da sua organização, o Databricks recomenda usar um gerenciador de senhas.
Tenha acesso no modelo Aberto para Databricks
No modelo Open-to-Databricks:
O provedor de dados usa o protocolo OpenSharing de software livre para criar compartilhamentos e adicionar ativos ao compartilhamento.
O provedor de dados envia uma URL de ativação (por um canal seguro) ou uma URL do portal. Siga as instruções para baixar um arquivo de credencial ou uma URL que permita acessar os dados compartilhados com você.
Há suporte para tokens de portador e credenciais de cliente OAuth.
Importante
Não compartilhe o link de ativação com ninguém. Você pode baixar um arquivo de credenciais apenas uma vez. Se você acessar o link de ativação novamente depois de já ter baixado o arquivo de credenciais, o botão Baixar Arquivo de Credenciais estará desabilitado.
Caso perca o link de ativação antes de usá-lo, entre em contato com o provedor de dados.
Armazene o arquivo de credencial em seu workspace Azure Databricks.
Não compartilhe o arquivo de credencial com ninguém fora do grupo de usuários que devem ter acesso aos dados compartilhados.
Ler os dados compartilhados
A forma como você lê dados compartilhados com segurança com você usando o OpenSharing depende se você recebeu um arquivo de credencial ou se está usando um workspace do Databricks e forneceu ao provedor de dados o identificador de compartilhamento (o modelo Databricks-to-Databricks).
Note
Se você receber um erro informando que um ativo de dados não existe ao tentar ler seus compartilhamentos, consulte Erro Ativo de dados "não existe".
Ler dados compartilhados usando um arquivo de credenciais (compartilhamento do Databricks para aberto ou compartilhamento de Aberto para Databricks)
Se os dados tiverem sido compartilhados com você usando tokens de portador, use o arquivo de credencial baixado para autenticar na conta do provedor de dados e ler os dados compartilhados. O acesso persiste enquanto o token subjacente for válido e o provedor continuar a compartilhar os dados. Os provedores gerenciam a validade e a rotação dos tokens. Os tokens são válidos por um máximo de um ano após a criação. As atualizações dos dados ficam disponíveis quase em tempo real. Você pode ler e fazer cópias dos dados compartilhados, mas não pode modificar os dados de origem.
Para usar Azure Databricks para acessar e ler dados compartilhados, consulte Importar um provedor e ler dados compartilhados em Azure Databricks.
Para usar o Apache Spark, pandas e Power BI para acessar e ler dados compartilhados, consulte Ler dados compartilhados com tokens de portador.
Ler dados compartilhados usando uma federação OIDC (compartilhamento Databricks-to-Open)
Se os dados tiverem sido compartilhados com você usando o protocolo de compartilhamento Databricks-to-Open com a federação OIDC, use a URL que foi enviada para você para autenticar na conta do provedor de dados e ler os dados compartilhados. O acesso persiste desde que o provedor continue compartilhando os dados. As atualizações dos dados ficam disponíveis quase em tempo real. Você pode ler e fazer cópias dos dados compartilhados, mas não pode modificar os dados de origem.
Para saber como acessar e ler dados compartilhados usando o fluxo de federação de token OIDC em Tableau e Power BI, consulte Dados compartilhados usando a federação OIDC (Open ID Connect) em um fluxo U2M. Para saber como acessar e ler dados compartilhados usando o fluxo de federação de token OIDC em um aplicativo cliente Python, consulte Dados compartilhados usando a federação OIDC (Open ID Connect) em um fluxo M2M.
Ler dados compartilhados usando o compartilhamento de Databricks para Databricks
Se os dados tiverem sido compartilhados com você usando o modelo Databricks para Databricks, então nenhum arquivo de credencial será necessário para acessar os dados compartilhados. O Databricks cuida da conexão segura e os dados compartilhados são detectáveis automaticamente no workspace do Databricks.
Para saber como localizar, ler e gerenciar esses dados compartilhados em seu workspace do Databricks, consulte Ler dados compartilhados usando o Databricks-to-Databricks OpenSharing (para destinatários).
Uso de auditoria dos dados compartilhados
Se você tiver acesso a um workspace do Azure Databricks, poderá usar os logs de auditoria do Azure Databricks para entender quem, na sua organização, está acessando quais dados usando o OpenSharing. Veja Auditar e monitorar o compartilhamento de dados.