この章では、以下の項目について説明します。

このセクションでは、DDF Builder での作業に関する概念的な情報を提供します。以下のセクションがあります。

DDF Builder で作業を開始する前に、このマニュアルで使用している用語についてもう一度確認してください。用語には、リレーショナル データベース モデルでのみ使用されるものもあれば、トランザクショナル データベース モデルに関するものもあります。DDF Builder はトランザクショナル データからリレーショナル テーブル定義を作成するよう設計されているため、これら 2 つのモデルを一つの場所で一緒に用います。トランザクショナル モデルで使用される用語がリレーショナル モデルでは異なる意味になることもあるため、ここでの情報は役に立ちます。次の表に、このマニュアルで使用される用語を示します。

DDF Builder でセキュリティが有効なデーターベースを扱う場合は、DDF Builder でそのファイルを開く前にすべてのセキュリティを無効にしておくことをお勧めします。セキュリティを無効にできなかった場合、DDF Builder では呼び出しが実行されるたびに安全なログインとパスワードを要求します。呼び出しごとにこの要求があると、テーブル定義の作成や変更に必要な回数によっては作業効率の低下を招く恐れもあります。

DDF Builder は PSQL v9.x 以上のバージョンでサポートされます。Scalable SQL v4.00 以上で作成された DDF は Btrieve データ ファイル v6.x 以上と一緒にサポートされます。

Scalable SQL v3.xx 以前のバージョンで作成された DDF がある場合は、それを DDF Builder で開く前に変換しておく必要があります。

この手順については、レッスン 1 － v3.00 の DDF を使った作業を参照してください。

DDF Builder ではバージョン 6.x のファイルをサポートしますが、バージョン 6.x より前に作成されたファイルはサポートしません。Btrieve v5.x 以前に作成された Btrieve データ ファイルがある場合は、それを DDF Builder で開く前にリビルドしておく必要があります。

この手順については、レッスン 2 － v6.x より前のファイル形式での作業を参照してください。

Btrieve ファイルに関連付けられている既存のテーブル定義を開く場合、DDF Builder では一連の比較とチェックを行います。これらの比較とチェックによってエラーが検出されると、DDF Builde はテーブル定義に対して一定の調整を行うことがあります。テーブル定義に対する変更は定義エラー ビューに記録されます。

DDF Builder が行う変更の評価と可能性を理解できるよう、DDF Builder がたどる手順を見てみましょう。

まず、DDF Builder は Btrieve ファイルを調べて、レコード長、インデックス、インデックス セグメントなど適切な内容を分析します。次に、DDF Builder は既存の DDF を開き、その DDF に含まれる情報を見て Btrieve ファイルと比較します。双方の内容が互いに一致するかしないか、体系的に比較されます。

DDF Builder では、Btrieve ファイルで見つかった内容を基準にしてエラーや問題を検出および修正します。次の例でわかりやすく説明します。

1 つのキーを含む Btrieve ファイルがあります。テーブル定義にはこれに対応するインデックスがありません。DDF Builder では Btrieve ファイルを変更することはできないので、この Btrieve ファイルで定義されているキーがインデックスとしてテーブル定義へ引き継がれます。

この種の状況を処理する場合の情報については、レッスン 6 – インデックスの不一致を参照してください。

Btrieve ファイルには総レコード長が 120 バイトで定義されているレコードがありますが、テーブル定義では 100 バイト分しか定義されていませんでした。DDF Builder では Btrieve レコードを変更できないので、テーブル定義の方に、割り当てられていない 20 バイトの列を追加します。

この種の状況を処理する場合の情報については、レッスン 8 – レコード長の不一致を参照してください。

Btrieve ファイルのキーには、テーブル定義内の対応する SQL インデックスのフラグ設定と一致しないフラグがあります。前の例と同様、DDF Builder では Btrieve ファイルを変更できないので、テーブル定義の SQL インデックスにおけるフラグ設定は Btrieve ファイルのフラグ設定と一致するよう変更されます。

この種の状況を処理する場合の情報については、レッスン 5 － ファイル/フィールド フラグの不一致を参照してください。

DDF Builder ではすべての問題を修正することはできません。DDF Builder で検出され修正される問題については、テーブル定義エラーを参照してください。

DDF Builder は既存のテーブル定義に対して推奨する変更を行いますが、その変更を保持するよう要求されたり、あるいは元のテーブル定義を破棄するよう要求されることはありません。

変更した定義または元の定義のどちらかを別名で保存すれば、両方の定義を保存しておくことができます。DDF Builder によって行われた変更を受け入れる場合、変更したテーブル定義か元のテーブル定義のどちらかを別名で保存できます。

DDF Builder によって行われた変更を拒否する場合、元のテーブル定義は元の名前で保持されます。

テーブル定義エディターは、テーブル定義のビュー、作成および変更に使用するいくつかの情報ページで構成されます。テーブル定義エディターには以下のページがあります。

［テーブル］ページはテーブル定義の作成や変更時に大半の作業を行うページです。この［テーブル］ページには、未加工データ ビューとグリッド データ ビューがあります。

未加工データ ビューでは、Btrieve ファイルのデータを ASCII と 16 進数表示で見ることができます。このビューにはレコード長、オフセット、およびフィールド サイズも表示されます。

また、未加工データ ビューでは列、ヌル インジケーターの判断や、不明なフィールドやバイトを特定するために必要なビジュアル インジケーターを提供します。

グリッド データ ビューの機能は、PSQL Control Center の SQL Editor で見られるグリッド ウィンドウ ビューに似ています。

インデックスに使用されるフィールドはサイズや型を変更することができません。フィールド名のみグリッド データ ビューで変更できます。インデックスの追加、インデックスの削除、またはその他のインデックス情報の変更を行うには、Btrieve Maintenance ユーティリティを使用して Btrieve ファイルを直接変更する必要があります。

［インデックス］ページでは、DDF Builder が Btrieve ファイルで検出したインデックスとインデックス セグメントを見ることができます。このページからインデックスやインデックス セグメントを追加したり変更したりすることはできません。［インデックス］ページで可能なのはインデックス名の変更のみです。［テーブル］ページでインデックス フィールドの名前を変更した場合、その変更は［インデックス］ページでリアルタイムに反映されインデックス名が更新されます。

オルタネート コレーティング シーケンス（ACS）ファイルを使用する Btrieve ファイルで作業する場合、その ACS ファイルは作業対象の Btrieve ファイルと同じディレクトリにあり、拡張子は .alt（upper.alt など）である必要があります。

［プレビュー］ページでは、現在のテーブル定義を使用して書式設定されたファイルのデータを見ることができます。テーブル定義を変更すると、それに応じてこのプレビューも変わります。

［プレビュー］ページは読み取り専用です。このページに表示される情報を編集することはできません。ただし、このページの下部にある矢印ボタンを使ってレコードを移動することはできます。

［統計情報］ページでは、テーブル定義エディター で開いたファイルの Btrieve ファイル統計情報が表示されます。このページに表示される情報は、Btrieve Maintenance ユーティリティでこのファイルに対して生成された統計情報レポートで報告される情報と同じです。

［SQL ビュー］ページでは、テーブル定義の作成や変更を反映した SQL ステートメントが表示されます。テーブル定義を変更すると、その基となる SQL ステートメントは［SQL ビュー］ページで直ちに更新されます。

このページの情報は読み取り専用なので、このページ上で内容の変更を行うことはできません。必要であれば、ステートメントを選択してコピーし別の場所で使用してください。

レガシー ヌルについては、Pervasive.SQL 2000 より前の PSQL のバージョンでのみサポートしていました。レガシー ヌルを使用するファイルは DDF Builder で認識されますが、DDF Builder で作業する場合は、このタイプのヌルを処理するために必要なアクションはありません。

Pervasive.SQL 2000 では真のヌルに対するサポートが追加されました。真のヌルについては、フィールドの先頭にあるバイトで、ヌル インジケーター バイトとしても知られています。これは、該当する列にヌル値の可否を指定するために用いられます。

DDF Builder でレコード フィールドを定義する場合、レコード内にヌル値を許可するフィールドがあるかどうかを知っていることが重要です。なぜなら、レコードの一部分でヌル値を許可することにした場合、1 バイトが余分にフィールドへ追加されるからです。ファイルは Btrieve ファイルであるため、レコードでヌル値が許可される部分は、ヌル インジケーター バイトを使用することで指定されます。ヌル インジケーター バイトは、テーブル定義エディターの未加工データ ビューでフィールドまたは列の直前のバイトに該当します。［ヌル］チェック ボックスが選択されると、ヌル インジケーター バイトがアクティブになり、そのヌル インジケーター バイト分を確保するためフィールドのサイズは自動的に 1 バイト削減されます。

DDF Builder でヌルを許可するフィールドを作成する際は、フィールドのサイズとヌル インジケーター用に必要な 1 バイトを考慮する必要があります。これはヌル値が可能なフィールドのサイズを 25 バイトにするつもりでれば、実際は 26 バイトとして定義し、1 バイト分をヌル インジケーター用に確保することを意味します。フィールドに対してヌル値を許可するよう指定すると、そのフィールドのサイズは自動的に DDF Builder によって 1 バイト削減されます。

DDF Builder ではグラフィカル ユーザー インターフェイス（GUI）が利用できます。この GUI には、オブジェクトの表示や作業に使用するさまざまなエディター、ビューおよびウィザードがあります。

編集中のオブジェクトは、エディター上部にタブによって示されます。タブにはオブジェクトの名前が表示されます。エディター内で変更したデータは明示的に保存する必要があります。

ビューは、一度に 1 つのみ開くことができます。ビュー内で実行された操作は直ちに適用されます。明示的に保存する必要はありません。

ウィザードでは 1 つまたは複数のダイアログによって特定の結果を得るための作業手順を導きます。

以下の表に DDF Builder で提供されるエディター、ビューおよびウィザードを示します。

DDF Builder を起動するたびに［ようこそ］ページが開きます。このページから迅速にさまざまな情報へアクセスしたり、共通のタスクを実行することができます。

このページから実行できる共通のタスクはサーバーの新規作成やデータベースの新規作成です。

また、このページからはさまざまな情報も得ることができます。各種情報に素早くアクセスできるリンクもいくつかあります。［ようこそ］ページで提供される情報は、以下のとおりです。

DDF Builder の［ようこそ］ページは、一度閉じてしまってもいつでも開くことができます。DDF Builder のメニュー バーで［ヘルプ｜ようこそ］をクリックすると［ようこそ］ページが表示されます。

DDF Builder では データ ソース エクスプローラーと呼ばれるオブジェクト ツリー形式のファイル エクスプローラーを使用します。オブジェクトには、データベース、データ パス、Btrieve ファイルおよび SQL テーブルなどがあります。ツリー オブジェクトはノードと呼ばれます。

ノードは展開したり折りたたんだりして、下位ノードの表示/非表示を切り替えることができます。ノードに下位ノードがある場合は、そのノードの左側に展開/折りたたみ用アイコンが表示されます。

Btrieve ファイル エディターでは新しい Btrieve ファイル用のファイル仕様およびキー仕様を作成します。DDF は新しい Btrieve ファイルに対して自動的に作成されません。DDF が必要な場合は別途追加する必要があります（SQL テーブルを参照）。

データ ソース エクスプローラーで、［データ パス］ノードの直下にある作業対象のデータ パス ノードを右クリックし、［Btrieve ファイルの作成］を選択します。

Btrieve ファイルは物理ストレージに置く必要があります。これは Btrieve ファイル エディターがデータ パスから起動されるからです。

Btrieve ファイル エディターには、ファイルの特性を指定するタブとキーの特性を指定するタブがあります。各タブにある［適用］ボタンをクリックすると、そのタブで指定した仕様が保存されます。［ファイル］>［保管］をクリックすると両方のタブで行った変更を一括保存します。

Btrieve ファイルを作成するためには、少なくともファイル名とレコード長を指定する必要があります。これは［ファイル スペック］タブで指定します。

必要な知識でも述べているように、このマニュアルは、トランザクショナル アクセス方法とリレーショナルの概念について十分に理解していることを前提として説明しています。このセクションでは Btrieve ファイル エディターのタブにあるコントロールについては説明しません。Btrieve ファイルについてさらに理解を深める必要がある場合は、次の表で提供する関連ドキュメントを参照してください。

一度に作成できる Btrieve ファイルは 1 つだけです。［キー スペック］タブで、セグメント キーのセグメントを追加または変更したら［適用］をクリックします。これにより、各セグメントへの変更が保存され、次のセグメントを新たに作成または編集することができます。

テーブル定義エディターでは、SQL メタデータ用のスキーマを新規作成したり既存のスキーマを変更したりします。テーブル定義エディターは PSQL Control Center（PCC）の Table Editor と似ています。詳細については、Table Editorを参照してください。

データ ソース エクスプローラーで以下の操作のいずれかを実行します。

テーブル定義エディターは、PSQL Control Center（PCC）の Table Editor と同様に、タブまたはページを使用してテーブル定義情報のさまざまなビューを表示します。読み取り専用の情報ページもあれば、テーブル定義を作成したり編集したりする作業領域を持つページもあります。

列が Btrieve ファイルのキーとして使用されている場合、その列のサイズ、オフセットおよびデータ型を変更することはできません。DDF Builder では既存の Btrieve ファイルのレイアウト構造を変更できません。

テーブル定義エディターの［テーブル］ページでは、2 種類のメタデータ ビュー（未加工ビューとグリッド ビュー）を提供します。未加工ビューでは情報を Btrieve ファイルで表示し、グリッド ビューは情報を SQL テーブルとして表示します。

［テーブル］ページはテーブル定義エディターの下部にある［テーブル］タブをクリックして開きます。

未加工データ ビューではデータ レコードの 16 進値と ASCII 値を同時に表示します。また、このビューではレコード長のほか、オフセットや選択したバイト数も表示します。このオフセットやサイズの値は、ビュー内で選択したバイト位置やバイト数に応じて調整されます。

未加工データ ビューの上部にはフィールド、列、ヌルおよび不明であることを示すインジケーターが表示されます。フィールド インジケーターは、レコード内で各フィールドの開始位置を示します。ヌル インジケーターはヌル インジケーター バイトが置かれる場所を示します。不明なフィールドやバイトも未加工データ ビューで表示されます。

次に未加工データ ビューで表示される属性を挙げます。

グリッド データ ビューは、テーブルのスキーマ構造を行と列のグリッドとして表示します。各フィールドはグリッド上で行として表されます。各行は、各フィールドの属性を示すセルで構成されます。属性の多くは編集可能で、スキーマへの変更として保存もできます。

次にグリッド データ ビューで表示される属性を挙げます。

グリッド データ ビューでセルを選択すると、未加工データ ビューではそのセルのフィールドに該当するバイト部分が示されます。同様に、未加工データ ビューで任意のバイト部分を選択すると、グリッド データ ビューではそれに該当するフィールド行が選択されます。

1 つのフィールドの定義範囲を越えて次のフィールド定義まで選択しようとすると、エラー メッセージが表示され、グリッド データ ビューではその両方の行が選択されます。エラー メッセージと警告メッセージは共に未加工データ ビューで表示されます。

［インデックス］ページの内容は、SQL インデックス名を除き読み取り専用です。このページで、インデックスの構造を変更することはできません。インデックスの追加や SQL テーブルへの変更は PSQL Control Center で行う必要があります。『PSQL User's Guide』のTable Editorを参照してください。

［インデックス］ページはテーブル定義エディターの下部にある［インデックス］タブをクリックして開きます。

［テーブル］ページで、インデックスとして指定されているフィールド名を変更すると、その変更はすぐに［インデックス］ページにも反映されます。

［インデックス］ページでは SQL インデックス名のみが変更できます。

オルタネート コレーティング シーケンス（ACS）ファイルを使用する Btrieve ファイルで作業する場合、その ACS ファイルは作業対象の Btrieve ファイルと同じディレクトリにあり、拡張子は .alt（upper.alt など）である必要があります。

［プレビュー］ページは、ファイルのデータを行と列で構成した読みやすいレイアウトで表示します。

［プレビュー］ページはテーブル定義エディターの下部にある［プレビュー］タブをクリックして開きます。

ページの下部中央にあるボタンを使用するとデータ レコード間を移動できます。このボタンの右側にはファイルの位置が表示されます。ファイル位置は、総レコード数のうち表示されているレコード範囲を示します。たとえば、"100-199/1314" と表示されている場合、総レコード数 1,314 件のうち、100 番目から 199 番目までのレコードが表示されていることを示します。

［テーブル］ページで列定義を変更すると、その変更はすぐに［プレビュー］ページにも反映されます。

このページの情報は読み取り専用で、変更できません。

［統計情報］ページには Btrieve ファイルのファイル仕様とキーの仕様が表示されます。この情報は読み取り専用で、このビュー内では変更できません。

［統計情報］ページはテーブル定義エディターの下部にある［統計情報］タブをクリックして開きます。

統計情報は、Btrieve ファイルの構造上の特性を見るための便利な手段です。これは、ファイルのスキーマをエクスポートしようと考えているがファイルやキーの仕様がよくわからないときには大いに役立ちます。

Btrieve スキーマのエクスポートも参照してください。

［SQL ビュー］ページでは、現在のテーブル定義を作成するために必要な SQL ステートメントを表示します。

［SQL ビュー］ページはテーブル定義エディターの下部にある［SQL ビュー］タブをクリックして開きます。

DDF Builder で作成される SQL ステートメントに基づいて新しいスキーマを作成するために、ここで作成されている大部分の SQL ステートメントをコピーして PSQL Control Center で再利用することができます。PSQL Control Center で使用する SQL ステートメントは将来使用するため保存しておくこともできます。

ここで作成される SQL ステートメントはコピーして再利用することができますが、保存はされません。また、現在 DDF Builder で提供されている SQL ステートメントを自動的に保存する手段もありません。SQL ステートメントを保存するには、このウィンドウからそのステートメントをコピーしてテキスト エディターに貼り付けて保存する必要があります。

これはデータベースを新規作成します。このダイアログは PSQL Control Center（PCC）と共有になっています。『PSQL User's Guide』のデータベースおよび［データベースの新規作成］GUI のリファレンスを参照してください。

DDF Builder ではテーブルの一貫性をチェックする機能を提供します。一貫性のチェックでは一連の検証ルールを使用して、物理データ ファイルとメタデータをそのデータ辞書ファイルで比較します。

一貫性のチェックでは以下のような条件を検証します。

一貫性のチェックは、一度にすべてのテーブルを対象に行ったり、テーブルを個別に選択して行うこともできます。このチェックでは、オブジェクトによる検証メッセージ、エラーおよび警告のカウントを報告します。オブジェクトとはデータベース、テーブルまたはデータ辞書ファイル（DDF）です。

"正常終了" という見出しによって分類される検証メッセージは、検証された一貫性チェックを一覧表示します。エラーは "エラー" という見出しによって分類され、警告は "警告" という見出しによって分類されます。

エラー メッセージがある場合は必ず表示されます。オブジェクトにエラーと警告の両方がある場合、警告は "エラー" にもリストされます。

検証メッセージや警告は表示したり非表示にしたりすることができます。

エラーはテーブル定義における問題を示すもので、多くの場合、データ ファイルがアクセスされたときにエラーや不正なデータが返される原因になります。たとえば、DDF に定義されているインデックスがデータ ファイルにはないとエラーになります。そのようなインデックスは実際にはデータ ファイルにないため、エンジンがその特定のインデックスで最適化するような SQL クエリではエラーが発生します。

警告は起こり得る問題を暗示するものですが、その問題がエラーを引き起こすとは限りません。たとえば、あるインデックスがデータ ファイルに定義されているが、対応する DDF エントリがない場合は警告になります。SQL アクセスはインデックスについて知らないので、それを使用しようとはしません。そのため時間のかかるクエリになるかもしれませんが、このクエリは最終的には正しい結果を返します。

データ ソース エクスプローラーで、データベース名を右クリックして［データベースの確認］を選択するか、［データ パス］または［SQL テーブル］ノードの下にある SQL テーブル名を右クリックして［テーブルの確認］を選択しますShift キーまたは Ctrl キーを押したまま対象のテーブル名をクリックすると、複数のテーブルを選択することができます。

DBCheck ペインはドッキング解除して DDF Builder ウィンドウ内の別の場所へ移動させることができます。このペインは最小化および最大化することができます。

SQL 定義のコピー ウィザードでは、既存の SQL テーブルのスキーマをソースとして使用し、新たな SQL テーブルを作成します。また、このウィザードでは新しい SQL テーブルと関連付けられる Btrieve ファイルも作成されます。

データ ソース エクスプローラーで SQL ファイル名を右クリックし、［SQL 定義のコピー］を選択します。

このウィザードでは以下の項目について指定が必要です。

Btrieve スキーマのエクスポート ウィザードでは、ソースとなる Btrieve ファイルのスキーマの仕様を定める XML ファイルを作成します。この XML ファイルを使用することによって、既存の Btrieve ファイルの構造に基づいた Btrieve ファイルを新たに作成することができます。「Btrieve スキーマのインポート」を参照してください。

ソース ファイルのデータはエクスポートされません。データをエクスポートする場合は、データ エクスポート ウィザードを使ったデータのエクスポートを参照してください。

データ ソース エクスプローラーで、［データ パス］ノードの下位にある Btrieve ファイル名を右クリックし、［Btrieve スキーマのエクスポート］をクリックします。

デフォルトで、このウィザードではエクスポートされる XML ファイル名にソース ファイル名を使用します。この XML 出力ファイルは .xml というファイル拡張子が付けられ、ソース ファイルと同じディレクトリに書き込まれます。出力ファイルのデフォルト名前と保存場所は変更することもできます。

また、エクスポートする前に XML の内容をプレビューすることもできます。

Btrieve スキーマのインポート ウィザードでは、別の Btrieve ファイルの構造を基にして Btrieve ファイルを作成します。この構造は XML フォーマットによるソース ファイルのスキーマである必要があります。

ソース ファイルのデータはインポートされません。データをインポートする場合は、データ インポート ウィザードを使ったデータのインポートを参照してください。

データ ソース エクスプローラーで、［データ パス］ノードの直下にある作業対象のデータ パス ノードを右クリックし、［Btrieve スキーマのインポート］を選択します。

Btrieve ファイルは物理ストレージに置く必要があります。これはこのウィザードがデータ パスから起動されるからです。

このウィザードは、既知のデータ パスのコンテキストから起動するため、ターゲット ファイルのパスを指定する必要はありません。ファイル名を指定するだけです。ファイル名の長さは 255 文字以下で指定してください。［スペースを含むファイル/ディレクトリ名］クライアント設定オプションが有効になっていない場合、名前にスペースを含めることはできません。デフォルトでこのオプションは有効になっています。『Advanced Operations Guide』でクライアント用の「アプリケーション特性」設定にある スペースを含むファイル/ディレクトリプロパティを参照してください。

データ パスは、データ ソース エクスプローラーで［データ パスの追加］コマンドを使用して追加します。データ パスとは、Btrieve ファイルが存在する物理ストレージ上の場所を指します。各データベースには、識別されるデータ パスが最低 1 つあります。

Btrieve ファイル用に作成される DDF は、そのデータベースの元のデータ パスに置かれます。これはそのデータベース全体の SQL テーブルがすべて同じ DDF のセットに定義されるためです。

データ ソース エクスプローラーで、［データ パス］ノードを右クリックし、［データ パスの追加］をクリックします。

既存のディレクトリは、空の場合と既にファイルが含まれている場合があります。

［削除］コマンドを使用すると、データ ソース エクスプローラーからデータ パスが削除されます（削除対象のデータ パスまたはデータベース名を右クリックし、［削除］をクリックします）。ディレクトリは物理ストレージから削除されません。

DDF Builder では、選択したテーブル定義（SQL テーブル）に関連付けられるデータ ファイルを変更することができます。

データ ソース エクスプローラーで、関連付けされているデータ ファイルを変更する SQL テーブルを右クリックし、［関連するデータファイルの変更］をクリックします。関連付けるデータ ファイルの完全なパス名を入力するか、参照して選択します。

特定の SQL テーブルに関連付けられているデータ ファイルを変更する場合、ファイル名を入力するか、［参照］ボタンを使用してファイルの場所を参照し選択します。

DDF Builder では、Btrieve データ型とサイズ、およびそれに対応する SQL データ型を表示する単独のビュー（Btrieve ビュー）を提供しています。

この Btrieve 型ビューはデータの分析に使用することができます。未加工データ ビューで任意のバイトを選択すると、Btrieve 型ビューではそのバイト（サイズ）に適合するデータ型でデータがどのように見えるかを表示します。テーブル定義エディターで特定の列を選択した場合にも、Btrieve 型ビューでは書式設定されたデータのプレビューを表示します。

［Btrieve 型］タブは DDF Builder ウィンドウの左側のペインのデータ ソース エクスプローラーで［データ ソース］タブの隣にあります。［Btrieve 型］タブをクリックすると、Btrieve 型ビューが表示されます。

Btrieve 型ビューのペインは、データを比較したりプレビューしたりして不正なデータ型やサイズを解決しようとする際に役立ちます。このタスクをサポートするために、Btrieve 型ビューのペインをドッキング解除して DDF Builder ウィンドウ内の適当な位置に移動させることができます。

［プレビュー］列も提供され、選択したデータがその特定のデータ型に対してどのように表示されるかを示します。また、この列ごとのプレビューはデータ型のサイズを決定する場合にも利用できます。

DDF Builder では、既存のテーブル定義で問題を検出して変更するときは自動的に定義エラー ビューが開きます。このウィンドウを閉じた場合、再度このウィンドウを開けば変更を見直すことができます。

DDF Builder のメニュー バーで［ウィンドウ］>［定義エラーの表示］を選択します。エラーがなければ、このコマンドは淡色表示になります。

定義エラー ビューに挙げられているエラーは DDF Builder で解決される問題に関する具体的な情報を示しています。元のテーブル定義も読み取り専用モードで元の定義ペインに提供されます。これらのペインは比較しやすいように並べて開くことができます。

次の表では、DDF Builder が既存の定義で検出する可能性のあるテーブル定義エラーを示します。発生したエラーの一般的な説明と、それを受けて DDF Builder がどのようにテーブル定義を修正するかについても示します。

DDF Builder が問題を検出して既存のテーブル定義を変更する場合、変更を保存するまでは元のテーブル定義が保持されます。ユーザーが既存のテーブル定義に変更を加える場合も、その変更を保存するまでは元の定義が保持されます。元のテーブル定義は、元の定義ビューを開いて見ることができます。

DDF Builder のメニュー バーで［ウィンドウ］>［元の定義の表示］を選択します。変更がなければ、このメニュー コマンドは淡色表示になります。

元のテーブル定義は読み取り専用モードでこのビューに提供されます。このビューは、更新されたテーブル定義と比較しやすいよう移動することができます。

変更した定義または元の定義のどちらかを別名で保存すれば、元のテーブル定義をずっと保持することができます。これを行うには、［ファイル］>［別名保管］をクリックして別の名前を入力します。

このセクションでは、DDF Builder で実行する作業について説明します。作業は以下のカテゴリに分かれています。

一般的な作業は、このツールの全体的な使用に適用されます。

DDF Builder の起動 を参照

［ヘルプ］>［PSQL ドキュメント ライブラリ］を選択することもできます。DDF Builder と PSQL Control Center（PCC）は同じコンポーネント（SQL Editor など）を共有しているので、DDF Builder 内で開くオンライン ヘルプであっても PSQL の他の機能に関する情報が表示されることもあります。

DDF Builder における作業の多くは、データ ソース エクスプローラー内にあるノードに関連付けられているコマンドを選択することによって実行します。コマンドによってエディター、ビューまたはウィザードが起動します。次に示す表では、希望するアクションを実行するための手順を説明します。この表は、関連する分野ごとにまとめられています。