DBMS_CLOUD_LINK_ADMIN-Package

Das Package DBMS_CLOUD_LINK_ADMIN ermöglicht es dem ADMIN-Benutzer, Datasets zu registrieren oder auf registrierte Datasets für eine bestimmte Autonomous Database-Instanz zuzugreifen, vorbehaltlich der Zugriffsbeschränkungen, die mit dem erteilten Geltungsbereich definiert sind.

Berechtigungen können auch für einen Benutzer deaktiviert werden, der über die Berechtigungen zum Registrieren von Datasets oder zum Zugriff auf registrierte Datasets verfügt.

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 DBMS_CLOUD_LINK_ADMIN-Package nutzt Oracle Cloud Infrastructure-Zugriffsmechanismen, um Datasets innerhalb eines bestimmten Geltungsbereichs zugänglich zu machen. Darüber hinaus gibt es einen optionalen Autorisierungsschritt.

Zusammenfassung der DBMS_CLOUD_LINK_ADMIN-Unterprogramme

In dieser Tabelle werden die Unterprogramme zusammengefasst, die im Package DBMS_CLOUD_LINK_ADMIN enthalten sind.

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 der Prozeduren DBMS_CLOUD_LINK.GRANT_AUTHORIZATION und DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Prozedur GRANT_READ

Ermöglicht es einem Benutzer, registrierte Datensätze zu lesen, vorbehaltlich der Zugriffsbeschränkungen, die bei der Registrierung für Datensätze gelten.

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

Erlaubt einem Benutzer den Zugriff auf registrierte Datasets der Autonomous Database-Instanz.

Prozedur REVOKE_REGISTER

Erlaubt einem Benutzer die Registrierung von Datasets für den Remotezugriff. Datensätze, die bereits vom Benutzer registriert wurden, bleiben davon unberührt.

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 Wert service_name 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 Namen des Datenbankservice an. Gültige Werte hängen vom Workload-Typ ab:

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

  • Transaktionsverarbeitung, JSON Database oder APEX: Gültige Werte sind: 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

Legt einen Benutzernamen fest.

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. Der ADMIN-Benutzer kann diese Berechtigung jedoch selbst erteilen.

Prozedur GRANT_READ

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

Syntax

DBMS_CLOUD_LINK_ADMIN.GRANT_READ(
      username        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

username

Legt einen Benutzernamen fest.

Hinweise zur Verwendung

  • Um Datasets lesen zu können, müssen Sie die Berechtigung mit DBMS_CLOUD_LINK_ADMIN.GRANT_READ erteilt haben. Dies gilt auch für ADMIN-Benutzer. Der ADMIN-Benutzer kann 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 sollen.

Gültige Werte sind:

  • '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. Der ADMIN-Benutzer kann 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

Mit der Prozedur DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING wird eine Servicezuordnung für eine angegebene Datenbank entfernt.

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 jeden 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".

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

Legt einen Benutzernamen fest.

Prozedur REVOKE_READ

Mit dieser Prozedur kann ein Benutzer nicht auf registrierte Datasets in der Autonomous Database-Instanz zugreifen.

Syntax

DBMS_CLOUD_LINK_ADMIN.REVOKE_READ(
      username        IN   VARCHAR2
);

Parameter

Parameter Beschreibung

username

Legt einen Benutzernamen fest.

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 Datensätze 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.