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 Compartilhamento de Consumo:
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á baixar seu perfil de compartilhamento, assinar o provedor de compartilhamento de dados, registrar os compartilhamentos e criar tabelas externas em cima de seus compartilhamentos. A ferramenta de Compartilhamento de Dados autoriza o acesso usando o perfil JSON enviado ao destinatário usando o e-mail de ativação. Após a concessão do acesso, 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 Live Share:
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 da 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 da lista de provedores de compartilhamento, pesquisa por provedores de compartilhamento e adiciona um provedor de compartilhamento. - Consumir Compartilhamento com Controle de Versão
Siga estas etapas para disponibilizar dados com controle de versão compartilhados 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 o Live Share
Os dados em tempo real 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 Compartilhar Provedor, clique no ícone Ações à direita da entrada da entidade Compartilhar Provedor e clique em Exibir Detalhes.
Tópico principal: Ferramenta de compartilhamento de dados
Visão Geral do Compartilhamento de Consumo
O Compartilhamento de Consumo fornece uma visão geral da lista de provedores de compartilhamento, pesquisa por provedores de compartilhamento e adicionar um provedor de compartilhamento.
- No menu do Data Studio, selecione Compartilhar Consumo no menu Compartilhamento de Dados.
- Na página Compartilhamento de Dados, clique no widget Compartilhar Consumo presente na seção Provedor e Consumidor.
A página Compartilhamento de Consumo contém:
Descrição da ilustração consum-share-new.png
- Provedores de Compartilhamento ao Vivo 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 conforme seu desejo. Você também pode se inscrever no Live Share usando o sinal + à direita dos Compartilhamentos listados em Compartilhamentos disponíveis nos últimos 7 dias.
-
Campo Pesquisar Provedor de Compartilhamento Inscrito
Você pode procurar o Destinatário de Compartilhamento criado inserindo o nome do Provedor de Compartilhamento Inscrito. Informe o nome do Provedor de Compartilhamento Inscrito, por exemplo, REVIEW_PROVIDER e clique no ícone amplificador para concluir a pesquisa. A ferramenta Compartilhar exibe os resultados da pesquisa na área de exibição.
- Selecione + Inscrever-se para Compartilhar Provedor para se inscrever em um novo Provedor de Compartilhamento. Consulte Inscrever-se para Compartilhar Provedor 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
Ao definir valores de classificação usando o controle Classificar por na barra de ferramentas, as configurações são exibidas em pequenas caixas abaixo da barra de ferramentas. Você pode excluir uma definição clicando no ícone X na caixa. Ou 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 definindo valores de classificação.
Tópico principal: Compartilhar Consumo
Consumir Compartilhamento com Versão
Siga estas etapas para disponibilizar dados com controle de versão compartilhados 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.
- Registrar ações disponibilizadas para você.
- Crie tabelas externas sobre seus compartilhamentos.
Sobre o Perfil JSON
Arquivos de perfil são arquivos JSON que contêm as credenciais de um usuário para acessar um Delta Sharing Server. Isso permite que você se autentique com o servidor de compartilhamento delta e descubra os compartilhamentos de dados que você pode 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 o levará a uma nova tela no navegador com um botão Obter Informações do Perfil, conforme mostrado abaixo:

Descrição da ilustração Json-profile.png
Você só pode clicar no botão Obter Informações do Perfil 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. Clicar nele duas vezes abre 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 do token ao 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 a expiração da autenticação.
- 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.
Aprimoramentos 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 privilegiado. Isso permite que você acesse o compartilhamento via Internet.
Isso deve ser feito antes de usar o Assistente 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) chamado, 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 do 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 suas descrições:
- host- Especifica o nome ou o endereço IP do host. O nome do host ou do domínio não faz distinção entre maiúsculas e minúsculas.
- porta inferior- Especifica a porta inferior de um intervalo 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) para o qual o privilégio é concedido ou negado. Faz distinção entre maiúsculas e minúsculas.
- principal_type- Especifica o tipo de principal que você usa.
Para obter mais detalhes sobre os subprogramas do pacote DBMS_NETWORK_ACL_ADMIN
, consulte o documento PL/SQL Packages and Types Reference.
PRIV_ORDS_ACL CONSTANT PLS_INTEGER := 8;
Neste 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 Assinar 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 Compartilhar Origem, escolha Delta Share Provider JSON.
Em Compartilhar JSON do Provedor, 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 fez download.
- JSON: Você pode selecionar essa opção e colar o conteúdo JSON do perfil que você copia 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 mover 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 provedor é criado com êxito. Após a criação bem-sucedida do provedor, você verá a tela Vincular Objeto do Cloud da página Carregamento de Dados.
- Você pode exibir o nome do provedor de Compartilhamento no campo de local de armazenamento em nuvem. O compartilhamento aparece no local do arquivo de origem com os arquivos que você adiciona ao compartilhamento.
Descrição da ilustração link-cloud-object.pngExpanda o carrinho de pasta Compartilhar, arraste e solte o arquivo que você compartilha da origem para o carrinho de Link de Dados.
Selecione Iniciar no carrinho de links de Dados para executar o job de link de dados.
- Exiba as tabelas criadas no Database Actions.
- Clique no Database Actions, na trilha de navegação estrutural, para voltar ao inicializador do Database Actions.
- Clique no bloco 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: Compartilhar Consumo
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 visualizações podem ser consultadas usando scripts SQL.
- Abra a página Compartilhar Consumo e clique em + Inscrever-se no Provedor de Compartilhamento para selecionar Inscrever-se no Provedor de Compartilhamento ao Vivo na lista drop-down. Isso abre a caixa de diálogo Assinar para compartilhar profissional de saúde.
- No painel Definições do Provedor da caixa de diálogo Inscrever-se para Compartilhar Provedor, especifique os seguintes detalhes:
Descrição da ilustração subscribe-live-share-provider.pngNa seção Compartilhar Origem, escolha Selecionar em Provedores de Compartilhamento ao Vivo e selecione o provedor na lista drop-down.
No campo Compartilhar detalhes do profissional de saúde, insira 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 deseja consumir nos Compartilhamentos Disponíveis e selecione qualquer uma das opções disponíveis:
Descrição da ilustração add-shares.png- >: Esta opção permite mover 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 provedor é criado com êxito. Após a criação bem-sucedida do provedor, você verá a tela Vincular Objeto do Cloud da página Carregamento de Dados.
- Você pode exibir o nome do provedor de Compartilhamento no campo de local de armazenamento em nuvem. O compartilhamento aparece no local do arquivo de origem com os arquivos que você adiciona ao compartilhamento.
Descrição da ilustração link-cloud-object.pngExpanda o carrinho de pasta Compartilhar, arraste e solte o arquivo que você compartilha da origem para o carrinho de Link de Dados.
Selecione Iniciar no carrinho de links de Dados para executar o job de link de dados.
Tópico principal: Compartilhar Consumo
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, em seguida, 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 do provedor Gerenciar Compartilhamentos para 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 qualquer alteração 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 Link: 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: Compartilhar Consumo