Acessar o Sistema de Arquivos da Rede no Autonomous Database

Use DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM para anexar um sistema de arquivos a um diretório no seu Autonomous Database.

1. Crie um diretório ou use um diretório existente para anexar um Sistema de Arquivos de Rede ao seu Autonomous Database. Você deve ter o privilégio WRITE no objeto de diretório da sua instância do Autonomous Database para anexar um sistema de arquivos a um local de diretório no banco de dados.

   Por exemplo, o seguinte comando cria o diretório de banco de dados chamado FSS_DIR e cria o diretório de sistema de arquivos: fss

   CREATE DIRECTORY FSS_DIR AS 'fss';

   Consulte Criar Diretório no Autonomous Database para mais informações.

2. Execute DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM para anexar um sistema de arquivos a um diretório no seu Autonomous Database. Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

   • Por padrão, DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM usa 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;
     /

     Opcionalmente, você pode usar o parâmetro params e especificar o nfs_version com o valor 3 para especificar NFSv3.

   • Para usar NFSv4, inclua o parâmetro params com DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM e especifique o nfs_version com o valor 4 para especificar 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;
     /

   Esses exemplos anexam o sistema de arquivos de rede especificado no parâmetro file_system_name ao Autonomous Database.

   O parâmetro file_system_location especifica a localização do sistema de arquivos. O valor fornecido com file_system_location consiste em um FQDN (Nome de Domínio Totalmente Qualificado) e um caminho de arquivo no formato: FQDN:file_path.

   Por exemplo:

   • SEQUÊNCIA: myhost.sub000445.myvcn.oraclevcn.com

     Para o Oracle Cloud Infrastructure File Storage, defina o FQDN em Mostrar Opções Avançadas ao criar um sistema de arquivos. Consulte Criando Sistemas de Arquivos para mais informações.

   • Caminho do arquivo: /results

   O parâmetro directory_name especifica o nome do diretório no Autonomous Database em que você deseja anexar o sistema de arquivos. Esse é o diretório criado na Etapa 1 ou outro diretório criado anteriormente.

   O parâmetro description especifica a descrição da tarefa.

   O parâmetro params é um valor JSON que especifica um atributo adicional nfs_version, cujo valor pode ser 3 ou 4 (NFSv3 ou 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');

Use o procedimento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM para desanexar um sistema de arquivos de um diretório no seu Autonomous Database.

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

Fornece um exemplo para configurar um servidor NSFv4 para uso com o Autonomous Database.

1. Configure um ponto final privado para a instância do Autonomous Database.

   Consulte Configurando o Acesso à Rede com Pontos Finais Privados para obter mais informações.

   As regras de entrada e saída a seguir precisam ser definidas para a lista de segurança da sua VCN para que o Autonomous Database e o servidor NFSv4 possam se comunicar entre si

   • Entrada com monitoramento de estado em todas as portas do bloco CIDR da origem para a porta TCP 2049.
   • Saída com monitoramento de estado das portas TCP ALL para a porta 2049 em bloco CIDR de destino.
2. Configure o servidor NFS em uma VM do Oracle Cloud com o Oracle Linux 8 na sub-rede privada, que pode estabelecer conexão com a instância do 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. Monte o sistema de arquivos NFSv4 com DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM.

   Consulte Anexar Sistema de Arquivos de Rede ao Autonomous Database para obter mais informações.

A view DBA_CLOUD_FILE_SYSTEMS lista informações sobre o sistema de arquivos de rede anexado a um local de diretório no banco de dados.