Documentation sur Oracle Cloud Infrastructure

Ensemble DBMS_CLOUD_LINK_ADMIN

L'ensemble DBMS_CLOUD_LINK_ADMIN permet à l'utilisateur ADMIN de permettre à un utilisateur de base de données d'enregistrer des jeux de données ou d'accéder à des jeux de données enregistrés pour une instance de base de données IA autonome 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 dont les privilèges sont définis pour enregistrer des jeux de données ou accéder à des jeux de données enregistrés.

Rubrique parent : Informations de référence sur les ensembles fournis avec Autonomous AI Database

Aperçu de DBMS_CLOUD_LINK_ADMIN

Décrit l'utilisation de l'ensemble DBMS_CLOUD_LINK_ADMIN.

Les liens vers le nuage fournissent une méthode en nuage permettant d'accéder à distance en lecture seule aux données d'une instance de base de données d'IA autonome. L'ensemble DBMS_CLOUD_LINK_ADMIN tire parti des mécanismes d'accès d'Oracle Cloud Infrastructure pour rendre les jeux de données accessibles dans une portée spécifique et comporte en outre une étape d'autorisation facultative.

Rubrique parent : Ensemble DBMS_CLOUD_LINK_ADMIN

Sommaire des sous-programmes DBMS_CLOUD_LINK_ADMIN

Ce tableau résume les sous-programmes inclus dans l'ensemble DBMS_CLOUD_LINK_ADMIN.

Sous-programme Description

ADD_SERVICE_MAPPING Procédure

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

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

GRANT_READ Procédure

Permet à un utilisateur de lire les 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.

GRANT_REGISTER Procédure

Permet à un utilisateur d'enregistrer un jeu de données pour un accès distant.

REMOVE_SERVICE_MAPPING Procédure

Supprimez un mappage de service pour une base de données spécifiée.

REVOKE_AUTHORIZE Procédure

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

REVOKE_READ Procédure

Interdit à un utilisateur d'accéder aux jeux de données enregistrés de l'instance de base de données Autonomous AI Database.

REVOKE_REGISTER 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.
  • Procédure ADD_SERVICE_MAPPING
    La procédure DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associe une base de données de consommateur à un service de base de données.
  • Procédure GRANT_AUTHORIZE
    La procédure accorde à un utilisateur l'autorisation 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 jeu de données pour un accès distant.
  • Procédure REMOVE_SERVICE_MAPPING
    La procédure DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING supprime un mappage de service pour une base de données spécifié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 jeux de données enregistrés sur l'instance de base de données IA autonome.
  • 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 : Ensemble DBMS_CLOUD_LINK_ADMIN

ADD_SERVICE_MAPPING Procédure

La procédure DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associe une base de données de 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

Spécifie l'ID base de données pour une instance de base de données d'intelligence artificielle autonome qui est un consommateur Cloud Link. Utilisez DBMS_CLOUD_LINK.GET_DATABASE_ID pour obtenir l'ID base de données.

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

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

service_name

Spécifie le nom du service de base de données.

Les valeurs valides sont les suivantes : 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 de base de données IA autonome du responsable du jeu de données.

GRANT_AUTHORIZE Procédure

La procédure accorde à un utilisateur l'autorisation 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 d'utilisateur.

Notes d'utilisation

  • Pour activer l'autorisation pour un jeu de données avec DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, vous devez avoir accordé le privilège avec DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE. Cela est également vrai pour l'utilisateur ADMIN. Toutefois, l'utilisateur ADMIN peut lui accorder ce privilège.

GRANT_READ Procédure

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 d'utilisateur.

Notes d'utilisation

  • Pour lire des jeux de données, vous devez avoir accordé le privilège avec DBMS_CLOUD_LINK_ADMIN.GRANT_READ. Cela est également vrai pour l'utilisateur ADMIN. Toutefois, l'utilisateur ADMIN peut lui accorder ce privilège.

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

    Par exemple, l'interrogation suivante :

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

    Retourne 'YES' ou 'NO'.

GRANT_REGISTER Procédure

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

Syntaxe 

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

Paramètres

Paramètre Description

username

Indique un nom d'utilisateur.

scope

Indique l'étendue dans laquelle les autorisations de publication doivent être accordées à l'utilisateur spécifié.

Les valeurs valides sont :

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

Notes d'utilisation

  • Pour enregistrer des jeux de données, vous devez avoir accordé le privilège avec DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Cela est également vrai pour l'utilisateur ADMIN. Toutefois, l'utilisateur ADMIN peut lui accorder ce privilège.

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

    Par exemple, l'interrogation suivante :

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

    Retourne 'YES' ou 'NO'.

REMOVE_SERVICE_MAPPING Procédure

La procédure DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING supprime un mappage de service pour une base de données spécifiée.

Syntaxe 

DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING(
      database_id        IN   VARCHAR2
);

Paramètres

Paramètre Description

database_id

Spécifie l'ID base de données pour une instance de base de données d'intelligence artificielle autonome. Utilisez DBMS_CLOUD_LINK.GET_DATABASE_ID pour obtenir l'ID base de données.

La valeur "ANY" supprime toute valeur service_name spécifiée avec toutes les bases de données de consommateurs qui n'ont pas d'entrée correspondant à leur identificateur de base de données. Autrement dit, tout database_id dont service_name n'a pas été défini avec DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

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

Note d'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.

REVOKE_AUTHORIZE Procédure

Cette procédure interdit à un utilisateur d'appeler des 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 d'utilisateur.

REVOKE_READ Procédure

Cette procédure interdit à un utilisateur d'accéder aux jeux de données enregistrés sur l'instance de base de données IA autonome.

Syntaxe 

DBMS_CLOUD_LINK_ADMIN.REVOKE_READ(
      username        IN   VARCHAR2
);

Paramètres

Paramètre Description

username

Spécifie un nom d'utilisateur.

Note d'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 jeu de données.

    Par exemple, l'interrogation suivante :

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

    Retourne 'YES' ou 'NO'.

REVOKE_REGISTER Procédure

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 d'utilisateur.

Note d'utilisation

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

    Par exemple, l'interrogation suivante :

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

    Retourne 'YES' ou 'NO'.