Accès au système de fichiers réseau à partir d'Autonomous Database

Utilisez DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM pour joindre un système de fichiers à un répertoire dans votre instance Autonomous Database.

1. Créez un répertoire ou utilisez un répertoire existant pour attacher un système de fichiers réseau dans votre instance Autonomous Database. Vous devez disposer du privilège WRITE sur l'objet de répertoire sur votre instance Autonomous Database pour joindre 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 dans Autonomous Database.

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

   • Par défaut, DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM utilise 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;
     /

     Vous pouvez éventuellement utiliser le paramètre params et indiquer nfs_version avec la valeur 3 pour indiquer NFSv3.

   • 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 NFS for sales data',
         params                => JSON_OBJECT('nfs_version' value 4)
     );
     END;
     /

   Ces exemples attachent le système de fichiers réseau indiqué dans le paramètre file_system_name à Autonomous Database.

   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 suivant : FQDN:file_path.

   Par exemple :

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

     Pour Oracle Cloud Infrastructure File Storage, définissez le nom de domaine qualifié complet dans Afficher les options avancées lorsque vous créez un système de fichiers. Pour plus d'informations, reportez-vous à la section Creating File Systems.

   • Chemin du fichier : /results

   Le paramètre directory_name indique le nom du répertoire dans la base de données Autonomous Database auquel 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.

   Le paramètre params est une valeur JSON qui indique un attribut supplémentaire nfs_version, dont la valeur peut être 3 ou 4 (NFSv3 ou NFSv4).

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

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

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

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

Utilisez la procédure DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM pour détacher un système de fichiers d'un répertoire dans votre instance Autonomous Database.

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

Fournit un exemple de configuration d'un serveur NSFv4 pour une utilisation avec Autonomous Database.

1. Configurez une adresse privée pour l'instance Autonomous Database.

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

   Les règles entrantes et sortantes suivantes doivent être définies pour la liste de sécurité de votre VCN afin qu'Autonomous Database et le serveur NFSv4 puissent communiquer entre eux

   • Entrée avec état de TOUS Les ports dans le bloc CIDR source vers le port TCP 2049,
   • Sortie avec conservation de statut à partir de TCP ALL ports vers port 2049 dans le bloc CIDR de destination.
2. Configurez le serveur NFS sur une machine virtuelle Oracle Cloud avec Oracle Linux 8 dans le sous-réseau privé, qui peut se connecter à l'instance Autonomous Database.

   Compute Instance Image: Oracle-Linux-8.8-2023.09.26-0
   $ sudo su -
   $ mkdir /exports
   $ chown nobody /exports
   $ chgrp nobody /exports
    
   # If the VM is using Linux 7, "data" directory may need having the privilege 777 so that ADB can have access to NFS.
   uname -a
   chmod 777 /exports/data
    
   $ mkdir /exports/data
   $ chown nobody /exports/data
   $ chgrp nobody /exports/data
    
   # Either the private IP or the private FQDN can be used in "/etc/exports".
   # Both can be found in the information of the autonomous database on the OCI console.
   $ tee -a /etc/exports <<'EOF'
     /exports/data *(rw,insecure)
     /exports/data example.adb.us-phoenix-1.oraclecloud.com(rw,insecure)
     EOF
    
   $ systemctl start nfs-server
   $ systemctl enable nfs-server
    
   # Configure the firewall to allow NFS connections. "public" is the default zone on Oracle Cloud VM.
   $ firewall-cmd --get-default-zone
   public
    
   $ firewall-cmd --zone=public --add-service=nfs
   $ firewall-cmd --permanent --zone=public --add-service=nfs
    
   $ firewall-cmd --reload
    
   # Display a list of the exported file systems.
   $ showmount -e
    
   # Displays all of the current clients and all of the file systems that the clients have mounted.
   $ showmount -a

3. Montez le système de fichiers NFSv4 avec DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM.

   Pour plus d'informations, reportez-vous à Attachement d'un système de fichiers réseau à Autonomous Database.

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