Documentation sur Oracle Cloud Infrastructure

Lister les hyperliens de table, les groupes et les membres de groupe

Vous pouvez répertorier les hyperliens de table actifs, les groupes d'hyperliens de table et les membres de groupe d'hyperliens de table.

Rubrique parent : Utiliser des hyperliens de table pour l'accès aux données en lecture seule dans une base de données d'IA autonome

Lister les hyperliens de table et les groupes d'hyperliens de table

Vous pouvez lister les hyperliens de table actifs que vous avez générés sur une instance de base de données d'intelligence artificielle autonome et l'utilisateur ADMIN peut lister tous les hyperliens de table actifs. La liste des hyperliens de table inclut les groupes d'hyperliens de table.

Exécutez DBMS_DATA_ACCESS.LIST_ACTIVE_URLS pour lister les hyperliens de table et les groupes d'hyperliens de table actifs. 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" : "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
  }
]

Lorsqu'une entrée de liste d'hyperliens de table est un groupe d'hyperliens de table, "is_group_url" s'affiche avec la valeur true. Exemple : 

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

Lorsque la valeur is_group_url est true, cela indique qu'un ID hyperlien de table est un groupe d'hyperliens de table.

Pour plus d'informations, voir Fonction LIST_ACTIVE_URLS.

Membres du groupe d'hyperliens de la table de liste

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

Note

Pour lister les membres d'un groupe d'hyperliens de table, vous devez fournir le groupe d'hyperliens de table id.

Exécutez DBMS_DATA_ACCESS.LIST_MEMBERS pour lister les membres du groupe d'hyperliens de table.

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, voir Fonction LIST_ACTIVE_URLS et Procédure LIST_MEMBERS.

Notes pour lister les hyperliens de table et les groupes d'hyperliens de table

Fournit des notes pour lister les hyperliens de table et les groupes d'hyperliens de table.

Notes pour 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 tout utilisateur doté du rôle PDB_DBA, la fonction liste tous les hyperliens de table actifs, quel que soit l'utilisateur qui a généré l'hyperlien 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 hyperliens de table actifs générés par l'appelant.

  • Lorsque vous générez et lister un hyperlien de table sur une instance de base de données de l'IA autonome avec un point d'extrémité privé, le résultat inclut un nom private_preauth_url avec la valeur du formulaire : "https://private-endpoint/adb/p/parurl-token/data".

    Lorsque vous générez et lister un hyperlien de table sur une instance de base de données de l'IA autonome avec un point d'extrémité privé et que le point d'extrémité privé est configuré avec l'option Autoriser l'accès public activée, le résultat inclut à la fois preauth_url pour le point d'extrémité public et private_preauth_url.

    Pour plus d'informations, voir Configurer des points d'extrémité privés et Utiliser un point d'extrémité privé avec accès public autorisé.

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