Von autonomer KI-Datenbank auf Netzwerkdateisystem zuzugreifen

Verwenden Sie DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM, um ein Dateisystem an ein Verzeichnis in Ihrer autonomen KI-Datenbank anzuhängen.

1. Erstellen Sie ein Verzeichnis, oder verwenden Sie ein vorhandenes Verzeichnis, um ein Netzwerkdateisystem in der autonomen KI-Datenbank anzuhängen. Sie benötigen die Berechtigung WRITE für das Verzeichnisobjekt in Ihrer autonomen AI-Datenbankinstanz, um ein Dateisystem an einen Verzeichnisspeicherort in der Datenbank anzuhängen.

   Beispiel: Der folgende Befehl erstellt das Datenbankverzeichnis FSS_DIR und das Dateisystemverzeichnis fss:

   CREATE DIRECTORY FSS_DIR AS 'fss';

   Weitere Informationen finden Sie unter Verzeichnis in autonomer KI-Datenbank erstellen.

2. Führen Sie DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM aus, um ein Dateisystem an ein Verzeichnis in Ihrer autonomen KI-Datenbank anzuhängen. Um diese Prozedur ausführen zu können, müssen Sie als ADMIN-Benutzer angemeldet sein oder über die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN verfügen.

   • Standardmäßig verwendet DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 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;
     /

     Optional können Sie den Parameter params verwenden und die nfs_version mit dem Wert 3 angeben, um NFSv3 anzugeben.

   • Um NFSv4 zu verwenden, nehmen Sie den Parameter params in DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM auf, und geben Sie nfs_version mit Wert 4 an, um NFSv4 anzugeben:

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

   In diesen Beispielen wird das im Parameter file_system_name angegebene Netzwerkdateisystem an die autonome KI-Datenbank angehängt.

   Der Parameter file_system_location gibt den Speicherort des Dateisystems an. Der Wert, den Sie mit file_system_location angeben, besteht aus einem vollqualifizierten Domainnamen (FQDN) und einem Dateipfad im Format: FQDN:file_path.

   Beispiel:

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

     Legen Sie für Oracle Cloud Infrastructure File Storage den FQDN in Erweiterte Optionen anzeigen fest, wenn Sie ein Dateisystem erstellen. Weitere Informationen finden Sie unter Dateisysteme erstellen.

   • Dateipfad: /results

   Der Parameter directory_name gibt den Verzeichnisnamen in der autonomen KI-Datenbank an, an die Sie das Dateisystem anhängen möchten. Dies ist das Verzeichnis, das Sie in Schritt 1 erstellt haben, oder ein anderes Verzeichnis, das Sie zuvor erstellt haben.

   Der Parameter description gibt die Beschreibung für die Aufgabe an.

   Der Parameter params ist ein JSON-Wert, der ein zusätzliches Attribut nfs_version angibt, dessen Wert entweder 3 oder 4 (NFSv3 oder NFSv4) sein kann.

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');

Verwenden Sie die Prozedur DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM, um ein Dateisystem von einem Verzeichnis in Ihrer autonomen KI-Datenbank zu trennen.

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

Enthält ein Beispiel für das Einrichten eines NSFv4-Servers zur Verwendung mit Autonomous AI Database.

1. Richten Sie einen privaten Endpunkt für die Instanz der autonomen KI-Datenbank ein.

   Weitere Informationen finden Sie unter Netzwerkzugriff mit privaten Endpunkten konfigurieren.

   Die folgenden Ingress- und Egress-Regeln müssen für die Sicherheitsliste des VCN festgelegt werden, damit Autonomous AI Database und der NFSv4-Server miteinander kommunizieren können.

   • Zustandsbehafteter Ingress von ALLEN Ports im Quell-CIDR-Block zu TCP-Port 2049.
   • Zustandsbehafteter Egress-Traffic von TCP ALL-Ports zu Port 2049 im Ziel-CIDR-Block
2. Richten Sie den NFS-Server auf einer Oracle Cloud-VM mit Oracle Linux 8 im privaten Subnetz ein, das eine Verbindung zur Instanz der autonomen KI-Datenbank herstellen kann.

   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. Mounten Sie das Dateisystem NFSv4 mit DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM.

   Weitere Informationen finden Sie unter Netzwerkdateisystem an autonome KI-Datenbank anhängen.

Die Ansicht DBA_CLOUD_FILE_SYSTEMS listet Informationen über das Netzwerkdateisystem auf, das an ein Verzeichnis in der Datenbank angehängt ist.