La procédure DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM attache un système de fichiers dans la base de données et stocke les informations sur le système de fichiers dans la vue DBA_CLOUD_FILE_SYSTEMS.

Syntaxe

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name         IN VARCHAR2,
    file_system_location     IN VARCHAR2,
    directory_name           IN VARCHAR2,
    description              IN VARCHAR2 DEFAULT NULL,
    params                   IN CLOB DEFAULT NULL
);

Paramètres

Exemples :

Connectez-vous à un système de fichiers NFSv3 :

BEGIN
   DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'FSS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'FSS_DIR',
    description           => 'Source NFS for sales data'
  );
END;
/     

Connectez-vous à un système de fichiers NFSv4 :

BEGIN
   DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'FSS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'FSS_DIR',  
    description           => 'Source NFS for sales data',
    params                => JSON_OBJECT('nfs_version' value 4)
);                                                      
END;                                                        
/

Notes d'utilisation

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Vous devez disposer du privilège WRITE sur l'objet de répertoire dans la base de données pour attacher un système de fichiers à l'aide de DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM.

• La procédure DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM peut uniquement attacher un service File Storage privé aux bases de données pour lesquelles les adresses privées sont activées.

  Pour plus d'informations, reportez-vous à Service OCI File Storage et à Configuration de l'accès réseau avec des adresses privées.

• La procédure DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM recherche le nom d'hôte du système de fichiers réseau sur le réseau cloud virtuel (VCN) du client. L'erreur "ORA-20000: Mounting NFS fails" est renvoyée si le nom d'hôte spécifié dans l'emplacement ne peut pas être localisé.

• Oracle Cloud Infrastructure File Storage utilise NFSv3 pour le partage

• Si vous associez des systèmes autres qu'Oracle Cloud Infrastructure File Storage, la procédure prend en charge NFSv3 et NFSv4

• Si vous disposez d'un serveur NFS attaché qui utilise NFSv3 et que la version NFS est mise à jour vers NFSv4 dans le serveur NFS, vous devez exécuter DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM, puis DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (à l'aide du paramètre params avec nfs_version défini sur 4). Cette opération attache NFS avec le protocole correspondant afin qu'Autonomous Database puisse accéder au serveur NFSv4. Sans détachement puis rattachement, le serveur NFS sera inaccessible et vous risquez de voir une erreur telle que : "Protocol not supported".

Syntaxe

Cette procédure annule la capture de charge globale en cours et active l'actualisation sur le clone actualisable.

DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;

Exemple

Remarque sur l'utilisation

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

Syntaxe

DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
       db_link_name         IN VARCHAR2,
       hostname             IN VARCHAR2,
       port                 IN NUMBER,
       service_name         IN VARCHAR2,
       ssl_server_cert_dn   IN VARCHAR2 DEFAULT,
       credential_name      IN VARCHAR2 DEFAULT,
       directory_name       IN VARCHAR2 DEFAULT,
       gateway_link         IN BOOLEAN DEFAULT,
       public_link          IN BOOLEAN DEFAULT,
       private_target       IN BOOLEAN DEFAULT
       gateway_params       IN CLOB DEFAULT);

DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
       db_link_name         IN VARCHAR2,
       rac_hostnames        IN CLOB,
       port                 IN NUMBER,
       service_name         IN VARCHAR2,
       ssl_server_cert_dn   IN VARCHAR2 DEFAULT,
       credential_name      IN VARCHAR2 DEFAULT,
       directory_name       IN VARCHAR2 DEFAULT,
       gateway_link         IN BOOLEAN DEFAULT,
       public_link          IN BOOLEAN DEFAULT,
       private_target       IN BOOLEAN DEFAULT);

Paramètres

'["sales1-svr1.domain", "sales1-svr2.domain",
      "sales1-svr3.domain"]'

gateway_params => JSON_OBJECT(
     'db_type' value 'snowflake',
     'enable_ssl' value true)

Notes d'utilisation

• Lorsque vous indiquez le paramètre gateway_params, pour certaines valeurs db_type, des paramètres gateway_params supplémentaires sont pris en charge :

  db_type	Valeurs gateway_params supplémentaires
  azure	Lorsque la valeur db_type est azure, deux paramètres facultatifs, auth_method et domain, prennent en charge l'authentification NTLM/AD. Lorsque NTLMv2 est configuré, définissez auth_method=10 et domain sur la valeur de domaine Windows. Pour utiliser un mot de passe Azure Active Directory, définissez auth_method=13. N'utilisez pas auth_method=13 pour accéder à une base de données sur site Oracle. Pour plus d'informations, reportez-vous à Méthode d'authentification Microsoft SQL Server.
  google_analytics	Lorsque db_type est défini sur google_analytics, les informations d'identification que vous indiquez doivent être des informations d'identification Google OAuth (gcp_oauth2). Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL.
  google_bigquery	Lorsque db_type est défini sur google_bigquery, les informations d'identification que vous indiquez doivent être des informations d'identification Google OAuth (gcp_oauth2) Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL. Lorsque db_type est défini sur google_bigquery, le paramètre project est valide. Ce paramètre indique le nom du projet pour google_bigquery et est requis. Le nom de table que vous indiquez lorsque vous utilisez SELECT avec Google BigQuery doit être entre guillemets. Par exemple : SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK
  google_drive	Pour db_type google_drive, les informations d'identification que vous fournissez avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK doivent être des informations d'identification de type OAuth utilisant le paramètre params avec des valeurs gcp_oauth2 indiquées (client_id, client_secret et refresh_token). Pour vous connecter à Google Drive et obtenir des données, vous devez fournir les paramètres de passerelle directory_name et file_name. Ces paramètres spécifient un fichier de modèle (fichier REST automatique) qui met en correspondance la réponse JSON avec le modèle relationnel. Le fichier modèle indique les adresses, le mapping de table et le code de réponse HTTP pour le traitement de la réponse JSON. Pour plus d'informations, reportez-vous aux sections Syntaxe des fichiers de modèle et Exemple de fichier de modèle. Lorsque vous utilisez le paramètre gateway_params avec db_type google_drive, vous devez fournir au paramètre gateway_params db_type la valeur 'google_drive', les paramètres directory_name et file_name, ainsi que les informations d'identification de type OAuth : Le paramètre directory_name indique le répertoire avec le fichier de configuration REST. Vous pouvez créer ce répertoire comme suit : create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR'; Obtenir et télécharger le fichier REST automatique dans le répertoire spécifié. Par exemple : exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); Définissez la valeur file_name sur le nom du fichier REST automatique que vous avez téléchargé, "google_drive.rest". Vous pouvez ensuite utiliser le fichier de configuration REST avec OAuth 2.0.
  hive	Lorsque db_type est défini sur hive, le paramètre http_path est valide. Ce paramètre indique la valeur HttpPath, si nécessaire, pour la connexion à l'instance Hive.
  salesforce	Lorsque db_type est défini sur salesforce, le paramètre security_token est valide. Un jeton de sécurité est un code alphanumérique sensible à la casse. Vous devez fournir une valeur security_token pour accéder à Salesforce. Par exemple : gateway_params => JSON_OBJECT( 'db_type' value 'salesforce', 'security_token' value 'security_token_value' ) Pour plus d'informations, reportez-vous à Réinitialisation du jeton de sécurité.
  servicenow	Pour vous connecter à ServiceNow et obtenir des données, vous devez indiquer les paramètres de passerelle directory_name et file_name. Ces paramètres indiquent un fichier de modèle (fichier de configuration REST) qui met en correspondance la réponse JSON avec le modèle relationnel. Le fichier de modèle indique les adresses, la correspondance de table et le code de réponse HTTP pour le traitement de la réponse JSON. Pour plus d'informations, reportez-vous aux sections Syntaxe du fichier modèle et Exemple de fichier modèle. Lorsque vous utilisez le paramètre gateway_params avec db_type servicenow, deux options sont prises en charge : Authentification de base : vous devez fournir le paramètre gateway_params db_type avec la valeur 'servicenow', et les paramètres directory_name et file_name avec les informations d'identification de type nom utilisateur/mot de passe. Authentification OAuth 2.0 : vous devez indiquer le paramètre gateway_params db_type avec la valeur 'servicenow', les paramètres directory_name, file_name et token_uri, ainsi que les informations d'identification de type OAuth. Le paramètre directory_name indique le répertoire avec le fichier de configuration REST ServiceNow. Vous pouvez créer ce répertoire comme suit : create or replace directory servicenow_dir as 'SERVICENOW_DIR'; Obtenez et téléchargez le fichier de configuration REST ServiceNow dans le répertoire indiqué. Exemple : exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); Définissez la valeur file_name sur le nom du fichier de configuration REST que vous avez téléchargé, "servicenow.rest". Vous pouvez ensuite utiliser le fichier de configuration REST ServiceNow avec l'authentification de base ou OAuth2.0. Vous pouvez ensuite utiliser le fichier de configuration REST ServiceNow avec l'authentification de base ou OAuth2.0. Pour obtenir des exemples, reportez-vous à HETEROGENEOUS_CONNECTIVITY_INFO View.
  sharepoint	Lorsque vous utilisez le paramètre gateway_params avec db_type sharepoint, indiquez également des valeurs pour auth_uri, scope, service_url et token_uri. Pour db_type sharepoint, les informations d'identification que vous fournissez avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK doivent être de type OAuth à l'aide du paramètre params avec les valeurs gcp_oauth2 indiquées (client_id, client_secret et refresh_token). Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL. Générez le fichier refresh_token pour tenant_id.sharepoint.com/.default offline_access. Pour plus d'informations, reportez-vous aux sections suivantes : Déterminer l'étendue et Authentification OAuth 2.0. Définissez les valeurs de gateway_params pour db_type sharepoint : auth_uri : définissez auth_uri à partir d'Azure. Pour plus d'informations, reportez-vous à Obtention des informations et des adresses client d'application. scope : définissez la portée. Pour plus d'informations, reportez-vous à Descriptions des options de connexion. service_url : définissez service_url. Reportez-vous à URL de service pour plus d'informations. token_uri : obtenez le fichier token_uri à partir d'Azure. Pour plus d'informations, reportez-vous à Obtention des informations et des adresses client d'application.
  snowflake	Lorsque db_type est défini sur SNOWFLAKE, les paramètres facultatifs role, schema et warehouse sont valides. Ces valeurs indiquent un schéma, un rôle ou une valeur d'entrepôt différent de la valeur par défaut. Exemple : gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
  youtube	Pour vous connecter à YouTube et obtenir des données, vous devez indiquer les paramètres de passerelle directory_name et file_name. Ces paramètres indiquent un fichier de modèle (fichier de configuration REST) qui met en correspondance la réponse JSON avec le modèle relationnel. Le fichier de modèle indique les adresses, la correspondance de table et le code de réponse HTTP pour le traitement de la réponse JSON. Pour plus d'informations, reportez-vous aux sections Syntaxe du fichier modèle et Exemple de fichier modèle. Lorsque vous utilisez le paramètre gateway_params avec db_type youtube, les informations d'identification que vous indiquez doivent être des informations d'identification Google OAuth (gcp_oauth2). Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL. Authentification OAuth 2.0 : vous devez indiquer le paramètre gateway_params db_type avec la valeur youtube, les paramètres directory_name et file_name, ainsi que les informations d'identification de type OAuth. Le paramètre directory_name indique le répertoire avec le fichier de configuration REST ServiceNow. Vous pouvez créer ce répertoire comme suit : create or replace directory youtube_dir as 'YOUTUBE_DIR'; Obtenez et téléchargez le fichier de configuration REST ServiceNow dans le répertoire indiqué. Exemple : exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); Définissez la valeur file_name sur le nom du fichier de configuration REST que vous avez téléchargé, "youtube.rest". Vous pouvez ensuite utiliser le fichier de configuration REST ServiceNow avec OAuth2.0. Pour obtenir des exemples, reportez-vous à HETEROGENEOUS_CONNECTIVITY_INFO View.

• Pour exécuter DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK avec un utilisateur autre qu'ADMIN, vous devez accorder les privilèges EXECUTE et CREATE DATABASE LINK à cet utilisateur. Par exemple, exécutez la commande suivante en tant qu'ADMIN pour accorder des privilèges à adb_user :

  GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO adb_user;
  GRANT CREATE DATABASE LINK TO adb_user;

  De plus, lorsque vous créez un lien de base de données dans un schéma autre que le schéma ADMIN, par exemple dans un schéma nommé adb_user, le schéma adb_user doit posséder les informations d'identification que vous utilisez avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

• Un seul fichier de portefeuille est valide par répertoire indiqué avec le paramètre directory_name. Vous ne pouvez télécharger qu'un seul fichier cwallet.sso à la fois vers le répertoire choisi pour les fichiers de portefeuille. Ainsi, avec un fichier cwallet.sso dans un répertoire, vous pouvez uniquement créer des liens de base de données vers les bases de données pour lesquelles le portefeuille de ce répertoire est valide. Pour utiliser plusieurs fichiers cwallet.sso avec des liens de base de données, vous devez créer des répertoires supplémentaires et placer chaque fichier cwallet.sso dans un répertoire différent.

  Reportez-vous à Création d'un répertoire dans Autonomous Database pour plus d'informations sur la création de répertoires.

• Pour créer un lien de base de données vers une base de données Autonomous Database, définissez GLOBAL_NAMES sur FALSE sur la base de données source (autre qu'Autonomous Database).

  SQL> ALTER SYSTEM SET GLOBAL_NAMES = FALSE;
   
  System altered.
  
  SQL> SHOW PARAMETER GLOBAL_NAMES
  NAME                     TYPE        VALUE
  ----------------------   ----------- -----------
  global_names             boolean     FALSE
  

• Lorsque le paramètre private_target est TRUE, le paramètre hostname indique un hôte privé à l'intérieur du VCN.

Exemples

La procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM détache un système de fichiers de votre base de données. En outre, la procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM supprime également les informations sur le système de fichiers de la vue DBA_CLOUD_FILE_SYSTEMS.

Syntaxe

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM(
    file_system_name         IN VARCHAR2
);

Paramètres

Exemple :

BEGIN
   DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM (
    file_system_name      => 'FSS'                                       
  );                                                                          
END;                                                                          
/     

Notes d'utilisation

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Vous devez disposer du privilège WRITE sur l'objet de répertoire dans la base de données pour détacher un système de fichiers d'un répertoire à l'aide de la procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM.

• La procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM peut uniquement détacher un service File Storage privé dans les bases de données pour lesquelles les adresses privées sont activées.

  Pour plus d'informations, reportez-vous à Service OCI File Storage et à Configuration de l'accès réseau avec des adresses privées.

• La procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM recherche le nom d'hôte du système de fichiers réseau sur le réseau cloud virtuel (VCN) du client. L'erreur "ORA-20000: Mounting NFS fails" est renvoyée si le nom d'hôte spécifié dans l'emplacement ne peut pas être localisé.

Syntaxe

DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
    service_name      IN VARCHAR2);

Paramètres

Notes d'utilisation

Pour plus d'informations sur la continuité d'application, reportez-vous à Présentation de la continuité d'application.

Exemple

Syntaxe

DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;

Exceptions

Exemple

BEGIN 
   DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;
END;
/

PL/SQL procedure successfully completed.

Syntaxe

DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name    IN  VARCHAR2);

Paramètres

Exemples

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'ORAMTS');   
END;
/

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'AUTO_DST_UPGRADE');   
END;
/

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA');   
END;
/

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'OWM');   
END;
/

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'WORKLOAD_AUTO_REPLAY');   
END;
/

Notes d'utilisation

• Afin de désactiver les fonctionnalités OraMTS, AUTO_DST_UPGRADE, AUTO_DST_UPGRADE_EXCL_DATA, OWM ou WORKLOAD_AUTO_REPLAY pour votre instance Autonomous Database, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Lorsque AUTO_DST_UPGRADE et AUTO_DST_UPGRADE_EXCL_DATA sont désactivés, si de nouvelles versions de fuseau horaire sont disponibles, l'instance Autonomous Database ne procède pas à la mise à niveau pour utiliser les derniers fichiers de fuseau horaire disponibles.

• Interrogez dba_cloud_config pour vérifier que AUTO_DST_UPGRADE est désactivé.

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade';
  
  0 rows selected.

• Interrogez dba_cloud_config pour vérifier que AUTO_DST_UPGRADE_EXCL_DATA est désactivé.

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade_excl_data';
  
  0 rows selected.  

Syntaxe

DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;

Exemple

BEGIN 
    DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;   
END;
/

Syntaxe

DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH(
       provider    IN VARCHAR2,
       username    IN VARCHAR2 DEFAULT 'ADMIN' );

Paramètres

Notes d'utilisation

• Lorsque la valeur du fournisseur est AZURE et que la valeur username est ADMIN, la procédure désactive l'authentification basée sur le principal de service Azure sur Autonomous Database et supprime l'application Azure sur l'instance Autonomous Database.

• Lorsque la valeur du fournisseur est AZURE et que la valeur username est un utilisateur autre que l'utilisateur ADMIN, la procédure révoque les privilèges de l'utilisateur indiqué. L'utilisateur ADMIN et les autres utilisateurs autorisés à utiliser le principal de service Azure peuvent continuer à utiliser ADMIN.AZURE$PA, et l'application créée pour l'instance Autonomous Database reste sur l'instance.

Exemples

Syntaxe

DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2);

Paramètre

Exceptions

Notes d'utilisation

• Le principal de ressource n'est pas disponible avec les clones actualisables.

• Vous devez configurer un groupe dynamique et des stratégies pour le groupe dynamique avant d'appeler DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

  Pour plus d'informations sur la création de stratégies, d'un groupe dynamique et de règles, procédez comme suit :

  • Utilisation du principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure

  • Gérer les groupes dynamiques

  • Gérer les stratégies

• Vérifiez qu'une information d'identification de principal de ressource est activée en interrogeant l'une des vues : DBA_CREDENTIALS ou ALL_TAB_PRIVS.

  Par exemple, en tant qu'utilisateur ADMIN, interrogez la vue DBA_CREDENTIALS :

  SELECT owner, credential_name FROM dba_credentials 
          WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN'; 
  
  OWNER  CREDENTIAL_NAME
  -----  ----------------------
  ADMIN  OCI$RESOURCE_PRINCIPAL 
  

  Par exemple, en tant qu'utilisateur autre qu'ADMIN, interrogez la vue ALL_TAB_PRIVS :

  SELECT grantee, table_name, grantor, FROM ALL_TAB_PRIVS 
            WHERE  grantee = 'ADB_USER';
  
  GRANTEE   TABLE_NAME GRANTOR
  --------- -------------------------------------
  ADB_USER  OCI$RESOURCE_PRINCIPAL ADMIN

Exemple

EXEC DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL();

PL/SQL procedure successfully completed. 

SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL'; 

No rows selected.

Syntaxe

DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK(
        db_link_name      IN VARCHAR2,
        public_link       IN BOOLEAN DEFAULT);

Paramètres

Exemples

Notes d'utilisation

Après avoir utilisé un lien de base de données et exécuté DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK, pour assurer la sécurité de votre base de données Oracle, enlevez les fichiers de portefeuille stockés. Exemples :

• Enlevez le fichier de portefeuille dans la banque d'objets.

• Utilisez DBMS_CLOUD.DELETE_FILE pour enlever le fichier de portefeuille du répertoire data_pump_dir ou du répertoire défini par l'utilisateur dans lequel le fichier de portefeuille a été téléchargé.

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

Paramètres

Notes d'utilisation

Pour plus d'informations sur la continuité d'application, reportez-vous à Présentation de la continuité d'application.

Exemple

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN(
       username     IN VARCHAR2 DEFAULT NULL,
       grant_option IN BOOLEAN DEFAULT FALSE);

Paramètres

Exemple

Remarque sur l'utilisation

• Vous devez être utilisateur ADMIN pour exécuter la procédure DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN.

Pour plus d'informations, reportez-vous à Utilisation des noms de ressource Amazon pour accéder aux ressources AWS.

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
   type         IN VARCHAR2,
   force        IN BOOLEAN DEFAULT FALSE,
   params       IN CLOB DEFAULT NULL
);

Paramètre

Exceptions

Notes d'utilisation

• Avec le type OCI_IAM, si le principal de ressource n'est pas activé sur l'instance Autonomous Database, cette routine active le principal de ressource avec DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

• Cette procédure définit les paramètres système IDENTITY_PROVIDER_TYPE et IDENTITY_PROVIDER_CONFIG sur les utilisateurs requis pour accéder à l'instance avec l'authentification et l'autorisation Oracle Cloud Infrastructure Identity and Access Management.

Exemples

Activation de l'authentification OCI_IAM

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'OCI_IAM',
     force=> TRUE );
END;
/

PL/SQL procedure successfully completed.

Activation de l'authentification CMU pour Microsoft Active Directory

Transmettez un nom de répertoire contenant les fichiers de configuration de la fonctionnalité Utilisateurs gérés centralement via l'argument JSON params.

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'CMU',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'CMU_DIR'); // CMU_DIR directory object already exists
END;
/

PL/SQL procedure successfully completed.

Transmettez un URI d'emplacement pointant vers un emplacement Object Storage contenant les fichiers de configuration de la CMU via l'argument params JSON.

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
       type     => 'CMU',
       params   => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
                               'credential_name' value 'my_credential_name')
   );
END;
/

PL/SQL procedure successfully completed.

Activation de l'authentification Azure AD

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'AZURE_AD',
     force => TRUE,
     params   => JSON_OBJECT( 'tenant_id' VALUE '....',
                              'application_id' VALUE '...',
                              'application_id_uri' VALUE '.....' ));
END;
/

PL/SQL procedure successfully completed.

Activation de l'authentification Kerberos

Transmettez un nom de répertoire contenant les fichiers de configuration Kerberos via l'argument JSON params.

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR'); // KERBEROS_DIR directory object already exists
END;
/

PL/SQL procedure successfully completed.

Transmettez un URI d'emplacement pointant vers un emplacement Object Storage contenant les fichiers de configuration Kerberos via l'argument params JSON :

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
                           'credential_name' value 'my_credential_name');
END;
/

Transmettez un nom de service avec kerberos_service_name dans l'argument JSON params :

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR', // KERBEROS_DIR directory object already exists
                           'kerberos_service_name' value 'oracle' ));
END;
/

Une fois Kerberos activé sur votre instance Autonomous Database, utilisez la requête suivante pour visualiser le nom de service Kerberos :

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

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
    feature_name     IN VARCHAR2,
    params           IN  CLOB   DEFAULT NULL);

Paramètres

Exemple d'activation de la fonctionnalité JAVAVM :

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'JAVAVM' );
END;
/

Exemple d'activation de la fonction d'heure d'été automatique :

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'AUTO_DST_UPGRADE' );
END;
/

Exemple d'activation de la fonction de données EXCL d'heure d'été automatique :

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA' );
END;
/

Exemple d'activation de la fonctionnalité OraMTS :

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'ORAMTS',   
        params       => JSON_OBJECT('location_uri' VALUE 'https://mymtsserver.mycorp.com')
   );
END;
/

Exemple d'activation de la fonctionnalité OWM :

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'OWM' );
END;
/

Exemple d'activation de la fonction de réexécution automatique de la charge globale

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'WORKLOAD_AUTO_REPLAY',
        params       => JSON_OBJECT('target_db_ocid' VALUE 'OCID1.autonomousdatabase.REGION..ID1', 'capture_duration' VALUE 120, 'capture_day' VALUE 'MONDAY', 'capture_time' VALUE '15:00'));
END;
/

La valeur d'erreur ORA-20000: Invalid argument for target_db_ocid peut indiquer que l'OCID que vous avez fourni n'est pas un clone actualisable. Dans ce cas, vous devez fournir un OCID avec une valeur pour un clone actualisable.

Notes d'utilisation

• Vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN pour exécuter DBMS_CLOUD_ADMIN.ENABLE_FEATURE.

• Après avoir exécuté DBMS_CLOUD_ADMIN.ENABLE_FEATURE avec la valeur 'JAVAVM' de feature_name, vous devez redémarrer l'instance Autonomous Database pour installer Oracle Java.

  Après le redémarrage de l'instance Autonomous Database, l'installation Java se poursuit pendant un certain temps après l'ouverture de la base de données.

  Pour plus d'informations sur la vérification du statut de l'installation Java, reportez-vous à Vérification de la version d'Oracle Java.

• Une fois que vous avez exécuté DBMS_CLOUD_ADMIN.ENABLE_FEATURE avec la valeur feature_name 'OWM', vous devez redémarrer l'instance Autonomous Database pour activer Oracle Workspace Manager. Oracle.

• Afin d'activer les fonctionnalités AUTO_DST_UPGRADE, AUTO_DST_UPGRADE_EXCL_DATA, ORAMTS, JAVAVM, OWM ou WORKLOAD_AUTO_REPLAY pour votre base de données, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Par défaut, AUTO_DST_UPGRADE et AUTO_DST_UPGRADE_EXCL_DATA sont tous deux désactivés. Vous pouvez activer l'une ou l'autre de ces options, mais pas les deux.

• Une fois que vous avez activé AUTO_DST_UPGRADE, lors du prochain redémarrage ou arrêt, puis du démarrage de l'instance Autonomous Database, l'instance est mise à niveau pour utiliser les derniers fichiers de fuseau horaire disponibles. Une fois AUTO_DST_UPGRADE activé, lorsque de nouveaux fichiers de fuseau horaire sont disponibles, l'instance poursuit la mise à niveau vers la dernière version disponible à chaque redémarrage ou arrêt et démarrage ultérieurs, jusqu'à ce que la fonctionnalité soit désactivée.

  Interrogez dba_cloud_config pour vérifier que AUTO_DST_UPGRADE est activé.

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade';
  
  PARAM_NAME       PARAM_VALUE
  ---------------- -------------- 
  auto_dst_upgrade enabled

• Une fois que vous avez activé AUTO_DST_UPGRADE_EXCL_DATA, les mises à niveau d'instance Autonomous Database utilisent les derniers fichiers de fuseau horaire disponibles. Une fois cette fonction activée, chaque fenêtre de maintenance suivante met à niveau l'instance pour utiliser la dernière version de fuseau horaire disponible. Cette fonctionnalité garantit que les fichiers de fuseau horaire sont mis à niveau pour la base de données (l'activation de AUTO_DST_UPGRADE_EXCL_DATA ne met pas à jour les lignes affectées).

  Interrogez dba_cloud_config pour vérifier que AUTO_DST_UPGRADE_EXCL_DATA est activé.

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade_excl_data';
  
  PARAM_NAME                    PARAM_VALUE
  --------------------------    -----------
  auto_dst_upgrade_excl_data    enabled

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
    auth_duration    IN  NUMBER  DEFAULT 1
);

Paramètres

Exemple

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
       auth_duration => 12 );
END;
/

Notes d'utilisation

• ORA-20000: Operator access is already enabled indique que l'accès de l'opérateur a déjà été accordé. Dans ce cas :

  • Attendez que l'accès de l'opérateur expire, puis accordez à nouveau l'accès à l'opérateur avec DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS

  • Désactivez explicitement l'accès des opérateurs à l'aide de la procédure DISABLE_OPERATOR_ACCESS.

• DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS autorise uniquement l'accès à Cloud Operator et n'autorise l'accès à aucun autre utilisateur. Toutes les opérations effectuées par l'opérateur cloud sont stockées dans la vue DBA_OPERATOR_ACCESS. Pour plus d'informations, reportez-vous à Affichage des actions des opérations Oracle Cloud Infrastructure.

• Vous autorisez un opérateur cloud à accéder aux schémas de base de données en exécutant la procédure DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS. Cela signifie que si vous enregistrez une demande de service auprès du support technique Oracle Cloud et que les opérateurs Oracle Cloud doivent accéder aux schémas de base de données, vous devez également activer l'accès de l'opérateur en exécutant DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS.

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(
       provider    IN VARCHAR2,
       username    IN VARCHAR2 DEFAULT 'ADMIN',
       params      IN CLOB DEFAULT NULL);

Paramètres

Notes d'utilisation

• Lorsque le paramètre provider est défini sur AZURE, le paramètre params doit inclure azure_tenantid dans les cas suivants :

  • Lorsque DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH est appelé pour la première fois.

  • Lorsque DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH est appelé pour la première fois après l'appel de DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH avec le paramètre provider AZURE et le paramètre username ADMIN.

• Lorsque le paramètre provider est défini sur AWS :

  • Une fois que vous avez activé ARN sur l'instance Autonomous Database en exécutant DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH, les informations d'identification nommées AWS$ARN peuvent être utilisées avec n'importe quelle API DBMS_CLOUD qui prend des informations d'identification comme entrée.

Exemples

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2,
   grant_option     IN BOOLEAN DEFAULT FALSE);

Paramètre

Exceptions

Notes d'utilisation

• Vous devez appeler DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL avec ADMIN avec username ou sans argument avant d'appeler DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL avec un paramètre username pour un schéma d'utilisateur de base de données.

• Vous devez configurer un groupe dynamique et des stratégies pour le groupe dynamique avant d'appeler DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

  Pour plus d'informations sur les stratégies, la création d'un groupe dynamique et les règles, reportez-vous aux sections suivantes :

  • Utilisation du principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure

  • Gérer les groupes dynamiques

  • Gérer les stratégies

• L'activation du principal de ressource avec DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL est une opération ponctuelle. Vous n'avez pas besoin d'activer à nouveau le principal de ressource, sauf si vous exécutez DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL pour désactiver le principal de ressource.

• Le principal de ressource n'est pas disponible avec les clones actualisables.

Exemple

EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

PL/SQL procedure successfully completed. 

SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL'; 

OWNER    CREDENTIAL_NAME
-------  ---------------
ADMIN    OCI$RESOURCE_PRINCIPAL

Exemple

Notes d'utilisation

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Lorsque vous transmettez le paramètre duration à START_WORKLOAD_CAPTURE, la capture se termine lorsqu'elle atteint l'heure indiquée. Toutefois, si vous appelez FINISH_WORKLOAD_CAPTURE, la capture de charge globale est arrêtée (peut-être avant l'heure indiquée avec le paramètre de durée).

  Vous pouvez interroger la vue DBA_CAPTURE_REPLAY_STATUS pour vérifier le statut de fin de la charge globale. Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_STATUS View.

Paramètres

Syntaxe

DBMS_CLOUD_ADMIN.PREPARE_REPLAY(
        capture_name IN VARCHAR2);

Exemple

Cet exemple prépare le clone actualisable pour réexécuter la charge globale indiquée par le paramètre capture_name, ce qui implique de le faire remonter à l'heure de début de la capture, puis de le déconnecter.

Remarque sur l'utilisation

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

Syntaxe

DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE( 
   scope      IN VARCHAR2, 
   before_scn IN INTEGER DEFAULT NULL, 
   before_ts  IN TIMESTAMP DEFAULT NULL); 

Exemple

BEGIN
	DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE(
           scope => 'ALL'); // Purge all historical data from Flashback Data Archive flashback_archive
END;
/

Syntaxe

DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        capture_name                  IN VARCHAR2,        
        replay_name                   IN VARCHAR2 DEFAULT NULL,
        capture_source_tenancy_ocid   IN VARCHAR2 DEFAULT NULL,
        capture_source_db_name        IN VARCHAR2 DEFAULT NULL);

DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        location_uri      IN VARCHAR2,               
        credential_name   IN VARCHAR2 DEFAULT NULL,
        synchronization   IN BOOLEAN  DEFAULT TRUE,
        process_capture   IN BOOLEAN  DEFAULT TRUE);

Paramètres

Exemple de réexécution de la charge globale à partir d'une base de données sur site sur une instance Autonomous Database :

Lorsque vous exécutez cet exemple, il :

• Télécharge les fichiers de capture à partir de l'emplacement Object Storage indiqué dans location_uri et traite les fichiers de capture en fonction de la valeur du paramètre process_capture.

• Réexécute la charge globale capturée en fonction de la valeur du paramètre synchronization.

Dans cet exemple, namespace-string est l'espace de noms de stockage d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

Pour plus d'informations sur Object Storage, reportez-vous à Accès à Oracle Cloud Infrastructure Object Storage et création d'un bucket.

Pour plus d'informations sur le téléchargement de fichiers vers Object Storage, reportez-vous à Téléchargement de fichiers vers le bucket de banque d'objets Oracle Cloud Infrastructure.

La valeur de credential_name utilisée à cette étape correspond aux informations d'identification de la banque d'objets.

Vous n'avez pas besoin de créer d'informations d'identification pour accéder à Oracle Cloud Infrastructure Object Storage si vous activez les informations d'identification de principal de ressource. Pour plus d'informations, reportez-vous à Utilisation du principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure.

Exemple de réexécution de la charge globale à partir d'une instance Autonomous Database sur une autre instance Autonomous Database :

Lorsque vous exécutez cet exemple, il :

• Déconnecte l'instance Autonomous Database en cours.

• Télécharge les fichiers de capture à partir d'Object Storage.

• Réexécute la charge globale capturée.

• Télécharge le rapport de réexécution après une réexécution.

Notes d'utilisation pour la réexécution de la charge globale à partir d'une base de données sur site ou d'une autre base de données Cloud Service sur une autre base de données Autonomous Database

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Avant de démarrer la réexécution, vous devez télécharger vers l'emplacement de stockage d'objet les sous-répertoires cap et capfiles, qui contiennent les fichiers de capture de charge globale.

Remarques sur l'utilisation de la réexécution de la charge globale à partir d'une instance Autonomous Database sur une autre instance Autonomous Database

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Les fichiers de réexécution sont automatiquement téléchargés vers la banque d'objets sous forme de fichier ZIP.

• Vous pouvez interroger la vue DBA_CAPTURE_REPLAY_STATUS pour vérifier le statut de réexécution de la charge globale.

  Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_STATUS View.

Syntaxe

DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION (
    retention_days INTEGER);

Exemple

BEGIN
     DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION(
           retention_days => 90); // sets the retention time to 90 days
END;
/

Syntaxe

DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name  IN VARCHAR2,
        duration      IN NUMBER   DEFAULT NULL);

Paramètres

Exemple

Notes d'utilisation

• Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

• Pour mesurer l'impact d'une modification système sur une charge globale, vous devez vous assurer que les systèmes de capture et de réexécution présentent le même état logique.

• Avant de lancer une capture de charge globale, vous devez envisager de provisionner un clone actualisable afin de garantir le même point de départ pour la réexécution.