Oracle Cloud Infrastructure-Dokumentation

Hyperlinks, Gruppen und Gruppenmitglieder auflisten

Sie können die aktiven Tabellen-Hyperlinks, Tabellen-Hyperlink-Gruppen und Tabellen-Hyperlink-Gruppen auflisten.

Übergeordnetes Thema: Tabellenhyperlinks für schreibgeschützten Datenzugriff in Autonomous Database verwenden

Hyperlinks und Hyperlinkgruppen für Listentabellen

Sie können die aktiven Tabellen-Hyperlinks auflisten, die Sie in einer Autonomous Database-Instanz generiert haben, und der ADMIN-Benutzer kann alle aktiven Tabellen-Hyperlinks auflisten. Die Liste der Tabellen-Hyperlinks enthält Tabellen-Hyperlink-Gruppen.

Führen Sie DBMS_DATA_ACCESS.LIST_ACTIVE_URLS aus, um die aktiven Tabellen-Hyperlinks und Tabellen-Hyperlinkgruppen aufzulisten. Beispiel: 

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

Dieses Beispiel zeigt die folgende Ausgabe:

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

Wenn ein Tabellen-Hyperlink-Listeneintrag eine Tabellen-Hyperlink-Gruppe ist, wird "is_group_url" mit dem Wert true angezeigt. Beispiel: 

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

Wenn der Wert für is_group_url true lautet, gibt dies an, dass eine Tabellen-Hyperlink-ID eine Tabellen-Hyperlinkgruppe ist.

Weitere Informationen finden Sie unter Funktion LIST_ACTIVE_URLS.

Hyperlinkgruppenmitglieder für Listentabelle

Sie können die Elemente einer Tabellen-Hyperlink-Gruppe auflisten.

Hinweis

Um die Elemente einer Tabellen-Hyperlinkgruppe aufzulisten, müssen Sie die Tabellen-Hyperlinkgruppe id angeben.

Führen Sie DBMS_DATA_ACCESS.LIST_MEMBERS aus, um die Elemente der Tabellen-Hyperlinkgruppe aufzulisten.

Beispiel:

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

Die folgende Ausgabe wird angezeigt:

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

Weitere Informationen finden Sie unter Funktion LIST_ACTIVE_URLS und Prozedur LIST_MEMBERS.

Hinweise zum Auflisten von Tabellen-Hyperlinks und Tabellen-Hyperlink-Gruppen

Enthält Hinweise zum Auflisten von Tabellen-Hyperlinks und Tabellen-Hyperlink-Gruppen.

Hinweise zur Ausführung von DBMS_DATA_ACCESS.LIST_ACTIVE_URLS:

  • Das Verhalten von DBMS_DATA_ACCESS.LIST_ACTIVE_URLS hängt vom ausführenden Benutzer ab. Wenn der ausführende Benutzer ADMIN oder ein Benutzer mit der Rolle PDB_DBA ist, listet die Funktion alle aktiven Tabellen-Hyperlinks auf, unabhängig vom Benutzer, der den Tabellen-Hyperlink generiert hat. Wenn der ausführende Benutzer nicht der ADMIN-Benutzer und kein Benutzer mit der Rolle PDB_DBA ist, enthält die Liste nur die aktiven Tabellen-Hyperlinks, die vom ausführenden Benutzer generiert werden.

  • Wenn Sie einen Tabellen-Hyperlink in einer Autonomous Database-Instanz mit einem privaten Endpunkt generieren und auflisten, enthält das Ergebnis den Namen private_preauth_url mit dem Wert des folgenden Formulars: "https://private-endpoint/adb/p/parurl-token/data".

    Wenn Sie einen Tabellen-Hyperlink in einer Autonomous Database-Instanz mit einem privaten Endpunkt generieren und auflisten und der private Endpunkt mit aktiviertem Öffentlichen Zugriff zulassen konfiguriert ist, enthält das Ergebnis sowohl die preauth_url für den öffentlichen Endpunkt als auch die private_preauth_url.

    Weitere Informationen finden Sie unter Private Endpunkte konfigurieren und Privaten Endpunkt mit zulässigem öffentlichem Zugriff verwenden.

  • Wenn ein Tabellen-Hyperlink ein Gruppenmitglied ist, zeigt der DBMS_DATA_ACCESS.LIST_ACTIVE_URLS-Antworteintrag "group_ids" mit einem Wert ungleich null an, der mindestens eine ID enthält. Die IDs zeigen die Tabellen-Hyperlink-Gruppen-IDs an, zu denen der Tabellen-Hyperlink (Gruppenmitglied) gehört.