Oracle Cloud Infrastructureドキュメント

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

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

親トピック: Autonomous Databaseでの読取り専用データ・アクセスでの表ハイパーリンクの使用

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

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

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

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

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_urlとprivate_preauth_urlの両方が含まれます。

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

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