以下のトピックでは DDF Builder を使用するための学習資料を提供します。

この章では、DDF Builder を使用した 2 つのチュートリアルを提供します。各チュートリアルでは、データの構造に関する基本的な情報、ファイルを使用したサンプル シナリオ、チュートリアルの目的、および各演習の目的を達成するために必要となる一般的な手順を提供します。

最初のチュートリアルでは、Btrieve ファイルはあるが、リレーショナル アクセスを可能にするために必要なテーブル定義がないという状況を解決します。Btrieve ファイル用の DDF がないため、まずは DDF を作成しなければいけません。このチュートリアルでは、空の DDF を使用してデータベースを新規作成し、Btrieve ファイル用のテーブル定義をその DDF に追加する手順を示します。

また、このチュートリアルの実行を通して、DDF Builder インターフェイスで作業するための基本的な知識も提供します。このチュートリアルで初めて DDF Builder を使用する場合は、第 2 章 DDF Builder の使用をもう一度読んで、インターフェイスやコンポーネントが置かれている場所についてよく理解しておくとよいでしょう。

2 番目のチュートリアルでは、既存のテーブル定義に古い定義あるいは不正な定義情報が含まれているため、そのテーブル定義を修正するという少し複雑な状況を解決します。このチュートリアルでは、既存のテーブル定義を見直して Btrieve ファイルのセットに関連付けられている DDF に対して必要な変更を行う手順を示します。

この 2 番目のチュートリアルはさまざまなレッスンで構成されています。各レッスンでは DDF Builder を使用して DDF を変更しようとする場合に発生する可能性がある問題に焦点を当てています。DDF Builder で自動的に解決される問題もありますが、手動で変更を行う必要がある問題もあります。

チュートリアルを開始する前に行うことがいくつかあります。このセクションでは、本章のチュートリアルを開始する前に行っておく必要がある事項を確認します。

DDF Builder でテーブル定義を作成したり変更することによって、データベースの構造が変更されます。用心のために、作業対象のファイルを必ずバックアップしておいてください。この作業対象ファイルにはデータ ファイルと既存の辞書ファイルの両方が含まれます。

DDF Builder では Btrieve ファイルを開きますが、DDF への変更を行うだけで既存の Btrieve ファイルへの変更は行いません。しかし、すべてのファイルをバックアップしておくことや、コピーしたファイルで作業することをお勧めします。DDF の部分的な変更によって既存のテーブル定義が破損してしまい、作業中の定義が壊れて使用できなくなることもあります。

データ ファイルをバックアップするか、作業対象ファイルのコピーを作成したら、チュートリアルで使用されるファイルの所在を確認する準備が整います。

DDF Builder のインストール時には、この章に含まれているチュートリアルを使用するためのフォルダーやファイルがシステム上に作成されます。このチュートリアル ファイルはデフォルトの Application Data ディレクトリで以下の場所にインストールされます。

DDF Builder 内でチュートリアルのデータベースにアクセスするには、各データベースに対して関連付けられたデータ ソース名（DSN）が作成されていること確かめておく必要があります。

チュートリアル 1 では、データベースを作成する時点で DSN を作成します。チュートリアル 1 は Btrieve ファイルしかない状態から始めるため、データベースも、DDF、DSN もすべて 1 から作成する必要があります。

チュートルアル 2 では、DDF Builder インターフェイス内でファイルとフォルダーを見るために 2 つの DSN を作成する必要があります。一方の DSN はチュートリアル 2 のデータベースを指し、もう一方の DSN は Tutorial2 フォルダーにある V3 データベースを指します。

次の表では ODBC データ ソース アドミニストレーターで Tutorial 2 および V3 データベースの DSN を作成するためのオプションを示します。

ファイルをバックアップし、チュートリアルのファイルの所在を確認し、DSN を作成したら、チュートリアル 1 を開始する準備が整いました。

このチュートリアルでは、Btrieve データ ファイルがあり、そのレポートを作成するために ODBC アクセスを提供する必要があります。

これを行うには、その Btrieve ファイル用のテーブル定義を作成する必要があります。テーブル定義はデータベースの DDF ファイルに格納されます。ご存知のとおり、この Btrieve ファイル用のテーブル定義はないので最初から作成します。

このチュートリアルの目的は、テーブル定義のない Btrieve ファイルへリレーショナル アクセスを提供するために必要な手順を実践することです。このチュートリアルの目的を達成するためには、DDF Builder を使用して以下の作業を実行します。

DDF Builder でテーブル定義の作成や変更作業を行うときは、そのデータの構造についてある程度の知識が必要です。このレコード長やインデックス情報などいくつかの情報は Btrieve ファイル自身に保存されます。しかし、列情報は Btrieve ファイルに保存されません。この列情報はソフトウェア ベンダーやアプリケーション開発者から提供される場合もあります。データを入念に調べてテーブル定義の作成や変更を試みることもできますが、データの構造について十分な知識を持っていない場合はこのユーティリティを使用しないようにしてください。

このチュートリアルの場合、データの構造はわかっています。このファイルの構造を見てみましょう。

CREATE_NEW.MKD という名前の Btrieve データ ファイルがあります。このファイルのレコード長は 110 バイトで 6 個のフィールドがあります。このフィールドは次のように定義されています。

このファイルには、ID フィールドに設定された重複のないキー（一意のインデックス）があり、そのインデックスには indx_id という名前が付けられています。

データ構造について理解できたら、作業を開始することができます。DDF Builder を使用して空のデータベースを作成することから始めます。これは Btrieve ファイル用に定義する空の DDF のセットを提供します。

既存の Btrieve ファイル用に DDF を作成する前に、まずはデータベースを作成する必要があります。DDF Builder をまだ実行していない場合は起動します。「DDF Builder の起動」を参照してください。

新しいデータベースを作成するための［データベースの新規作成］ダイアログ ボックスが開きます。

［データベースの新規作成］ダイアログは次のようになります。

データベースが作成されると、データ ソース エクスプローラーのデータベース ツリーにそのデータベースが新しいノードとして現れます。

このデータベース ノードには、［データ パス］、［SQL テーブル］および［システム オブジェクト］フォルダーがあります。［データ パス］フォルダーには Btrieve ファイルの場所が含まれています。［SQL テーブル］フォルダーにはデータベースのリレーショナル テーブルが含まれ（この時点ではありません）、［システム オブジェクト］フォルダーはシステム辞書テーブル用および、この場合は空のデータ辞書ファイル用のフォルダーになります。

これらの要素を使用して Zen データベースを作成することが、Btrieve ファイル用のテーブル定義を作成する最初の手順です。先程作成されたデータベースには辞書ファイル（DDF）がありますが、現時点でこれらのファイルには DDF 自身の構造用の定義しか含まれていません。DDF Builder で Btrieve ファイルを開いたら、このデータベース用に作成された DDF へテーブル定義を追加し、その Btrieve ファイルのデータにアクセスできるようにします。

このデータベースには SQL テーブルが含まれていないので注意してください。含まれているのはこのチュートリアルで使用する CREATE_NEW.MKD Btrieve ファイルのみです。これは定義済みのユーザー テーブルがないからです。データ ファイルとは別に、空の DDF が［システム オブジェクト］フォルダーに置かれています。テーブル定義を作成すると、そのテーブル定義に一致する SQL テーブルも作成されます。この SQL テーブルはテーブル定義にアクセスします。引き続き、DDF Builder で Btrieve ファイルを開く作業に進みます。

Btrieve ファイルと同じ場所に DDF ファイルを作成したら、DDF Builder でそのファイルを開いてデータ構造がどのように解読されるかを見ます。

データ ソース エクスプローラーはデータ パスの一覧を表示して、mkd ファイルがインストールされたディレクトリを示します。これはデータベースを作成した場所と同じディレクトリです。データ ソース エクスプローラーで TUTORIAL1 データベース ディレクトリの構造は次のようになります。

テーブル定義を作成する場合、DDF Builder では新しいテーブル名とこのテーブル定義のセットを関連付けるための［テーブル定義の新規作成］ダイアログを表示します。このテーブルはトランザクショナル ファイルに対応するリレーショナル テーブルと考えてください。テーブル定義の作成が終了すると、SQL テーブルは元の Btrieve ファイルと同じ構造を正確に反映しているはずです。

テーブルの名前を指定して［OK］をクリックすると、DDF Builder では Btrieve ファイルを開くことができるようにするために、そのファイルの分析を開始します。DDF Builder ではファイル内に認識できるキーやインデックスがあるかを判断し、その結果をテーブル定義エディター内に表示します。テーブル定義エディターの表示は次のようになります。

ファイルを開くことができたら、DDF Builder の調査結果をより詳しく見ていきます。

DDF Builder ではファイルの一般的な統計情報と既知のキーまたはインデックスを基にデータを分析します。DDF Builder による分析では、このファイルのレコードの先頭 4 バイトはキーであり、そのキーは Btrieve データ型で Integer であることを検出しています。このキーはテーブル定義エディターの先頭列でキー アイコンとして示されています。

レコード内のキー以外の残りの部分は DDF Builder で解読できないため 1 つのグループにまとめられ、テーブル定義エディターで疑問符アイコンとして示し Btrieve 型には不明（Unknown）が割り当てられます。

Btrieve ファイル用のテーブル定義を作成するにあたり、DDF Builder で検出された不明なフィールドを必要に応じてさまざまなフィールドへ分割するという作業が生じます。このまま先に進めば、各フィールドを詳細に定義します。

レコード フィールドの定義を始める前に、テーブル定義エディターでヌルがどのように扱われるかを理解しておいてください。

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

サイズが 50 バイトでヌル値を許可するフィールドを作成するとします。ヌル インジケーター バイトを確保するためにはフィールドのサイズを 51 バイトとして選択します。フィールドにヌル値を許可すると、そのサイズは自動的に 50 バイトに削減されます。

この情報はレコードのフィールドを定義する際に役立ちます。

既にご覧になったように、Btrieve ファイルを開くと DDF Builder では 4 バイトのインデックスとそれ以外を 106 バイトの不明なフィールドと判断します。不明なフィールドをレコード フィールドに定義します。

DDF Builder は先頭フィールドのほとんどの属性を判断しましたが、フィールド名は判断できませんでした。このため、まずは先頭フィールドに名前を付けてください。

これで不明なデータを解析して定義する準備ができました。

次のフィールドはヌル値を許可するよう定義します。次の手順では未加工データ ビューでデータを選択し、そのデータからヌル値を許可する列を作成する方法について説明します。

Btrieve 型を設定してそのフィールドが定義されると、それ以降、グリッド データ ビューには不明なフィールド インジケーターが表示されなくなるので注意してください。

引き続き、グリッド データ ビュー内で不明な行を複数の列に分割して、ファイル内の不明なフィールドを定義します。

列を分割する場合、分割される 2 つの列のサイズはそれぞれ同等か、ほぼ同等になるようにします。これは、85 バイトの列を 2 つの列に分割した場合、一方の列は 42 バイトでもう一方の列は 43 バイトになるということです。

サイズを 42 から 20 に変更すると、DDF Builder では "フィールド3" 行に余分の 22 バイトを追加します。

SQL プレビュー列には定義されたデータが表示されていることがわかります。ここでは、テーブル定義に基づき DDF Builder がデータがどのように解釈したかをプレビューしています。

フィールド3 を定義します。このフィールドにはヌル値を許可します。

テーブル定義は次のようになります。

サイズを 4 に変更すると、DDF Builder では残りのバイト数を次のフィールドに含めます。

この時点で、60 バイトの不明なフィールドが残っています。データ構造ではさらに 2 つのフィールドの定義が必要であることを示しています。未加工データ ビューを使用して、その列を作成します。

ヌル値を許可しない列を作成しましたが、本当に必要なのはヌル値を許可する列です。グリッド データ ビューを使用して、この列をヌル値を許可する列に変更します。

［ヌル］チェックボックスをチェックすると、ヌル バイト インジケーターを確保するのでサイズが 50 バイトに減少します。

テーブル定義は次のようになります。

最後に、ファイルの最後のフィールドを定義します。

最初に［ヌル］チェックボックスを選択することによって、サイズは自動的に修正されます。最初にサイズを 8 に変更すると、DDF Builder では最後に残った 1 バイトから不明な列を新たに作成してしまいます。

これで、ファイルのフィールドに対する定義が終了しました。テーブル定義は次のようになります。

作業を進める前に、テーブル定義を保存しておいてください。

これで DDF にテーブル定義を作成することができました。作業を保存すると、データ ソース エクスプローラーで［SQL テーブル］ノードの下にその SQL テーブルが作成されます。

テーブル定義を作成したので、インデックスを見てみましょう。

DDF Builder がファイルで検出したインデックスを見てみましょう。

DDF Builder ではファイルに作成されているインデックスを検出することができますが、Btrieve はインデックス名を使用しないため、DDF Builder でインデックスに関連付ける名前はありません。

［インデックス］ページは主に読み取り専用ですが、インデックス名については変更可能です。

DDF Builder でインデックスに対して行うことができるのはこれだけです。

テーブル定義を終えたらそのデータを必ずプレビューするようにしてください。

次に、作成したテーブル定義用のファイルにあるデータを再度確認します。

おめでとうございます。これでチュートリアル 1 は完了し、リレーショナル アクセスを使用して Btrieve ファイルのデータにアクセスできる DDF のセットを持つことができました。

古い DDF または不正な DDF を処理する場合にはさまざまなシナリオが発生するので、このチュートリアルではそれぞれのシナリオについて余すところなく取り上げています。そのため、このチュートリアルはさまざまなレッスンで構成され、Btrieve ファイルや既存のテーブル定義で作業するときに発生する可能性のある特定の状況をレッスンごとに詳しく述べています。各レッスンは、混乱を招かないよう 1 つの問題に専念して解決できるよう設計されています。

このチュートリアルは、処理しやすい単位で分割した課題をレッスンごとに取り組むことができるよう整理されています。また、このチュートリアルはトラブルシューティング調査として参照し、発生する可能性がある状況を見つけるということにも利用できます。レッスンの一覧から、探している状況について取り上げているレッスンに進み、有効な解決策を調べることができます。

使用可能な DDF を持つ Btrieve データ ファイルの一群があります。しかし、その DDF のテーブル定義は古いもので変更する必要があります。これはベンダーから古いファイルを受け取った、あるいはアプリケーションが変更されても DDF が適切に更新されていなかったという状況が考えられます。

このチュートリアルの目的は、すべての Btrieve ファイルと既存のテーブル定義を開くことです。DDF Builder の調査結果を検証して必要であれば変更を行い、DDF Builder でそのテーブル定義を保存します。このテーブル定義はデータベース スキーマをミラー化するので、Btrieve ファイルのデータを厳密に表示できます。

このチュートリアルの各レッスン内容は次のとおりです。

このレッスンでは、既存のテーブル定義セットを持つ 1 つのデータベースがあります。このテーブル定義はかなり古いバージョンの Zen で作成されたもので、今回リリースされた DDF Builder でサポートされる Pervasive.SQL 2000 とはもう互換性がありません。

このレッスンの目的は、DDF Builder でその DDF を開くことです。このチュートリアルでは、DDF Builder でこれらのファイルがどのように処理されるかを説明し、またそのファイルを DDF Builder と互換性を持つファイルへ変換できるようにする解決策を提供します。

このレッスンで使用するファイルは V3 という名前のフォルダーにあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

作業を続ける前に、このデータベース用の DSN を作成する必要があります。

DDF Builder をまだ実行していない場合は起動します。

本来、これらのファイルは、現在ではサポートされていないバージョンの製品で作成されているため開くことができません。

DDF Builder では Scalable SQL v3.00 のデータ辞書ファイルを開くことができません。これはその時点（Scalable SQL 3.01）で使用されていたフォーマットが現在サポートされていないからです。

古い DDF がある場合はそれらを新しいフォーマットに変換する必要があります。以下の手順を使用します。

上記の手順は、シンプルなデータ ファイルに対する最も基本的な作業です。まずはこの手順を試して変換の結果を調べてください。

以下の 2 つの状況がある場合は、さらに作業が必要です。

テーブルの列がオルタネート コレーティング シーケンス（ACS）を使用する場合、CREATE TABLE ステートメントを手動で変更する必要があります。ZenCC ではテーブル スキーマをエクスポートするときに ACS を含めません。

列が ACS を使用しているかどうかを調べるには、DDF Builder でテーブルの一貫性を確認します（テーブルの一貫性のチェックを参照）。属性と物理キーファイル セグメントが一致しないというメッセージが通知された場合、その列は ACS を使用しています。

次の例は変更済みの CREATE TABLE ステートメントで、コレーティングが手動で追加されています。

また、インデックスの順序がテーブルに対して正しくない場合は、CREATE INDEX ステートメントを並び替えて正しい順序でインデックス セグメントを置く必要があります。

テーブル定義によっては、解決が困難なため ZenCC と DDF Builder の両方を使用する必要がある場合もあります。列が DDF Builder で "不明" と示された場合は、ZenCC の Table Editor でその列が含まれるテーブルを表示し、DDF Builder 側でその列を同様に定義する必要があります。両方のユーティリティを用いて作業することにより、テーブル定義を完了させることができます。

このレッスンでは、DDF Builder で Scalable SQL v3.01 の DDF がどのように処理されるかをご紹介し、またそれら DDF を本ソフトウェアの現行バージョンで作業できるように変換するための解決策も提供しました。

また、Scalable SQL v3.01 の DDF で作成されたデータベースには、v6.x より前のファイル形式の Btrieve データ ファイルが含まれている可能性があるので、それらのファイルも DDF Builder を使用する前にリビルドしておく必要があることも学習しました。

このレッスンでは、既存のテーブル定義セットを持つ Btrieve ファイルがあります。この Btrieve ファイルは v6.x より前のファイル形式で、本リリースの DDF Builder でサポートされている Zen とはもう互換性がありません。

このレッスンの目的は、DDF Builder でそのファイルを開くことです。ここでは、DDF Builder で v6.x より前のファイル形式と v6.x 以上のファイル形式がどのように処理されるかを説明します。また、v6.x より前の Btrieve ファイルを DDF Builder に対応させるための解決策も提供します。

このレッスンで使用するファイル、および残りのレッスンで使用するファイルは Tutorial2 というフォルダーにあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

作業を続ける前に、このデータベース用の DSN を作成する必要があります。

このレッスンで作業対象となるファイルは KO.BTR と KO.MKD です。

DDF Builder をまだ実行していない場合は起動します。

フォルダー内にあるいくつかのファイルが v6.x より前の形式であったため、全ファイルを開くことができませんでした。

DDF Builder ではバージョン 5.x 以下の形式のファイルが完全にサポートされなくなったので、そのファイルは開くことができません。v6.x より前の形式のファイルを使用するには、そのファイルをバージョン 6.x 以上のファイル形式にリビルドする必要があります。

バージョン 5.x 以下のファイルをリビルドする前にログ ファイルを確認し、リビルドする必要があるファイルを特定してください。

リビルドする必要があるファイルは DDF Builder ログ ファイルに記録されています。

ログ ファイルは、ご使用のシステムでデフォルト設定されているテキスト エディターに表示されます。次の画面は、このレッスン用のログ ファイルのサンプルです。

ログ ファイルには v6.x より前の形式のファイルがリストアップされ、そのファイルの完全なデータ パスも記録されています。このデータ パスを使用して、リビルドが必要なファイルの場所を見つけることができます。

Zen Rebuild ユーティリティを使用して、ファイルをバージョン 6.x 以上にリビルドします。Rebuild ユーティリティは Zen における中心的なユーティリティの 1 つとしてインストールされるもので、Zen Control Center の［ツール］メニューから使用することができます。

Rebuild ユーティリティは Zen Control Center から使用できます。このユーティリティの使用法については、『Advanced Operations Guide』の「データ ファイルの変換」の章を参照してください。

このレッスンでは、DDF Builder で 6.x より前のファイル形式がどのように処理されるかをご紹介し、またそれらを DDF Builder で作業できるようにリビルドするための解決策も提供しました。

このレッスンでは、不正なデータ型とサイズを持つ Btrieve ファイルがあります。この結果、データは理解できるような書式に設定されません。

このレッスンの目的は、DDF Builder で Btrieve ファイルの既存のテーブル定義を開くことです。Btrieve 型ビューですべてのデータ型とサイズを調べて必要な変更を行い、フィールドのサイズに対して的確なデータ型でデータが書式設定されるようにします。

このレッスンでは、TYPE_SIZE.MKD というファイルを使用します。このファイルは Tutorial2 フォルダー内にあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

このフォルダーは Tutorial2 データベースの一部です。

Btrieve ファイルを開く

すぐ前のレッスンから引き続き作業していれば DDF Builder は起動しているはずです。終了していた場合は、DDF Builder を起動してください。

テーブル定義エディターでは、次のメッセージが表示されます。

このメッセージは、DDF Builder で既存のテーブル定義を分析したら、その定義に問題があったということを知らせています。この結果、DDF Builder で既存のテーブル定義を開いて表示するために、いくつか修正を行う必要がありました。

まずは DDF Builder インターフェイスで処理対象の不一致を確認します。特に、グリッド データ ビューと定義エラー ビューを見てください。

テーブル定義エディターのグリッド データ ビューでは、既存のテーブル定義に対して DDF Builder が行った変更を反映したテーブル定義が表示されています。

この例で、DDF Builder は新たに作成したフィールドや、DDF Builder がデータ型を「不明」に変更したフィールドに対して不明な列インジケーターを追加することにより、注目すべき列を視覚的に示しています。

定義エラー ビューでは DDF Builder によって検出および変更された問題を表示します。

DDF Builder によって変更が行われる前の元のテーブル定義は、元の定義ビューで見ることができます。

定義エラー ビューでは以下のことを通知します。

定義エラーでは次の 3 つの問題を挙げています。

1 番目のエラーは、元のテーブル定義では定義されていないバイト群がファイルに含まれていることを示しています。DDF Builder はこれら未定義のバイトを新しい列として作成し、その列に "フィールド6" という名前を付けました。

また、このファイルには列のデータ型がその列のサイズに対して不正な 2 つのフィールド（Age と dob）があります。どちらも、フィールドの型が "Unknown"（不明）に変更されています。Age 列について詳しく見る前に、まず DDF Builder で判断できることとできないことを確認します。

DDF Builder では、指定したデータ型に対して有効なサイズを確かめることはできませんが、指定したサイズに対して有効なデータ型を検証することはできます。DDF Builder では問題を検出して一般的な変更を行い、その変更を記録することはできますが、選択されたデータ型が正しいかどうかを判断することはできません。

DDF Builder ではフィールドのサイズに応じて選択できるデータ型が制限されます。たとえば Age 列の不正なデータ型とサイズについて見てみると、サイズが 4 バイトになっています。グリッド データ ビューの［Btrieve 型］リストには、4 バイトのサイズに対して適用可能なデータ型のみが設定されます。DDF Builder で選択可能なデータ型を 1 つずつ試してみるのではなく、Btrieve 型ビューや［プレビュー］ページでそのデータを見て適切なデータ型を判断してください。

次に、4 バイトのサイズに対して適用可能なデータ型を調べ、ファイルのデータをプレビューしてどのデータ型が最も適しているかを見ます。

フィールド サイズに対して有効なデータ型で書式設定されたデータを見るには、テーブル定義エディターの左側にある［Btrieve 型］タブの Btrieve 型ビューを使用します。

Integer および Unsigned Binary データ型はいずれもデータを適切に受け入れて理解できるように書式設定します。また、どちらのデータ型も 1、2、4 および 8 バイトをサポートします。このため、どちらかのデータ型を選択するための決定的な理由はないように思われます。この例は、テーブル定義を作成または変更する場合には、データの基本的な構造を知っておく必要があることを端的に示しています。

有効なデータ型と書式設定されたデータを再検討し、Age 列には Integer データ型を選択することにします。

これで 1 番目のテーブル定義エラーが解決されました。しかし、ほかのエラーを解決するまではテーブル定義を保存することができません。

次のエラー対象の 2 つのフィールドは並んでいるので集合的に見ることができます。残りの 2 つのテーブル定義エラーを解決するには、これらを単一のエラーとして考える必要があります。

まず、dob フィールドに定義されていたデータ型（Date）は 2 バイトの列サイズに対して有効ではない、という点に DDF Builder が注目したことがわかります。その結果、DDF Builder はこのデータ型を "Unknown"（不明）に変更しました。

次に、元のテーブル定義では定義されていない 2 バイトがあります。DDF Builder はこれらの 2 バイトから新しい列（フィールド6）を作成し、"Unknown" データ型を割り当てました。

dob フィールドの用途に適したデータ型は Date ですが、この Date データ型は 4 バイトのフィールドが必要です。"dob" 列" と "フィールド6" 列をマージすれば、Date データ型に適合する 4 バイトのフィールドを作成できます。2 つの列をマージして Date データ型を使用した場合、1 番目のエラーでも行ったように、そのデータが適切に受け入れられ理解できるような書式になっているかどうかを検証する必要があります。

この情報の入力後に残りの列フィールドを見てみると、Date データ型を追加したことによってレコードのデータが適切に書式設定されることがわかります。

［プレビュー］ページで、Date データ型で書式設定されたデータがどのように処理されるかを確認することをお勧めします。

［プレビュー］ページの dob 列を見て、全データが適切に受け入れられ理解できる書式で設定されていることを確認できます。

これでテーブル定義が完了したので、この作業を保存して変更を有効にしてください。作業を保存する前に、もう一度テーブル定義を見直してください。データ グリッド ビューは次のようになります。

Btrieve 型がすべて定義されていること、未定義のフィールドが残っていないこと、またすべてのバイトが明確に割り当てられていることが一目でわかります。これでテーブル定義を保存できます。

このレッスンでは、データ型とサイズが適合しない場合に DDF Builder でどのように処理されるかをご紹介しました。不正なデータ型やサイズが既存のテーブル定義内でどのように表示されるかを示し、サイズとデータ型が適合して情報が適切に正しく表示できるようテーブル定義を変更するための解決例をいくつか提供しました。

このレッスンでは、既存のテーブル定義があり、ファイル内で同じバイトを共有する 2 つの列定義が含まれています。これは重複する列定義を作成することになるので修正が必要です。

このレッスンの目的は、DDF Builder でファイルを開き、DDF Builder によってこの定義になんらかの変更が行われるかどうかを確認することです。DDF Builder が実施する変更を調べ、重複している列定義を修正するために必要となる変更について検討します。

このレッスンでは、OVERLAP.MKD というファイルを使用します。このファイルは Tutorial2 フォルダー内にあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

このフォルダーは Tutorial2 データベースの一部です。

すぐ前のレッスンから引き続き作業していれば DDF Builder は起動しているはずです。終了していた場合は、DDF Builder を起動してください。

テーブル定義エディターでは、次のメッセージが表示されます。

このメッセージは、DDF Builder で既存のテーブル定義を分析したら、その定義に問題があったということを知らせています。この結果、DDF Builder で既存のテーブル定義を開いて表示するために、いくつか修正を行う必要がありました。

まずは DDF Builder インターフェイスで、元の定義と DDF Builder による変更後の定義との違いを確認し、報告されたエラーについても再調査します。

テーブル定義エディターのグリッド データ ビューでは、既存のテーブル定義に対して DDF Builder が行った変更を反映したテーブル定義が表示されます。

変更または追加されたフィールドであること示す不明アイコンやその他の視覚的なインジケーターはありません。

定義エラー ビューでは DDF Builder によって検出および変更された問題を表示します。

DDF Builder によって変更が行われる前の元のテーブル定義は、元の定義ビューでいつでも見ることができます。

元の定義と変更後の定義はすぐに比較できますが、最初は DDF Builder によって報告されるエラーを見てください。

定義エラー ビューでは以下のことを通知します。

定義エラー ビューでは次の 1 つの問題が挙げられています。この問題について詳しく見てみましょう。

DDF Builder によって報告されたエラーは列定義の重複です、これは、テーブル定義に同じバイトを共有する 2 つの列の定義が含まれていることを意味します。

DDF Builder では、firstName 列が次の列と重ならないようにするために、この列のサイズを自動的に削減します。これで列の長さが一致し、複数の列にわたって定義されているバイトがなくなります。

グリッド データ ビューと元の定義を見比べると、重複している列を確認することができます。

変更後の定義で firstName フィールドのサイズが 20 であるのに対し、元の定義ではサイズが 30 になっていることに注目してください。元の定義では、［プレビュー］列にファースト ネームの "Joe" とラスト ネームの "Smith" の両方が表示されています。変更後の定義ではこのフィールドのサイズが小さくなり、［プレビュー］列にはファースト ネームのみが適切に表示されています。

元の定義と DDF Builder によって変更された定義を比較し、それに加えてデータがどのように書式設定されたかを検証することは、DDF Builder によって行われた変更を受け付けるかどうかを判断するのに役立ちます。

DDF Builder が行った変更の結果、データが期待どおりの書式で表示され、列の長さも一致することが確認できます。

両ファイルの違いを調べ、DDF Builder による変更を理解し、データが適切であることを検証できたら、いつでもその変更を受け入れることができます。

テーブル定義の変更を行ったのが、ユーザーであろうと DDF Builder であろうと、その変更を有効にするためにはそれを保存する必要があります。テーブル定義を保存する前に、もう一度テーブル定義と［プレビュー］タブを見て、すべてのフィールドが定義済みで各バイトが明確にされていることを確認すると良いでしょう。

すべての Btrieve 型が定義済みで、レコード内のすべてのバイトが明確に割り当てられていることがわかります。これでテーブル定義を保存できます。

これで、列定義の重複を修正するために DDF Builder が変更したテーブル定義は、現在の定義として保存できました。

このレッスンでは、列定義の重複が DDF Builder でどのように処理されるか、また列の重複を解決するために DDF Builder が実施する変更についてご紹介しました。DDF Builder によって変更された定義と元の定義を比較して、その変更を受け入れるか、あるいは拒否するかを判断する方法も示しました。

このレッスンでは、テーブル定義で設定されている SQL 列フラグと一致しないフラグ設定のフィールドを持つ Btrieve ファイルがあります。

このレッスンの目的は、DDF Builder でファイルを開き、DDF Builder によってこの定義になんらかの変更が行われるかどうかを確認することです。DDF Builder が実施する変更を調べ、フラグの不一致を修正するために必要な変更があればその変更について検討します。

このレッスンでは、FLAGS.MKD というファイルを使用します。このファイルは Tutorial2 フォルダー内にあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

このフォルダーは Tutorial2 データベースの一部です。

すぐ前のレッスンから引き続き作業していれば DDF Builder は起動しているはずです。終了していた場合は、DDF Builder を起動してください。

テーブル定義エディターでは、次のメッセージが表示されます。

このメッセージは、DDF Builder で既存のテーブル定義を分析したら、その定義に問題があったということを知らせています。この結果、DDF Builder で既存のテーブル定義を開いて表示するために、いくつか修正を行う必要がありました。

まずは DDF Builder インターフェイスで処理対象の不一致を確認します。まずは、グリッド データ ビューと定義エラー ビューを見てください。

テーブル定義エディターのグリッド データ ビューでは、既存のテーブル定義に対して DDF Builder が行った変更を反映したテーブル定義が表示されています。

このレッスンの場合、DDF Builder は注目すべき列について視覚的なインジケーターを何も示しません。フィールドが変更されていることを示す不明な列インジケーターはありません。

定義エラー ビューでは DDF Builder によって検出および変更された問題を表示します。

ここで、元のテーブル定義を見てみましょう。DDF Builder によって変更が行われる前の元のテーブル定義は、元の定義ビューで見ることができます。

テーブル定義の不一致の詳しい説明に進む前に、DDF Builder によって報告された定義エラーを理解しておいてください。

定義エラー ビューでは以下のことを通知します。

定義エラーでは次の 1 つの問題を挙げています。

このエラーは、SQL 列に対して大小文字無視フラグが設定されているが、対応する Btreive セグメントにはこのフラグが設定されていないことを示しています。DDF Builder は Btrieve ファイルを変更しないので、SQL テーブルは Btrieve ファイルの仕様に一致するよう変更されます。この状況を確かめるには、現在のテーブル定義を元の定義と比較します。

定義エラーでは lastName 列の大小文字無視の設定に問題があることを示しています。現在のテーブル定義と元のテーブル定義の lastName フィールドを比較すると、この違いがすぐにわかります。

この比較によって、以下のことが判断できます。

DDF Builder は Btrieve ファイルに基づいて変更を行います。DDF Builder では Btrieve ファイルを変更できません。変更できるのは Btrieve ファイルの構造を決定するテーブル定義のみであることを覚えておいてください。そのような訳で、DDF Builder は（大小文字無視フラグのない）元の定義を変更して、lastName フィールドで大小文字無視フラグを利用できるようにしました。

定義エラーの原因を究明し、DDF Builder が行った変更について理解しました。ここで、DDF Builder がテーブル定義に対して行った変更を受け入れるか、または拒否する必要があります。

DDF Builder が行った変更が正しくなければ、その変更を拒否して最初からテーブル定義を作成し直してください。これは、インデックスとして指定されているフィールドの大小文字無視の設定は変更できないためです。

ただし、このレッスンの目的は DDF Builder が行った変更を受け入れることです。lastName フィールドには大小文字無視フラグを設定します。

テーブル定義エラーと変更について確認できたら、この作業を保存して変更を有効にしてください。作業を保存する前に、もう一度テーブル定義を見直してください。データ グリッド ビューは次のようになります。

Btrieve 型がすべて定義されていること、未定義のフィールドが残っていないこと、またすべてのバイトが明確に割り当てられていることが一目でわかります。これでテーブル定義を保存できます。

このレッスンでは、Btrieve ファイルと既存のテーブル定義でフラグ設定が異なる場合に DDF Builder でどのように処理されるかをご紹介しました。DDF Builder によって行われた変更を、グリッド データ ビューと元の定義ビューを使用して比較できることも示しました。また、DDF Builder ではインデックスとして設定されているフィールドに対する変更が行えないことも示しました。DDF Builder によって行われた変更を拒否する、または受け入れるための方針についても説明しました。

このレッスンでは、テーブル定義のインデックス設定と一致しないインデックス設定を持つ Btrieve ファイルがあります。

このレッスンの目的は、DDF Builder でファイルを開き、DDF Builder によってこの定義になんらかの変更が行われるかどうかを確認することです。DDF Builder が実施する変更を調べ、インデックスの不一致を修正するために必要な変更について検討します。

このレッスンでは、INDEX_INC.MKD というファイルを使用します。このファイルは Tutorial2 フォルダー内にあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

このフォルダーは Tutorial2 データベースの一部です。

すぐ前のレッスンから引き続き作業していれば DDF Builder は起動しているはずです。終了していた場合は、DDF Builder を起動してください。

テーブル定義エディターでは、次のメッセージが表示されます。

このメッセージは、DDF Builder で既存のテーブル定義を分析したら、その定義に問題があったということを知らせています。この結果、DDF Builder で既存のテーブル定義を開いて表示するために、いくつか修正を行う必要がありました。

まずは DDF Builder インターフェイスで検出された不一致を確認します。これは、グリッド データ ビューと元の定義を比較すればすぐにわかります。

このレッスンの場合、DDF Builder は注目すべき列について視覚的なインジケーターを何も示しません。フィールドが変更されていることを示す不明な列インジケーターはありません。

大変興味深いことに、これらの 2 つのテーブル定義を比較しても違いが見つかりません。DDF Builder では変更を行っていますが、DDF Builder が修正した問題はインデックスに関するものなので、テーブル定義上に表れません。

インデックス情報についてより詳しく見る前に、定義エラー ビューに挙げられている問題を調査しましょう。定義エラー ビューでは DDF Builder によって検出および変更された問題を表示します。

定義エラー ビューでは以下のことを通知します。

定義エラーでは次の 2 つの問題を挙げています。

1 番目のエラーは、Btrieve ファイルに存在しないインデックスが既存のテーブル定義に含まれていることを示します。DDF Builder はテーブル定義を変更するだけで Btrieve ファイル自体を変更することはできないため、このインデックスは無視されます。これは、存在しないインデックスを使用しないようにするためにも知っておくことが重要です。

2 番目のエラーはこの逆の状況です。既存のテーブル定義に、Btrieve ファイルで定義されているインデックスがありません。DDF Builder は Btrieve ファイルのインデックスを表すために、これまで定義されていなかった SQL インデックスを追加します。

DDF Builder が作成したインデックスに名前を割り当て、そのテーブル定義のインデックスに対する変更を受け入れます。

DDF Builder によってテーブル定義に追加されたインデックスを検証したので、この作業を保存して変更を有効にしてください。作業を保存する前に、もう一度テーブル定義を見直してください。

Btrieve 型はすべて定義され、不明なフィールドも無く、またすべてのバイトが明確に割り当てられています。これでテーブル定義を保存できます。

おめでとうございます。これでテーブル定義の保存が成功しました。このレッスンでは、DDF Builder が認識したインデックスの不一致についてご紹介しました。また、DDF Builder が行った変更と更新されたテーブル定義の保存方法についても説明しました。

このレッスンでは、テーブル定義で設定されている可変長レコードとは異なる可変長レコードを持つ Btrieve ファイルがあります。

このレッスンの目的は、DDF Builder でファイルを開き、DDF Builder によってこの定義になんらかの変更が行われるかどうかを確認することです。DDF Builder が実施する変更を調べ、可変長レコードの不一致を修正するために必要となる変更について検討します。

このレッスンでは、VARTABLE.MKD というファイルを使用します。このファイルは Tutorial2 フォルダー内にあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

このフォルダーは Tutorial2 データベースの一部です。

すぐ前のレッスンから引き続き作業していれば DDF Builder は起動しているはずです。終了していた場合は、DDF Builder を起動してください。

テーブル定義エディターでは、次のメッセージが表示されます。

このメッセージは、DDF Builder で既存のテーブル定義を分析したら、その定義に問題があったということを知らせています。この結果、DDF Builder で既存のテーブル定義を開いて表示するために、いくつか修正を行う必要がありました。

まずは DDF Builder インターフェイスで、元の定義と DDF Builder による変更後の定義との違いを確認し、報告されたエラーについても再調査します。

テーブル定義エディターのグリッド データ ビューでは、変更済みのテーブル定義が示されます。

DDF Builder では、変更または追加されたフィールドに対して不明な列インジケーターを追加し、注目すべき列であることを視覚的に示します。また、可変長列インジケーターが可変長の列に追加されます。

定義エラー ビューでは DDF Builder によって検出および変更された問題を表示します。

DDF Builder によって変更が行われる前の元のテーブル定義は、元の定義ビューで見ることができます。

定義エラー ビューでは以下のことを通知します。

定義エラーでは次の 2 つの問題を挙げています。

DDFBLDR-12 エラーは、テーブル定義の最後の列ではない可変長フィールドが原因で発生しています。このファイルにはレコードの最後の列以外の位置に可変長フィールドがあるため、DDF Builder ではこのフィールドのデータ型を "Unknown"（不明）に変更します。

可変長フィールドの問題を修正するには、不明なフィールドを適切なデータ型で定義します。これは次のセクションで説明します。

最後に報告されたエラーは、DDF Builder が既存のテーブル定義でインデックスを検出したが、それに対応するキーが Btrieve ファイルにはないという事象です。このレッスンの過程で、このエラーは解決されません。解決されるのは可変長フィールドについてだけです。インデックスに関するエラーを解決するためには、レッスン 6 – インデックスの不一致を参照してください。

テーブル定義エディターのグリッド データ ビューで、不明なフィールドを定義します。

不明なフィールドを定義し、すべての問題を修正したら、テーブル定義を保存できます。

作業を保存する前に、もう一度テーブル定義を見直してください。

テーブル定義に未定義のフィールドがなく、すべてのバイトが明確に割り当てられています。これでテーブル定義を保存できます。

おめでとうございます。テーブル定義が保存され、可変長フィールドの修正に成功しました。このレッスンでは、レコードの最後にない可変長フィールドを DDF Builder でどのように処理するかをご紹介しました。また、フィールドを定義する方法と、ファイルに対して有効なテーブル定義を作成する方法についても説明しました。

このレッスンでは、テーブル定義で設定されているレコード長とは異なるレコード長を持つ Btrieve ファイルがあります。

このレッスンの目的は、DDF Builder でファイルを開き、DDF Builder によってこの定義になんらかの変更が行われるかどうかを確認することです。DDF Builder が実施する変更を調べ、レコード長の不一致を修正するために必要な変更について検討します。

このレッスンでは、rec_length.mkd というファイルを使用します。このファイルは Tutorial2 フォルダー内にあります。デフォルトのインストール先にインストールしている場合、このフォルダーは次の場所にあります。

このフォルダーは Tutorial2 データベースの一部です。

すぐ前のレッスンから引き続き作業していれば DDF Builder は起動しているはずです。終了していた場合は、DDF Builder を起動してください。

テーブル定義エディターでは、次のメッセージが表示されます。

このメッセージは、DDF Builder で既存のテーブル定義を分析したら、その定義に問題があったということを知らせています。この結果、DDF Builder で既存のテーブル定義を開いて表示するために、いくつか修正を行う必要がありました。

まずは DDF Builder インターフェイスで、元の定義と DDF Builder による変更後の定義との違いを確認し、報告されたエラーについても再調査します。

テーブル定義エディターのグリッド データ ビューでは、変更済みのテーブル定義が示されます。

DDF Builder では、変更または追加されたフィールドに対して不明な列インジケーターを追加し、注目すべき列であることを視覚的に示します。

定義エラー ビューでは DDF Builder によって検出および変更された問題を表示します。

DDF Builder によって変更が行われる前の元のテーブル定義は、元の定義ビューで見ることができます。

定義エラー ビューでは以下のことを通知します。

定義エラーでは次の 1 つの問題を挙げています。

DDF Builder によって報告されたエラーは、レコード長の不一致を示しています。

これは、レコードのすべてのバイトに当たるフィールドがテーブル定義に含まれていなかったことを意味します。このようなバイトを明らかにするために、DDF Builder は新しい列を不明なデータ型として作成しました。

すべてのバイトを定義して明確に割り当て、Btrieve ファイルと正確に一致するテーブル定義を作成します。グリッド データ ビューの下部にある "フィールド6" の行を見てください。

レコード長が Btrieve ファイルとテーブル定義で一致するよう、不明なフィールドを定義することができます。

次に、テーブル定義エディターのグリッド データ ビューで、不明のフィールドを定義します。

テーブル定義は次のようになります。

テーブル定義は次のようになります。

これで不明なフィールドはすべて定義され、すべてのバイトは明確に割り当てられたので、テーブル定義を保存します。

行った変更を保存して適用できるようテーブル定義を保存します。

おめでとうございます。テーブル定義が保存され、レコード長の不一致が適切に修正されました。このレッスンでは、レコード長が異なる場合に DDF Builder でどのように処理されるかをご紹介しました。また、フィールドを定義する方法や、サイズを変更して列を分割したり、ファイルに対して有効なテーブル定義を作成する方法についても説明しました。