Vamos Explorar Como Anexar um Sistema de Arquivos ao Oracle Autonomous Database

Introdução

O Armazenamento de Arquivos do OCI (Oracle Cloud Infrastructure) é um sistema de arquivos elástico totalmente gerenciado que suporta o protocolo NFS (Network File System). Ele fornece armazenamento de arquivos compartilhado e escalável que pode ser montado simultaneamente por várias instâncias de computação e sistemas de banco de dados em uma VCN (Virtual Cloud Network). O Oracle Autonomous Database, que consiste em Autonomous Data Warehouse (ADW) e Autonomous Transaction Processing (ATP), é a plataforma de banco de dados totalmente gerenciada da Oracle que automatiza o provisionamento, o ajuste, o dimensionamento, a aplicação de patches e os backups. Embora o Autonomous Database não forneça acesso direto ao sistema de arquivos no nível do sistema operacional, determinadas configurações de implantação — como Oracle Autonomous Database on Dedicated Exadata Infrastructure ou Autonomous Database com ponto final privado — permitem a integração com o File Storage em uma VCN privada. A anexação do File Storage a um Autonomous Database permite:

Objetivos

Este documento descreve o processo e as considerações para integrar o OCI File Storage Service ao Oracle Autonomous Data Warehouse (ADW) ou ao Autonomous Transaction Processing (ATP) usando um ponto final privado. Os objetivos são:

Pré-requisitos

Antes de anexar um OCI File Storage a um Autonomous Database (ADW/ATP), certifique-se de que os seguintes requisitos sejam atendidos:

Requisitos de Serviço e Implantação

Um Autonomous Database implantado com:

O File Storage deve ser provisionado na mesma região que o Autonomous Database.

Requisitos de Rede

Configuração de VCN e Sub-rede:
O Autonomous Database e o ponto de acesso NFS do serviço File Storage devem estar na mesma VCN/sub-rede ou conectados por meio de pareamento de VCN.

Regras de Segurança/NSGs:
Permitir tráfego NFS de entrada e saída entre o ponto de acesso NFS do Autonomous Database e o File Storage:

Resolução de DNS:
Certifique-se de que o DNS privado esteja ativado para que o FQDN do ponto de acesso NFS do serviço File Storage possa ser resolvido no Autonomous Database.

Permissões do IAM

Você deve ter as seguintes permissões do OCI:

Você deve ter o seguinte privilégio no nível do banco de dados:

Ferramentas e Acesso

Você deve ter acesso às seguintes ferramentas:

Informações a serem coletadas antes do início

Tarefas

Nas tarefas a seguir, você configurará e validará a integração entre o File Storage e um Autonomous Database (ADW/ATP) implantado com acesso de ponto final privado.

São estas as etapas:

  1. Provisionar o OCI ADW somente com acesso ao ponto final privado
  2. Criar regras de segurança de VCN para acesso ao Serviço File Storage
  3. Criar um sistema de arquivos no Serviço File Storage
  4. Obter o nome de domínio totalmente qualificado (FQDN) para o ponto de acesso NFS
  5. Anexar o sistema de arquivos ao Autonomous Database
  6. Consulta DBA_CLOUD_FILE_SYSTEMS
  7. Criar e gravar em um arquivo via UTL_FILE
  8. Listar arquivos no sistema de arquivos anexado e ler um arquivo via UTL_FILE

Tarefa 1: Provisionar o Autonomous Database

Crie uma instância do ADW com ponto final privado na VCN e na sub-rede apropriadas.

Imagem mostrando como criar uma instância do ADW com ponto final privado

Tarefa 2: Configurar Segurança de Rede

Crie ou atualize listas de segurança da VCN ou grupos de segurança de rede para permitir o tráfego do protocolo NFS entre a sub-rede do Autonomous Database e as sub-redes do ponto de acesso NFS do serviço File Storage.

Crie regras de segurança da VCN para acesso ao serviço File Storage, adicionando algumas regras de entrada e saída na lista de segurança da VCN para que seu Autonomous Database e sistema de arquivos possam se comunicar entre si.

Entrada com Monitoramento de Estado de TODAS as portas do bloco CIDR da origem para as portas TCP 111, 2048, 2049 e 2050.
Entrada com monitoramento de estados de TODAS as portas do bloco CIDR da origem para as portas UDP 111 e 2048.
Saída com monitoramento de estado das portas TCP ALL para as portas 111, 2048, 2049 e 2050 no bloco CIDR de destino.
Saída com monitoramento de estado das portas UDP ALL para a porta 111 em bloco CIDR de destino.
Certifique-se de que os gateways de serviço estejam disponíveis

Imagem mostrando detalhes da VCN
Imagem mostrando regras de entrada
Imagem mostrando regras de saída

Tarefa 3: Provisionar o OCI File Storage

Criar um sistema de arquivos no Serviço File Storage.
Início -> Armazenamento -> Armazenamento de Arquivos -> Sistemas de Arquivos -> Criar Sistema de Arquivos para NFS na console do OCI.
Certifique-se de que o ponto de acesso NFS seja igual à VCN e à sub-rede do Autonomous Database.

Crie um sistema de arquivos e um ponto de acesso NFS na mesma VCN ou em uma VCN pareada. Imagem mostrando como criar um sistema de arquivos e um ponto de acesso NFS na mesma VCN ou em uma VCN pareada

Início -> Armazenamento -> Armazenamento de Arquivos -> Pontos de Acesso NFS na console do OCI.

Configure as definições de exportação para o ponto de acesso NFS.
Imagem mostrando exportações

Tarefa 4: Obter Detalhes do Ponto de Acesso NFS

Recupere o nome de domínio totalmente qualificado (FQDN) e o caminho de exportação do ponto de acesso NFS.

File Storage -> Pontos de Acesso NFS -> <yourMountTargetName> na console do OCI e obtenha o FQDN conforme mostrado abaixo:

Imagem mostrando como recuperar o nome de domínio totalmente qualificado (FQDN) e o caminho de exportação do ponto de acesso NFS

Tarefa 5: Anexar o Sistema de Arquivos ao 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;
  /

Use DBMS_CLOUD_ADMIN.CREATE_FILE_SYSTEM para montar o serviço File Storage no Autonomous Database. Imagem mostrando como anexar o sistema de arquivos ao Autonomous Database

Tarefa 6: Verificar Anexo do Sistema de Arquivos

Consulte DBA_CLOUD_FILE_SYSTEMS para confirmar se o sistema de arquivos foi montado com sucesso.

SELECT file_system_name, file_system_location, directory_path FROM dba_cloud_file_systems;

Imagem mostrando como verificar o anexo do sistema de arquivos

Tarefa 7: Executar Operações do Arquivo

Crie um objeto de diretório apontando para o File Storage e grave arquivos usando UTL_FILE.PUT_LINE.

(Você pode criar um arquivo chamado channel.csv e gravá-lo:)

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

Liste arquivos usando DBMS_CLOUD.LIST_FILES.

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

Leia o conteúdo do arquivo usando 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;
/

Tarefa 8: Restrições e Limitações do Documento

Capture as configurações suportadas, as restrições de serviço e as limitações conhecidas para usar o OCI File Storage com o Oracle Autonomous Database.

Principais Validações

Isso só funcionará se:

O ADW tem um ponto final privado na mesma VCN/sub-rede do File Storage ou conectado por meio de pareamento de VCN.

As listas de segurança/NSGs permitem portas NFS.

Você está usando o Oracle Autonomous Database on Dedicated Infrastructure ou o Oracle Autonomous Database compartilhado com ponto final privado + suporte ao OCI File Storage.

DBA_CLOUD_FILE_SYSTEMS mostrará o Armazenamento de Arquivos montado após a anexação bem-sucedida.

UTL_FILE é ativado apenas em sistemas de arquivos anexados ou diretórios aprovados.

Limitações e restrições

Restrições de Implantação

Não há suporte no Autonomous Database Shared – ponto final público. O OCI File Storage só pode ser montado no Oracle Autonomous Database on Dedicated Exadata Infrastructure ou no Oracle Autonomous Database com ponto final privado e acesso adequado à VCN. O Autonomous Database deve estar na mesma VCN (ou VCN pareada) que o ponto de acesso NFS do File Storage.

Restrições de Rede

O tráfego NFS (TCP 111, 2048–2050, 2049) deve ser permitido nas duas direções entre a sub-rede do Autonomous Database e a sub-rede do File Storage. Se estiver usando pareamento de VCN, as regras de segurança deverão permitir portas NFS na conexão de pareamento. A resolução de DNS deve ser ativada para que o Autonomous Database possa resolver o FQDN do ponto de acesso NFS. Sem acesso ao File Storage via gateway de internet — você deve usar o roteamento privado.

Restrições do Sistema de Arquivos

O acesso root não é fornecido pelo Autonomous Database; as operações são feitas como o usuário do sistema operacional do banco de dados. Não é possível montar mais do que o número máximo de sistemas de arquivos definidos pela Oracle (varia por nível de serviço). O tamanho do caminho e o nome do arquivo devem estar em conformidade com os limites NFS e Oracle (geralmente ≤255 caracteres por nome de arquivo).

Restrições do Banco de Dados

As operações UTL_FILE são restritas a diretórios na lista branca criados via DBMS_CLOUD_ADMIN.CREATE_DIRECTORY_IN_FILE_SYSTEM. Você não pode alterar o ponto de montagem NFS manualmente — ele é gerenciado pela Oracle. Sem acesso no nível do sistema operacional — todo acesso a arquivos deve passar por SQL, PL/SQL (UTL_FILE, DBMS_CLOUD) ou ferramentas como o SQL Developer. O desempenho de E/S de arquivo depende dos limites de largura de banda da VCN e da camada de desempenho do File Storage.

Restrições operacionais

Se o ponto de acesso NFS do serviço File Storage for excluído ou a exportação for removida, a montagem no Autonomous Database se tornará inutilizável até ser reconfigurada. Nenhuma operação chmod/chown direta — as permissões são gerenciadas pelas opções de exportação no Console do OCI. O tamanho máximo do arquivo é limitado pelo File Storage Service (até 8 EiB por sistema de arquivos, mas arquivos individuais devem ter suporte para limites de cliente NFS). A alta disponibilidade depende de vários pontos de acesso NFS nos Domínios de Disponibilidade. O Autonomous Database não fará failover do Armazenamento de Arquivos automaticamente.

Anexar o Sistema de Arquivos de Rede ao Autonomous Database no Usando o Oracle Autonomous Database Serverless

Confirmações

Mais Recursos de Aprendizado

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal do Oracle Learning YouTube. Além disso, acesse education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.