Scopri come allegare un file system a Oracle Autonomous Database

Introduzione

Oracle Cloud Infrastructure (OCI) File Storage è un file system elastico completamente gestito che supporta il protocollo NFS (Network File System). Fornisce storage di file condiviso e scalabile che può essere montato contemporaneamente da più istanze di computazione e sistemi di database all'interno di una rete cloud virtuale (VCN, Virtual Cloud Network). Oracle Autonomous Database, costituito da Autonomous Data Warehouse (ADW) e Autonomous Transaction Processing (ATP), è la piattaforma di database completamente gestita di Oracle che automatizza il provisioning, l'ottimizzazione, il ridimensionamento, l'applicazione di patch e i backup. Sebbene Autonomous Database non fornisca l'accesso diretto al file system a livello di sistema operativo, alcune configurazioni di distribuzione, come Oracle Autonomous Database on Dedicated Exadata Infrastructure o Autonomous Database con endpoint privato, consentono l'integrazione con lo storage di file su una VCN privata. Il collegamento dello storage di file ad Autonomous Database consente di:

Accesso ai file condivisi tra Autonomous Database e altre risorse OCI nella stessa VCN.
Posizionamento nell'area intermedia e scambio di file di dati per ETL, analytics o elaborazione batch.
Registra l'archiviazione e riporta l'output direttamente in un'area di memorizzazione file gestita e persistente.

Obiettivi

Questo documento descrive il processo e le considerazioni per l'integrazione di OCI File Storage Service con Oracle Autonomous Data Warehouse (ADW) o Autonomous Transaction Processing (ATP) utilizzando un endpoint privato. Gli obiettivi sono:

Esegui il provisioning di un Autonomous Database sicuro: distribuisci un Autonomous Database con accesso all'endpoint privato per garantire che tutte le comunicazioni con lo storage di file si verifichino su una rete privata sicura.
Abilita connettività di rete per l'accesso NFS: configura le liste di sicurezza VCN o i gruppi di sicurezza di rete per consentire le porte NFS necessarie tra Autonomous Database e lo storage di file.
Provisioning e configurazione dello storage di file: creare un file system e una destinazione di MOUNT all'interno della stessa VCN/subnet (o rete peered) dell'Autonomous Database.
Collega storage di file ad Autonomous Database: esegue il MOUNT del file system ad Autonomous Database utilizzando i comandi OCI e di database supportati.
Verificare l'allegato del file system: eseguire una query su DBA_CLOUD_FILE_SYSTEMS per confermare la riuscita dell'allegato.
Eseguire le operazioni dei file dal database: creare directory nel file system allegato, scrivere, leggere e elencare i file utilizzando package PL/SQL quali UTL_FILE e DBMS_CLOUD.
Comprendi le limitazioni e le restrizioni: documenta i vincoli di servizio, rete e operativi per l'utilizzo dello storage di file con Autonomous Database.

Prerequisiti

Prima di collegare uno storage di file OCI a un Autonomous Database (ADW/ATP), assicurarsi che vengano soddisfatti i requisiti riportati di seguito.

Requisiti di servizio e distribuzione

Un'istanza di Autonomous Database distribuita con:

Endpoint privato abilitato
In hosting su Oracle Autonomous Database on Dedicated Exadata Infrastructure

Il provisioning dello storage di file deve essere eseguito nella stessa area di Autonomous Database.

Requisiti di networking

Configurazione VCN e subnet:
Autonomous Database e la destinazione di accesso allo storage di file devono trovarsi nella stessa VCN/subnet o essere connessi tramite peering VCN.

Regole di sicurezza/NSG:
consentire il traffico NFS in entrata e in uscita tra Autonomous Database e la destinazione di accesso allo storage di file:

TCP 111 (Portmapper)
TCP/UDP 2048–2050 (daemon correlati a NFS)
TCP 2049 (NFS)

Risoluzione DNS:
assicurarsi che il DNS privato sia abilitato in modo che il nome FQDN della destinazione di accesso allo storage di file possa essere risolto da Autonomous Database.

Autorizzazioni IAM

È necessario disporre delle autorizzazioni OCI seguenti:

Gestire Autonomous Database
Gestisci famiglia di memorizzazione file
Gestisci risorse rete virtuale

È necessario disporre del privilegio a livello di database seguente:

Utente ADMIN in Autonomous Database (per eseguire le procedure DBMS_CLOUD_ADMIN)

Strumenti e accesso

È necessario avere accesso ai seguenti strumenti:

Accesso a OCI Console per la creazione/configurazione delle risorse.
Accesso client SQL (SQL Developer, SQL*Plus o SQLcl) per connettersi come ADMIN.
Pacchetto DBMS_CLOUD_ADMIN disponibile in Autonomous Database.

Informazioni da raccogliere prima di iniziare

FQDN della destinazione di accesso dello storage di file
Dettagli subnet per ADB e storage di file
Qualsiasi percorso di esportazione configurato nello storage di file per il file system

Task

Nei task riportati di seguito, configurerai e convaliderai l'integrazione tra File Storage e un Autonomous Database (ADW/ATP) distribuito con l'accesso agli endpoint privati.

Di seguito è illustrata la procedura.

Esegui provisioning di OCI ADW solo con accesso all'endpoint privato
Crea regole di sicurezza VCN per l'accesso allo storage dei file
Creare un file system nello storage di file
Ottenere il nome dominio completamente qualificato (FQDN) per la destinazione di accesso
Collegare il file system ad Autonomous Database
Interrogazione DBA_CLOUD_FILE_SYSTEMS
Creare e scrivere su un file tramite UTL_FILE
Elenca i file nel file system allegato e leggi un file tramite UTL_FILE

Task 1: Provisioning di Autonomous Database

Creare un'istanza ADW con endpoint privato nella VCN e nella subnet appropriate.

Immagine che mostra come creare un'istanza ADW con endpoint privato

Task 2: Configurazione della sicurezza di rete

Creare o aggiornare le liste di sicurezza VCN o i gruppi di sicurezza di rete per consentire il traffico del protocollo NFS tra la subnet di Autonomous Database e le subnet di destinazione di accesso allo storage di file.

Crea regole di sicurezza VCN per l'accesso allo storage di file aggiungendo alcune regole di entrata e uscita nella lista di sicurezza della VCN in modo che Autonomous Database e il file system possano comunicare tra loro.

Ingresso con conservazione dello stato da TUTTE le porte nel blocco CIDR di origine alle porte TCP 111, 2048, 2049 e 2050.
Ingresso con conservazione dello stato da TUTTE le porte nel blocco CIDR di origine alle porte UDP 111 e 2048.
Uscita con conservazione dello stato dalle porte TCP ALL alle porte 111, 2048, 2049 e 2050 nel blocco CIDR di destinazione.
Uscita con conservazione dello stato dalle porte UDP ALL alla porta 111 nel blocco CIDR di destinazione.
Assicurarsi che i gateway del servizio siano disponibili

Immagine che mostra i dettagli della VCN
Immagine che mostra le regole di entrata

Task 3: Provisioning dello storage di file OCI

Creare un file system nello storage di file.
Home -> Storage -> File Storage -> File system -> Create File System for NFS nella console OCI.
Assicurarsi che la destinazione di accesso sia uguale alla VCN e alla subnet di Autonomous Database.

Creare un file system e una destinazione di accesso nella stessa VCN o in una VCN in peering. Immagine che mostra come creare un file system e una destinazione di accesso nella stessa VCN o in una VCN peer

Home -> Storage -> Storage di file -> Destinazioni di accesso nella console OCI.

Configurare le impostazioni di esportazione per la destinazione di accesso.
Immagine che mostra le esportazioni

Task 4: Ottieni dettagli destinazione di accesso

Recupera il nome dominio completamente qualificato (FQDN) e il percorso di esportazione della destinazione di accesso.

Storage di file -> Destinazioni di accesso -> <yourMountTargetName> nella console OCI e ottenere il nome FQDN come mostrato di seguito:

Immagine che mostra come recuperare il nome dominio completamente qualificato (FQDN) e il percorso di esportazione della destinazione di accesso

Task 5: Collegare il file system ad Autonomous Database

  CREATE DIRECTORY FSS_DIR AS 'fss';

  BEGIN
    DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM(
      file_system_name => 'FileSystemTest',
      file_system_location => 'test.sub04171438361.oracledatabase2.oraclevcn.com:/  FileSystem-20250801-1113-05',
     directory_name => 'FSS_DIR',
      description => 'attach OCI file system'
    );
  END;
  /

Utilizzare DBMS_CLOUD_ADMIN.CREATE_FILE_SYSTEM per eseguire il MOUNT dello storage di file in Autonomous Database. Immagine che mostra come collegare il file system ad Autonomous Database

Task 6: Verifica allegato file system

Eseguire una query su DBA_CLOUD_FILE_SYSTEMS per confermare che il file system è stato attivato correttamente.

SELECT file_system_name, file_system_location, directory_path FROM dba_cloud_file_systems;

Immagine che mostra come verificare l'allegato del file system

Task 7: Esegui operazioni file

Creare un oggetto directory che punti allo storage di file e scrivere i file utilizzando UTL_FILE.PUT_LINE.

(È possibile creare un file chiamato channel.csv e scrivere in esso:)

DECLARE
  l_file         UTL_FILE.file_type;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'channel.csv';
BEGIN
  -- Open file.
  l_file := UTL_FILE.fopen(l_location, l_filename, 'w');
   
  UTL_FILE.PUT(l_file, 'Catalog, Indirect, 12');
 
  -- Close the file.
  UTL_FILE.fclose(l_file);
END;
/

Elencare i file utilizzando DBMS_CLOUD.LIST_FILES.

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

Leggere il contenuto dei file utilizzando UTL_FILE.GET_LINE.

DECLARE
  l_file         UTL_FILE.file_type;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'channel.csv';
  l_text         VARCHAR2(32767);
BEGIN
  -- Open file.
  l_file := UTL_FILE.fopen(l_location, l_filename, 'r');
 
 UTL_FILE.GET_LINE(l_file, l_text, 32767);
 DBMS_OUTPUT.put_line(l_text);

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

Task 8: Limitazioni e limitazioni dei documenti

Acquisisci le configurazioni supportate, i vincoli del servizio e le limitazioni note per l'uso di OCI File Storage con Oracle Autonomous Database.

Convalide chiavi

Funziona solo se:

ADW dispone di un endpoint privato nella stessa VCN/subnet dello storage di file o connesso tramite peering VCN.

Le liste di sicurezza/NSG consentono le porte NFS.

Stai utilizzando Oracle Autonomous Database on Dedicated Infrastructure o Oracle Autonomous Database condiviso con endpoint privato e supporto OCI File Storage.

DBA_CLOUD_FILE_SYSTEMS mostrerà lo storage di file di cui è stato eseguito il MOUNT dopo il collegamento riuscito.

UTL_FILE viene abilitato solo sui file system allegati o sulle directory approvate.

Limitazioni e restrizioni

Limitazioni distribuzione

Non supportato nell'endpoint pubblico condiviso di Autonomous Database. Lo storage di file OCI può essere eseguito solo in Oracle Autonomous Database on Dedicated Exadata Infrastructure o Oracle Autonomous Database con endpoint privato e accesso VCN appropriato. Autonomous Database deve trovarsi nella stessa VCN (o VCN in peering) della destinazione di accesso allo storage di file.

Limitazioni di rete

Il traffico NFS (TCP 111, 2048-2050, 2049) deve essere consentito in entrambe le direzioni tra la subnet di Autonomous Database e la subnet di storage di file. Se si utilizza il peering VCN, le regole di sicurezza devono consentire le porte NFS nella connessione peering. La risoluzione DNS deve essere abilitata in modo che Autonomous Database possa risolvere il nome FQDN della destinazione di accesso. Nessun accesso allo storage di file tramite gateway Internet: è necessario utilizzare il routing privato.

Limitazioni del file system

L'accesso root non viene fornito da Autonomous Database; le operazioni vengono eseguite come utente del sistema operativo del database. Non è possibile attivare più del numero massimo di file system definito da Oracle (variabile in base al livello di servizio). La lunghezza del percorso e il nome del file devono essere conformi ai limiti NFS e Oracle (generalmente ≤255 caratteri per nome file).

Limitazioni del database

Le operazioni UTL_FILE sono limitate alle directory nella lista di inclusione create tramite DBMS_CLOUD_ADMIN.CREATE_DIRECTORY_IN_FILE_SYSTEM. Non è possibile modificare manualmente il punto di attivazione NFS, poiché è gestito da Oracle. Nessun accesso a livello di sistema operativo: tutto l'accesso ai file deve avvenire tramite SQL, PL/SQL (UTL_FILE, DBMS_CLOUD) o strumenti come SQL Developer. Le prestazioni di I/O dei file dipendono dai limiti di larghezza di banda della VCN e dal livello di prestazioni dello storage di file.

Restrizioni operative

Se la destinazione di accesso allo storage di file viene eliminata o l'esportazione viene rimossa, l'accesso in Autonomous Database diventa inutilizzabile fino a quando non viene riconfigurato. Nessuna operazione chmod/chown diretta: le autorizzazioni sono gestite dalle opzioni di esportazione in OCI Console. La dimensione massima dei file è limitata dal servizio di storage di file (fino a 8 EiB per file system, ma i singoli file devono essere supportati dai limiti del client NFS). L'alta disponibilità dipende da più destinazioni di accesso nei vari domini di disponibilità: Autonomous Database non subirà automaticamente il failover dello storage di file.

Collegare il file system di rete ad Autonomous Database in Uso di Oracle Autonomous Database Serverless

Conferme

Autore: Aditya Srivastawa (Principal Cloud Architect)

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti di formazione gratuiti sul canale YouTube di Oracle Learning. Inoltre, visitare education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.

Per la documentazione del prodotto, visitare Oracle Help Center.

Titolo e informazioni sul copyright

Attach a File System to Oracle Autonomous Database

G42755-01

Oracle e/o relative consociate.