Tabellen-Hyperlinks erstellen, verwalten und überwachen

Zeigt die Schritte zum Erstellen eines Tabellen-Hyperlinks an, mit denen Sie den Zugriff für ein Schemaobjekt (Tabelle oder View) freigeben können.

1. Geben Sie die Tabelle oder View an, die Sie gemeinsam verwenden möchten.

   Wenn es Einschränkungen für die Daten gibt, die Sie zur Verfügung stellen möchten, verwenden Sie den Parameter application_user_id, wenn Sie den Tabellen-Hyperlink generieren, und erstellen Sie eine VPD-Policy, um die angezeigten Daten einzuschränken. Weitere Informationen finden Sie unter Policy für virtuelle private Datenbanken zum Sichern von Tabellen-Hyperlinkdaten definieren.

2. Führen Sie DBMS_DATA_ACCESS.CREATE_URL aus, um den Tabellen-Hyperlink zu generieren.

   DECLARE
      status CLOB;
      BEGIN
         DBMS_DATA_ACCESS.CREATE_URL(
             schema_name => 'SCOTT',
             schema_object_name    => 'TREE_DATA',
             expiration_minutes    => 360,
             result                => status);
          dbms_output.put_line(status);
       END;
   /

   Der Parameter expiration_minutes gibt an, dass der Tabellen-Hyperlink abläuft und nach 360 Minuten invalidiert wird.

   Weitere Informationen finden Sie unter Prozedur CREATE_URL.

3. Prüfen Sie das Ergebnis.

   In diesem Beispiel enthält status das Ergebnis, das Informationen zum Tabellen-Hyperlink enthält.

   {
     "status" : "SUCCESS",
     "id" : "wPY0uxyx-gioxOndiKVlqVF585xqJs14CIp9M1qHd-m8bqJi-QCahwfwGesG",
     "preauth_url" : "https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/Y0uxyx-gioxOndiKVlqVF585xqJs14CIp9M1qHhVJUCWm5OEG3fNq2m0HCjaMt8s/data",
     "expiration_ts" : "2025-08-12T04:30:41.484Z"
   }

Zeigt die Schritte zum Erstellen eines Tabellen-Hyperlinks an, der den Zugriff auf Daten mit einer SQL-Abfrageanweisung ermöglicht.

1. Identifizieren Sie die Tabelle oder View mit den Informationen, die Sie gemeinsam verwenden möchten, sowie die SELECT-Anweisung in der Tabelle oder View, die Sie verwenden möchten.

   Wenn es Einschränkungen für die Daten gibt, die Sie zur Verfügung stellen möchten, verwenden Sie den Parameter application_user_id, wenn Sie den Tabellen-Hyperlink generieren, und erstellen Sie eine VPD-Policy, um die angezeigten Daten einzuschränken. Weitere Informationen finden Sie unter Policy für virtuelle private Datenbanken zum Sichern von Tabellen-Hyperlinkdaten definieren.

2. Führen Sie DBMS_DATA_ACCESS.CREATE_URL aus, um den Tabellen-Hyperlink zu generieren.

   Sie haben zwei Optionen, je nachdem, ob Sie Default Bind-Variablenwerte aufnehmen möchten (wenn Sie Bind-Variablen in die SELECT-Anweisung aufnehmen).

   1. Geben Sie eine SELECT-Anweisung an, und verwenden Sie nicht den optionalen Parameter default_bind_values.

      Beispiel:

      DECLARE
         status CLOB;
         BEGIN
            DBMS_DATA_ACCESS.CREATE_URL(
                sql_statement        => 'SELECT species, height FROM TREE_DATA',
                expiration_minutes   => 360,
                result               => status);
             dbms_output.put_line(status);
          END;
      /

      Der Wert sql_statement muss eine SELECT-Anweisung sein. Die SELECT-Anweisung unterstützt Bind-Variablen. Wenn Bind-Variablen in der SELECT-Anweisung enthalten sind, müssen die Bind-Variablenwerte beim Zugriff auf die Daten als Abfrageparameter an den generierten Tabellen-Hyperlink angehängt werden.
   2. Geben Sie eine SELECT-Anweisung an, und nehmen Sie den Parameter default_bind_values auf.

      Beispiel:

      DECLARE
         status CLOB;
         BEGIN
            DBMS_DATA_ACCESS.CREATE_URL(
                sql_statement => 'select * FROM TREE_DATA WHERE COUNTY = :countyNAME',
                default_bind_values  => '{"countyNAME" : "First"}',
                expiration_minutes   => 360,
                result               => status);
             dbms_output.put_line(status);
          END;
      /

      Der Parameter sql_statement muss eine SELECT-Anweisung sein. Die SELECT-Anweisung unterstützt Bind-Variablen.

      Der Parameter default_bind_values gibt Werte für eine oder mehrere Bind-Variablen in sql_statement an. Wenn default_bind_values in DBMS_DATA_ACCESS.CREATE_URL enthalten ist:

      • Bei Bind-Variablen, die in default_bind_values angegeben sind, können Sie die Bind-Variablenwerte auslassen, wenn Sie auf die Daten zugreifen. Der Standardwert wird für eine angegebene Bind-Variable verwendet, wenn beim Zugriff auf die Daten kein Override in der Tabellen-Hyperlink-URL als Abfrageparameter angegeben ist.

      • Sie können einen in default_bind_values angegebenen Standard-Bind-Variablenwert außer Kraft setzen, wenn Sie den Wert der Bind-Variablen in der Tabellen-Hyperlink-URL als Abfrageparameter beim Zugriff auf die Daten anhängen.

      • Wenn in der SELECT-Anweisung eine Bind-Variable enthalten ist und im Parameter default_bind_values kein Standardwert für die Bind-Variable angegeben ist, müssen Sie beim Zugriff auf die Daten einen Bind-Variablenwert an die generierte Tabellen-Hyperlink-URL als Abfrageparameter anhängen.

   Die Unterstützung von Bind-Variablen ist für die Spaltentypen NUMBER und VARCHAR2 verfügbar.

   In diesen Beispielen gibt der Parameter expiration_minutes an, dass der Tabellen-Hyperlink abläuft und nach 360 Minuten invalidiert wird.

3. Prüfen Sie das Ergebnis.

   In diesem Beispiel enthält status das Ergebnis, das den Tabellen-Hyperlink enthält.

   {
     "status" : "SUCCESS",
     "id" : "LCvtpALqZgcHGL4Lxyzabcxyza-QVEFngwh1UGhg8jjuFAHOQJLGFi",
     "preauth_url" : "https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/GL4Lxyzabcxyza-QVEFngwh1UGhg8n4GfPaHCgdGoLJl-V1tTUxMDgdQ/data",
     "expiration_ts" : "2025-08-12T04:33:40.162Z"
   }

Wenn Sie einen Tabellen-Hyperlink erstellen, können Sie den Parameter column_lists verwenden, um UI-Features für angegebene Spalten anzugeben.

1. Geben Sie die Tabelle, View oder Select-Anweisung an, die Sie gemeinsam verwenden möchten.

   In diesem Beispiel wird ein Tabellen-Hyperlink mit dem Parameter column_lists und einer Tabelle generiert. Sie können diesen Parameter auch verwenden, wenn Sie einen Tabellen-Hyperlink mit einer SELECT-Anweisung generieren.

   Weitere Informationen finden Sie unter Tabellen-Hyperlink für eine Tabelle oder eine Ansicht erstellen und Tabellen-Hyperlink mit einer SELECT-Anweisung erstellen.

2. Führen Sie DBMS_DATA_ACCESS.CREATE_URL aus, um den Tabellen-Hyperlink zu generieren und die Option "Gruppieren nach Spalten" für die Anzeige mit einem Browser anzugeben:

   Beispiel: So geben Sie "Gruppieren nach Spalten" an:

   DECLARE
      status CLOB;
      BEGIN
         DBMS_DATA_ACCESS.CREATE_URL(
             schema_name => 'SCOTT',
             schema_object_name    => 'TREE_DATA',
             expiration_minutes    => 360,
             column_lists          => '{ "group_by_columns": ["COUNTY", "SPECIES"] }',
             result                => status);
   
          dbms_output.put_line(status);
       END;
   /

   Der Parameter column_lists ist JSON, der eine Liste von JSON-Arrays von Spalten enthält, die Tabellen-Hyperlink-Funktionalität definieren. Mit diesem Parameter können Sie die Spalten für eine oder mehrere der Optionen angeben: order_by_columns, filter_columns, default_color_columns oder group_by_columns.

   Beispiel:

   column_lists => '{ 
           "group_by_columns":["COUNTY", "SPECIES"], 
           "order_by_columns":["COUNTY"] }'

   Weitere Informationen finden Sie unter Prozedur CREATE_URL.

3. Prüfen Sie das Ergebnis.

   In diesem Beispiel enthält status das Ergebnis, das Informationen zum Tabellen-Hyperlink enthält.

   {
     "status" : "SUCCESS",
     "id" : "LLUZjJ5Yy8d0txydMiuxCVL_j4abc_xyzV198nGw-3yFYctMNm1p3atJr",
     "preauth_url" : "https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/-P46uQtYRt_yRfTxbcabc_xyzWlANP5RmM9Ys/data",
     "expiration_ts" : "2025-08-12T04:37:22.190Z"
   }
   

   Ein Beispiel für die Verwendung von Gruppen nach Spalten finden Sie unter Tabellenhyperlinks für den Zugriff auf Daten mit der Option "Gruppieren nach" im Tabellenformat verwenden.

4. Führen Sie DBMS_DATA_ACCESS.CREATE_URL aus, um den Tabellen-Hyperlink zu generieren, und geben Sie eine UI-Formatoption an.

   Beispiel: Um die sortierbaren Spalten festzulegen, verwenden Sie die Option column_lists order_by_columns:

   DECLARE
      status CLOB;
      column_lists CLOB;
      BEGIN
         DBMS_DATA_ACCESS.CREATE_URL(
             schema_name => 'SCOTT',
             schema_object_name    => 'TREE_DATA',
             expiration_minutes    => 360,
             column_lists          => '{ "order_by_columns": ["COUNTY", "SPECIES"] }',
             result                => status);
          dbms_output.put_line(status);
       END;
   /

   Der Parameter column_lists ist JSON, der eine Liste von JSON-Arrays von Spalten enthält, die Tabellen-Hyperlink-Funktionalität definieren. Mit diesem Parameter können Sie die Spalten für eine oder mehrere der Optionen angeben: order_by_columns, filter_columns, default_color_columns oder group_by_columns.

   Weitere Informationen finden Sie unter Prozedur CREATE_URL.

5. Prüfen Sie das Ergebnis.

   In diesem Beispiel enthält status das Ergebnis, das Informationen zum Tabellen-Hyperlink enthält.

   {
     "status" : "SUCCESS",
     "id" : "tCz2IRLIaDDymwOe1o105WQMGtyw4Z_0mGwfbv0ARcjI5SPkzR_xyz_abceyMgV",
     "preauth_url" : "https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/yfWQoyYxyz_abcGxQnCx0trQhH72m0HCjaMt8s/data",
     "expiration_ts" : "2025-08-12T04:41:05.115Z"
   }

   Ein Beispiel, das die Reihenfolge nach Spaltenverwendung anzeigt, finden Sie unter Tabellenhyperlinks im Tabellenformat mit Spaltensortierung verwenden.

Wenn Sie einen Tabellen-Hyperlink erstellen, können Sie ein Tabellen-Hyperlink-Kennwort angeben.

1. Geben Sie die Tabelle, die View oder die Abfrageanweisung für die Daten an, die Sie gemeinsam verwenden möchten.

   Sie können einen kennwortgeschützten Tabellen-Hyperlink oder eine Tabellen-Hyperlink-Gruppe angeben.

2. Wenn Sie einen Tabellen-Hyperlink oder eine Tabellen-Hyperlinkgruppe erstellen, geben Sie den Parameter password an.

   Beispiel:

   DECLARE
      status CLOB;
      BEGIN
         DBMS_DATA_ACCESS.CREATE_URL(
             schema_name => 'SCOTT',
             schema_object_name          => 'TREE_DATA',
             password                    => passwd,
             max_failed_access_attempts  => 15,
             result                      => status);
          dbms_output.put_line(status);
       END;
   /

   Der Parameter password gibt das Kennwort an, das für den Zugriff auf den Tabellen-Hyperlink (oder die Tabellen-Hyperlink-Gruppe) erforderlich ist. Zusätzlich zum Passwort gelten alle Sicherheitsmaßnahmen, die für einen Tabellen-Hyperlink gelten, wie Ablaufzeit und Ablaufanzahl, auch für einen kennwortgeschützten Tabellen-Hyperlink.

   Der Parameter max_failed_access_attempts gibt die maximale Anzahl an aufeinanderfolgenden fehlgeschlagenen Kennwortversuchen an. Wenn dieser Wert überschritten wird, wird der Tabellen-Hyperlink invalidiert. Der Standardwert für diesen Parameter ist 10. Die Anzahl der nacheinander nicht erfolgreichen Zugriffsversuche wird auf 0 zurückgesetzt, wenn der Benutzer das richtige Kennwort angibt.

   Weitere Informationen finden Sie unter Prozedur CREATE_URL.

3. Prüfen Sie das Ergebnis.

   In diesem Beispiel enthält status das Ergebnis, das Informationen zum Tabellen-Hyperlink enthält.

   {
     "status" : "SUCCESS",
     "id" : "wPY0uxyx-gioxOndiKVlqVF585xqJs14CIp9M1qHabc_1",
     "url" : "https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/-pPLdrbUTcLUr1XetvO0tekak4p92m0HCjaMt8s/data",
     "expiration_ts" : "2025-11-06T22:41:14.779Z"
   }

Ein Benutzer mit entsprechenden Berechtigungen kann einen Tabellen-Hyperlink jederzeit invalidieren.

DECLARE
    status CLOB;
    BEGIN
       DBMS_DATA_ACCESS.INVALIDATE_URL(
        id => 'Vd1Px7QWASdqDbnndiuwTAyyEstv82PCHqS_example',
        result => status);           
       dbms_output.put_line(status);
    END;
/

1. Rufen Sie den application_user_id-Wert ab, den Sie beim Generieren des Tabellen-Hyperlinks angegeben haben.
2. Erstellen Sie eine VPD-Policy für die Datenbank, in der Sie den Tabellen-Hyperlink generiert haben.

   CREATE OR REPLACE FUNCTION limit_sal (v_schema IN VARCHAR2, v_objname IN VARCHAR2)
     RETURN VARCHAR2 authid current_user AS
   BEGIN
        RETURN 'employee_id = SYS_CONTEXT(''DATA_ACCESS_CONTEXT$'', ''USER_IDENTITY'')';
   END;
   

   Weitere Informationen finden Sie unter DBMS_RLS.

3. VPD-Policy registrieren

   BEGIN
      DBMS_RLS.ADD_POLICY( 
           object_schema        => 'HR',
           object_name          => 'EMPLOYEE',
           policy_name          => 'POL',
           policy_function      => 'LIMIT_SAL');
   END;
   /

   Weitere Informationen finden Sie unter DBMS_RLS.

Die autonome KI-Datenbank bietet Ansichten, mit denen Sie die Verwendung von Tabellen-Hyperlinks überwachen können.

Hinweise zum Erstellen eines Tabellen-Hyperlinks oder einer Tabellen-Hyperlink-Gruppe mit DBMS_DATA_ACCESS.CREATE_URL:

• Mit dem optionalen Parameter service_name können Sie angeben, dass ein generierter Tabellen-Hyperlink mit einer bestimmten Service-Level-Garantie und Ressourcen verarbeitet wird. Beispiel: Verwenden Sie den Parameter service_name, um anzugeben, dass der Zugriff auf die SQL-Anweisung dem HIGH-Service zugeordnet ist.

• Sie können den einen oder beide der optionalen Parameter inherit_acl und acl verwenden, wenn Sie den Zugriff auf Tabellen-Hyperlink-Daten einschränken möchten:

  • inherit_acl: Verwenden Sie den optionalen Parameter inherit_acl, wenn Sie den Zugriff auf Tabellen-Hyperlinkdaten einschränken möchten. Setzen Sie diesen Parameter auf TRUE, um ACLs zu übernehmen. Wenn der Wert dieses Parameters TRUE lautet, wird die IP-Adresse eines eingehenden Tabellen-Hyperlink-Consumers mit den ACLs in der Producer-Datenbank validiert, bevor der Zugriff auf Daten zugelassen wird. Wenn für die Producer-Datenbank keine ACLs konfiguriert sind, wird der Wert inherit_acl ignoriert, und der Datenzugriff ist ohne ACL-Prüfungen zulässig.

  • acl: Verwenden Sie den optionalen Parameter acl, um eine ACL anzugeben, die für den Tabellen-Hyperlink gilt. Der Parameterwert gibt die Liste der zulässigen IP-Adressen, CIDR-Blöcke oder OCI-VCN-OCIDs an. Wenn der Parameter acl angegeben wird, kann ein Tabellen-Hyperlink-Consumer nur von den in der ACL angegebenen Hosts auf die Daten zugreifen.

  Wenn inherit_acl TRUE ist und der Parameter acl so festgelegt ist, dass eine ACL angegeben wird, kann ein Tabellen-Hyperlink-Consumer auf die Daten eines Tabellen-Hyperlinks von den Hosts zugreifen, die mit dem Parameter acl angegeben wurden, oder von den geerbten Hosts, die in der für die Instanz der autonomen KI-Datenbank angegebenen ACL definiert sind.

  Weitere Informationen finden Sie unter Netzwerkzugriff mit Zugriffskontrollregeln (ACLs) konfigurieren.

• Wenn Sie den optionalen Parameter consistent auf TRUE setzen, erzeugt ein Tabellen-Hyperlink-Producer Daten konsistent über verschiedene Seiten hinweg. Dadurch kann ein Consumer auf die Daten für alle Seiten zugreifen, die mit einem Tabellen-Hyperlink verknüpft sind, und dabei denselben Daten-Snapshot (SCN) wie die SCN verwenden, die mit dem Zugriff für die erste Seite verknüpft ist. Mit dieser Option kann ein Producer konsistente Daten an einen Consumer zurückgeben, bei dem Antworten paginiert werden und mehrere Seiten zurückgegeben werden (die Daten werden Seite für Seite zurückgegeben, wenn auf sie zugegriffen wird).

  Wenn consistent auf TRUE gesetzt ist und ein Tabellen-Hyperlink Schemaobjekte aus dem Schema eines anderen Benutzers referenziert, muss der Datenbankbenutzer, der den Tabellen-Hyperlink erstellt, die Berechtigung FLASHBACK für alle Schemaobjekte besitzen, die im Tabellen-Hyperlink verwendet werden und zum Schema des anderen Benutzers gehören.

  Beispiel:

  GRANT FLASHBACK ON TREE_SCHEMA.TREE_DATA TO SCOTT;

  Hinweis: Wenn eine hohe Datenbankaktivität vorliegt und genügend Zeit zwischen dem Abrufen der ersten Seite und dem Abrufen einer nachfolgenden Seite vergeht, ist es möglicherweise nicht möglich, nachfolgende Daten abzurufen, die mit dem ersten Zugriff konsistent sind. In diesem Fall führt der Abruf zu einem Fehler.

  Weitere Informationen finden Sie unter Auf Daten mit Tabellen-Hyperlinks oder mit Tabellen-Hyperlink-Gruppen zugreifen.

• Wenn Sie einen Tabellen-Hyperlink in einer autonomen KI-Datenbankinstanz mit einem privaten Endpunkt erstellen, 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 Tabellenhyperlink in einer autonomen AI-Datenbankinstanz mit einem privaten Endpunkt erstellen 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 private_preauth_url.

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

• Verwenden Sie DBMS_DATA_ACCESS.LIST_ACTIVE_URLS, um Tabellen-Hyperlinks anzuzeigen. Weitere Informationen finden Sie unter Listen-Tabellen-Hyperlinks und Tabellen-Hyperlinkgruppen.

• Verwenden Sie DBMS_DATA_ACCESS.EXTEND_URL, um die Lebensdauer eines Tabellen-Hyperlinks zu verlängern. Weitere Informationen finden Sie unter Prozedur EXTEND_URL.