ネットワーク・ファイル・ストレージ(NFS)共有をAutonomous Databaseに接続する前に、次のことを確認してください:

• NFSv4にNFSv3および19.23以降を使用する場合、Autonomous Databaseのバージョンは19.18以上です。
• お客様が指定したNFSは、Autonomous VMクラスタ・ノードからネットワークにアクセスできます。
• NFSマウント・ファイル・システムは、すべてのAutonomous VMクラスタ・ノード上でoracleオペレーティング・システム・ユーザーによって読取りおよび書込みが可能です。
• 権限がユーザー・レベルで制御されている場合、Autonomous VMクラスタのoracleユーザーのuid:gidは1001:1001です。

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMを使用して、Autonomous Database内のディレクトリにファイル・システムをアタッチします。

1. ディレクトリを作成するか、既存のディレクトリを使用して、Autonomous Databaseに外部ファイル・システムをアタッチします。ファイル・システムをデータベース内のディレクトリの場所にアタッチするには、Autonomous Databaseインスタンスのディレクトリ・オブジェクトに対するWRITE権限が必要です。

   たとえば、次のコマンドは、NFS_DIRという名前のデータベース・ディレクトリを作成し、ファイル・システム・ディレクトリのnfsを作成します:

   CREATE DIRECTORY NFS_DIR AS ‘nfs’;

   詳細は、ディレクトリの作成を参照してください。

2. DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMを実行して、Autonomous Database内のディレクトリにファイル・システムをアタッチします。このプロシージャを実行するには、ADMINユーザーとしてログインするか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

   • デフォルトでは、DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMはNFSv3を使用します。ただし、paramsパラメータを明示的に使用し、値3でnfs_versionを指定してNFSv3を指定することもできます。

     BEGIN
     DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
         file_system_name      => 'NFS',
         file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
         directory_name        => 'NFS_DIR',  
         description           => 'Source NFS for sales data'                                   
     );END;                                                                          
     /

   • NFSv4を使用するには、DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMにparamsパラメータを含めて、値4でnfs_versionを指定してNFSv4を指定します。

     BEGIN
       DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
         file_system_name => 'NFS',
         file_system_location => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
         directory_name => 'NFS_DIR',
         description => 'Source NFS for sales data',
         params => JSON_OBJECT('nfs_version' value 4)
       );
     END;
     /

   前述の例では、file_system_nameパラメータで指定されたネットワーク・ファイル・システムをAutonomous Databaseにアタッチしています。

   file_system_locationパラメータは、ファイル・システムの場所を指定します。file_system_locationで指定する値は、完全修飾ドメイン名(FQDN)とファイル・パス(FQDN:file_path)で構成されます。

   例:

   • FQDN: myhost.sub000445.myvcn.oraclevcn.com
   • ファイル・パス: /results

   directory_nameパラメータは、ファイル・システムをアタッチするAutonomous Database内のディレクトリ名を指定します。これは、ステップ1で作成したディレクトリ、または以前に作成した別のディレクトリです。

   descriptionパラメータは、タスクの説明を指定します。

   paramsパラメータは、追加属性nfs_versionを指定するJSON値で、その値は3または4 (NFSv3またはNFSv4)のいずれかです。

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMの使用に関するノート:

• Oracle Cloud Infrastructure File Storageは、NFSv3を使用して共有します。詳細は、ファイル・ストレージの概要を参照してください。

• Oracle Cloud Infrastructure File Storage以外のシステムにアタッチする場合、このプロシージャではNFSv3およびNFSv4がサポートされます。

• NFSv3を使用する接続されたNFSサーバーがあり、NFSサーバーでNFSバージョンがNFSv4に更新されている場合は、(nfs_versionを4に設定したparamsパラメータを使用して)DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM、DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMを実行する必要があります。これにより、Autonomous DatabaseがNFSv4サーバーにアクセスできるように、一致するプロトコルでNFSがアタッチされます。デタッチしてから再アタッチしないと、NFSサーバーにアクセスできなくなり、"Protocol not supported"などのエラーが表示される場合があります。

詳細は、ATTACH_FILE_SYSTEMプロシージャを参照してください。

例:

SELECT file_system_name, file_system_location, directory_path                      
   FROM dba_cloud_file_systems
   WHERE file_system_name = 'FSS';

UTL_FILEを使用した、アタッチされたファイル・システム上のファイルの書込みを示す例:

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

UTL_FILEを使用した、アタッチされたファイル・システム上のファイルの読取りを示す例:

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

DBMS_CLOUD.LIST_FILESを使用したアタッチされたファイル・システム上のリスト・ファイルを示す例:

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

詳細は、次を参照してください:

• UTL_FILE
• LIST_FILESファンクション

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャを使用して、Autonomous Databaseのディレクトリからファイル・システムをデタッチします。

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャを実行して、Autonomous Databaseのディレクトリの場所からファイル・システムをデタッチします。このプロシージャを実行するには、ADMINユーザーとしてログインするか、DBMS_CLOUD_ADMINに対するEXECUTE権限を持っている必要があります。

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