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

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

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インスタンスで表ハイパーリンクを生成およびリストする場合、結果には、フォームの値を含む名前private_preauth_urlが含まれます: "https://private-endpoint/adb/p/parurl-token/data"。

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

詳細については、「プライベート・エンドポイントの構成」と「パブリック・アクセスが許可されたプライベート・エンドポイントの使用」を参照してください。
表ハイパーリンクがグループ・メンバーである場合、DBMS_DATA_ACCESS.LIST_ACTIVE_URLSレスポンス・エントリには、1つ以上のIDを含むnull以外の値を含む"group_ids"が表示されます。 IDには、表ハイパーリンク(グループ・メンバー)がメンバーである表ハイパーリンク・グループIDが表示されます。