Lista Hiperlinks da Tabela, Grupos e Membros do Grupo

Você pode listar os membros ativos Hiperlinks de Tabela, Grupos de Hiperlink de Tabela e Grupo de Hiperlink de Tabela.

Hiperlinks de Tabela de Lista e Grupos de Hiperlinks de Tabela

Você pode listar os Hiperlinks de Tabela ativos que gerou em uma instância do Autonomous Database e o usuário ADMIN pode listar todos os Hiperlinks de Tabela ativos. A listagem de Hiperlinks de Tabela inclui Grupos de Hiperlinks de Tabela.

Execute DBMS_DATA_ACCESS.LIST_ACTIVE_URLS para listar os Hiperlinks de Tabela e os Grupos de Hiperlink de Tabela ativos. Por exemplo:

DECLARE    
    result CLOB;
    BEGIN
       result := DBMS_DATA_ACCESS.LIST_ACTIVE_URLS;           
       dbms_output.put_line(result);
    END;
/

Este exemplo mostra a seguinte saída:

[{"id":"pT36lYHFGA4s3UXSNBCRO13v3D4_example1",
"created_by":"SCOTT",
"service_name":"HIGH",
"expiration_time":"2025-07-28T16:38:02.723Z",
"expiration_count":10,
"access_count":0,
"created":"2025-04-29T16:38:02.977Z",
"inherit_acl":true,
"sql_statement":"select * FROM TREE_DATA WHERE COUNTY = :county"}]

Quando uma entrada da lista de Hiperlinks de Tabela é um Grupo de Hiperlinks de Tabela, o "is_group_url" é mostrado com o valor true. Por exemplo:

{
"id":"vnns6DhPUBXyB1bzUtTOoPUcqnDcpplRo_example",
"created_by":"SCOTT",
"service_name":"HIGH",
"expiration_time":"2025-09-04T15:36:39.355Z",
"expiration_count":10,
"access_count":0,
"created":"2025-06-06T15:36:39.377Z",
"is_group_url":true,
"group_ids":[null]
}
Observação

Quando o valor is_group_url é true, isso indica que um id de Hiperlink de Tabela é um Grupo de Hiperlink de Tabela.

Consulte Função LIST_ACTIVE_URLS para obter mais informações.

Membros do Grupo de Hiperlinks da Tabela da Lista

Você pode listar os membros de um Grupo de Hiperlinks de Tabela.

Observação

Para listar os membros de um Grupo de Hiperlinks de Tabela, você precisa fornecer o Grupo de Hiperlinks de Tabela id.

Execute DBMS_DATA_ACCESS.LIST_MEMBERS para listar os membros do Grupo de Hiperlinks da Tabela.

Por exemplo:

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.LIST_MEMBERS(
         id => 'aGnHVyZ4vBo4_Fq2R0A2G2-y6TdUKRHeveqyGJ3_example',
         result => status);           
      dbms_output.put_line(status);
    END;
/

Isso mostra a seguinte saída:

{ "members" :
  [
    {"id" : "lVy_kJnm5MzO1EGBYBvdcaYark5waukv7V59wObq5RDS2Z2AlzEh_DmaboSNeCfR", "schema_name" : "admin", "schema_object_name" : "employee", "name" : "employee", "description" : "employee description"},
    {"id" : "8L5QWWVDB3NrGu-NLx6Q-k-1EsP6jxmjednfMxgrbVFolPipNNDbL1rIt2Ywwprc", "sql_statement" : "select * from admin.tree", "name" : "tree", "description" : "tree description"}
  ]
}

Consulte Função LIST_ACTIVE_URLS e Procedimento LIST_MEMBERS para obter mais informações.

Observações para Listar Hiperlinks de Tabela e Grupos de Hiperlinks de Tabela

Fornece observações para listar Hiperlinks de Tabela e Grupos de Hiperlinks de Tabela.

Observações para executar DBMS_DATA_ACCESS.LIST_ACTIVE_URLS:

  • O comportamento de DBMS_DATA_ACCESS.LIST_ACTIVE_URLS depende do chamador. Se o chamador for ADMIN ou qualquer usuário com a função PDB_DBA, a função listará todos os Hiperlinks de Tabela ativos, independentemente do usuário que gerou o Hiperlink de Tabela. Se o chamador não for o usuário ADMIN e não um usuário com a atribuição PDB_DBA, a lista incluirá apenas os Hiperlinks de Tabela ativos gerados pelo chamador.

  • Quando você gera e lista um Hiperlink 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 e lista um Hiperlink 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.

  • Quando um Hiperlink de Tabela é um membro do grupo, a entrada de resposta DBMS_DATA_ACCESS.LIST_ACTIVE_URLS mostra "group_ids" com um valor não nulo que inclui um ou mais IDs. Os IDs mostram os IDs do Grupo de Hiperlinks da Tabela dos quais o Hiperlink da Tabela (membro do grupo) é membro.