Accedi al file system di rete da Autonomous Database

Utilizzare DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM per collegare un file system a una directory in Autonomous Database.

1. Creare una directory o utilizzare una directory esistente per collegare un file system di rete in Autonomous Database. Per collegare un file system a una posizione di directory nel database, è necessario disporre del privilegio WRITE sull'oggetto directory nell'istanza di Autonomous Database.

   Ad esempio, il comando seguente crea la directory del database denominata FSS_DIR e crea la directory del file system fss:

   CREATE DIRECTORY FSS_DIR AS 'fss';

   Per ulteriori informazioni, vedere Crea directory in Autonomous Database.

2. Eseguire DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM per collegare un file system a una directory in Autonomous Database. Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

   • Per impostazione predefinita DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM utilizza 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;
     /

     Facoltativamente, è possibile utilizzare il parametro params e specificare nfs_version con il valore 3 per specificare NFSv3.

   • Per utilizzare NFSv4, includere il parametro params con DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM e specificare nfs_version con il valore 4 per specificare 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;
     /

   Questi esempi collegano il file system di rete specificato nel parametro file_system_name ad Autonomous Database.

   Il parametro file_system_location specifica la posizione del file system. Il valore fornito con file_system_location è costituito da un nome dominio completamente qualificato (FQDN) e da un percorso file nel formato: FQDN:file_path.

   Ad esempio:

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

     Per Oracle Cloud Infrastructure File Storage, impostare il nome FQDN in Mostra opzioni avanzate quando si crea un file system. Per ulteriori informazioni, vedere Creazione di file system.

   • Percorso file: /results

   Il parametro directory_name specifica il nome della directory in Autonomous Database in cui si desidera collegare il file system. Questa è la directory creata al Passo 1 o un'altra directory creata in precedenza.

   Il parametro description specifica la descrizione del task.

   Il parametro params è un valore JSON che specifica un attributo aggiuntivo nfs_version, il cui valore può essere 3 o 4 (NFSv3 o 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');

Utilizzare la procedura DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM per scollegare un file system da una directory in Autonomous Database.

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

Fornisce un esempio di impostazione di un server NSFv4 da utilizzare con Autonomous Database.

1. Impostare un endpoint privato per l'istanza di Autonomous Database.

   Per ulteriori informazioni, vedere Configurazione dell'accesso di rete con endpoint privati.

   Le seguenti regole di entrata e uscita devono essere impostate per la lista di sicurezza della VCN in modo che Autonomous Database e il server NFSv4 possano comunicare tra loro

   • Ingresso con conservazione dello stato da TUTTE le porte nel blocco CIDR di origine alla porta TCP 2049.
   • Uscita con conservazione dello stato dalle porte TCP ALL alla porta 2049 nel blocco CIDR di destinazione.
2. Impostare il server NFS su una VM Oracle Cloud con Oracle Linux 8 nella subnet privata, in grado di connettersi all'istanza di 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. Attivare il file system NFSv4 con DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM.

   Per ulteriori informazioni, vedere Allegare il file system di rete ad Autonomous Database.

La vista DBA_CLOUD_FILE_SYSTEMS elenca le informazioni sul file system di rete collegato a una posizione di directory nel database.