Tabellen-Hyperlinkgruppen erstellen und verwalten

Beim Zugriff auf eine Tabellen-Hyperlink-Gruppe werden die Berechtigungen verwendet, die dem Datenbankbenutzer erteilt wurden, der die Tabellen-Hyperlink-Gruppe erstellt. Der Benutzer, der eine Tabellen-Hyperlink-Gruppe erstellt, muss über die Mindestberechtigungen verfügen, die für den Zugriff auf die Daten erforderlich sind. Um die Sicherheit aufrechtzuerhalten, empfiehlt Oracle, DBMS_DATA_ACCESS.CREATE_URL nicht als ADMIN-Benutzer auszuführen.

So erstellen Sie eine Tabellen-Hyperlink-Gruppe:

Hinweise zum Erstellen einer Tabellen-Hyperlink-Gruppe:

• Die result enthält den Wert preauth_url: Dieser Wert ist die URL, mit der Sie auf die Tabellen-Hyperlinkgruppe zugreifen. Weitere Informationen finden Sie unter Tabellen-Hyperlinkgruppe für den Zugriff auf Daten verwenden.

• Wenn Sie eine Tabellen-Hyperlinkgruppe in einer autonomen KI-Datenbankinstanz mit einem privaten Endpunkt generieren, 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 eine Tabellen-Hyperlinkgruppe in einer autonomen KI-Datenbankinstanz mit einem privaten Endpunkt generieren 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.EXTEND_URL, um die Lebensdauer einer Tabellen-Hyperlinkgruppe zu verlängern. Wenn Sie DBMS_DATA_ACCESS.EXTEND_URL mit einem id für eine Tabellen-Hyperlinkgruppe ausführen, verlängert dies nur den Ablauf der hinzugefügten Elemente, wenn Sie die Gruppe mit DBMS_DATA_ACCESS.CREATE_URL erstellen (dies umfasst keine Tabellen-Hyperlinks, die mit DBMS_DATA_ACCESS.ADD_MEMBER hinzugefügt werden). Mit DBMS_DATA_ACCESS.ADD_MEMBER hinzugefügte Tabellen-Hyperlinks existieren auch unabhängig außerhalb des Kontextes der Tabellen-Hyperlinkgruppe. Sie können DBMS_DATA_ACCESS.EXTEND_URL unabhängig von diesen Tabellen-Hyperlinks ausführen.

  Weitere Informationen finden Sie unter Prozedur EXTEND_URL.

• Verwenden Sie den Parameter password, wenn Sie eine kennwortgeschützte Tabellen-Hyperlinkgruppe erstellen möchten. Wenn Sie den Kennwortparameter einschließen, können Sie auch mit max_failed_access_attempts die maximale Anzahl an aufeinanderfolgenden nicht erfolgreichen Kennwortversuchen angeben. Wenn dieser Wert überschritten wird, wird die Tabellen-Hyperlinkgruppe invalidiert.

  Weitere Informationen finden Sie unter Hyperlink für kennwortgeschützte Tabellen erstellen.

• Weitere Informationen zu optionalen Parametern für DBMS_DATA_ACCESS.CREATE_URL finden Sie unter Hinweise zum Erstellen eines Tabellen-Hyperlinks oder einer Tabellen-Hyperlinkgruppe.

Verwenden Sie DBMS_DATA_ACCESS.ADD_MEMBER, um einer Gruppe einen vorhandenen Tabellen-Hyperlink hinzuzufügen. Beispiel:

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

Die Parameter sind:

• id: Gibt die Tabellen-Hyperlinkgruppen-ID an. Dies ist der id-Wert, der im Ergebnis angezeigt wird, wenn Sie eine Tabellen-Hyperlinkgruppe erstellen. Weitere Informationen finden Sie unter Tabellen-Hyperlinkgruppe erstellen.

• member_id: Gibt eine vorhandene Tabellen-Hyperlink-ID an, die der Gruppe hinzugefügt werden soll. Der Wert member_id darf keine Tabellen-Hyperlinkgruppen-ID sein (is_group_url muss false sein). Weitere Informationen finden Sie unter Listen-Tabellen-Hyperlinks und Tabellen-Hyperlinkgruppen.

• result: stellt JSON bereit, das das Ergebnis des Vorgangs angibt.

Weitere Informationen finden Sie unter Prozedur ADD_MEMBER.

Verwenden Sie DBMS_DATA_ACCESS.REMOVE_MEMBER, um ein Element aus einer Tabellen-Hyperlinkgruppe zu entfernen. Beispiel:

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

Die Parameter sind:

• id: Gibt die Tabellen-Hyperlinkgruppen-ID an. Dies ist der id-Wert, der im Ergebnis angezeigt wird, wenn Sie eine Tabellen-Hyperlinkgruppe erstellen. Weitere Informationen finden Sie unter Tabellen-Hyperlinkgruppe erstellen.

• member_id: Gibt die Element-ID an, die aus der Tabellen-Hyperlinkgruppe entfernt werden soll.

• result: stellt JSON bereit, das das Ergebnis des Vorgangs angibt.

Hinweise zum Entfernen eines Mitglieds:

• Der Wert member_id darf keine Tabellen-Hyperlinkgruppen-ID sein (is_group_url muss false sein). Weitere Informationen finden Sie unter Hinweise zum Auflisten von Tabellen-Hyperlinks und Tabellen-Hyperlinkgruppen.

• Mit DBMS_DATA_ACCESS.LIST_MEMBERS können Sie die Elemente einer Tabellen-Hyperlinkgruppe auflisten. Weitere Informationen finden Sie unter Hinweise zum Auflisten von Tabellen-Hyperlinks und Tabellen-Hyperlinkgruppen.

• Wenn das entfernte Element ein vorhandener Tabellen-Hyperlink ist, der der Gruppe mit DBMS_DATA_ACCESS.ADD_MEMBER hinzugefügt wurde, wird das Element aus der Gruppe entfernt, aber der Tabellen-Hyperlink kann direkt aufgerufen werden, bis er explizit invalidiert wird oder abläuft.

• Wenn eine Tabellen-Hyperlink-Gruppe nur ein Element enthält und dieses Element entfernt wird, wird die Gruppe invalidiert.

Weitere Informationen finden Sie unter Prozedur REMOVE_MEMBER.

Verwenden Sie DBMS_DATA_ACCESS.INVALIDATE_URL, um eine Tabellen-Hyperlinkgruppe zu invalidieren. Beispiel:

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

Die Parameter sind:

• id: Gibt die Tabellen-Hyperlinkgruppen-ID an. Dies ist der id-Wert, der im Ergebnis angezeigt wird, wenn Sie eine Tabellen-Hyperlinkgruppe erstellen. Weitere Informationen finden Sie unter Tabellen-Hyperlinkgruppe erstellen.

• result: stellt JSON bereit, das das Ergebnis des Vorgangs angibt.

Weitere Informationen finden Sie unter Prozedur INVALIDATE_URL.