Quando você acessa um Grupo de Hiperlinks de Tabela, ele usa os privilégios concedidos ao usuário do banco de dados que cria o Grupo de Hiperlinks de Tabela. O usuário que cria um Grupo de Hiperlinks de Tabela deve ter os privilégios mínimos necessários para fornecer acesso aos dados. Para manter a segurança, a Oracle recomenda que você não execute DBMS_DATA_ACCESS.CREATE_URL como usuário ADMIN.

Para criar um Grupo de Hiperlinks de Tabela:

Observações para criar um Grupo de Hiperlinks de Tabela:

• O result inclui o valor preauth_url é o URL que você usa para acessar o Grupo de Hiperlinks da Tabela. Consulte Usar um Grupo de Hiperlinks de Tabela para Acessar Dados para obter mais informações.

• Quando você gera um Grupo de Hiperlinks de Tabela em uma instância do Autonomous Database com um ponto final privado, o resultado inclui um nome private_preauth_url com o valor do formato: "https://private-endpoint/adb/p/parurl-token/data".

  Quando você gera um Grupo de Hiperlinks de Tabela em uma instância do Autonomous Database com um ponto final privado e o ponto final privado é configurado com a opção Permitir acesso público ativada, o resultado inclui o preauth_url para o ponto final público e o private_preauth_url.

  Consulte Configurar Pontos Finais Privados e Usar um Ponto Final Privado com Acesso Público Permitido para obter mais informações.

• Use DBMS_DATA_ACCESS.EXTEND_URL para estender a vida útil de um Grupo de Hiperlinks de Tabela. Quando você executa DBMS_DATA_ACCESS.EXTEND_URL com um id para um Grupo de Hiperlinks de Tabela, isso só estende a expiração dos membros adicionados quando você cria o grupo com DBMS_DATA_ACCESS.CREATE_URL (isso não inclui Hiperlinks de Tabela adicionados com DBMS_DATA_ACCESS.ADD_MEMBER). Os Hiperlinks de Tabela adicionados com DBMS_DATA_ACCESS.ADD_MEMBER também existem independentemente fora do contexto do Grupo de Hiperlinks de Tabela e você pode executar DBMS_DATA_ACCESS.EXTEND_URL independentemente nesses Hiperlinks de Tabela.

  Consulte EXTEND_URL Procedures para obter mais informações.

• Consulte Observações para Criar um Hiperlink de Tabela para obter informações adicionais sobre parâmetros opcionais para DBMS_DATA_ACCESS.CREATE_URL.

Use DBMS_DATA_ACCESS.ADD_MEMBER para adicionar um Hiperlink de Tabela existente a um grupo. Por exemplo:

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.ADD_MEMBER(
        id => 'Vd1Px7QWASdqDbnndiuwTAyyEstv82PCHqS_example',
        member_id => 'Zdd1Px7QWASdqDbnndiuwTAyyEstv82PCHlS_example',
        result => status);           
       dbms_output.put_line(status);
    END;
/

Os parâmetros são:

• id: especifica o ID do Grupo de Hiperlinks da Tabela. Este é o valor id mostrado no resultado quando você cria um Grupo de Hiperlinks de Tabela. Consulte Criar um Grupo de Hiperlinks de Tabela para obter mais informações.

• member_id: especifica um ID de Hiperlink de Tabela existente a ser adicionado ao grupo. O valor member_id não pode ser um ID do Grupo de Hiperlinks da Tabela (is_group_url deve ser false). Consulte Listar Hiperlinks de Tabela e Grupos de Hiperlinks de Tabela para obter mais informações.

• result: fornece JSON que indica o resultado da operação.

Consulte ADD_MEMBER Procedures para obter mais informações.

Use DBMS_DATA_ACCESS.REMOVE_MEMBER para remover um membro de um Grupo de Hiperlinks de Tabela. Por exemplo:

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.REMOVE_MEMBER(
        id => 'Vd1Px7QWASdqDbnndiuwTAyyEstv82PCHqS_example',
        member_id => 'Zdd1Px7QWASdqDbnndiuwTAyyEstv82PCHlS_example',
        result => status);           
       dbms_output.put_line(status);
    END;
/

Os parâmetros são:

• id: especifica o ID do Grupo de Hiperlinks da Tabela. Este é o valor id mostrado no resultado quando você cria um Grupo de Hiperlinks de Tabela. Consulte Criar um Grupo de Hiperlinks de Tabela para obter mais informações.

• member_id: especifica o ID do membro a ser removido do Grupo de Hiperlinks da Tabela.

• result: fornece JSON que indica o resultado da operação.

Notas para remover um membro:

• O valor member_id não pode ser um ID do Grupo de Hiperlinks da Tabela (is_group_url deve ser false). Consulte Observações para Listar Hiperlinks de Tabela e Grupos de Hiperlinks de Tabela para obter mais informações.

• Você pode usar DBMS_DATA_ACCESS.LIST_MEMBERS para listar os membros de um Grupo de Hiperlinks de Tabela. Consulte Observações para Listar Hiperlinks de Tabela e Grupos de Hiperlinks de Tabela para obter mais informações.

• Se o membro removido for um Hiperlink de Tabela existente que foi adicionado ao grupo usando DBMS_DATA_ACCESS.ADD_MEMBER, o membro será removido do grupo, mas o Hiperlink de Tabela poderá ser acessado diretamente até que seja explicitamente invalidado ou expire.

• Se um Grupo de Hiperlink de Tabela contiver apenas um membro e esse membro for removido, o grupo será invalidado.

Consulte REMOVE_MEMBER Procedures para obter mais informações.

Use DBMS_DATA_ACCESS.INVALIDATE_URL para invalidar um Grupo de Hiperlinks de Tabela. Por exemplo:

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.INVALIDATE_URL(
        id => 'Vd1Px7QWASdqDbnndiuwTAyyEstv82PCHqS_example',
        result => status);           
       dbms_output.put_line(status);
    END;
/

Os parâmetros são:

• id: especifica o ID do Grupo de Hiperlinks da Tabela. Este é o valor id mostrado no resultado quando você cria um Grupo de Hiperlinks de Tabela. Consulte Criar um Grupo de Hiperlinks de Tabela para obter mais informações.

• result: fornece JSON que indica o resultado da operação.

Consulte INVALIDATE_URL Procedures para obter mais informações.