Sommaire des sous-programmes DBMS_CLOUD_ADMIN

La procédure DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM associe un système de fichiers à votre 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 :

Attacher à 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;
/     

Attacher à 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 ne peut attacher un service de stockage de fichiers privé que dans les bases de données pour lesquelles des points d'extrémité privés sont activés.

  Pour plus d'informations, voir Service de stockage de fichiers OCI et Configurer l'accès au réseau à l'aide de points d'extrémité privés.

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

• Le service de stockage de fichiers d'Oracle Cloud Infrastructure utilise NFSv3 pour le partage

• Si vous associez des systèmes de stockage de fichiers non Oracle Cloud Infrastructure, la procédure prend en charge NFSv3 et NFSv4

• Si vous avez un serveur NFS attaché qui utilise NFSv3 et que la version NFS est mise à jour à 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 réglé à 4). Cette opération associe NFS au protocole correspondant afin qu'Autonomous AI Database puisse accéder au serveur NFSv4. Sans le détachement, puis le 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 la charge globale en cours et active l'actualisation du clone actualisable.

DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;

Exemple

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

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 spécifiez 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, il existe deux paramètres facultatifs, auth_method et domain pour prendre en charge l'authentification NTLM/AD. Lorsque NTLMv2 est configuré, réglez auth_method=10 et réglez domain à la valeur du 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 Oracle sur place. Pour plus d'informations, voir Méthode d'authentification Microsoft SQL Server.
  google_analytics	Lorsque db_type est google_analytics, les données d'identification que vous spécifiez doivent être des données d'identification Google OAuth (gcp_oauth2). Pour plus d'informations, voir ProcédureCREATE_CREDENTIAL.
  google_bigquery	Lorsque db_type est google_bigquery, les données d'identification que vous spécifiez doivent être des données d'identification Google OAuth (gcp_oauth2) Voir Procédure CREATE_CREDENTIAL pour plus d'informations. Lorsque db_type est google_bigquery, le paramètre project est valide. Ce paramètre spécifie le nom du projet pour google_bigquery et est obligatoire. Le nom de table que vous spécifiez lorsque vous utilisez SELECT avec Google BigQuery doit être entre guillemets. Exemple : SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK
  google_drive	Pour db_type google_drive, les données 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 spécifié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 mappe la réponse JSON au modèle relationnel. Le fichier de modèle spécifie les points d'extrémité, le mappage de table et le code de réponse HTTP pour le traitement de la réponse JSON. Pour plus d'informations, voir Syntaxe du fichier 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 le paramètre gateway_params db_type avec la valeur 'google_drive' et les paramètres directory_name et file_name, ainsi que les données d'identification de type OAuth : Le paramètre directory_name spécifie 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'; Obtenez et téléchargez le fichier REST automatique dans le répertoire spécifié. Exemple : exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); Réglez la valeur file_name au 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 hive, le paramètre http_path est valide. Ce paramètre spécifie la valeur HttpPath, si nécessaire, pour la connexion à l'instance Hive.
  salesforce	Lorsque db_type est salesforce, le paramètre : security_token est valide. Un jeton de sécurité est un code alphanumérique sensible à la casse. Une valeur security_token est requise pour accéder à Salesforce. Exemple : gateway_params => JSON_OBJECT( 'db_type' value 'salesforce', 'security_token' value 'security_token_value' ) Pour plus d'informations, voir Réinitialiser le jeton de sécurité.
  servicenow	Pour vous connecter à ServiceNow 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 de configuration REST) qui mappe la réponse JSON au modèle relationnel. Le fichier de modèle spécifie les points d'extrémité, le mappage de table et le code de réponse HTTP pour le traitement de la réponse JSON. Pour plus d'informations, voir Syntaxe du fichier de modèle et Exemple de fichier de 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 fournir les paramètres directory_name et file_name ainsi que les données d'identification de type nom d'utilisateur/mot de passe. Authentification OAuth 2.0 : Vous devez fournir au paramètre gateway_params db_type la valeur 'servicenow' et les paramètres directory_name, file_name et token_uri, ainsi que les données d'identification de type OAuth. Le paramètre directory_name spécifie 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 spécifié. Exemple : exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); Réglez la valeur file_name au 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. Voir Vue HETEROGENEOUS_CONNECTIVITY_INFO pour des exemples.
  sharepoint	Lorsque vous utilisez le paramètre gateway_params avec db_type sharepoint, spécifiez également des valeurs pour auth_uri, scope, service_url et token_uri. Pour db_type sharepoint, les données 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 spécifiées (client_id, client_secret et refresh_token). Pour plus d'informations, voir ProcédureCREATE_CREDENTIAL. Générer la valeur de refresh_token pour tenant_id.sharepoint.com/.default offline_access. Pour plus d'informations, voir Déterminer la portée et Authentification OAuth 2.0. Définissez des valeurs pour gateway_params pour db_type sharepoint : auth_uri : Définissez auth_uri à partir d'Azure. Pour plus d'informations, voir Obtenir des informations sur le client d'application et des points d'extrémité. scope : Définissez la portée. Pour plus d'informations, voir Descriptions des options de connexion. service_url : Définissez service_url. Pour plus d'informations, voir URL du service. token_uri : Obtenir token_uri à partir d'Azure. Pour plus d'informations, voir Obtenir des informations sur le client d'application et des points d'extrémité.
  snowflake	Lorsque db_type est SNOWFLAKE, les paramètres facultatifs : role, schema et warehouse sont valides. Ces valeurs indiquent une valeur de schéma, de rôle ou d'entrepôt différente de celle 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 fournir les paramètres de passerelle directory_name et file_name. Ces paramètres spécifient un fichier de modèle (fichier de configuration REST) qui mappe la réponse JSON au modèle relationnel. Le fichier de modèle spécifie les points d'extrémité, le mappage de table et le code de réponse HTTP pour le traitement de la réponse JSON. Pour plus d'informations, voir Syntaxe du fichier de modèle et Exemple de fichier de modèle. Lorsque vous utilisez le paramètre gateway_params avec db_type youtube, les données d'identification que vous spécifiez doivent être des données d'identification Google OAuth (gcp_oauth2) Voir Procédure CREATE_CREDENTIAL pour plus d'informations. Authentification OAuth 2.0 : Vous devez fournir le paramètre gateway_params db_type avec la valeur youtube, les paramètres directory_name et file_name, ainsi que les données d'identification de type OAuth. Le paramètre directory_name spécifie 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 spécifié. Exemple : exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); Réglez la valeur file_name au 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. Voir Vue HETEROGENEOUS_CONNECTIVITY_INFO pour des exemples.

• 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'administrateur pour accorder des privilèges à adb_user :

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

  En outre, 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 être responsable des données d'identification que vous utilisez avec DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

• Un seul fichier de portefeuille est valide par répertoire spécifié avec le paramètre directory_name. Vous ne pouvez charger qu'un seul fichier cwallet.sso à la fois dans le répertoire choisi pour les fichiers de portefeuille. Cela signifie qu'avec 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.

  Voir Créer un répertoire dans Autonomous AI 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 IA autonome, réglez GLOBAL_NAMES à FALSE sur la base de données source (base de données IA non autonome).

  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 spécifie un hôte privé dans le 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 ne peut détacher un service de stockage de fichiers privé que dans les bases de données pour lesquelles des points d'extrémité privés sont activés.

  Pour plus d'informations, voir Service de stockage de fichiers OCI et Configurer l'accès au réseau à l'aide de points d'extrémité privés.

• La procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM recherche le nom d'hôte du système de fichiers de réseau sur le réseau en nuage virtuel (VCN) du client. L'erreur "ORA-20000: Mounting NFS fails" est retourné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

Voir Aperçu de la continuité des applications pour plus d'informations sur la continuité des applications.

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

• Pour désactiver les fonctions OraMTS, AUTO_DST_UPGRADE, AUTO_DST_UPGRADE_EXCL_DATA, OWM ou WORKLOAD_AUTO_REPLAY pour votre instance de base de données d'intelligence artificielle autonome, 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 de base de données d'intelligence artificielle autonome 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 username est ADMIN, la procédure désactive l'authentification basée sur le principal de service Azure dans Autonomous AI Database et supprime l'application Azure dans l'instance Autonomous AI Database.

• Lorsque la valeur du fournisseur est AZURE et que username est un utilisateur autre que l'utilisateur ADMIN, la procédure révoque les privilèges de l'utilisateur spécifié. L'utilisateur ADMIN et les autres utilisateurs qui sont activés pour utiliser le principal de service Azure peuvent continuer à utiliser ADMIN.AZURE$PA et l'application créée pour l'instance de base de données d'intelligence artificielle autonome 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 des clones actualisables.

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

  Pour plus d'informations sur la création de politiques, la création d'un groupe dynamique et la création de règles, voir :

  • Utiliser un principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure

  • Gestion des groupes dynamiques

  • Gestion des politiques

• Vérifiez que les données d'identification d'un principal de ressource sont activées en interrogeant l'une des vues : DBA_CREDENTIALS ou ALL_TAB_PRIVS.

  Par exemple, lorsque l'utilisateur ADMIN interroge 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 non 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

Une fois que vous avez terminé d'utiliser un lien de base de données et que vous avez exécuté DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK, pour assurer la sécurité de votre base de données Oracle, supprimez tous les fichiers de portefeuille stockés. Exemple :

• Supprimez le fichier de portefeuille dans le magasin d'objets.

• Utilisez DBMS_CLOUD.DELETE_FILE pour supprimer 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é chargé.

Syntaxe

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

Paramètres

Notes d'utilisation

Voir Aperçu de la continuité des applications pour plus d'informations sur la continuité des applications.

Exemple

Syntaxe

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

Paramètres

Exemple

Note d'utilisation

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

Pour plus d'informations, voir Utiliser des noms de ressource Amazon (ARN) 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 type OCI_IAM, si le principal de ressource n'est pas activé sur l'instance de base de données d'intelligence artificielle autonome, ce sous-programme active le principal de ressource avec DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

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

Exemples

Activer l'authentification OCI_IAM

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

PL/SQL procedure successfully completed.

Activer l'authentification CMU pour Microsoft Active Directory

Vous transmettez un nom de répertoire qui contient les fichiers de configuration CMU au moyen de 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.

Vous transmettez un URI d'emplacement pointant vers un emplacement de stockage d'objets qui contient des fichiers de configuration CMU au moyen de l'argument JSON params.

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.

Activer 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.

Activer l'authentification Kerberos

Vous transmettez un nom de répertoire qui contient des fichiers de configuration Kerberos au moyen de 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.

Vous transmettez un URI d'emplacement pointant vers un emplacement de stockage d'objets qui contient des fichiers de configuration Kerberos au moyen de l'argument JSON params :

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;
/

Vous 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 AI Database, utilisez l'interrogation suivante pour voir le nom du 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 pour activer la fonction JAVAVM :

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

Exemple pour activer la fonction d'heure avancée automatique :

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

Exemple pour activer la fonction de données DST EXCL automatique :

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

Exemple pour activer la fonction OraMTS :

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

Exemple pour activer la fonction OWM :

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

Exemple pour activer la fonction de réexécution automatique de charge de travail

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;
/

Une 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 feature_name 'JAVAVM', vous devez redémarrer l'instance de base de données d'intelligence artificielle autonome pour installer Oracle Java.

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

  Voir Vérifier la version Java d'Oracle pour plus de détails sur la vérification du statut de l'installation Java.

• Après avoir exécuté DBMS_CLOUD_ADMIN.ENABLE_FEATURE avec la valeur feature_name 'OWM', vous devez redémarrer l'instance de base de données du service d'intelligence artificielle autonome pour activer Oracle Workspace Manager. Oracle.

• Pour activer les fonctions 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 désactivés. Vous pouvez activer l'une ou l'autre de ces options, mais pas les deux.

• Après avoir activé AUTO_DST_UPGRADE, la prochaine fois que vous redémarrez, ou que vous arrêtez puis démarrez l'instance de base de données d'IA autonome, 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 continue de passer à la dernière version disponible à chaque redémarrage ou arrêt et démarrage ultérieurs, jusqu'à ce que la fonction 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

• Après avoir activé AUTO_DST_UPGRADE_EXCL_DATA, l'instance de base de données du service d'intelligence artificielle autonome est mise à niveau pour utiliser les derniers fichiers de fuseau horaire disponibles. Une fois cette fonction activée, chaque fenêtre de maintenance suivante met à niveau l'instance pour qu'elle utilise la dernière version de fuseau horaire disponible. Cette fonction 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 rangées concerné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, vous disposez de deux options :

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

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

• DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS autorise uniquement l'accès à l'opérateur de nuage et n'autorise l'accès à aucun autre utilisateur. Toutes les opérations effectuées par l'opérateur de nuage sont stockées dans la vue DBA_OPERATOR_ACCESS. Pour plus d'informations, voir Voir les actions sur les opérations d'Oracle Cloud Infrastructure.

• Vous autorisez un opérateur en nuage à 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 soumettez une demande de service avec le soutien technique pour Oracle Cloud et que les opérateurs Oracle Cloud doivent accéder à vos schémas de base de données, vous devez également activer l'accès des opérateurs en exécutantDBMS_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 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 que DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH est appelé avec le paramètre provider AZURE et le paramètre username ADMIN.

• Lorsque le paramètre provider est AWS :

  • Après avoir activé ARN sur l'instance de base de données d'intelligence artificielle autonome en exécutant DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH, les données d'identification nommées AWS$ARN peuvent être utilisées avec toute API DBMS_CLOUD qui utilise des données 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 username ou sans argument avant d'appeler DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL avec username pour un schéma d'utilisateur de base de données.

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

  Pour plus d'informations sur les politiques, la création d'un groupe dynamique et la création de règles, voir :

  • Utiliser un principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure

  • Gestion des groupes dynamiques

  • Gestion des politiques

• 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 de 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 des 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 saisie se termine lorsqu'elle atteint l'heure spécifiée. Toutefois, si vous appelez FINISH_WORKLOAD_CAPTURE, cela arrête la saisie de la charge de travail (peut-être avant l'heure spécifié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 de travail. Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_STATUS.

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 de travail indiquée par le paramètre capture_name, ce qui implique de l'indiquer à l'heure de début de la capture, puis de la déconnecter.

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

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 de travail à partir d'une base de données sur place sur une instance de base de données d'IA autonome :

Lorsque vous exécutez cet exemple, il effectue les opérations suivantes :

• Télécharge les fichiers de saisie à partir de l'emplacement de stockage d'objets spécifié dans location_uri et traite les fichiers de saisie en fonction de la valeur du paramètre process_capture.

• Permet de réexécuter la charge de travail saisie en fonction de la valeur du paramètre synchronization.

Dans cet exemple, namespace-string est l'espace de noms du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

Voir Naviguer jusqu'au service de stockage d'objets pour Oracle Cloud Infrastructure et créer un seau pour plus d'informations sur le stockage d'objets.

Voir Charger des fichiers dans le seau de stockage d'objets Oracle Cloud Infrastructure pour plus d'informations sur le chargement de fichiers dans le stockage d'objets.

La valeur credential_name que vous utilisez dans cette étape correspond aux données d'identification pour le magasin d'objets.

Vous n'avez pas besoin de créer des données d'identification pour accéder au magasin d'objets Oracle Cloud Infrastructure si vous activez les données d'identification du principal de ressource. Pour plus d'informations, voir Utiliser un principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure.

Exemple de réexécution de la charge de travail à partir d'une instance de base de données IA autonome sur une autre base de données IA autonome :

Lorsque vous exécutez cet exemple, il effectue les opérations suivantes :

• Déconnecte l'instance de base de données IA autonome courante.

• Télécharge les fichiers de saisie à partir du stockage d'objets.

• Permet de réexécuter la charge globale capturée.

• Charge le rapport de réexécution après une réexécution.

Notes d'utilisation pour la réexécution de la charge de travail à partir d'une base de données Cloud Service sur place ou autre sur une autre base de données autonome avec intelligence artificielle

• 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 commencer la réexécution, vous devez charger les sous-répertoires cap et capfiles, qui contiennent les fichiers de saisie de charge de travail, dans l'emplacement de stockage d'objets.

Notes d'utilisation pour rejouer la charge de travail à partir d'une instance de base de données d'IA autonome sur une autre base de données d'IA autonome

• 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 chargés dans le magasin d'objets en tant que fichier zip.

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

  Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_STATUS.

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 du système sur une charge globale, vous devez vous assurer que les systèmes de capture et de réexécution ont le même état logique.

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

Syntaxe

DBMS_CLOUD_ADMIN.START_LIVE_WORKLOAD_REPLAY(
        capture_replay_name  IN VARCHAR2,
        target_db_ocid       IN VARCHAR2,
        capture_duration     IN NUMBER DEFAULT NULL,
        reconnect_target     IN BOOLEAN DEFAULT TRUE
 );

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 du système sur une charge globale, vous devez vous assurer que les systèmes de capture et de réexécution ont le même état logique.

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