Attachement d'un stockage de fichiers externe à la base de données Autonomous AI sur une infrastructure Exadata dédiée

Vous pouvez attacher un stockage de fichiers externe déployé dans Oracle Cloud Infrastructure ou on-premise à votre base de données Autonomous AI, à condition que la base de données et le système de fichiers se trouvent sur le même réseau privé. Autonomous AI Database on Dedicated Exadata Infrastructure prend en charge NFSv4, par défaut.

Vous pouvez ainsi charger des données à partir d'OCI File Storage dans votre réseau cloud virtuel (VCN) ou de tout autre système de fichiers réseau dans les data centers sur site.

La prise en charge du stockage de fichiers externes vous permet d'effectuer les opérations suivantes :

Exigences relatives au stockage de fichiers externe

Pour accéder aux données d'une base de données Autonomous AI à partir du système de fichiers, procédez comme suit :

Joindre un système de fichiers externe

Utilisez DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM pour joindre un système de fichiers à un répertoire de votre base de données Autonomous AI.

Remarque : la procédure DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM ne peut attacher un service File Storage privé qu'aux bases de données situées sur des adresses privées.

  1. Créez un répertoire ou utilisez un répertoire existant pour attacher le système de fichiers externe dans votre base de données Autonomous AI. Vous devez disposer du privilège WRITE sur l'objet de répertoire sur votre instance de base de données Autonomous AI pour attacher un système de fichiers à un emplacement de répertoire dans la base de données.

    Par exemple, la commande suivante crée le répertoire FSS_DIR de base de données et le répertoire fss de système de fichiers :

    CREATE DIRECTORY FSS_DIR AS 'fss';

    Pour plus d'informations, reportez-vous à Création d'un répertoire.

  2. Exécutez DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM pour attacher un système de fichiers à un répertoire dans votre base de données Autonomous AI. 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.

    • Par défaut, DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM utilise NFSv3. Cependant, vous pouvez choisir d'utiliser explicitement le paramètre params et d'indiquer nfs_version avec la valeur 3 pour indiquer 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 FSS for sales data'
);END;
/

    • Pour utiliser NFSv4, incluez le paramètre params avec DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM et indiquez nfs_version avec la valeur 4 pour indiquer 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 FSS for sales data',

    **params => JSON_OBJECT('nfs_version' value 4)**
  );
END;
/

    Cet exemple joint le système de fichiers réseau indiqué dans le paramètre file_system_name à la base de données Autonomous AI.

    Le paramètre file_system_location indique l'emplacement du système des fichiers. La valeur que vous fournissez avec file_system_location se compose d'un nom de domaine qualifié complet et d'un chemin de fichier au format : FQDN:file_path. Exemple :

    • FQDN : myhost.sub000445.myvcn.oraclevcn.com

    • Chemin du fichier : /results

    Le paramètre directory_name indique le nom du répertoire dans la base de données Autonomous AI où vous voulez attacher le système de fichiers. Il s'agit du répertoire que vous avez créé à l'étape 1 ou d'un autre répertoire que vous avez créé précédemment.

    Le paramètre description indique la description de la tâche.

Remarques concernant l'utilisation de DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM :

Interroger DBA_CLOUD_FILE_SYSTEMS

Une fois que vous avez joint un système de fichiers, vous pouvez interroger la vue DBA_CLOUD_FILE_SYSTEMS pour extraire des informations sur le système de fichiers joint.

Par exemple :

SELECT file_system_name, file_system_location, directory_path
  FROM dba_cloud_file_systems
  WHERE file_system_name = 'FSS';

Cette requête renvoie les détails du nom du système de fichiers FSS. Pour plus d'informations, consultez la vue DBMS_CLOUD_FILE_SYSTEMS.

Avec un système de fichiers joint, vous pouvez lire et écrire dans les fichiers d'un système de fichiers joint à l'aide de n'importe quelle API PL/SQL qui accepte un nom de répertoire. Par exemple, vous pouvez utiliser l'une des méthodes suivantes pour travailler avec un répertoire FSS attaché :

Exemple illustrant l'écriture d'un fichier sur un système de fichiers joint à l'aide de UTL_FILE :

DECLARE
  l_file         UTL_FILE.FILE_TYPE;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'test.csv';
BEGIN
  -- Open the file.
  l_file := UTL_FILE.FOPEN(l_location, l_filename, 'w');

  UTL_FILE.PUT(l_file, 'Scott, male, 1000');

  -- Close the file.
  UTL_FILE.FCLOSE(l_file);
END;
/

Exemple montrant une lecture de fichier sur un système de fichiers joint à l'aide de UTL_FILE :

DECLARE
  l_file         UTL_FILE.FILE_TYPE;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'test.csv';
  l_text         VARCHAR2(32767);
BEGIN
  -- Open the file.
  l_file := UTL_FILE.FOPEN(l_location, l_filename, 'r');

  UTL_FILE.GET_LINE(l_file, l_text, 32767);

  -- Close the file.
  UTL_FILE.FCLOSE(l_file);
END;
/

Exemple illustrant les fichiers de liste sur un système de fichiers joint à l'aide de DBMS_CLOUD.LIST_FILES :

SELECT object_name FROM DBMS_CLOUD.LIST_FILES('FSS_DIR');

Vue DBMS_CLOUD_FILE_SYSTEMS

La vue DBA_CLOUD_FILE_SYSTEMS répertorie les informations sur le système de fichiers externe attaché à un emplacement de répertoire dans la base de données.

Colonne Type de données Description
FILE_SYSTEM_NAME VARCHAR2(128) Nom du système de fichiers
FILE_SYSTEM_LOCATION VARCHAR2(4000) Emplacement de système de fichiers
DIRECTORY_NAME VARCHAR2(128) Nom de répertoire attaché
DIRECTORY_PATH VARCHAR2(4000) Chemin du répertoire attaché
NFS_VERSION NUMBER Version NFS
DESCRIPTION VARCHAR2(4000) Valeur fournie pour le paramètre de description lorsque vous exécutez DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
CREATION_TIME TIMESTAMP(6) WITH TIME ZONE Horodatage de création
UPDATE_TIME TIMESTAMP(6) WITH TIME ZONE Mettre à jour l'horodatage

Détacher le système de fichiers externe

Utilisez la procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM pour détacher un système de fichiers d'un répertoire de votre base de données Autonomous AI.

Remarque : la procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM peut uniquement détacher un service File Storage privé des bases de données qui se trouvent sur des adresses privées.

Vous devez disposer du privilège WRITE sur l'objet de répertoire pour détacher un système de fichiers d'un emplacement de répertoire.

Exécutez la procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM pour détacher un système de fichiers d'un emplacement de répertoire dans votre base de données Autonomous AI. 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.

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

Cet exemple détache le système de fichiers réseau indiqué dans le paramètre file_system_name de la base de données Autonomous AI. Vous devez indiquer une valeur pour ce paramètre. Les informations relatives à ce système de fichiers sont supprimées de la vue DBA_CLOUD_FILE_SYSTEMS.

Contenu connexe

Pour plus d'informations, reportez-vous à :