表のハイパーリンク、グループおよびグループ・メンバーのリスト

アクティブな表ハイパーリンク、表ハイパーリンク・グループおよび表ハイパーリンク・グループのメンバーをリストできます。

表ハイパーリンクおよび表ハイパーリンク・グループのリスト

Autonomous Databaseインスタンスで生成したアクティブな表ハイパーリンクをリストでき、ADMINユーザーはすべてのアクティブな表ハイパーリンクをリストできます。表のハイパーリンクのリストには、表のハイパーリンク・グループが含まれます。

DBMS_DATA_ACCESS.LIST_ACTIVE_URLSを実行して、アクティブな表ハイパーリンクおよび表ハイパーリンク・グループをリストします。たとえば:

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

この例は、次の出力を示しています。

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

表のハイパーリンク・リスト・エントリが表ハイパーリンク・グループの場合、is_group_urlは値trueとともに表示されます。たとえば:

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

is_group_url値がtrueの場合、表ハイパーリンクIDが表ハイパーリンク・グループであることを示します。

詳細は、LIST_ACTIVE_URLSファンクションを参照してください。

リスト表ハイパーリンク・グループ・メンバー

表ハイパーリンク・グループのメンバーをリストできます。

ノート

表ハイパーリンク・グループのメンバーをリストするには、表ハイパーリンク・グループidを指定する必要があります。

DBMS_DATA_ACCESS.LIST_MEMBERSを実行して、表ハイパーリンク・グループのメンバーをリストします。

たとえば:

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

次の出力が表示されます。

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

詳細は、LIST_ACTIVE_URLSファンクションおよびLIST_MEMBERSプロシージャを参照してください。

表ハイパーリンクおよび表ハイパーリンク・グループのリストに関するノート

表ハイパーリンクおよび表ハイパーリンク・グループをリストするためのノートを提供します。

DBMS_DATA_ACCESS.LIST_ACTIVE_URLSの実行に関するノート:

  • DBMS_DATA_ACCESS.LIST_ACTIVE_URLSの動作は、実行者によって異なります。実行者がADMINまたはPDB_DBAロールを持つユーザーの場合、表ハイパーリンクを生成したユーザーに関係なく、このファンクションはすべてのアクティブな表ハイパーリンクをリストします。実行者がADMINユーザーではなく、PDB_DBAロールを持つユーザーではない場合、リストには実行者によって生成されたアクティブな表ハイパーリンクのみが含まれます。

  • プライベート・エンドポイントを含むAutonomous Databaseインスタンスで表ハイパーリンクを生成してリストすると、結果には"https://private-endpoint/adb/p/parurl-token/data"という形式の値を持つprivate_preauth_urlという名前が含まれます。

    プライベート・エンドポイントを含むAutonomous Databaseインスタンスで表ハイパーリンクを生成してリストし、プライベート・エンドポイントが「パブリック・アクセスの許可」を有効にして構成されている場合、結果にはパブリック・エンドポイントのpreauth_urlprivate_preauth_urlの両方が含まれます。

    詳細は、プライベート・エンドポイントの構成およびパブリック・アクセスを許可したプライベート・エンドポイントの使用を参照してください。

  • 表ハイパーリンクがグループ・メンバーである場合、DBMS_DATA_ACCESS.LIST_ACTIVE_URLSレスポンス・エントリには、1つ以上のIDを含むnull以外の値を含むgroup_idsが表示されます。IDには、表ハイパーリンク(グループ・メンバー)がメンバーである表ハイパーリンク・グループIDが表示されます。