システム障害が発生した場合にリージョン データベース、リージョン間データベース、およびデータストア データベースからリソースを回復するには、dbfhadmin コマンド ライン ツールを使用します。これを使用して、主索引キーおよび代替索引キーに使用されるデータベースの列が正しい SQL 型に設定されるようにすることもできます。
注: このコマンドは、MFDBFH_CONFIG 変数が管理対象データベースのデータ ソース エントリを含む構成ファイルを指している環境から実行する必要があります。
構文:
dbfhadmin [action][options]
- action
- コマンドの実行全体を参照します。
- -casprocess - CAS プロセスのリソースをリストまたは回復します。
- -createdb - データベースを作成します。
- -keytypes - キータイプ メタデータをリスト、追加、削除、インポート、エクスポートします。
- -openfiles - データストアのファイルをリストするか開いているファイルを閉じます。
- -region - リージョンのリソースをリストまたは回復します。ロックされたリソースを自動回復プロセスで解放できなかった場合、この方法で解放する必要がある場合があります。これに該当する場合、そのことを示すエラー メッセージがコンソール ログに表示されることがあります。
- -script - データベースを作成するための SQL スクリプトを生成します。
- options
- 指定したアクションのオプションを定義します。有効な値は次のとおりです。
- -add
- 特定のデータストアのキータイプ メタデータを追加または更新するように指定します。-keytypes アクションとともに使用します。
- -collation:<id>
- Db2 データベースの作成時に使用する照合タイプ。デフォルトは、Windows の場合は SYSTEM_1252_US、UNIX/Linux の場合は SYSTEM_923_US です。-script -provider:db2 アクション/オプションとともに使用します。
- -datastore:<url>
- ファイルをリストまたは回復するデータストアの URL。-openfiles および -keytypes -import/-export アクション/オプションとともに使用します。
- -db:<dbname>
- 作成または使用するデータベースの名前。-script -provider:db2 アクション/オプションとともに使用します。
- -delete
- 特定のデータストアのキータイプ メタデータを削除するように指定します。-keytypes アクションとともに使用します。
- -ebcdic
- EBCDIC をサポートするデータベースを作成します。-createdb -provider:db2 アクション/オプションとともに使用します。
- -existdb:<db-name>
- データストア、リージョン データベース、またはリージョン間データベースを作成する既存のデータベースの名前。-script -provider:db2 アクション/オプションとともに使用します。
- -export:<file-name>
- 特定のデータストアのキータイプ メタデータをエクスポートするためのファイルを指定します。-keytypes -datastore アクション/オプションとともに使用します。
- -file:<url>
- キータイプ メタデータを追加または削除するデータストア データ ファイルを指定します。-keytypes -add/-delete アクション/オプションとともに使用します。
- -file:<file-name>
- データベース作成用の入力ファイル名、または生成されたスクリプトの出力ファイル名を指定します。入力ファイルについては -createdb アクション、出力ファイルについては -script アクションとともに使用します。
- -host:<name>
- プロセスを回復するかファイルを強制的に閉じる対象のホスト名。-casprocess -list/-recover または -openfiles -list/-recover アクション/オプションとともに使用します。
- -import:<file-name>
- インポートするキータイプ メタデータを含むファイルを指定します。-keytypes -datastore アクション/オプションとともに使用します。
- 次の例は、インポート ファイルの形式を示しています。データストアのルートにある file1.dat には、英数字の主キーと符号付き COMP-X の最初の代替キーが含まれています。PAY1 サブフォルダーにある file2.dat には、英数字の主キーと最初の代替キー、および符号なし COM-X の 2 番目の代替キーが含まれています。
<?xml version="1.0" encoding="us-ascii" standalone="no"?>
<keytypes_definitions>
<keytypes_definition filename="file1.dat" folder="/" types="AN,SCOMPX"/>
<keytypes_definition filename="file2.dat" folder="/PAY1" types="AN,AN,UCOMPX"/>
</keytypes_definitions>
- -list
- 指定したアクションの結果をリストします。-casprocess -list はアクティブなプロセスを表示し、-region -list はリージョン リソースのロックを表示し、-openfiles -list は現在開いているファイルを表示します。
- -name:<object-name>
- 作成するデータストアまたはリージョン データベース スクリプトの名前、または回復するリージョン リソースの名前。-script -type:datastore および -script -type:region アクション/オプション、および -region -list/recover アクション/オプションとともに使用します。
- -nobanner
- -quiet と同じ。
- -password:<pwd>
- データベースへの接続に使用するパスワード。-createdb -provider:az|pg|ss アクション/オプションとともに使用します。
- -pid:<process-id>
- 指定したアクションに該当するプロセス ID。-casprocess -recover または -openfiles -recover アクション/オプションとともに使用します。
- -provider:<db-type>
- スクリプトを生成する (-script) かデータベースを作成する (-createdb) データベース プロバイダーの名前。<db-type> は、次のいずれかになります。
-
db-type |
説明 |
az |
Azure SQL データベース |
azuresqldb |
Azure SQL データベース |
db2 |
Db2 |
postgresql |
PostgreSQL |
pg |
PostgreSQL |
sqlserver |
Microsoft SQL Server |
ss |
Microsoft SQL Server |
- -recover
- CAS プロセスが所有するリソースを回復するか、開いているデータストア ファイルを閉じます。-casprocess、-region、または -openfiles アクション/オプションとともに使用します。
- -replace
- ファイルに対する既存のキータイプ メタデータを置き換えます。-keytypes、-add、または -import アクション/オプションとともに使用します。
- -type:<script-type>
- データベース作成スクリプトのタイプを指定します。crossregion、datastore、region のいずれかです。-script および -createdb アクションとともに使用します。
- -types:<key-types>
- ファイルの主キーと代替キーのカラム型を定義します。次のタイプを使用して、キー タイプをコンマ区切りリストとして指定します。
タイプ |
説明 |
AN |
英数字 |
BIN |
バイナリ |
SCOMPX |
符号付き COMP-X |
UCOMPX |
符号なし COMP-X |
- -keytypes -add/-replace/-import/-export/-list アクション/オプションとともに使用します。
- -usedb:<instance>
- 指定したデータベース サーバー インスタンスを使用します。-casprocess -list/-recover、-createdb -provider:az|ss、-openfiles -list/-recover、または -openfiles -list/-recover アクション/オプションとともに使用します。
- -user:<user-name>
- データベースへの接続に使用するユーザー名。-createdb -provider:az|pg|ss アクション/オプションとともに使用します。
- -verbose
- 現在の操作について、データベース構成ファイルや有効なスクリプト フォルダーの場所などの追加情報を表示します。