Autonomous Databaseからのネットワーク・ファイル・システムへのアクセス

Autonomous Databaseのディレクトリの場所にネットワーク・ファイル・システムをアタッチできます。

これにより、Virtual Cloud Network (VCN)のOracle Cloud Infrastructure File Storageまたはオンプレミスのデータ・センター内の他のネットワーク・ファイル・システムからデータをロードできます。アクセスするネットワーク・ファイル・システムのバージョンに応じて、NFSv3とNFSv4の両方がサポートされます。

サポート・ネットワーク・ファイル・システムを使用すると、次のことを実行できます。

  • レガシー・アプリケーションからAutonomous Databaseインスタンスに接続し、ファイル・システムを使用してデータをロードおよびアンロードします。

  • Autonomous Database内の様々なソースからのデータを分析します。

  • オンプレミスのデータ・センターまたはプライベートVirtual Cloud Networks (VCNs)のファイル・システムから、Autonomous Database内のデータへのアクセスを保護します。

トピック

Autonomous Databaseへのネットワーク・ファイル・システムのアタッチ

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

添付ファイル・システムでは、次のいずれかからデータをロードできます。

  • Virtual Cloud Network (VCN)のOracle Cloud Infrastructure File Storage。

    Autonomous DatabaseでのOracle Cloud Infrastructure File Storageの設定の詳細は、Autonomous Databaseへのファイル・システムのアタッチ方法を参照してください。

  • オンプレミス・データ・センターのネットワーク・ファイル・システムから。アクセスするネットワーク・ファイル・システムのバージョンに応じて、NFSv3とNFSv4の両方がサポートされます。

    NFSv4ネットワーク・ファイル・システムの構成例は、「例: Oracle Cloud ComputeでのNFSv4サーバーの設定」を参照してください。

ノート

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMプロシージャは、Autonomous Databaseインスタンスがプライベート・エンドポイントにある場合にのみプライベート・ファイル・ストレージ・サービスをアタッチできます。

オンプレミス・データ・センター内のファイル・システムからAutonomous Databaseのデータにアクセスするには、オンプレミス・データ・センターに接続するためにFastConnectまたはサイト間VPNを設定する必要があります。詳細は、FastConnectおよびサイト間VPNを参照してください。

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

    たとえば、次のコマンドでは、FSS_DIRという名前のデータベース・ディレクトリが作成され、ファイル・システム・ディレクトリfssが作成されます。

    CREATE DIRECTORY FSS_DIR AS 'fss';

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

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

      オプションで、paramsパラメータを使用し、nfs_versionに値3を指定してNFSv3を指定できます。

    • NFSv4を使用するには、paramsパラメータをDBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMに含め、値4のnfs_versionを指定して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;
      /

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

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

    たとえば:

    • FQDN: myhost.sub000445.myvcn.oraclevcn.com

      Oracle Cloud Infrastructure File Storageの場合、ファイル・システムの作成時に「拡張オプションの表示」でFQDNを設定します。詳細は、ファイル・システムの作成を参照してください。

    • ファイル・パス: /results

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

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

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

ファイル・システムをアタッチした後、DBA_CLOUD_FILE_SYSTEMSビューを問い合せて、アタッチされたファイル・システムに関する情報を取得できます。

たとえば:

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

この問合せは、FSSファイル・システム名の詳細を返します。

詳細は、DBA_CLOUD_FILE_SYSTEMSビューを参照してください。

添付ファイル・システムでは、ディレクトリ名を受け入れる任意のPL/SQL APIを使用して、添付ファイル・システム上のファイルの読取りおよび書込みを実行できます。たとえば、次のいずれかの方法を使用して、接続されたNFSディレクトリを操作できます。

  • UTL_FILEパッケージ。

  • Data Pump ExportおよびImportユーティリティ。

  • DBMS_CLOUD.LIST_FILESDBMS_CLOUD.PUT_OBJECTなどのディレクトリを操作するDBMS_CLOUD API。

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');

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

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

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

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

Autonomous Databaseからのネットワーク・ファイル・システムのデタッチ

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

ノート

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEMプロシージャは、プライベート・エンドポイントにあるデータベースからのみプライベート・ファイル・ストレージ・サービスをデタッチできます。

ディレクトリの場所からファイル・システムをデタッチするには、ディレクトリ・オブジェクトに対するWRITE権限が必要です。

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

たとえば:

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

この例では、file_system_nameパラメータで指定されたネットワーク・ファイル・システムをAutonomous Databaseからデタッチします。このパラメータの値を指定する必要があります。

このファイル・システムに関する情報は、DBA_CLOUD_FILE_SYSTEMSビューから削除されます。

例: Oracle Cloud ComputeでのNFSv4サーバーの設定

Autonomous Databaseで使用するNSFv4サーバーの設定例を示します。

  1. Autonomous Databaseインスタンスのプライベート・エンドポイントを設定します。

    詳細は、プライベート・エンドポイントを使用したネットワーク・アクセスの構成を参照してください。

    Autonomous DatabaseとNFSv4サーバーが相互に通信できるように、VCNのセキュリティ・リストに次のイングレス・ルールとエグレス・ルールを設定する必要があります

    • ソースCIDRブロックのすべてのポートからTCPポート2049へのステートフル・イングレス。
    • TCP ALL港から宛先CIDRブロックのすべての港2049へのステートフル・エグレス。
  2. プライベート・サブネットのOracle Linux 8を使用するOracle Cloud VMでNFSサーバーを設定し、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. NFSv4ファイル・システムをDBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMでマウントします。

DBA_CLOUD_FILE_SYSTEMSビュー

DBA_CLOUD_FILE_SYSTEMSビューには、データベース内のディレクトリの場所に接続されているネットワーク・ファイル・システムに関する情報が表示されます。

データ型 摘要
FILE_SYSTEM_NAME VARCHAR2(128)

ファイル・システム名

FILE_SYSTEM_LOCATION VARCHAR2(4000)

ファイル・システムの位置

DIRECTORY_NAME VARCHAR2(128)

アタッチされたディレクトリ名

DIRECTORY_PATH VARCHAR2(4000)

添付ディレクトリ・パス

NFS_VERSION NUMBER NFSバージョン。
DESCRIPTION VARCHAR2(4000)

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEMの実行時に説明パラメータに指定された値

CREATION_TIME TIMESTAMP(6) WITH TIME ZONE 作成タイムスタンプ
UPDATE_TIME TIMESTAMP(6) WITH TIME ZONE 更新スタンプ