Documentation Oracle Cloud Infrastructure

Package DBMS_CLOUD_LINK_ADMIN

Le package DBMS_CLOUD_LINK_ADMIN permet à l'utilisateur ADMIN d'autoriser un utilisateur de base de donnée à inscrire des ensembles d'informations ou à accéder à des ensembles d'informations inscrits pour une instance Autonomous Database donnée, sous réserve des restrictions d'accès définies avec la portée accordée.

Les privilèges peuvent également être désactivés pour un utilisateur qui dispose des privilèges définis pour enregistrer des jeux de données ou accéder à des jeux de données enregistrés.

Rubrique parent : Référence de package fourni avec Autonomous Database

DBMS_CLOUD_LINK_ADMIN Présentation

Décrit l'utilisation du package DBMS_CLOUD_LINK_ADMIN.

Cloud Links fournit une méthode basée sur le cloud permettant d'accéder à distance aux données en lecture seule sur une instance Autonomous Database. Le package DBMS_CLOUD_LINK_ADMIN s'appuie sur les mécanismes d'accès d'Oracle Cloud Infrastructure pour rendre les ensembles de données accessibles dans une portée spécifique. En outre, une étape d'autorisation facultative est disponible.

Rubrique parent : Package DBMS_CLOUD_LINK_ADMIN

Récapitulatif des sous-programmes DBMS_CLOUD_LINK_ADMIN

Ce tableau récapitule les sous-programmes inclus dans le package DBMS_CLOUD_LINK_ADMIN.

Sous-programme Description

Procédure ADD_SERVICE_MAPPING

La procédure associe une base de données consommateur Cloud Links à un service de base de données.
Procédure GRANT_AUTHORIZE

Accorde à un utilisateur le droit d'appeler les procédures DBMS_CLOUD_LINK.GRANT_AUTHORIZATION et DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Procédure GRANT_READ

Permet à un utilisateur de lire des jeux de données enregistrés, sous réserve des restrictions d'accès imposées aux jeux de données lors de l'enregistrement.

Procédure GRANT_REGISTER

Permet à un utilisateur d'enregistrer un ensemble de données pour l'accès à distance.

Procédure REMOVE_SERVICE_MAPPING

Enlevez un mapping de service pour une base de données indiquée.

Procédure REVOKE_AUTHORIZE

Révoque le droit d'un utilisateur d'appeler les procédures DBMS_CLOUD_LINK.GRANT_AUTHORIZATION et DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Procédure REVOKE_READ

Empêche un utilisateur d'accéder aux ensembles de données inscrits de l'instance Autonomous Database.

Procédure REVOKE_REGISTER

Interdit à un utilisateur d'enregistrer des jeux de données pour l'accès distant. Les jeux de données déjà enregistrés par l'utilisateur ne sont pas affectés.
  • Procédure ADD_SERVICE_MAPPING
    La procédure DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associe une base de données consommateur à un service de base de données.
  • Procédure GRANT_AUTHORIZE
    La procédure accorde à un utilisateur le droit d'appeler les procédures DBMS_CLOUD_LINK.GRANT_AUTHORIZATION et DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • Procédure GRANT_READ
    La procédure permet à un utilisateur de lire des jeux de données enregistrés, sous réserve des restrictions d'accès imposées aux jeux de données lorsqu'un jeu de données est enregistré à l'aide de DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.
  • Procédure GRANT_REGISTER
    La procédure permet à un utilisateur d'enregistrer un ensemble de données pour un accès distant.
  • Procédure REMOVE_SERVICE_MAPPING
    La procédure DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING enlève une correspondance de service pour une base de données indiquée.
  • Procédure REVOKE_AUTHORIZE
    Cette procédure interdit à un utilisateur d'appeler les procédures DBMS_CLOUD_LINK.GRANT_AUTHORIZATION et DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • Procédure REVOKE_READ
    Cette procédure interdit à un utilisateur d'accéder aux ensembles de données inscrits sur l'instance Autonomous Database.
  • Procédure REVOKE_REGISTER
    La procédure interdit à un utilisateur d'enregistrer des jeux de données pour un accès distant. Les jeux de données déjà enregistrés par l'utilisateur ne sont pas affectés.

Rubrique parent : Package DBMS_CLOUD_LINK_ADMIN

Procédure ADD_SERVICE_MAPPING

La procédure DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associe une base de données consommateur à un service de base de données.

Syntaxe

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

Paramètres

Paramètre Description

database_id

Indique l'ID de base de données d'une instance Autonomous Database qui est un consommateur de lien cloud. Utilisez DBMS_CLOUD_LINK.GET_DATABASE_ID pour obtenir l'ID de base de données.

La valeur "ANY" associe la valeur service_name indiquée à toutes les bases de données consommateur qui n'ont pas d'entrée correspondant à leur identificateur de base de données. Autrement dit, toute valeur database_id dont service_name n'a pas été définie avec DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

Valeurs valides : un ID de base de données ou "ANY".

service_name

Indique le nom du service de la base de données. Les valeurs valides dépendent du type de charge globale :

  • Data Warehouse : les valeurs valides sont HIGH, MEDIUM et LOW.

  • Traitement des transactions : JSON Database ou APEX : les valeurs valides sont : TP, TPURGENT, HIGH, MEDIUM, LOW

Notes d'utilisation

  • Seuls l'utilisateur ADMIN et les schémas dotés du rôle PDB_DBA peuvent exécuter DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

  • Vous devez exécuter DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING sur l'instance Autonomous Database du propriétaire de l'ensemble de données.

Procédure GRANT_AUTHORIZE

La procédure accorde à un utilisateur le droit d'appeler les procédures DBMS_CLOUD_LINK.GRANT_AUTHORIZATION et DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Syntaxe

DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE(
      username        IN   VARCHAR2
);

Paramètres

Paramètre Description

username

Spécifie un nom utilisateur.

Notes d'utilisation

  • Pour activer l'autorisation pour un ensemble de données avec DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, vous devez avoir accordé le privilège avec DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE. Ceci est également vrai pour l'utilisateur ADMIN. Cependant, l'utilisateur ADMIN peut accorder ce privilège à lui-même.

Procédure GRANT_READ

La procédure permet à un utilisateur de lire des jeux de données enregistrés, sous réserve des restrictions d'accès imposées aux jeux de données lorsqu'un jeu de données est enregistré à l'aide de DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.

Syntaxe

DBMS_CLOUD_LINK_ADMIN.GRANT_READ(
      username        IN   VARCHAR2
);

Paramètres

Paramètre Description

username

Spécifie un nom utilisateur.

Notes d'utilisation

  • Pour lire des ensembles de données, vous devez avoir accordé le privilège avec DBMS_CLOUD_LINK_ADMIN.GRANT_READ. Ceci est également vrai pour l'utilisateur ADMIN. Cependant, l'utilisateur ADMIN peut accorder ce privilège à lui-même.

  • Un utilisateur peut interroger SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') pour vérifier s'il est activé pour l'accès READ à un ensemble de données.

    Par exemple, la requête suivante :

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

    Renvoie YES ou NO'.

Procédure GRANT_REGISTER

La procédure permet à un utilisateur d'enregistrer un ensemble de données pour un accès à distance.

Syntaxe

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

Paramètres

Paramètre Description

username

Indique un nom utilisateur.

scope

Indique la portée dans laquelle les droits d'accès à publier doivent être accordés à l'utilisateur spécifié.

Les valeurs valides sont les suivantes :

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

Notes d'utilisation

  • Pour inscrire des ensembles de données, vous devez avoir accordé le privilège avec DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Ceci est également vrai pour l'utilisateur ADMIN. Cependant, l'utilisateur ADMIN peut accorder ce privilège à lui-même.

  • Un utilisateur peut interroger SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') pour vérifier s'il est activé pour l'inscription des ensembles de données.

    Par exemple, la requête suivante :

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

    Renvoie YES ou NO'.

Procédure REMOVE_SERVICE_MAPPING

La procédure DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING enlève un mapping de service pour une base de données indiquée.

Syntaxe

DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING(
      database_id        IN   VARCHAR2
);

Paramètres

Paramètre Description

database_id

Indique l'ID de base de données d'une instance Autonomous Database. Utilisez DBMS_CLOUD_LINK.GET_DATABASE_ID pour obtenir l'ID de base de données.

La valeur "ANY" enlève toute valeur service_name indiquée avec toutes les bases de données consommateur qui n'ont pas d'entrée correspondant à leur identificateur de base de données. Autrement dit, toute valeur database_id dont service_name n'a pas été définie avec DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

Valeurs valides : un ID de base de données ou "ANY".

Remarque sur l'utilisation

Seuls l'utilisateur ADMIN et les schémas dotés du rôle PDB_DBA peuvent exécuter DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING.

Procédure REVOKE_AUTHORIZE

Cette procédure empêche un utilisateur d'appeler les procédures DBMS_CLOUD_LINK.GRANT_AUTHORIZATION et DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Syntaxe

DBMS_CLOUD_LINK_ADMIN.REVOKE_AUTHORIZE(
      username        IN   VARCHAR2
);

Paramètres

Paramètre Description

username

Spécifie un nom utilisateur.

Procédure REVOKE_READ

Cette procédure empêche un utilisateur d'accéder aux ensembles de données inscrits sur l'instance Autonomous Database.

Syntaxe

DBMS_CLOUD_LINK_ADMIN.REVOKE_READ(
      username        IN   VARCHAR2
);

Paramètres

Paramètre Description

username

Spécifie un nom utilisateur.

Remarque sur l'utilisation

  • Un utilisateur peut interroger SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') pour vérifier s'il est activé pour l'accès READ à un ensemble de données.

    Par exemple, la requête suivante :

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

    Renvoie YES ou NO'.

Procédure REVOKE_REGISTER

La procédure interdit à un utilisateur d'enregistrer des jeux de données pour un accès distant. Les jeux de données déjà enregistrés par l'utilisateur ne sont pas affectés.

Syntaxe

DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER(
      username        IN   VARCHAR2
);

Paramètres

Paramètre Description

username

Indique un nom utilisateur.

Remarque sur l'utilisation

  • Un utilisateur peut interroger SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') pour vérifier s'il est activé pour l'inscription des ensembles de données.

    Par exemple, la requête suivante :

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

    Renvoie YES ou NO'.