1. Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス
  2. DBMS_DNFS

60 DBMS_DNFS

DBMS_DNFSパッケージは、バックアップ・セットに含まれているファイルを使用したデータベースの作成を支援するためのインタフェースを提供します。

この章のトピックは、次のとおりです:

参照:

『Oracle Database管理者ガイド』

60.1 DBMS_DNFSのセキュリティ・モデル

このパッケージは、SYSDBA権限のあるユーザーで実行する必要があります。

60.2 DBMS_DNFSサブプログラムの要約

DBMS_DNFSパッケージには、CLONEDB_RENAMEFILE、RESTORE_DATAFILE_PERMISSIONS、UNMOUNTVOLUMEの各プロシージャが含まれています。

表60-1 DBMS_DNFSパッケージのサブプログラム

サブプログラム 説明

CLONEDB_RENAMEFILEプロシージャ

バックアップ・セットを指していたデータファイルの名前を、クローニングされたデータベース内の実際のファイル名に変更します。

RESTORE_DATAFILE_PERMISSIONSプロシージャ

このプロシージャは、PDBに属するデータ・ファイルの読取り/書込み権限をread writeにリストアします。PDBデータ・ファイルは、このソースPDBを使用して1つ以上のクローンを作成すると、read onlyに変換されます。

UNMOUNTVOLUMEプロシージャ

このプロシージャは、SGAにキャッシュされたDirect NFSファイル・ハンドルをクリーンアップします。

60.2.1 CLONEDB_RENAMEFILEプロシージャ

このプロシージャは、バックアップ・セットを指していたデータファイルの名前を、クローニングされたデータベース内の実際のファイル名に変更するために使用されます。

srcfileは、バックアップ・イメージ・コピーまたは読取り専用ストレージ・スナップショット内のデータファイルを示すファイル名です。destfile宛先ファイル・パスは、cloneDBデータファイルが作成されるNFSボリュームを指す必要があります。このプロシージャが正常に実行されると、制御ファイル・レコードは新しいデータファイル名で更新されます。

構文 

DBMS_DNFS.CLONEDB_RENAMEFILE (
   srcfile        IN         VARCHAR2,
   destfile       IN         VARCHAR2);

パラメータ

表60-2 CLONEDB_RENAMEFILEプロシージャのパラメータ

パラメータ 説明

srcfile

制御ファイルのソース・データファイル名

destfile

新しいデータファイル名

60.2.2 RESTORE_DATAFILE_PERMISSIONSプロシージャ

このプロシージャは、PDBに属するデータ・ファイルの読取り/書込み権限をread writeにリストアします。PDBデータ・ファイルは、このソースPDBを使用して1つ以上のクローンを作成すると、read onlyに変換されます。ソースPDBファイルのデータ・ファイル権限をリストアするには、最後のクローンを削除した後に、このプロシージャを起動する必要があります。

構文 

DBMS_DNFS.RESTORE_DATAFILE_PERMISSIONS (
   pdb_name       IN         VARCHAR2  DEFAULT NULL);

パラメータ

表60-3 RESTORE_DATAFILE_PERMISSIONSプロシージャのパラメータ

パラメータ 説明

pdb_name

ファイル権限をリストアする必要があるプラガブル・データベースの名前。

60.2.3 UNMOUNTVOLUMEプロシージャ

このプロシージャは、SGAにキャッシュされたDirect NFSファイル・ハンドルをクリーンアップします。このプロシージャは、NFSマウントの変更がオペレーティング・システムを介して行われ、OSのアンマウントとマウントのコマンドが呼び出される場合に使用する必要があります。

serverは、NFSサーバーのホスト名またはIPアドレスです。volumeは、NFSサーバーからエクスポートされたパスです。アンマウントされるボリューム内に開いているファイルがデータベースにある場合、このプロシージャは失敗します。

構文 

DBMS_DNFS.UNMOUNTVOLUME (
   server         IN         VARCHAR2,
   volume         IN         VARCHAR2);

パラメータ

表60-4 UNMOUNTVOLUMEプロシージャのパラメータ

パラメータ 説明

server

NFSサーバーのホスト名またはIPアドレス。
volume

NFSサーバーからエクスポートされたパス。