Exploremos cómo asociar un sistema de archivos a Oracle Autonomous Database

Introducción

Oracle Cloud Infrastructure (OCI) File Storage es un sistema de archivos flexible y totalmente gestionado que soporta el protocolo de sistema de archivos de red (NFS). Proporciona almacenamiento de archivos escalable y compartido que pueden montar simultáneamente varias instancias informáticas y sistemas de base de datos en una red virtual en la nube (VCN). Oracle Autonomous Database, que consta de Autonomous Data Warehouse (ADW) y Autonomous Transaction Processing (ATP), es la plataforma de base de datos totalmente gestionada de Oracle que automatiza el aprovisionamiento, el ajuste, la ampliación, la aplicación de parches y las copias de seguridad. Aunque Autonomous Database no proporciona acceso directo al sistema de archivos a nivel de sistema operativo, determinadas configuraciones de despliegue, como Oracle Autonomous Database on Dedicated Exadata Infrastructure o Autonomous Database con punto final privado, permiten la integración con File Storage a través de una VCN privada. La asociación de File Storage a una instancia de Autonomous Database permite:

Acceso compartido a archivos entre Autonomous Database y otros recursos de OCI en la misma VCN.
Ubicación temporal e intercambio de archivos de datos para ETL, análisis o procesamiento por lotes.
Archivado de logs y salida de informe directamente en un almacén de archivos persistente y gestionado.

Objetivos

En este documento se describe el proceso y las consideraciones para integrar el servicio OCI File Storage con Oracle Autonomous Data Warehouse (ADW) o Autonomous Transaction Processing (ATP) mediante un punto final privado. Los objetivos son los siguientes:

Aprovisionamiento de una instancia de Autonomous Database segura: despliegue una instancia de Autonomous Database con acceso de punto final privado para garantizar que toda la comunicación con File Storage se produzca a través de una red privada y segura.
Activar conectividad de red para acceso NFS: configure listas de seguridad de VCN o grupos de seguridad de red para permitir los puertos NFS necesarios entre Autonomous Database y File Storage.
Aprovisionamiento y configuración de File Storage: cree un sistema de archivos y un destino de montaje dentro de la misma VCN/subred (o red con intercambio de tráfico) que la instancia de Autonomous Database.
Asociar almacenamiento de archivos a Autonomous Database: monte el sistema de archivos en la instancia de Autonomous Database mediante comandos de base de datos y OCI soportados.
Verifique la asociación del sistema de archivos: consulte DBA_CLOUD_FILE_SYSTEMS para confirmar la asociación correcta.
Realice operaciones de archivo desde la base de datos: cree directorios en el sistema de archivos asociado, escriba, lea y muestre archivos mediante paquetes PL/SQL como UTL_FILE y DBMS_CLOUD.
Comprender las limitaciones y restricciones: documente las restricciones operativas, de red y de servicio para utilizar File Storage con Autonomous Database.

Requisitos

Antes de asociar un almacenamiento de archivos de OCI a una instancia de Autonomous Database (ADW/ATP), asegúrese de que se cumplan los siguientes requisitos:

Requisitos de servicio y despliegue

Una instancia de Autonomous Database desplegada con:

Punto final privado activado
Alojado en Oracle Autonomous Database on Dedicated Exadata Infrastructure

El almacenamiento de archivos debe aprovisionarse en la misma región que la instancia de Autonomous Database.

Requisitos de red

Configuración de VCN y subred:
Autonomous Database y el destino de montaje de File Storage deben estar en la misma VCN/subred o conectados mediante el intercambio de tráfico de VCN.

Reglas de seguridad/NSG:
permite el tráfico NFS entrante y saliente entre el destino de montaje de Autonomous Database y File Storage:

TCP 111 (asignador de puertos)
TCP/UDP 2048–2050 (daemons relacionados con NFS)
TCP 2049 (NFS)

Resolución de DNS:
asegúrese de que el DNS privado está activado para que el FQDN del destino de montaje de File Storage se pueda resolver desde la instancia de Autonomous Database.

Permisos de IAM

Debe tener los siguientes permisos de OCI:

Gestión de una base de datos autónoma
Gestión de la familia de File Storage
Gestionar recursos de red virtual

Debe tener el siguiente privilegio de nivel de base de datos:

Usuario ADMIN en Autonomous Database (para ejecutar procedimientos DBMS_CLOUD_ADMIN)

Herramientas y acceso

Debe tener acceso a las siguientes herramientas:

Acceso a la consola de OCI para la creación o configuración de recursos.
Acceso de cliente SQL (SQL Developer, SQL*Plus o SQLcl) para conectarse como ADMIN.
Paquete DBMS_CLOUD_ADMIN disponible en la instancia de Autonomous Database.

Información que recopilar antes de comenzar

FQDN de destino de montaje del almacenamiento de archivos
Detalles de subred para ADB y File Storage
Cualquier ruta de exportación configurada en File Storage para el sistema de archivos

Tareas

En las siguientes tareas, configurará y validará la integración entre File Storage y una instancia de Autonomous Database (ADW/ATP) desplegada con acceso de punto final privado.

Realice los siguientes pasos:

Aprovisione OCI ADW solo con acceso de punto final privado
Creación de reglas de seguridad de VCN para el acceso a File Storage
Crear sistema de archivos en el almacenamiento de archivos
Obtener el nombre de dominio completo (FQDN) para el destino de montaje
Asociar el sistema de archivos a Autonomous Database
Consulta DBA_CLOUD_FILE_SYSTEMS
Crear y escribir en un archivo mediante UTL_FILE
Mostrar archivos en el sistema de archivos adjunto y leer un archivo mediante UTL_FILE

Tarea 1: Aprovisionamiento de Autonomous Database

Cree una instancia de ADW con un punto final privado en la VCN y la subred adecuadas.

Imagen que muestra cómo crear una instancia de ADW con un punto final privado

Tarea 2: Configuración de la seguridad de red

Cree o actualice listas de seguridad de VCN o grupos de seguridad de red para permitir el tráfico de protocolo NFS entre la subred de Autonomous Database y las subredes de destino de montaje de File Storage.

Cree reglas de seguridad de VCN para el acceso al almacenamiento de archivos agregando algunas reglas de entrada y salida en la lista de seguridad de la VCN para que la instancia de Autonomous Database y el sistema de archivos puedan comunicarse entre sí.

Entrada con estado desde TODOS los puertos del 111, 2048, 2049 y 2050 del bloque de CIDR del origen a TCP.
Entrada con estado desde TODOS los puertos del 111 y 2048 del bloque de CIDR del origen a los puertos UDP
Salida con estado a los puertos 111, 2048, 2049 y 2050 del 2bloque CIDR de destino0 de TODOS TCP.
Salida con estado del puerto ALL UDP al puerto 111 del bloque de CIDR de destino.
Asegúrese de que los gateways de servicio estén disponibles

Imagen que muestra los detalles de la VCN
Imagen que muestra las reglas de entrada

Tarea 3: Aprovisionamiento de OCI File Storage

Creación de un sistema de archivos en File Storage.
Inicio -> Almacenamiento -> Almacenamiento de archivos -> Sistemas de archivos -> Crear sistema de archivos para NFS en la consola de OCI.
Asegúrese de que el destino de montaje sea el mismo que la VCN y la subred de Autonomous Database.

Cree un sistema de archivos y un destino de montaje en la misma VCN o una VCN conectada. Imagen que muestra cómo crear un sistema de archivos y un destino de montaje en la misma VCN o una VCN con intercambio de tráfico

Inicio -> Almacenamiento -> Almacenamiento de archivos -> Destinos de montaje en la consola de OCI.

Configure los valores de exportación para el destino de montaje.
Imagen que muestra exportaciones

Tarea 4: Obtención de detalles de destino de montaje

Recupere el nombre de dominio completo (FQDN) y la ruta de exportación del destino de montaje.

Almacenamiento de archivos -> Destinos de montaje -> <yourMountTargetName> en la consola de OCI y obtenga el FQDN como se muestra a continuación:

Imagen en la que se muestra cómo recuperar el nombre de dominio completo (FQDN) y la ruta de exportación del destino de montaje

Tarea 5: Asociación del sistema de archivos a 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;
  /

Utilice DBMS_CLOUD_ADMIN.CREATE_FILE_SYSTEM para montar File Storage en la instancia de Autonomous Database. Imagen en la que se muestra cómo asociar el sistema de archivos a Autonomous Database

Tarea 6: Verificar anexo de sistema de archivos

Consulte DBA_CLOUD_FILE_SYSTEMS para confirmar que el sistema de archivos se ha montado correctamente.

SELECT file_system_name, file_system_location, directory_path FROM dba_cloud_file_systems;

Imagen en la que se muestra cómo verificar la asociación del sistema de archivos

Tarea 7: Realizar operaciones de archivo

Cree un objeto de directorio que apunte al almacenamiento de archivos y escriba los archivos mediante UTL_FILE.PUT_LINE.

(Puede crear un archivo denominado channel.csv y escribir en él:)

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

Enumere los archivos mediante DBMS_CLOUD.LIST_FILES.

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

Lea el contenido del archivo mediante 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;
/

Tarea 8: Limitaciones y restricciones de documentos

Captura las configuraciones soportadas, las restricciones de servicio y las limitaciones conocidas para utilizar OCI File Storage con Oracle Autonomous Database.

Validaciones clave

Esto sólo funciona si:

El almacén de datos autónomo tiene un punto final privado en la misma VCN/subred que File Storage o conectado mediante un intercambio de VCN.

Las listas de seguridad/NSG permiten puertos NFS.

Está utilizando Oracle Autonomous Database on Dedicated Infrastructure u Oracle Autonomous Database compartido con un punto final privado + soporte de OCI File Storage.

DBA_CLOUD_FILE_SYSTEMS mostrará el almacenamiento de archivos montado después de la conexión correcta.

UTL_FILE solo se activa en los sistemas de archivos adjuntos o directorios aprobados.

Limitaciones y restricciones

Restricciones de despliegue

No soportado en Autonomous Database Shared: punto final público. OCI File Storage solo se puede montar en Oracle Autonomous Database on Dedicated Exadata Infrastructure u Oracle Autonomous Database con un punto final privado y un acceso adecuado a la VCN. Autonomous Database debe estar en la misma VCN (o VCN con intercambio de tráfico) que el destino de montaje de File Storage.

Restricciones de red

El tráfico NFS (TCP 111, 2048–2050, 2049) debe estar permitido en ambas direcciones entre la subred de Autonomous Database y la subred de File Storage. Si se utiliza el intercambio de VCN, las reglas de seguridad deben permitir puertos NFS en toda la conexión de intercambio de tráfico. La resolución de DNS debe estar activada para que Autonomous Database pueda resolver el FQDN del destino de montaje. Sin acceso al almacenamiento de archivos a través del gateway de Internet: debe utilizar el enrutamiento privado.

Restricciones del sistema de archivos

El acceso raíz no se proporciona desde Autonomous Database; las operaciones se realizan como usuario del sistema operativo de la base de datos. No puede montar más de la cantidad máxima de sistemas de archivos definida por Oracle (varía por nivel de servicio). La longitud de la ruta y el nombre de archivo deben cumplir los límites de NFS y de Oracle (generalmente ≤255 caracteres por nombre de archivo).

Restricciones de Base de Datos

Las operaciones UTL_FILE están restringidas a directorios de la lista blanca creados mediante DBMS_CLOUD_ADMIN.CREATE_DIRECTORY_IN_FILE_SYSTEM. No puede cambiar el punto de montaje de NFS manualmente: lo gestiona Oracle. Sin acceso a nivel de sistema operativo: todo acceso a archivos debe pasar por SQL, PL/SQL (UTL_FILE, DBMS_CLOUD) o herramientas como SQL Developer. El rendimiento de E/S de archivos depende de los límites de ancho de banda de la VCN y del nivel de rendimiento del almacenamiento de archivos.

Restricciones operativas

Si se suprime el destino de montaje de File Storage o se elimina la exportación, el montaje en Autonomous Database no se podrá utilizar hasta que se vuelva a configurar. Sin operaciones chmod/chown directas: los permisos se gestionan mediante las opciones de exportación en la consola de OCI. El tamaño máximo de archivo está limitado por el servicio de almacenamiento de archivos (hasta 8 EiB por sistema de archivos, pero los límites de cliente NFS deben admitir archivos individuales). La alta disponibilidad depende de varios destinos de montaje en los dominios de disponibilidad: Autonomous Database no realizará un failover del almacenamiento de archivos automáticamente.

Asociación del sistema de archivos de red a Autonomous Database en Uso de Oracle Autonomous Database Serverless

Acuses de recibo

Autor - Aditya Srivastawa (arquitecto principal de la nube)

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.

Para obtener documentación sobre el producto, visite Oracle Help Center.

Título e Información de Copyright

Attach a File System to Oracle Autonomous Database

G42752-01

Oracle y/o sus filiales.