Lister les liens hypertexte de table, les groupes et les membres de groupe

Vous pouvez répertorier les liens hypertexte de table, les groupes de liens hypertexte de table et les membres de groupe de liens hypertexte de table actifs.

Lister les liens hypertexte de table et les groupes de liens hypertexte de table

Vous pouvez répertorier les liens hypertexte de table actifs que vous avez générés sur une instance Autonomous Database et l'utilisateur ADMIN peut répertorier tous les liens hypertexte de table actifs. La liste des liens hypertexte de table inclut les groupes de liens hypertexte de table.

Exécutez DBMS_DATA_ACCESS.LIST_ACTIVE_URLS pour répertorier les liens hypertexte de table et les groupes de liens hypertexte de table actifs. Par exemple :

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

Cet exemple présente la sortie suivante :

[{"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"}]

Lorsqu'une entrée de liste Lien hypertexte de table est un groupe de liens hypertexte de table, "is_group_url" s'affiche avec la valeur true. Par exemple :

{
"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]
}
Remarque

Lorsque la valeur is_group_url est true, cela indique qu'un ID de lien hypertexte de table est un groupe de liens hypertexte de table.

Pour plus d'informations, reportez-vous à Fonction LIST_ACTIVE_URLS.

Membres de groupe de liens hypertexte de table de liste

Vous pouvez répertorier les membres d'un groupe de liens hypertexte de table.

Remarque

Pour répertorier les membres d'un groupe de liens hypertexte de table, vous devez fournir le groupe de liens hypertexte de table id.

Exécutez DBMS_DATA_ACCESS.LIST_MEMBERS pour répertorier les membres du groupe de liens hypertexte de table.

Par exemple :

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

La sortie suivante s'affiche :

{ "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"}
  ]
}

Pour plus d'informations, reportez-vous à Fonction LIST_ACTIVE_URLS et Procédure LIST_MEMBERS.

Notes pour la liste des liens hypertexte de table et des groupes de liens hypertexte de table

Fournit des notes pour répertorier les liens hypertexte de table et les groupes de liens hypertexte de table.

Remarques concernant l'exécution de DBMS_DATA_ACCESS.LIST_ACTIVE_URLS :

  • Le comportement de DBMS_DATA_ACCESS.LIST_ACTIVE_URLS dépend de l'appelant. Si l'appelant est ADMIN ou un utilisateur doté du rôle PDB_DBA, la fonction répertorie tous les liens hypertexte de table actifs, quel que soit l'utilisateur qui a généré le lien hypertexte de table. Si l'appelant n'est pas l'utilisateur ADMIN et n'est pas un utilisateur doté du rôle PDB_DBA, la liste inclut uniquement les liens hypertexte de table actifs générés par l'appelant.

  • Lorsque vous générez et répertoriez un lien hypertexte de table sur une instance Autonomous Database avec une adresse privée, le résultat inclut un nom private_preauth_url avec la valeur du format : "https://private-endpoint/adb/p/parurl-token/data".

    Lorsque vous générez et répertoriez un lien hypertexte de table sur une instance Autonomous Database avec une adresse privée et que l'adresse privée est configurée avec l'option Autoriser l'accès public activée, le résultat inclut à la fois l'adresse preauth_url pour l'adresse publique et private_preauth_url.

    Pour plus d'informations, reportez-vous à Configuration des adresses privées et à Utilisation d'une adresse privée avec accès public autorisé.

  • Lorsqu'un lien hypertexte de table est un membre de groupe, l'entrée de réponse DBMS_DATA_ACCESS.LIST_ACTIVE_URLS affiche "group_ids" avec une valeur non NULL qui inclut un ou plusieurs ID. Les ID affichent les ID de groupe de liens hypertexte de table dont le lien hypertexte de table (membre du groupe) est membre.