Consumir Compartilhamento
Depois que os provedores compartilham os objetos, há algumas etapas que os destinatários precisam seguir para consumir o compartilhamento.
- Visão Geral do Consumo de Compartilhamento:
Para consumir compartilhamentos de dados, você precisa se inscrever neles e criar views de tabelas incluídas no compartilhamento ao vivo.
- Consumir Compartilhamento com Controle de Versão:
Como destinatário, você precisará fazer download do seu perfil de compartilhamento, assinar o provedor de compartilhamento de dados, registrar os compartilhamentos e criar tabelas externas sobre seus compartilhamentos. A ferramenta Compartilhamento de Dados autoriza o acesso usando o perfil JSON enviado ao destinatário usando o e-mail de ativação. Depois que o acesso é concedido, a ferramenta Compartilhamento de Dados vincula os objetos compartilhados à ferramenta de link de Dados, na qual o consumidor pode executar o job de link de dados e acessar os objetos compartilhados pelo provedor.
- Consumir Compartilhamento ao Vivo:
Isso permite que você, como destinatário, consuma dados ativos do banco de dados.
- Exibir Detalhes da Entidade do Provedor de Compartilhamento:
Use o ícone Ações à direita da entrada de entidade do provedor de compartilhamento ao vivo ou delta para exibir detalhes sobre a entidade do provedor de compartilhamento ao vivo ou delta que você cria.
- Visão Geral do Compartilhamento de Consumo
O Compartilhamento de Consumo fornece uma visão geral sobre a lista de provedores de compartilhamento, pesquisa por provedores de compartilhamento e adiciona um provedor de compartilhamento. - Consumir Compartilhamento com Controle de Versão
Você deve seguir estas etapas para disponibilizar dados com controle de versão compartilhados para você no Oracle Autonomous Database. Os dados compartilhados com você por meio do Delta Sharing não estão automaticamente disponíveis e podem ser descobertos no seu Autonomous Database. - Consumir Compartilhamento ao Vivo
Os dados ao vivo compartilhados com você por meio do compartilhamento de dados não estão automaticamente disponíveis para consumo. - Exibir Detalhes da Entidade do Provedor de Compartilhamento
Para exibir detalhes sobre a entidade do Provedor de Compartilhamento, clique no ícone Ações à direita da entrada da entidade do Provedor de Compartilhamento e, em seguida, clique em Exibir Detalhes.
Tópico principal: A Ferramenta de Compartilhamento de Dados
Visão Geral do Consumo Compartilhado
O Compartilhamento de Consumo fornece uma visão geral sobre a lista de provedores de compartilhamento, pesquisa por provedores de compartilhamento e adiciona um provedor de compartilhamento.
- No menu do Data Studio, selecione Consumir Compartilhamento no menu Compartilhamento de Dados.
- Na página Compartilhamento de Dados, clique no widget Compartilhamento de Consumo presente na seção Provedor e Consumidor.
A página Consumir Compartilhamento contém:
Descrição da ilustração consumir-share-new.png
- Provedores de Compartilhamento Ativos disponíveis nos últimos 7 Dias
Esta área exibe a lista de Provedores de Compartilhamento ao Vivo disponíveis que você criou nos últimos 7 dias. Você pode atualizar qualquer um dos campos de acordo com seu desejo. Você também pode se inscrever no Live Share usando o sinal + à direita de Compartilhamentos listados em Compartilhamentos disponíveis nos últimos 7 dias.
-
Campo Pesquisar Provedor de Compartilhamento Assinado
Você pode procurar o Destinatário de Compartilhamento criado digitando o nome do Provedor de Compartilhamento Inscrito. Informe o nome do Provedor de Compartilhamento Inscrito, por exemplo, REVIEW_PROVIDER e clique no ícone magnificador para concluir a pesquisa. A ferramenta Compartilhar exibe os resultados da pesquisa na área de exibição.
- Selecione + Assinar Provedor de Compartilhamento para se inscrever em um novo Provedor de Compartilhamento. Consulte Inscreva-se no Provedor de Compartilhamento para explorar este ícone.
- Meu ID de Compartilhamento
Um ID de Compartilhamento é um provedor exclusivo do seu Autonomous Database. Copie esse ID para a área de transferência e cole-o no campo ID de Compartilhamento do assistente Criar Destinatário de Compartilhamento. Isso permite que um Live Share seja compartilhado com um provedor de compartilhamento.
- Barra de Ferramentas
A barra de ferramentas consiste nas opções de classificação por, tamanho da página, atualização e exibição de entidade.
- Ordenar por configurações
Quando você define a classificação de valores usando o controle Classificar por na barra de ferramentas, as configurações são exibidas em caixas pequenas abaixo da barra de ferramentas. Você pode excluir uma definição clicando no ícone X na caixa. Como alternativa, você pode alterar as configurações retornando ao controle Classificar por na barra de ferramentas.
-
Área de exibição
A área abaixo do campo Pesquisar Provedores de Compartilhamento do Consumidor exibe as entidades retornadas por uma pesquisa e que correspondem aos critérios de filtro definidos no painel Filtros. Você pode classificar as entidades clicando no botão Classificar por e, em seguida, definindo valores de classificação.
Tópico principal: Consumir Compartilhamento
Consumir Compartilhamento com Versão
Siga estas etapas para disponibilizar dados com controle de versão compartilhados para você no Oracle Autonomous Database. Os dados compartilhados com você por meio do Delta Sharing não estão automaticamente disponíveis e podem ser descobertos no seu Autonomous Database.
- Faça download do perfil JSON.
- Assine o provedor de compartilhamento de dados.
- Registre as ações disponibilizadas para você.
- Crie tabelas externas sobre seus compartilhamentos.
Sobre o Perfil JSON
Os arquivos de perfil são arquivos JSON que contêm as credenciais de um usuário para acessar um Servidor de Compartilhamento Delta. Isso permite que você se autentique com o servidor de compartilhamento delta e descubra os compartilhamentos de dados aos quais está qualificado a acessar. Faça download do perfil usando o URL incluído no e-mail de convite enviado pelo provedor de compartilhamento de dados.
Depois que a ferramenta Compartilhar cria um objeto de compartilhamento, o destinatário recebe um e-mail de ativação com o assunto intitulado Oracle Autonomous Database Data Share.
Para acessar o compartilhamento, você precisa registrar os objetos compartilhados usando o perfil JSON de autorização pessoal.
Você pode clicar no link do perfil para fazer download do perfil JSON. Clicar no link do perfil leva você a uma nova tela no navegador com um botão Obter Informações de Perfil, conforme mostrado abaixo:

Descrição da ilustração json-profile.png
Você pode clicar no botão Obter Informações de Perfil apenas uma vez e também exibir o link para o Guia de Início Rápido. A ferramenta de compartilhamento não permite que você selecione Obter Informações do Perfil duas vezes. Clicando nele duas vezes traz uma tela que exibe a lista de causas da falha ao baixar o perfil.
{ "
shareCredentialsVersion ": 1,
"endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/",
"tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token",
"bearerToken": "-xxxxxxxxxxxxxxxxxxxxx",
"expirationTime": "2023-01-13T07:53:11.073Z",
"clientID": "xxxxxxxxxxxxxxxxxxxxxx..",
"clientSecret": "xxxxxxxxxxxxxxxxxxxx.."}
- shareCredentialsVersion: A versão do compartilhamento que você publica.
- ponto final: Especifica o ponto final de compartilhamento.
- tokenEndpoint: Especifica o ponto final do token. O cliente da ferramenta Compartilhar usa o ponto final do token para atualizar o timeout no token do portador se você estiver consumindo o compartilhamento usando a Oracle.
- bearerToken: Esta é uma string criptografada que o servidor de autenticação gera em resposta a uma solicitação de log-in.
- expirationTime: Este é o tempo necessário para que a autenticação expire.
- ClientID: Especifica o identificador público que o servidor de autenticação gera quando você registra a instância para autenticação.
- clientSecret: Especifica um identificador de segredo que o servidor de autenticação gera para autorização.
Certifique-se de copiar o perfil de conteúdo JSON completo, incluindo a chave esquerda e a chave direita.
Melhorias de Segurança
Como destinatário de compartilhamento, você deve configurar uma lista de controle de acesso (ACL) para a máquina do provedor de compartilhamento usando o procedimento APPEND_HOST_ACE
como usuário ADMIN ou outro usuário com privilégios. Isso permite que você acesse o compartilhamento pela Internet.
Isso deve ser feito antes de usar o Assistente para Adicionar Provedor de Compartilhamento para adicionar uma entrada de controle de acesso (ACE) à lista de controle de acesso (ACL) do host (ou seja, provedor de Compartilhamento). Você pode encontrar o nome do host no perfil JSON baixado na etapa anterior.
Por exemplo, se você quiser permitir que um usuário do banco de dados, A_SHARE_USER, acesse os pontos finais em um host (Provedor de compartilhamento) nomeado, aqui está uma amostra do procedimento PL/SQL que você precisará executar no editor de planilha SQL como administrador. Como pré-requisito, extraia o nome do host da propriedade de ponto final no perfil JSON de compartilhamento delta, conforme fornecido no exemplo acima. O nome do host do exemplo é myhost.us.example.com
.
BEGIN
dbms_network_acl_admin.append_host_ace(
host =>'myhost.us.example.com',
lower_port=>443,
upper_port=>443,
ace => xs$ace_type(
privilege_list => xs$name_list('http', 'http_proxy'),
principal_name =>'A_SHARE_USER',
principal_type => xs_acl.ptype_db));
COMMIT;
END;
/
A seguir estão os parâmetros com sua descrição:
- host- Especifica o nome ou o endereço IP do host. O nome do host ou do domínio não distingue maiúsculas de minúsculas.
- porta inferior- Especifica a porta inferior de uma faixa de portas TCP opcional.
- porta superior- Especifica a porta superior de um intervalo de portas TCP opcional.
- ace - A Entrada de Controle de Acesso.
- lista de privilégios- Especifica a lista de privilégios de rede a serem concedidos ou negados.
- principal_name- É o principal (usuário ou atribuição do banco de dados) ao qual o privilégio é concedido ou negado. Ele distingue maiúsculas de minúsculas.
- principal_type- Especifica o tipo de principal que você usa.
Consulte o documento PL/SQL Packages and Types Reference para obter mais detalhes sobre os subprogramas do pacote DBMS_NETWORK_ACL_ADMIN
.
PRIV_ORDS_ACL CONSTANT PLS_INTEGER := 8;
Nesse processo, você carregará o perfil JSON do provedor para configuração e credenciais para permitir o acesso aos destinatários.
- Abra a página Compartilhamento de Consumo e clique em + Inscrever-se no Provedor de Compartilhamento para selecionar Inscrever-se no Provedor de Compartilhamento Delta no menu suspenso. Isso abre a caixa de diálogo Inscrever para compartilhar profissional de saúde.
- No painel Definições do Provedor da caixa de diálogo Registrar Provedor de Compartilhamento, especifique os seguintes detalhes:
Descrição da ilustração subscribe-share-provider-version-providersettings.png- Nome do Provedor: Provedor.
- Descrição: Adicione uma descrição. Esse campo é opcional.
Na seção Origem do Compartilhamento, escolha JSON do Provedor de Compartilhamento Delta.
No campo JSON do Provedor de Compartilhamento, você pode compartilhar o perfil JSON das seguintes maneiras:- Do Arquivo: Selecione essa opção e clique na área de soltura intitulada "JSON do Perfil de Compartilhamento Delta". Clicar na área abre seu repositório local, onde você pode selecionar o perfil JSON que você baixou.
- JSON: Você pode selecionar essa opção e colar o conteúdo JSON do perfil copiado no bloco de notas.
Faça upload do arquivo de perfil JSON e crie uma assinatura do provedor de compartilhamento.
Clique em Próximo para avançar para a guia Adicionar Compartilhamentos. - Na guia Adicionar Compartilhamentos da caixa de diálogo, você verá a lista de compartilhamentos disponíveis. Clique no compartilhamento que você deseja consumir dos Compartilhamentos Disponíveis e selecione qualquer uma das opções disponíveis:
Descrição da ilustração subscribe-share-provider-version-addshares.png- >: Esta opção permite que você mova o Compartilhamento Disponível para Compartilhamentos Selecionados.
- <: Selecione esta opção para remover o compartilhamento selecionado dos Compartilhamentos Selecionados.
- >>: Esta opção permite que você mova todos os compartilhamentos para a tela Compartilhamentos Selecionados.
- <<: Selecione esta opção para remover todos os compartilhamentos selecionados dos Compartilhamentos Selecionados.
-
Clique em Inscrever-se para adicionar o compartilhamento. Um prompt de confirmação é exibido quando o profissional de saúde é criado com êxito. Após a criação bem-sucedida do provedor, agora você verá a tela Vincular Objeto de Nuvem da página Carga de Dados.
- Você pode exibir o nome do provedor de Compartilhamento no campo de local de armazenamento na nuvem. O compartilhamento aparece no local do arquivo de origem com os arquivos adicionados ao compartilhamento.
Descrição da ilustração link-cloud-object.pngExpanda o carrinho de pastas Compartilhar, arraste e solte o arquivo que você compartilha da origem para o carrinho Link de Dados.
Selecione Iniciar no carrinho de link de Dados para executar o job de link de dados.
- Exiba as tabelas criadas no Database Actions.
- Clique em Database Actions, na trilha de navegação, para voltar ao inicializador do Database Actions.
- Clique no mosaico SQL.
- Selecione a tabela externa, arraste-a e solte-a na planilha.
A instrução SQL Select da tabela é exibida. Esta instrução SQL pode ser executada para consumir os dados compartilhados.
Descrição da ilustração xt_sql.png
Tópico principal: Consumir Compartilhamento
Consumir Compartilhamento ao Vivo
Os dados em tempo real compartilhados com você por meio do compartilhamento de dados não estão automaticamente disponíveis para consumo.
Para consumir compartilhamentos de dados ao vivo, você precisa se inscrever neles e criar views de tabelas incluídas no compartilhamento ao vivo. As views podem ser consultadas usando scripts SQL.
- Abra a página Compartilhamento de Consumo e clique em + Inscrever-se no Provedor de Compartilhamento para selecionar Inscrever-se no Provedor de Compartilhamento Ativo na lista drop-down. Isso abre a caixa de diálogo Inscrever para compartilhar profissional de saúde.
- No painel Definições do Provedor da caixa de diálogo Inscrever-se no Provedor de Compartilhamento, especifique os seguintes detalhes:
Descrição da ilustração subscribe-live-share-provider.pngNa seção Origem do Compartilhamento, escolha Selecionar em Provedores de Compartilhamento Ativos e selecione o provedor na lista drop-down.
No campo Compartilhar detalhes do profissional de saúde, informe o seguinte:- Nome do Provedor: Especifique o nome do provedor.
- Descrição: Informe uma descrição do Provedor.
Clique em Próximo para avançar para a guia Adicionar Compartilhamentos.
- Na guia Adicionar Compartilhamentos da caixa de diálogo, você verá a lista de compartilhamentos disponíveis. Clique no compartilhamento que você deseja consumir dos Compartilhamentos Disponíveis e selecione qualquer uma das opções disponíveis:
Descrição da ilustração add-shares.png- >: Esta opção permite que você mova o Compartilhamento Disponível para Compartilhamentos Selecionados.
- <: Selecione esta opção para remover o compartilhamento selecionado dos Compartilhamentos Selecionados.
- >>: Esta opção permite que você mova todos os compartilhamentos para a tela Compartilhamentos Selecionados.
- <<: Selecione esta opção para remover todos os compartilhamentos selecionados dos Compartilhamentos Selecionados.
Clique em Inscrever-se para adicionar o compartilhamento. Um prompt de confirmação é exibido quando o profissional de saúde é criado com êxito. Após a criação bem-sucedida do provedor, agora você verá a tela Vincular Objeto de Nuvem da página Carga de Dados.
- Você pode exibir o nome do provedor de Compartilhamento no campo de local de armazenamento na nuvem. O compartilhamento aparece no local do arquivo de origem com os arquivos adicionados ao compartilhamento.
Descrição da ilustração link-cloud-object.pngExpanda o carrinho de pastas Compartilhar, arraste e solte o arquivo que você compartilha da origem para o carrinho Link de Dados.
Selecione Iniciar no carrinho de link de Dados para executar o job de link de dados.
Tópico principal: Consumir Compartilhamento
Exibir Detalhes da Entidade do Provedor de Compartilhamento
Para exibir detalhes sobre a entidade Compartilhar Provedor, clique no ícone Ações à direita da entrada da entidade Compartilhar Provedor e clique em Exibir Detalhes.
Para todas as entidades, os detalhes incluem as seções Linhagem e Impacto.
Para uma entidade do Provedor de Compartilhamento específica, você pode executar as ações a seguir usando o menu de contexto Ações.
- Exibir Detalhes: Consulte Exibir Detalhes da Entidade do Provedor de Compartilhamento.
- Gerenciar Compartilhamentos: Abre uma caixa de diálogo Gerenciar Compartilhamentos para o provedor de Compartilhamento. Isso lista os compartilhamentos que você seleciona para compartilhar com o destinatário. Você pode editar a lista de compartilhamentos que deseja compartilhar com o destinatário. Clique em OK para salvar as alterações ou selecione Cancelar para descartar o processo de edição.
- Renomear: Renomeia o Nome do Provedor. Selecione Sim para fazer alterações; caso contrário, clique em Não.
- Excluir: Remove a Entidade do Provedor de Compartilhamento.
- Carregar Tabelas: Você é direcionado para a página Carregar Dados com a guia Compartilhar selecionada.
- Tabelas de Links: Você é direcionado para a página Vincular Dados com a guia Compartilhar selecionada para exibir e executar o objeto de link relacionado. Arraste e solte os dados compartilhados para adicioná-los ao job de link de dados.
Tópico principal: Consumir Compartilhamento