-c

エラーが発生しても、次のデータ ファイルまたは辞書ファイルのリビルドを続行するように、Rebuild に指示します。ユーティリティにより、MicroKernel データ ファイル以外のファイルであることや MicroKernel ファイルでエラーが発生したことが通知されますが、データ ファイルのリビルドは続行されます。エラーはログ ファイルに書き出されます。ログ ファイルを参照してください。

ヒント：このパラメーターは、混合するファイルのセットに対してワイルドカード文字（*.*）を指定した場合に特に便利です。混合ファイルのセットとは、MicroKernel ファイルと非 MicroKernel ファイルの組み合わせです。Rebuild は非 MicroKernel ファイルを処理するたび（または MicroKernel ファイルのエラー時）にエラーを報告しますが、処理を続行します。

-d

-d を指定すると、バージョン 6.0 より前の補助インデックス（重複が可能）を 6.x、7.x または 8.x のリンク重複キーのあるインデックスに変換します。

このパラメータを指定しないと、Rebuild はインデックスを繰り返し重複キーとして保持します。

MicroKernel エンジンを介してのみデータ ファイルにアクセスし、かつファイルに比較的多数の重複キーがある場合には、-d パラメーターを使用して Get Next オペレーションや Get Previous オペレーションのパフォーマンスを向上させることができます。

-m<0 | 2>

"m" パラメータは処理方法を示します。Rebuild はこのパラメータが指定されているかどうかによって処理方法を選択します。このパラメーターを指定しない場合、Rebuild は以下のように処理します。

選択した方法によって影響を受けるメモリの量については、メモリ量を参照してください。

インデックスの削除や置き換えを行うことなくデータ ファイルまたは辞書ファイルの複製を作成してコピーします。この方法は -m2 の方法に比べて時間がかかります。インデックスをリビルドしない場合には、この方法が使用できます。

-m0 を使用すると、各キー ページの使用率が 55% から 65% のファイルが作成されます。このファイルは書き込み用により最適化されていて、読み取りには最適化されていません。状況によりますが、リビルドにかける時間の余裕がある場合は、書き込み用に最適化されるリビルドを行うのが望ましいでしょう。

Rebuild 処理の最適化も参照してください。

データ ファイルまたは辞書ファイルの複製を作成し、インデックスを削除して新しいファイルにレコードをコピーした後、インデックスをリビルドします。この方法は、-m0 の方法よりも短時間でリビルドでき、ファイルのサイズも小さくなります。

-m2 の方法では、元のファイルとは異なる物理順序のレコードを含む新規ファイルが作成されることがあります。

-m2 の方法を使用して作成されるファイルのキー ページは 100% 使用済みです。こうすると、ファイルを読み取りに最適化することができます。

-p<D | P | bytes>

ページ サイズをディスク ストレージに最適化します。

開発者リファレンス『PSQL Programmer's Guide』のページ サイズの選択を参照してください。

処理に対して最適化します（つまり、そのデータにアクセスするアプリケーションのための最適化です）。-pP では、Rebuild はデフォルトのページ サイズ 4096 バイトを使用します。

Rebuild 処理の最適化 を参照してください。

新しいファイルのページ サイズをバイト単位で指定します。9.0 より前のファイル バージョンの場合、有効な値は 512、1024、1536、2048、2560、3072、3584 および 4096 です。9.0 のファイル バージョンの場合、上記と同じ値に 8192 が加えられます。9.5 以上のファイル バージョンの場合、有効な値は 1024、2048、4096、8192 および 16384 です。

-bdirectoryname

リビルドしたファイルに別の場所を指定します。別のサーバー上の場所も指定できます。デフォルトの場所は、データ ファイルのあったディレクトリです。必ず存在する場所を指定してください。Rebuild はディレクトリを作成しません。また、そのディレクトリは PSQL データベース エンジンが起動しているマシン上のディレクトリでなければなりません。

完全修飾したパスまたは相対パスのいずれも使用できます。directoryname にはワイルドカード文字を使用しないでください。

ローカル サーバーの場合は、MicroKernel Database エンジンとメッセージ ルーターがロードされている必要があります。リモート サーバーの場合は、MicroKernel Database エンジンと通信コンポーネントがロードされている必要があります。

このパラメーターを指定しないと、リビルドされたファイルによって元のデータ ファイルが置き換えられます。元のファイルのコピーは保持されません。

このパラメーターを指定すると、リビルドされたファイルは指定の場所に置かれ、元のファイルが保持されます。これに関する例外があります。指定した場所に同じ名前のデータ ファイルが既に存在する場合です。元のファイルと同じ名前のファイルが指定された場所に含まれていた場合、Rebuild ではエラーが起こります。たとえば、folder1 というディレクトリにある mydata.mkd をリビルドしようとするとします。リビルドされたファイルを foder2 というディレクトリに保存したいとします。folder2 にも mydata.mkd が存在していた場合（おそらく気付かないうちに）、Rebuild ではエラーになり、ログ ファイルを調べるよう通知があります。

メモ：指定した場所（このパラメーターを指定しなかった場合は元のファイルの場所）に対して、ファイルを作成するアクセス権があることを確認してください。

-knumber

キー番号を指定します。Rebuild はこれを使って元のファイルを読み、リビルドしたファイルを並べ替えます。このパラメーターを指定しないと、Rebuild はもとのファイルを物理順に読み、リビルドしたファイルも物理順で作成します。

Rebuild 処理の最適化も参照してください。

-s[D | K]

リビルドしたファイルに、元のファイルの既存のシステム データとキーを保持します。このパラメーターを指定しないと、Rebuild はシステム データとキーをリビルドしたファイルに含めません。

リビルドしたファイルにシステム データを含めます。システム データにはインデックスが作成されません。

リビルドしたファイルにシステム データとキーを含めます。システム データにはインデックスが作成されます。

-lfile

Rebuild のログ ファイルにファイル名を指定します。オプションでパスの場所を指定することができます。デフォルトのファイル名は、Windows、Linux、および OS X では rbldcli.log です。デフォルトの場所は現在の作業ディレクトリです。

以下の条件が適用されます。

ログ ファイルも参照してください。

-pagecompresson

file のページ圧縮をオンにすると、以下の条件が設定されます。

-pagecompressoff

file のページ圧縮をオフにします。このパラメーターは、file にページ圧縮が指定されていない場合は無効です。

-recordcompresson

file のページ圧縮をオンにします。

-recordcompressoff

file のレコード圧縮をオフにします。このパラメーターは、file にレコード圧縮が指定されていない場合は無効です。

-f<6 | 7 | 8 | 9 | 95>

リビルド後のデータ ファイルまたは辞書ファイルのファイル形式を指定します。ファイル形式は、バージョン 6.x、7.x、8.x および 9.x が使用できます。次の例ではファイルを 9.0 形式にリビルドします。

rbldcli -f9 <file_path>\class.mkd

次の例ではファイルを 9.5 形式にリビルドします。

rbldcli -f95 <file_path>\class.mkd

このパラメータを指定しないと、Rebuild は MicroKernel の［作成ファイルのバージョン］設定オプションに指定されている値を使用します。

メモ 1：現在のデータベース エンジンでサポートされているバージョンより新しいファイル形式を指定した場合、Rebuild はそのエンジンでサポートされている最新のファイル形式を使用します。Rebuild はこれに関してはエラーもメッセージも報告しません。

メモ 2：Rebuild はインデックスのデータ型を変換しません。ファイルを古いデータベース エンジンで使用するために古いファイル形式にリビルドする場合、エンジンが使用されているデータ型をサポートしているかどうかを確認してください。必要に応じ、アプリケーションとそのデータベース エンジンによって、手作業でデータ型を調整する必要があります。

例 1：データ ファイルに WZSTRING データ型を使用するインデックス フィールドが含まれています。データ ファイルを 6.x 形式にリビルドする場合、WZSTRING データ型は変換されません。このデータ ファイルを Btrieve 6.15 エンジンで使用することはできません。このエンジンは WZSTRING データ型をサポートしません。

例 2：データ ファイルに NULL が含まれています。データ ファイルをを 7.x ファイル形式にリビルドします。真の NULL は変換されません。このデータ ファイルを PSQL 7 エンジンで使用することはできません。このエンジンは 真の NULL をサポートしません。

-uiduname

セキュリティが設定されているデータベースにアクセスする権限を与えられたユーザー名を指定します。

-pwdpword

uname で識別されるユーザーのパスワードを指定します。uname が指定された場合、pword は必ず指定する必要があります。

-dbdbname

セキュリティが設定されたデータベース名を指定します。

変換するデータ ファイルおよび辞書ファイルを指定します。元のファイルが現在の作業ディレクトリにない場合は、完全修飾パスまたは相対パスのいずれかを使用して場所を含めてください。ファイル名にはアスタリスク（*）ワイルドカード文字を使用して、複数のファイルを指定することができます。

メモ：元のファイルにオーナー ネームが含まれている場合、Rebuild はリビルドしたファイルにオーナー ネームとレベルを適用します。

@command_file

Rebuild で実行されるコマンド ファイルを指定します。1 つのコマンド ファイルに複数の項目を指定できます。コマンド ファイルの各項目には、コマンド ライン パラメーター（ある場合）と変換するファイルのセットを指定し、その後に <end> または ［end］ を続けます。

変換するファイルを指定する場合には、完全なディレクトリ名を使用します。ファイル名にはアスタリスク（*）ワイルドカード文字を使用できます。

次に、Rebuild コマンド ファイルの例を示します。

–c d:\mydir\*.*<end>
–c –p1024 e:\dir\*.*<end>
–m0 –k0 d:\ssql\*.*<end>