7 Compartilhar Dados

Este capítulo fornece detalhes sobre como gerenciar compartilhamentos de dados, ativos e destinatários no AI Data Platform Workbench.

Compartilhamento de Dados

O compartilhamento de dados no Oracle AI Data Platform Workbench permite o compartilhamento seguro e eficiente de dados em tempo real em toda e dentro da organização sem duplicação de dados.

O AI Data Platform Workbench usa o protocolo Delta Sharing para compartilhar dados com segurança. Para compartilhar seus dados, você deve concluir estas etapas:
  1. Crie um compartilhamento.
  2. Adicione ativos que você deseja compartilhar. Um ativo pode ser um esquema ou uma tabela.
  3. Crie e adicione destinatários a um compartilhamento. Um compartilhamento e um destinatário podem ser controlados por acesso usando o modelo de permissões.
  4. Ative os destinatários.

Na página Compartilhamento de dados, você pode ver todos os Compartilhamentos em seu AI Data Platform Workbench, todos os destinatários de Compartilhamentos em seu AI Data Platform Workbench, seus Compartilhamentos e Compartilhamentos que outras pessoas fizeram de você um destinatário.

Na guia Compartilhamentos, você pode ver os detalhes de Compartilhamentos em seu Workbench da Plataforma de Dados AI, incluindo o número de ativos em um Compartilhamento, o número de destinatários e quem possui o compartilhamento. Você pode criar um novo Compartilhamento clicando em Criar compartilhamento ao lado da barra de pesquisa.

Clicar em um Compartilhamento permite ver os ativos compartilhados, os destinatários, os detalhes e as permissões RBAC. Na guia Ativos, você pode adicionar ativos ao compartilhamento. Na guia Destinatários, você pode gerenciar os destinatários desse compartilhamento específico, criar novos destinatários ou compartilhar com destinatários existentes. A guia Detalhes fornece o nome, a descrição e os detalhes de criação do Compartilhamento. Na guia Permissões, você pode gerenciar as permissões RBAC para esse Compartilhamento.

Na guia Destinatários no nível superior do Compartilhamento de Dados, você pode ver detalhes dos destinatários do Compartilhamento no Workbench da Plataforma de Dados AI. Você pode criar novos destinatários clicando em Criar destinatário ao lado da barra de pesquisa.

Clicar em um nome de destinatário mostra Compartilhamentos aos quais o destinatário foi adicionado, detalhes desse destinatário e as permissões RBAC desse destinatário.

Tratando Expiração do Token

O Oracle AI Data Platform pode gerar novamente tokens de portador para compartilhamento de dados para destinatários ativos. Se o token ao portador atual não tiver expirado, você poderá estender a duração do token ao portador chamando a API updateSecretExpiry usando um comando curl:

curl
    --header 'Authorization: Bearer <token>’
    --header 'Content-Type: application/json'
    --data '{"existingTokenExpireInSeconds":"<duration>"}'
    --request POST ‘<delta_share_endpoint>/updateSecretExpiry'
Onde:
  • <token> é o valor do token ao portador no perfil de compartilhamento
  • <duration> é a duração do novo token em segundos
  • <delta_share_endpoint> é o ponto final de Compartilhamento Delta. Você pode obter esse valor para um destinatário usando sql("DESCRIBE recipient <<recipient_name>>") e verificando o valor do delta_share_enpoint do destinatário.

Limitações

  • Você pode enviar o e-mail do token de ativação usando um aplicativo de e-mail ou copiando o link de ativação e compondo um e-mail usando o serviço de e-mail existente.
  • Você não pode compartilhar volumes ou arquivos do espaço de trabalho (arquivos de dados, notebook, sql ou python) usando o compartilhamento de dados.

Criar um Compartilhamento

Crie um Compartilhamento como um contêiner para gerenciar ativos compartilhados como parte do compartilhamento de dados do AI Data Platform Workbench.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique em Ícone Criar compartilhamento Criar Compartilhamento.
  3. Informe um nome e a descrição para a sua Compartilhamento
  4. Clique em Criar.

Modificar um Compartilhamento

Você pode atualizar o nome e a descrição de suas Compartilhamentos após a criação.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Ao lado do compartilhamento a ser modificado, clique em Ícone de três pontos de ações Ações e, em seguida, clique em Editar.
  3. Digite um novo nome ou descrição para seu Compartilhamento. Clique em Salvar.

Excluir um Compartilhamento

Você pode excluir um Compartilhamento que não seja mais necessário.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Ao lado do compartilhamento a ser excluído, clique em Ícone de três pontos de ações Ações e, em seguida, clique em Excluir.
  3. Clique em Excluir.

Exibir Detalhes do Compartilhamento

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique na guia Compartilhamentos.
  3. Clique no nome do compartilhamento e clique na guia Detalhes.

Adicionar um Ativo a um Compartilhamento

Depois de criar um Compartilhamento, você pode adicionar ativos a serem compartilhados com destinatários.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique no nome do Compartilhamento ao qual adicionar ativos.
  3. Na guia Ativos, clique em Ícone Adicionar ativo Adicionar ativo.
  4. Selecione Espaço de Trabalho ou Catálogo como a origem do ativo.
  5. Use a barra de pesquisa ou navegue até o ativo que deseja compartilhar. Selecione-o e clique em Adicionar.

Remover um Ativo de um Compartilhamento

Você pode remover ativos que não deseja mais fazer parte de um Compartilhamento.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique no nome do Compartilhamento do qual remover ativos.
  3. Na guia Ativos, ao lado do ativo que você deseja remover, clique em Ícone de três pontos de ações Ações e, em seguida, clique em Excluir.
  4. Clique em Excluir.

Adicionar Destinatários ao Compartilhamento de Dados

Você deve adicionar destinatários para poder incluí-los em Compartilhamentos.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique na guia Destinatários.
  3. Clique em Ícone Criar destinatário Criar destinatário.
  4. Informe um nome e descrição para o destinatário.
  5. Opcional: Informe o endereço de e-mail para o qual enviar um link de ativação para o destinatário.
  6. Clique em Criar.

Adicionar um Destinatário Existente a um Compartilhamento

Você pode adicionar destinatários que já existem no Workbench da Plataforma de Dados do AI a um Compartilhamento.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique no nome de um Compartilhamento para adicionar um destinatário existente.
  3. Clique na guia Destinatários.
  4. Clique em Ícone Compartilhar com destinatários existentes Compartilhar com destinatários existentes.
  5. Procure um usuário e selecione a caixa ao lado do nome do destinatário.
  6. Clique em Compartilhar.

Ativar manualmente um destinatário

Você pode optar por ativar destinatários manualmente se houver problemas que os impeçam de usar os links de ativação de e-mail.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique na guia Destinatário.
  3. Clique no nome do destinatário e clique na guia Detalhes.
  4. Ao lado de Status da ativação, clique em Ativar.
  5. Copie o link de ativação do prompt e cole em uma janela separada.
  6. Verifique se o status de Ativação agora está definido como Ativo.

Reenviar link de ativação para um destinatário

Se o link de ativação foi perdido, excluído ou não recebido por um destinatário, você poderá reenviar o link de ativação para o endereço de e-mail fornecido.

O destinatário deve ter um endereço de e-mail como parte de seus detalhes para enviar a ele um link de ativação. Se o e-mail estiver incorreto ou ausente, talvez seja necessário criar um novo destinatário.
  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique na guia Destinatário.
  3. Clique no nome do destinatário e clique na guia Detalhes.
  4. Ao lado de Link de e-mail de ativação, clique em Enviar link de ativação. Seu aplicativo de e-mail configurado é aberto.
  5. Revise e envie o e-mail para o destinatário.

Remover Destinatário de um Compartilhamento

Você pode remover um destinatário de um Compartilhamento, mantendo o destinatário, mas removendo seu acesso aos ativos nesse Compartilhamento.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique no compartilhamento do qual você deseja remover destinatários.
  3. Clique na guia Destinatários.
  4. Ao lado do destinatário que você deseja remover, clique em Ícone de três pontos de ações Ações e, em seguida, clique em Remover.

Modificar um destinatário

Você pode atualizar o nome, a descrição e o endereço de e-mail de um destinatário após a criação.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique na guia Destinatário.
  3. Ao lado do destinatário a ser atualizado, clique em Ícone de três pontos de ações Ações e, em seguida, clique em Editar.
  4. Digite um novo nome ou uma descrição para o destinatário. Clique em Salvar.

Visualizar detalhes do destinatário

Você pode ver informações sobre um destinatário, como nome, endereço de e-mail para link de ativação, status ativo e detalhes de criação na guia Detalhes.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique na guia Destinatário.
  3. Clique no nome do destinatário e clique na guia Detalhes.

Excluir um destinatário

É possível excluir destinatários que não são mais necessários no Workbench da Plataforma de Dados do AI.

  1. Na Home page, clique em Compartilhamento de Dados.
  2. Clique na guia Destinatários.
  3. Ao lado do destinatário a ser excluído, clique em Ícone de três pontos de ações Ações e, em seguida, clique em Excluir.
  4. Clique em Excluir.