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 AI 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" : "tCz2IRLIaDDymwOe1o105WQMGtyw4Z_0mGwfbv0ARcjI5SPkzR_YZJhxyz",
    "created_by" : "SCOTT",
    "service_name" : "LOW",
    "expiration_time" : "2025-08-12T04:41:
05.115Z",
    "access_count" : 0,
    "created" : "2025-08-11T22:41:05.141Z",
    "schema_name" : "ADMIN",
    "schema_object_name" : "TREE_DATA",
    "column_lists" :
    {
      "order_by_columns" :
      [
        "COUNTY",
        "SPECIES"
      ]
    }
  },
  {
    "id" : "5dvYnMAJw2M1VFhTNUuqKF1kTtNmerJ0xRL0hRSkZ9pzxyz",
    "created_by" : "SCOTT",
    "service_name" : "LOW",
    "expiration_time" : "2025-08-12T04:33:40.162Z",
    "access_count" : 0,
    "created" : "2025-08-11T22:33:40.182Z",
    "sql_statement" : "SELECT species, height FROM TREE_DATA"
  },
  {
    "id" : "vnns6DhPUBXyB1bzUtTOoPUcqnDcpplRo_-byHiPQFLuhTp6XeAawxyz",
    "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
  }
]

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_-byHiPQFLuhTabc",
    "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
  },
  {
    "id" : "g8a3fKVZDZjqKAYLOgXjEVjFcdHGAO1PbBOzGRZZrcJP5au_NAabc",
    "created_by" : "SCOTT",
    "service_name" : "LOW",
    "expiration_time" : "2025-08-12T06:12:08.449Z",
    "access_count" : 0,
    "created" : "2025-08-12T00:12:08.472Z",
    "is_group_url" : true
  }
]

Observação

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

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 LISTA_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 AI 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 AI 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.