Découvrez comment attacher un système de fichiers à Oracle Autonomous Database

Introduction

Oracle Cloud Infrastructure (OCI) File Storage est un système de fichiers élastique entièrement géré qui prend en charge le protocole NFS (Network File System). Il fournit un stockage de fichiers partagé et évolutif qui peut être monté simultanément par plusieurs instances de calcul et systèmes de base de données au sein d'un réseau cloud virtuel (VCN). Oracle Autonomous Database, composé d'Autonomous Data Warehouse (ADW) et d'Autonomous Transaction Processing (ATP), est la plate-forme de base de données entièrement gérée d'Oracle qui automatise le provisionnement, le réglage, la mise à l'échelle, l'application de patches et les sauvegardes. Bien qu'Autonomous Database ne fournisse pas d'accès direct au système de fichiers au niveau du système d'exploitation, certaines configurations de déploiement, telles qu'Oracle Autonomous Database on Dedicated Exadata Infrastructure ou Autonomous Database avec une adresse privée, permettent l'intégration à File Storage sur un VCN privé. L'attachement de File Storage à une instance Autonomous Database permet les opérations suivantes :

Accès aux fichiers partagés entre Autonomous Database et d'autres ressources OCI dans le même VCN.
Stockage et échange de fichiers de données pour le traitement ETL, l'analyse ou le traitement par lots.
Journaliser l'archivage et générer des rapports directement dans un fichier de stockage géré et persistant.

Objectifs

Ce document décrit le processus et les éléments à prendre en compte pour intégrer OCI File Storage Service à Oracle Autonomous Data Warehouse (ADW) ou Autonomous Transaction Processing (ATP) à l'aide d'une adresse privée. Les objectifs sont les suivants :

Provisionner une instance Autonomous Database sécurisée : déployez une instance Autonomous Database avec un accès d'adresse privée pour garantir que toutes les communications avec File Storage se déroulent sur un réseau privé et sécurisé.
Activer la connectivité réseau pour l'accès NFS : configurez les listes de sécurité VCN ou les groupes de sécurité réseau pour autoriser les ports NFS requis entre Autonomous Database et File Storage.
Provisionner et configurer File Storage : créez un système de fichiers et une cible de montage au sein du même VCN/sous-réseau (ou réseau appairé) que la base de données Autonomous Database.
Attachement de File Storage à Autonomous Database : montez le système de fichiers vers Autonomous Database à l'aide des commandes OCI et de base de données prises en charge.
Vérifier la pièce jointe du système de fichiers : interrogez DBA_CLOUD_FILE_SYSTEMS pour confirmer la réussite de la pièce jointe.
Effectuer des opérations sur les fichiers à partir de la base de données : créer des répertoires dans le système de fichiers attaché, écrire dans des fichiers, les lire et répertorier des fichiers à l'aide de packages PL/SQL tels que UTL_FILE et DBMS_CLOUD.
Comprendre les limites et les restrictions : documentez les contraintes de service, de réseau et opérationnelles pour l'utilisation de File Storage avec Autonomous Database.

Prérequis

Avant d'attacher un stockage de fichiers OCI à une instance Autonomous Database (ADW/ATP), assurez-vous que les conditions suivantes sont remplies :

Exigences en matière de service et de déploiement

Une instance Autonomous Database déployée avec :

Adresse privée activée
Hébergé sur Oracle Autonomous Database on Dedicated Exadata Infrastructure

File Storage doit être provisionné dans la même région que la instance Autonomous Database.

Configuration réseau requise

Configuration de VCN et de sous-réseau :
la base de données Autonomous Database et la cible de montage File Storage doivent se trouver dans le même VCN/sous-réseau ou être connectées via l'appairage VCN.

Règles de sécurité/GNS :
autorisez le trafic NFS entrant et sortant entre la cible de montage Autonomous Database et File Storage :

TCP 111 (Portmapper)
TCP/UDP 2048–2050 (démons liés à NFS)
TCP 2049 (NFS)

Résolution DNS :
assurez-vous que le DNS privé est activé afin que le nom de domaine qualifié complet de la cible de montage File Storage puisse être résolu à partir d'Autonomous Database.

Droits d'accès IAM

Vous devez disposer des droits d'accès OCI suivants :

Gestion d'une base de données autonome
Gérer la famille de stockage de fichiers
Gérer les ressources de réseau virtuel

Vous devez disposer du privilège de niveau base de données suivant :

Utilisateur ADMIN dans Autonomous Database (pour exécuter les procédures DBMS_CLOUD_ADMIN)

Outils et accès

Vous devez avoir accès aux outils suivants :

Accès à la console OCI pour la création/configuration de ressources.
Accès client SQL (SQL Developer, SQL*Plus ou SQLcl) pour la connexion en tant qu'utilisateur ADMIN.
Package DBMS_CLOUD_ADMIN disponible dans Autonomous Database.

Informations à collecter avant de commencer

Nom de domaine qualifié complet de cible de montage du stockage de fichiers
Détails de sous-réseau pour ADB et File Storage
Tout chemin d'export configuré dans File Storage pour le système de fichiers

Tâches

Dans les tâches suivantes, vous allez configurer et valider l'intégration entre File Storage et une instance Autonomous Database (ADW/ATP) déployée avec un accès à une adresse privée.

Voici les étapes à suivre :

Provisionner OCI ADW avec accès à une adresse privée uniquement
Créer des règles de sécurité VCN pour l'accès au stockage de fichiers
Création d'un système d'exploitation dans File Storage
Obtenir le nom de domaine qualifié complet de la cible de montage
Attachement du système de fichiers à Autonomous Database
Interroger DBA_CLOUD_FILE_SYSTEMS
Créer et écrire dans un fichier via UTL_FILE
Répertoriez les fichiers dans le système de fichiers joint et lisez un fichier via UTL_FILE

Tâche 1 : provisionnement d'Autonomous Database

Créez une instance ADW avec une adresse privée dans le VCN et le sous-réseau appropriés.

Image illustrant la création d'une instance ADW avec une adresse privée

Tâche 2 : configurer la sécurité réseau

Créez ou mettez à jour des listes de sécurité VCN ou des groupes de sécurité réseau pour autoriser le trafic de protocole NFS entre le sous-réseau Autonomous Database et les sous-réseaux de cibles de montage File Storage.

Créez des règles de sécurité VCN pour l'accès à File Storage, en ajoutant des règles entrantes et sortantes dans la liste de sécurité du VCN afin que votre instance Autonomous Database et votre système de fichiers puissent communiquer entre eux.

Entrée avec état à partir de TOUS Les ports du bloc CIDR source vers les ports TCP 111, 2048, 2049 et 2050.
Entrée avec état à partir de TOUS Les ports du bloc CIDR source vers les ports UDP 111 et 2048.
Sortie avec conservation de statut à partir des ports TCP ALL vers les ports 111, 2048, 2049 et 2050 du bloc CIDR de destination.
Sortie avec conservation de statut des ports ALL UDP vers le port 111 dans le bloc CIDR de destination.
Assurez-vous que les passerelles de service sont disponibles

Image présentant les détails du VCN
Image représentant les règles entrantes
Illustration présentant les règles sortantes

Tâche 3 : provisionnement d'OCI File Storage

Créez un système d'exploitation dans File Storage.
Accueil -> Stockage -> Stockage de fichiers -> Systèmes de fichiers -> Créer un système de fichiers pour NFS dans la console OCI.
Assurez-vous que la cible de montage est identique au sous-réseau et au VCN d'Autonomous Database.

Créez un système de fichiers et une cible de montage dans le même VCN ou dans un VCN appairé. Image montrant comment créer un système de fichiers et une cible de montage dans le même VCN ou un VCN appairé

Accueil -> Stockage -> File Storage -> Monter des cibles dans la console OCI.

Configurez les paramètres d'export pour la cible de montage.
Image représentant les exportations

Tâche 4 : obtenir les détails de la cible de montage

Récupérez le nom de domaine qualifié complet et le chemin d'export de la cible de montage.

File Storage -> Mount Targets -> <yourMountTargetName> dans la console OCI et obtenez le nom de domaine qualifié complet comme indiqué ci-dessous :

Image montrant comment extraire le nom de domaine qualifié complet et le chemin d'export de la cible de montage

Tâche 5 : attachement du système de fichiers à 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;
  /

Utilisez DBMS_CLOUD_ADMIN.CREATE_FILE_SYSTEM pour monter le stockage de fichiers sur Autonomous Database. Image montrant comment attacher le système de fichiers à Autonomous Database

Tâche 6 : vérifier la pièce jointe du système de fichiers

Interrogez DBA_CLOUD_FILE_SYSTEMS pour vérifier que le système de fichiers a été monté.

SELECT file_system_name, file_system_location, directory_path FROM dba_cloud_file_systems;

Image montrant comment vérifier la pièce jointe du système de fichiers

Tâche 7 : effectuer des opérations sur les fichiers

Créez un objet répertoire pointant vers File Storage et écrivez des fichiers à l'aide de UTL_FILE.PUT_LINE.

(Vous pouvez créer un fichier nommé channel.csv et y écrire :)

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

Répertoriez les fichiers à l'aide de DBMS_CLOUD.LIST_FILES.

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

Lisez le contenu du fichier à l'aide de 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;
/

Tâche 8 : Restrictions et limites des documents

Capturez les configurations prises en charge, les contraintes de service et les limites connues pour l'utilisation d'OCI File Storage avec Oracle Autonomous Database.

Validations de clé

Cela ne fonctionne que si :

ADW dispose d'une adresse privée dans le même VCN/sous-réseau que File Storage ou connectée via un appairage VCN.

Les listes de sécurité/NSG autorisent les ports NFS.

Vous utilisez Oracle Autonomous Database sur une infrastructure dédiée ou Oracle Autonomous Database partagé avec une adresse privée + prise en charge d'OCI File Storage.

DBA_CLOUD_FILE_SYSTEMS affiche le stockage de fichiers monté après la connexion réussie.

UTL_FILE est activé uniquement sur les systèmes de fichiers joints ou les répertoires approuvés.

Limites et restrictions

Restrictions de déploiement

Non pris en charge sur l'adresse publique Autonomous Database Shared. OCI File Storage ne peut être monté que dans Oracle Autonomous Database on Dedicated Exadata Infrastructure ou Oracle Autonomous Database avec une adresse privée et un accès VCN approprié. Autonomous Database doit se trouver dans le même VCN (ou VCN appairé) que la cible de montage File Storage.

Restrictions réseau

Le trafic NFS (TCP 111, 2048–2050, 2049) doit être autorisé dans les deux sens entre le sous-réseau Autonomous Database et le sous-réseau File Storage. Si vous utilisez l'appairage VCN, les règles de sécurité doivent autoriser les ports NFS sur la connexion d'appairage. La résolution DNS doit être activée afin qu'Autonomous Database puisse résoudre le nom de domaine qualifié complet de la cible de montage. Aucun accès à File Storage via une passerelle Internet — vous devez utiliser un routage privé.

Restrictions du système de fichiers

L'accès root n'est pas fourni à partir d'Autonomous Database ; les opérations sont effectuées en tant qu'utilisateur du système d'exploitation de base de données. Vous ne pouvez pas monter plus que le nombre maximal de systèmes de fichiers défini par Oracle (varie selon le niveau de service). La longueur du chemin et le nom du fichier doivent respecter les limites NFS et Oracle (généralement ≤255 caractères par nom de fichier).

Restrictions de base de données

Les opérations UTL_FILE sont limitées aux répertoires sur liste blanche créés via DBMS_CLOUD_ADMIN.CREATE_DIRECTORY_IN_FILE_SYSTEM. Vous ne pouvez pas modifier manuellement le point de montage NFS, car il est géré par Oracle. Aucun accès au niveau du système d'exploitation : tous les accès aux fichiers doivent passer par SQL, PL/SQL (UTL_FILE, DBMS_CLOUD) ou des outils tels que SQL Developer. Les performances d'E/S de fichier dépendent des limites de bande passante VCN et du niveau de performances File Storage.

Restrictions opérationnelles

Si la cible de montage File Storage est supprimée ou que l'export est enlevé, le montage dans Autonomous Database devient inutilisable jusqu'à ce qu'il soit reconfiguré. Aucune opération chmod/chown directe : les droits d'accès sont gérés par les options d'export dans la console OCI. La taille maximale des fichiers est limitée par le service File Storage (jusqu'à 8 EiB par système de fichiers, mais les fichiers individuels doivent être pris en charge par les limites du client NFS). La haute disponibilité dépend de plusieurs cibles de montage sur des domaines de disponibilité. Autonomous Database ne bascule pas automatiquement sur File Storage.

Attachement d'un système de fichiers réseau à Autonomous Database dans le manuel Utilisation d'Oracle Autonomous Database Serverless

Accusés de réception

Auteur - Aditya Srivastawa (architecte cloud principal)

Ressources de formation supplémentaires

Explorez d'autres ateliers sur le site docs.oracle.com/learn ou accédez à d'autres contenus d'apprentissage gratuits sur le canal Oracle Learning YouTube. En outre, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir de la documentation sur le produit, consultez Oracle Help Center.

Informations relatives au titre et au copyright

Attach a File System to Oracle Autonomous Database

G42754-01

Oracle et/ou ses affiliés.