Oracle Cloud Infrastructure-Dokumentation

DBMS_CLOUD_LINK_ADMIN-Package

Mit dem Package DBMS_CLOUD_LINK_ADMIN kann der ADMIN-Benutzer einem Datenbankbenutzer die Registrierung von Datasets oder den Zugriff auf registrierte Datasets für eine bestimmte Autonomous Database-Instanz ermöglichen, vorbehaltlich der Zugriffsbeschränkungen, die mit dem erteilten Geltungsbereich definiert sind.

Berechtigungen können auch für einen Benutzer deaktiviert werden, für den die Berechtigungen zum Registrieren von Datasets oder zum Zugriff auf registrierte Datasets festgelegt sind.

Übergeordnetes Thema: Von Autonomous Database bereitgestellte Paketreferenz

DBMS_CLOUD_LINK_ADMIN - Überblick

Beschreibt die Verwendung des Packages DBMS_CLOUD_LINK_ADMIN.

Cloud-Links bieten eine cloudbasierte Methode für den Remotezugriff auf schreibgeschützte Daten in einer Autonomous Database-Instanz. Das Package DBMS_CLOUD_LINK_ADMIN nutzt Oracle Cloud Infrastructure-Zugriffsmechanismen, um Datasets innerhalb eines bestimmten Geltungsbereichs zugänglich zu machen. Außerdem gibt es einen optionalen Autorisierungsschritt.

Übergeordnetes Thema: Paket DBMS_CLOUD_LINK_ADMIN

Zusammenfassung der DBMS_CLOUD_LINK_ADMIN-Unterprogramme

In dieser Tabelle werden die im Package DBMS_CLOUD_LINK_ADMIN enthaltenen Unterprogramme zusammengefasst.

Unterprogramm Beschreibung

Prozedur ADD_SERVICE_MAPPING

Die Prozedur verknüpft eine Cloud Links-Consumer-Datenbank mit einem Datenbankservice.
Prozedur GRANT_AUTHORIZE

Erteilt einem Benutzer die Berechtigung zum Aufrufen von DBMS_CLOUD_LINK.GRANT_AUTHORIZATION- und DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION-Prozeduren.

Prozedur GRANT_READ

Ermöglicht einem Benutzer das Lesen von registrierten Datasets, vorbehaltlich Zugriffsbeschränkungen für Datasets bei der Registrierung.

Prozedur GRANT_REGISTER

Ermöglicht einem Benutzer die Registrierung eines Datasets für den Remotezugriff.

Prozedur REMOVE_SERVICE_MAPPING

Entfernen Sie eine Servicezuordnung für eine angegebene Datenbank.

Prozedur REVOKE_AUTHORIZE

Entzieht die Berechtigung eines Benutzers zum Aufrufen der Prozeduren DBMS_CLOUD_LINK.GRANT_AUTHORIZATION und DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Prozedur REVOKE_READ

Ermöglicht einem Benutzer den Zugriff auf registrierte Datasets der Autonomous Database-Instanz.

Prozedur REVOKE_REGISTER

Verhindert, dass ein Benutzer Datasets für den Remotezugriff registriert. Datensätze, die bereits vom Benutzer registriert wurden, sind davon nicht betroffen.
  • ADD_SERVICE_MAPPING-Prozedur
    Die Prozedur DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING verknüpft eine Consumer-Datenbank mit einem Datenbankservice.
  • Prozedur GRANT_AUTHORIZE
    Die Prozedur erteilt einem Benutzer die Berechtigung, die Prozeduren DBMS_CLOUD_LINK.GRANT_AUTHORIZATION und DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION aufzurufen.
  • GRANT_READ-Prozedur
    Mit dieser Prozedur kann ein Benutzer registrierte Datasets lesen, vorbehaltlich der Zugriffsbeschränkungen, die für Datasets gelten, wenn ein Dataset mit DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER registriert wird.
  • Prozedur GRANT_REGISTER
    Mit dieser Prozedur kann ein Benutzer ein Dataset für den Remotezugriff registrieren.
  • Prozedur REMOVE_SERVICE_MAPPING
    Die Prozedur DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING entfernt eine Servicezuordnung für eine angegebene Datenbank.
  • Prozedur REVOKE_AUTHORIZE
    Diese Prozedur verhindert, dass ein Benutzer die Prozeduren DBMS_CLOUD_LINK.GRANT_AUTHORIZATION und DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION aufruft.
  • Prozedur REVOKE_READ
    Diese Prozedur verhindert, dass Benutzer auf registrierte Datasets in der Autonomous Database-Instanz zugreifen können.
  • Prozedur REVOKE_REGISTER
    Die Prozedur verhindert, dass ein Benutzer Datasets für den Remotezugriff registriert. Datensätze, die bereits vom Benutzer registriert wurden, sind davon nicht betroffen.

Übergeordnetes Thema: Paket DBMS_CLOUD_LINK_ADMIN

Prozedur ADD_SERVICE_MAPPING

Die Prozedur DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING verknüpft eine Consumer-Datenbank mit einem Datenbankservice.

Syntax

DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING(
      database_id        IN   VARCHAR2,
      service_name       IN   VARCHAR2
);

Parameter

Parameter Beschreibung

database_id

Gibt die Datenbank-ID für eine Autonomous Database-Instanz an, die ein Cloud-Link-Consumer ist. Verwenden Sie DBMS_CLOUD_LINK.GET_DATABASE_ID, um die Datenbank-ID abzurufen.

Der Wert "ANY" verknüpft den angegebenen service_name-Wert mit allen Consumer-Datenbanken, die keinen Eintrag haben, der mit ihrer Datenbank-ID übereinstimmt. Das heißt, jede database_id, deren service_name nicht mit DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING festgelegt wurde.

Gültige Werte: eine Datenbank-ID oder "ANY".

service_name

Gibt den Service-Namen der Datenbank an. Gültige Werte hängen vom Workload-Typ ab:

  • Data Warehouse: Gültige Werte: HIGH, MEDIUM, LOW

  • Transaktionsverarbeitung, JSON-Datenbank oder APEX: Gültige Werte: TP, TPURGENT, HIGH, MEDIUM, LOW

Hinweise zur Verwendung

  • Nur der ADMIN-Benutzer und die Schemas mit der Rolle PDB_DBA können DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING ausführen.

  • Sie müssen DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING in der Autonomous Database-Instanz des Dataset-Eigentümers ausführen.

Prozedur GRANT_AUTHORIZE

Die Prozedur erteilt einem Benutzer die Berechtigung, die Prozeduren DBMS_CLOUD_LINK.GRANT_AUTHORIZATION und DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION aufzurufen.

Syntax

DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE(
      username        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

username

Gibt einen Benutzernamen an.

Hinweise zur Verwendung

  • Um die Autorisierung für ein Dataset mit DBMS_CLOUD_LINK.GRANT_AUTHORIZATION zu aktivieren, müssen Sie die Berechtigung mit DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE erteilt haben. Dies gilt auch für ADMIN-Benutzer. ADMIN-Benutzer können diese Berechtigung jedoch selbst erteilen.

Prozedur GRANT_READ

Das Verfahren ermöglicht es einem Benutzer, registrierte Datensätze zu lesen, vorbehaltlich der Zugriffsbeschränkungen, die für Datensätze gelten, wenn ein Datensatz mit DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER registriert wird.

Syntax

DBMS_CLOUD_LINK_ADMIN.GRANT_READ(
      username        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

username

Gibt einen Benutzernamen an.

Hinweise zur Verwendung

  • Zum Lesen von Datasets müssen Sie die Berechtigung mit DBMS_CLOUD_LINK_ADMIN.GRANT_READ erteilt haben. Dies gilt auch für ADMIN-Benutzer. ADMIN-Benutzer können diese Berechtigung jedoch selbst erteilen.

  • Ein Benutzer kann SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') abfragen, um zu prüfen, ob er für den READ-Zugriff auf ein Dataset aktiviert ist.

    Beispiel: Die folgende Abfrage:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') FROM DUAL;

    Gibt "YES" oder "NO'" zurück.

Prozedur GRANT_REGISTER

Mit dieser Prozedur kann ein Benutzer ein Dataset für den Remotezugriff registrieren.

Syntax

DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER(
      username        IN   VARCHAR2,
      scope           IN   CLOB
);

Parameter

Parameter Beschreibung

username

Gibt einen Benutzernamen an.

scope

Gibt den Geltungsbereich an, in dem dem angegebenen Benutzer Veröffentlichungsberechtigungen erteilt werden.

Gültige Werte:

  • 'MY$REGION'
  • 'MY$TENANCY'
  • 'MY$COMPARTMENT'

Hinweise zur Verwendung

  • Um Datasets zu registrieren, müssen Sie die Berechtigung mit DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER erteilt haben. Dies gilt auch für ADMIN-Benutzer. ADMIN-Benutzer können diese Berechtigung jedoch selbst erteilen.

  • Ein Benutzer kann SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') abfragen, um zu prüfen, ob sie für die Registrierung von Datasets aktiviert sind.

    Beispiel: Die folgende Abfrage:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') FROM DUAL;

    Gibt "YES" oder "NO'" zurück.

Prozedur REMOVE_SERVICE_MAPPING

Die Prozedur DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING entfernt eine Servicezuordnung für eine angegebene Datenbank.

Syntax

DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING(
      database_id        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

database_id

Gibt die Datenbank-ID für eine Autonomous Database-Instanz an. Verwenden Sie DBMS_CLOUD_LINK.GET_DATABASE_ID, um die Datenbank-ID abzurufen.

Der Wert "ANY" entfernt alle angegebenen service_name-Werte mit allen Consumer-Datenbanken, die keinen Eintrag haben, der mit ihrer Datenbank-ID übereinstimmt. Das heißt, jede database_id, deren service_name nicht mit DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING festgelegt wurde.

Gültige Werte: eine Datenbank-ID oder "ANY".

Hinweis zur Verwendung

Nur der ADMIN-Benutzer und die Schemas mit der Rolle PDB_DBA können DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING ausführen.

Prozedur REVOKE_AUTHORIZE

Diese Prozedur verhindert, dass ein Benutzer die Prozeduren DBMS_CLOUD_LINK.GRANT_AUTHORIZATION und DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION aufruft.

Syntax

DBMS_CLOUD_LINK_ADMIN.REVOKE_AUTHORIZE(
      username        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

username

Gibt einen Benutzernamen an.

Prozedur REVOKE_READ

Diese Prozedur verhindert den Zugriff eines Benutzers auf registrierte Datasets in der Autonomous Database-Instanz.

Syntax

DBMS_CLOUD_LINK_ADMIN.REVOKE_READ(
      username        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

username

Gibt einen Benutzernamen an.

Hinweis zur Verwendung

  • Ein Benutzer kann SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') abfragen, um zu prüfen, ob er für den READ-Zugriff auf ein Dataset aktiviert ist.

    Beispiel: Die folgende Abfrage:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') FROM DUAL;

    Gibt "YES" oder "NO'" zurück.

Prozedur REVOKE_REGISTER

Die Prozedur verhindert, dass ein Benutzer Datasets für den Remotezugriff registriert. Datensätze, die bereits vom Benutzer registriert wurden, bleiben davon unberührt.

Syntax

DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER(
      username        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

username

Gibt einen Benutzernamen an.

Hinweis zur Verwendung

  • Ein Benutzer kann SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') abfragen, um zu prüfen, ob sie für die Registrierung von Datasets aktiviert sind.

    Beispiel: Die folgende Abfrage:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') FROM DUAL;

    Gibt "YES" oder "NO'" zurück.