CREATE PFILE
目的
CREATE
PFILE
文を使用すると、バイナリのサーバー・パラメータ・ファイルまたは現行のインメモリーのパラメータ設定をテキストの初期化パラメータ・ファイルにエクスポートできます。テキストのパラメータ・ファイルの作成は、データベースで使用している現行のパラメータ設定リストを取得する便利な方法です。また、このファイルは、テキスト・エディタで簡単に編集でき、CREATE
SPFILE
文を使用してサーバー・パラメータ・ファイルに変換して戻すこともできます。
この文が正常に実行されると、サーバーにテキストのパラメータ・ファイルが作成されます。Oracle Real Application Clusters環境では、すべてのインスタンスのすべてのパラメータ設定が含まれます。サーバー・パラメータ・ファイルのパラメータ設定と同じ行のコメントも含まれます。
CDBにテキスト・パラメータ・ファイルを作成する場合のノート
マルチテナント・コンテナ・データベース(CDB)にテキスト・パラメータ・ファイルを作成する場合、現在のコンテナがルートまたはPDBである可能性があります。
-
現在のコンテナがルートである場合、データベースはルートのパラメータ設定を含むテキスト・ファイルを作成します。
-
現在のコンテナがPDBである場合、データベースはPDBのパラメータ設定を含むテキスト・ファイルを作成します。この場合、
pfile_name
を指定する必要があります。
関連項目:
-
サーバー・パラメータ・ファイルの詳細は、「CREATE SPFILE」を参照してください。
-
テキストの初期化パラメータ・ファイルおよびバイナリのサーバー・パラメータ・ファイルの詳細は、『Oracle Database管理者ガイド』を参照してください。
-
Oracle Real Application Clusters環境でのサーバー・パラメータ・ファイルの使用については、『Oracle Real Application Clusters管理およびデプロイメント・ガイド』を参照してください。
前提条件
この文を実行するには、次のいずれかのシステム権限が必要です。
-
SYSDBA
-
SYSDG
-
SYSOPER
-
SYSBACKUP
-
SYSASM
-
SYSRAC
この文は、インスタンスの起動前と起動後のいずれかで実行できます。
制限事項
SYSDG
、SYSOPER
またはSYSRAC
ユーザーとしてOSファイルを上書きすることはできません。
構文
create_pfile::=
セマンティクス
pfile_name
作成するテキストのパラメータ・ファイル名を指定します。pfile_name
を指定しないと、プラットフォーム固有のデフォルトの初期化パラメータ・ファイル名が使用されます。pfile_name
には、パス接頭辞を含めることができます。パス接頭辞を指定しない場合は、データベースによってデフォルトの格納場所(プラットフォームによって異なる)のパス接頭辞が追加されます。
spfile_name
テキストのファイルを作成する元となるバイナリのサーバー・パラメータ・ファイル名を指定します。
-
spfile_name
を指定する場合、そのファイルがサーバーに存在する必要があります。ファイルがオペレーティング・システムのサーバー・パラメータ・ファイルのデフォルト・ディレクトリに存在しない場合、フルパス名を指定する必要があります。 -
spfile_name
を指定しない場合は、現在インスタンスに関連付けられているspfileが使用されます。通常、これは起動時に使用されたspfileです。インスタンスにspfileが関連付けられていない場合は、プラットフォーム固有のデフォルトのサーバー・パラメータ・ファイル名が検索されます。このファイルが存在しない場合は、エラーが戻されます。
関連項目:
MEMORY
MEMORY
を指定すると、現行のシステム全体のパラメータ設定を使用してpfileを作成できます。Oracle RAC環境では、作成されたファイルには各インスタンスからのパラメータ設定が含まれます。
例
パラメータ・ファイルの作成: 例
次の例は、バイナリのサーバー・パラメータ・ファイルs_params.ora
からテキストのパラメータ・ファイルmy_init.ora
を作成します。
CREATE PFILE = 'my_init.ora' FROM SPFILE = 's_params.ora';
ノート:
通常、オペレーティング・システムのパラメータ・ファイルには、フルパスのファイル名を指定する必要があります。パス情報およびデフォルトのパラメータ・ファイル名については、Oracleオペレーティング・システムのドキュメントを参照してください。