DDF Builder チュートリアル

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開して使用可能データベースをすべて表示します。

一覧から V3 データベースを見つけます。

V3 データベースアイコンをダブルクリックします。

次のメッセージが表示されます。

［OK］をクリックしてこのメッセージウィンドウを閉じます。

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

警告メッセージを理解する

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

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

ファイルを変換する方法

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

既存の古いデータベースをバックアップするため、データファイルと DDF を別の保存場所にコピーします。

Zen Control Center（ZenCC）を使用して古いデータベースの全テーブルのテーブルスキーマをエクスポートします。『Zen User's Guide』のデータベーススキーマをエクスポートするにはを参照してください。［"IN DICTIONARY" 句を CREATE ステートメントに追加する］エクスポートオプションを必ず選択しておいてください。

エクスポートファイルの CREATE INDEX ステートメントで、各テーブルのインデックスセグメントが正しい順序で置かれていることを確認してください。

テーブルのインデックスは元のデータファイルと同じ順序になっていなければなりません。エクスポートされるテーブルスキーマはインデックスをアルファベット順に置くので、このステートメントを並べ替える必要があるかもしれません。

インデックスの順序を調べるには、元のデータファイルに対して butil -stat コマンドを使用します。『Advanced Operations Guide』のデータファイル情報の表示を参照してください。また、dbo.fSQLStatistics カタログ関数を使用して調べることもできます。『SQL Engine Reference』の dbo.fSQLStatistics を参照してください。

一般的には、古いファイルを変換するので、次の行をエクスポートスキーマファイルの先頭行として追加する必要があります。

SET TRUENULLCREATE = OFF;

次の行を、ファイルの最終行として追加します。

SET TRUENULLCREATE = ON;

ZenCC で新しいデータベースを作成します。『Zen User's Guide』の新規データベースを作成するにはを参照してください。

ZenCC の SQL Editor で、エクスポートスキーマファイルの CREATE TABLE SQL ステートメントを新しいデータベースに対して実行し、すべてのテーブルを作成します。『Zen User's Guide』の SQL スクリプトを開くにはを参照してください。

古いデータベースから古い Zen データファイル（DDF 以外）を、新しいデータベースデータファイル用の保存場所にコピーします。

SQL を使用（ZenCC などを使用）して既存のデータにアクセスできるようになります。

DDF Builder を使用して、定義がなかった Btrieve ファイルに対しテーブル定義を作成し、また問題のある定義を修正します。変換に関する注意も参照してください。

必要であれば、データファイルをリビルドします（6.x 以前のファイル形式の場合に必要となる可能性があります）。Btrieve データファイルのリビルドの詳細については、次のセクションレッスン 2 － v6.x より前のファイル形式での作業に進んでください。

変換に関する注意

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

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

•

オルタネートコレーティングシーケンス

•

ZenCC および DDF Builder の使用を必要とするテーブル定義

オルタネートコレーティングシーケンス

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

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

次の例は変更済みの CREATE TABLE ステートメントで、照合順序が手動で追加されています。

SET TRUENULLCREATE = OFF;

CREATE TABLE "PATAPP" IN DICTIONARY USING 'PATAPP.DTA' (

"ID" CHAR(6) NOT NULL COLLATE 'UPPER.alt',

"Appointment Date" DATE NOT NULL,

"Appointment Time" TIME NOT NULL,

"AMPM" CHAR(4) NOT NULL COLLATE 'UPPER.alt',

"Doctor" CHAR(12) NOT NULL,

"Code" CHAR(3) NOT NULL COLLATE 'UPPER.alt',

"Amount Paid" MONEY(14,2) NOT NULL,

"Date Paid" DATE NOT NULL);

CREATE INDEX "index_0" IN DICTIONARY ON "PATAPP" (

"Appointment Date" ,

"AMPM" ,

"Appointment Time" );

CREATE INDEX "index_1" IN DICTIONARY ON "PATAPP" (

"ID" );

CREATE INDEX "index_2" IN DICTIONARY ON "PATAPP" (

"Code" );

SET TRUENULLCREATE = ON;

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

ZenCC および DDF Builder の使用を必要とするテーブル定義

テーブル定義によっては、解決が困難なため 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 を使用する前にリビルドしておく必要があることも学習しました。

レッスン 2 － v6.x より前のファイル形式での作業

シナリオ

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

注意！ DDF Builder では 6.x のファイルをサポートしますが、そのバージョンより前に作成されたファイルはサポートしません。

目的

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

必要な知識

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

<Application Data>\DDFBuilder\tutorials\tutorial2

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

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

メモ： DSN の作成に関する情報については、データソース名（DSN）の作成を参照してください。

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開して使用可能データベースをすべて表示します。

一覧から Tutorial2 データベースを見つけます。

Tutorial2 データベースアイコンをダブルクリックします。

次のメッセージが表示されます。

［OK］をクリックしてこのメッセージウィンドウを閉じます。

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

警告メッセージを理解する

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

ヒント： DDF Builder は PSQL v9 以上でサポートされます。

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

ログファイルを表示する

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

ログファイルにアクセスするには

DDF Builder のメニューバーで［ヘルプ］をクリックします。

［DDF Builder のログを表示］をクリックします。

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

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

ファイルをリビルドする方法

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

Zen v16 リリースには、rbldcli_offline と呼ばれる Rebuild CLI ツールのスタンドアロンバージョンが含まれています。このユーティリティを使用すれば、Zen がインストールされていないシステムで Zen データファイルを変換することができます。大量のファイルやサイズが非常に大きなファイルをリビルドすると、他のユーザーの Zen データベースエンジンのパフォーマンスが低下する可能性があります。別のシステムでファイルをリビルドできれば、この問題を回避できます。

次に行うこと

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

終わりに

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

レッスン 3 －無効なデータ型とサイズ

シナリオ

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

目的

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

必要な知識

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

<Application Data>\DDFBuilder\tutorials\tutorial2

メモ：このチュートリアルのデータにアクセスするためには、このデータベースを指し示す DSN（データソース名）が必要です。まだ DSN を作成していない場合は、データソース名（DSN）の作成を参照してください。

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開し、一覧から Tutorial2 データベースを見つけます。

ノードをさらに展開して TYPE_SIZE.MKD ファイルを探し、それに関連付けられている SQL テーブルを表示します。

type_size SQL テーブル名をダブルクリックするか、右クリックして［テーブル定義の編集］をクリックします。

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

［OK］をクリックすると、このメッセージがクリアされテーブル定義が表示されます。

ヒント：発生する可能性がある定義エラーの詳細については、定義エラーリストを参照してください。

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

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

メモ： DDF Builder が行った変更は自動的に保存されません。DDF Builder による修正は保存する必要があります。

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

ヒント：グリッドデータビューにおける属性の詳細については、次にグリッドデータビューで表示される属性を挙げます。を参照してください。

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

定義エラービューでは以下の情報が通知されます。

•

•

•

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

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

問題が発生した場所	DDF Builder で検出された問題	必要な対処
列：フィールド6	DDFBLDR-6：テーブル定義内に未定義のバイトがあります。不明な列を追加しました。	DDF Builder が未定義のバイトを明らかにするために追加した不明な列を定義する必要があります。
列：Age	DDFBLDR-11：SQL 列の型が列サイズに適合していません。列の型を "Unknown" に変更しました。	DDF Builder が "Unknown"（不明）に変更した列の型を定義する必要があります。
列： dob	DDFBLDR-11：SQL 列の型が列サイズに適合していません。列の型を "Unknown" に変更しました。	DDF Builder が "Unknown"（不明）に変更した列の型を定義する必要があります。

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

無効なデータ型とサイズ

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

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

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

データ型とサイズを検証する

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

テーブル定義エディターで Age 列をクリックして選択します。

ヒント：テーブル定義の Age 列を選択すると、次で説明しているように［Btrieve 型］タブで特定のデータを見ることができます。

DDF Builder インターフェイスの左側にある［Btrieve 型］タブをクリックを表示します。［Btrieve 型］タブは次のように表示されます。

ヒント： Btrieve 型ビューの詳細については、Btrieve 型を参照してください。

Btrieve 型ビューの［プレビュー］列に表示されるデータを注意深く見てください。

Btrieve 型ビューでは、サイズが 4 バイトの場合に設定可能なデータ型のみを表示します。このように表示することで、その他の無効なデータ型をすべて除外することができるため非常に役に立ちます。

その列が年齢を表すものでサイズが 4 バイトであることを知っていれば、そのデータに対して妥当なのは 3 種類のデータ型のみであることがわかります。

次に、Auto Increment を妥当なデータ型の対象から除外します。これは Auto Increment データ型を使用すると新しいレコードごとに値が自動的に 1 ずつ増えるためです。

この除外によって Btrieve 型の一覧の中から Integer と Unsigned Binary という 2 つのデータ型に絞り込まれました。

Integer および Unsigned Binary データ型は実際によく似ています。これらのデータ型を試してみて、データがどのように解釈されるかを確認します。まず、Age 列の Btrieve 型として Integer を選択します。

［Btrieve 型］リストから "Integer" を選択します。

グリッドデータビューの［プレビュー］列では、データが適切に受け入れられているように見えます。［プレビュー］ページでファイルのすべてのデータを見るようにしてください。

テーブル定義エディターで［プレビュー］タブをクリックします。ファイルの全データを読みやすいレイアウトで見ることができます。

ファイルの全データを見ることによって全レコードをすばやく調査できるので、無効なデータ型かどうかをより確実に見極めるのに役立ちます。

Integer データ型を使用すると、データが適切に書式設定されているように見えることが確認できます。念のため、Unsigned Binary データ型も使用して同じように検証してください。

［Btrieve 型］リストから "Unsigned Binary" を選択します。

同様に、グリッドデータビューの［プレビュー］列には適切な書式でデータが表示されています。確認のため、Integer データ型を使用したときと同じように、［プレビュー］ページでファイルの全データを見ます。

テーブル定義エディターでで［プレビュー］タブをクリックして、ファイルの全データを読みやすいレイアウトで表示します。

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

最終的な変更を行う

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

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

ヒント：データ型が "Unknown"（不明）になっているものをすべて解決し、レコード内の未定義バイトを明確に割り当てるまで、テーブル定義を保存することはできません。

次のエラー対象の 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 番目のエラーでも行ったように、そのデータが適切に受け入れられ理解できるような書式になっているかどうかを検証する必要があります。

テーブル定義エディターで、"dob" 列と "フィールド6" 列の両方を（Shift キーを使って）選択します。

右クリックして［列のマージ］を選択します。

2 つの列が 1 つにマージされ、4 バイトの列が作成されます。

［Btrieve 型］リストから "Date" を選択します。

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

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

グリッドデータビューの下部にある［プレビュー］タブをクリックします。

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

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

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

メニューから、［ファイル］>［保管］を選択します。

終わりに

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

レッスン 4 – 列の定義の重複

シナリオ

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

目的

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

メモ： DDF Builder はファイル内の重複する列定義を修正するための解決策を提示し、それらの変更を保存できるようにします。

必要な知識

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

<Application Data>\DDFBuilder\tutorials\tutorial2

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開し、一覧から Tutorial2 データベースを見つけます。

ノードをさらに展開して OVERLAP.MKD ファイルを探し、それに関連付けられている SQL テーブルを表示します。

overlap SQL テーブル名をダブルクリックするか、右クリックして［テーブル定義の編集］をクリックします。

［OK］をクリックすると、このメッセージがクリアされテーブル定義が表示されます。

ヒント：発生する可能性がある定義エラーの詳細については、定義エラーリストを参照してください。

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

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

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

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

メモ： DDF Builder が行った変更は自動的に保存されません。DDF Builder による修正は保存する必要があります。

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

•

•

•

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

問題が発生した場所	DDF Builder で検出された問題	必要な対処
列： firstName	DDFBLDR-4：SQL 列がほかの列にオーバーラップしています。列のサイズを切り詰めました。	DDF Builder が指名した列（firstName）はほかの列と重なっています。重複する列をなくし、テーブル定義と Btrieve ファイルが同じレコード長になるようにするために、DDF Builder は列のサイズを短くしました。

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

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

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

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

変更を受け入れるまたは拒否する

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

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

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

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

メモ：テーブル定義で Btrieve 型が "Unknown"（不明）であったり、明確に割り当てられていないバイトが含まれているフィールドがあると、そのテーブル定義は保存することができません。

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

メニューから、［ファイル］>［保管］を選択するとテーブル定義が保存されます。

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

終わりに

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

レッスン 5 －ファイル/フィールドフラグの不一致

シナリオ

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

目的

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

必要な知識

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

<Application Data>\DDFBuilder\tutorials\tutorial2

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開し、一覧から Tutorial2 データベースを見つけます。

ノードをさらに展開して FLAGS.MKD ファイルを探し、それに関連付けられている SQL テーブルを表示します。

flags SQL テーブル名をダブルクリックするか、右クリックして［テーブル定義の編集］をクリックします。

［OK］をクリックすると、このメッセージがクリアされテーブル定義が表示されます。

ヒント：発生する可能性がある定義エラーの詳細については、定義エラーリストを参照してください。

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

メモ： DDF Builder が行った変更は自動的に保存されません。DDF Builder による修正は保存する必要があります。

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

ヒント：グリッドデータビューにおける属性の詳細については、次にグリッドデータビューで表示される属性を挙げます。を参照してください。

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

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

•

•

•

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

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

問題が発生した場所	DDF Builder で検出された問題	必要な対処
列： lastName	DDFBLDR-9：SQL 列の大小文字無視フラグが Btrieve セグメントの大小文字無視フラグと一致していません。列の大小文字無視フラグが変更されます。	エラー対象のフィールドに大小文字無視フラグを設定するかどうかを検証し、DDF Builder による変更を受け入れるか、または拒否する必要があります。

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

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

•

元の定義では、lastName フィールドに対して大小文字無視フラグが設定されていませんでした。

•

現在の（DDF Builder によって更新された）定義では、lastName フィールドに対して大小文字無視フラグが設定されています。

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

メモ： lastName フィールドはインデックスとして使用されます。このため、lastName フィールドの大小文字無視フラグの設定をクリアすることはできません。

変更を受け入れるまたは拒否する

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

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

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

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

メニューから、［ファイル］>［保管］を選択するとテーブル定義が保存されます。

更新されたテーブル定義が保存され、lastName フィールドに対して大小文字無視フラグを設定できました。

終わりに

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

レッスン 6 – インデックスの不一致

シナリオ

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

目的

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

ヒント： DDF Builder はインデックスの不一致を修正するための解決法を提示し、それらの変更を保存できるようにします。

必要な知識

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

<Application Data>\DDFBuilder\tutorials\tutorial2

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開し、一覧から Tutorial2 データベースを見つけます。

ノードをさらに展開して INDEX_INC.MKD ファイルを探し、それに関連付けられている SQL テーブルを表示します。

index_inc SQL テーブル名をダブルクリックするか、右クリックして［テーブル定義の編集］をクリックします。

［OK］をクリックすると、このメッセージがクリアされテーブル定義が表示されます。

ヒント：発生する可能性がある定義エラーの詳細については、定義エラーリストを参照してください。

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

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

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

メモ： DDF Builder が行った変更は自動的に保存されません。DDF Builder による修正は保存する必要があります。

•

•

•

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

ヒント： DDF Builder では Btrieve ファイルを変更できません。変更は Btrieve ファイルではなくテーブル定義に対して行われます。

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

問題が発生した場所	DDF Builder で検出された問題	必要な対処
インデックス：indx_id	DDFBLDR-1：この SQL インデックスに対応する Btrieve キーがありません。インデックスを無視しました。	テーブル定義で見つかった SQL インデックスに対応するキーが Btrieve ファイルに存在しません。その結果、DDF Builder ではこのインデックスが無視されるため、実行できる操作は DDF Builder による変更の確認のみです。
インデックス：インデックス 0	DDFBLDR-2：この Btrieve キーに対応する SQL インデックスが見つかりません。インデックスを追加しました。	Btrieve ファイルにキーがあるため、それに対応するインデックスが DDF Builder によってテーブル定義に追加されました。テーブル定義のインデックスを検証して、DDF Builder が行った変更を受け入れる必要があります。

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

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

メモ： DDF Builder によって作成されたインデックスがあり、それがもう必要でない場合は、ファイルおよびテーブル定義からそのインデックスを削除することができます。同様に、DDF Builder がテーブル定義を変更したときに、これまで定義されていなかったインデックスを追加する必要があることに気付くことができます。どちらの場合でも、『Zen Programmer's Guide』でインデックスの追加と削除に関する説明を参照してください。

インデックスに名前を付ける

テーブル定義エディターで［インデックス］タブを選択します。

［インデックス］列の "インデックス0" エントリをダブルクリックします。

インデックスの名前として「index_lname」と入力します。

メモ： Btrieve ファイルに定義されたインデックスを見るには、［統計情報］タブをクリックします。

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

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

メニューから、［ファイル］>［保管］を選択するとテーブル定義が保存されます。

終わりに

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

レッスン 7 – 可変長レコードの不一致

シナリオ

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

目的

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

メモ：現在、DDF Builder は可変長レコードの不一致を修正するための解決策を提示していません。

必要な知識

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

<Application Data>\DDFBuilder\tutorials\tutorial2

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開し、一覧から Tutorial2 データベースを見つけます。

ノードをさらに展開して VARTABLE.MKD ファイルを探し、それに関連付けられている SQL テーブルを表示します。

varTable SQL テーブル名をダブルクリックするか、右クリックして［テーブル定義の編集］をクリックします。

［OK］をクリックすると、このメッセージがクリアされテーブル定義が表示されます。

ヒント：発生する可能性がある定義エラーの詳細については、定義エラーリストを参照してください。

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

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

メモ： DDF Builder が行った変更は自動的に保存されません。DDF Builder による修正は保存する必要があります。

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

ヒント：グリッドデータビューにおける属性の詳細については、次にグリッドデータビューで表示される属性を挙げます。を参照してください。

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

•

•

•

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

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

問題が発生した場所	DDF Builder で検出された問題	必要な対処
列： Name	DDFBLDR-12：可変長列にできるのはテーブル内の最後の列だけです。列の型を "Unknown" に変更しました。	既存の SQL テーブル定義にはレコードの途中に NOTE または LVAR データ型があります。DDF Builder では、可変長列はレコード内の最後に配置する必要があると判断し、このデータ型を "Unknown"（不明）に変更します。DDF Builder が "Unknown"（不明）に変更した列を定義する必要があります。
インデックス：UK_ID	DDFBLDR-1：この SQL インデックスに対応する Btrieve キーがありません。インデックスを無視しました。	テーブル定義で見つかった SQL インデックスに対応するキーが Btrieve ファイルに存在しません。その結果、DDF Builder ではこのインデックスが無視されるため、実行できる操作は DDF Builder による変更の確認のみです。

ヒント：レッスン 3 －無効なデータ型とサイズでは、列のデータ型がその列のサイズに対して無効だった場合の具体的な対処手順を提供しています。

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

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

不明なフィールドを定義する

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

Name フィールドをクリックして選択します。

［Btrieve 型］リストから "String" を選択します。

メモ：テーブル定義に BLOB または CLOB データ型が含まれている場合、テーブルの可変長部分にある列を編集することはお勧めしません。

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

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

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

メニューから、［ファイル］>［保管］を選択するとテーブル定義が保存されます。

終わりに

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

レッスン 8 – レコード長の不一致

シナリオ

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

目的

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

ヒント： DDF Builder はレコード長の不一致を修正するための解決策を提示し、それらの変更を保存できるようにします。

必要な知識

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

<Application Data>\DDFBuilder\tutorials\tutorial2

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

DDF Builder のデータソースエクスプローラーで、［データベース］ノードを展開し、一覧から Tutorial2 データベースを見つけます。

ノードをさらに展開して REC_LENGTH.MKD ファイルを探し、それに関連付けられている SQL テーブルを表示します。

rec_length SQL テーブル名をダブルクリックするか、右クリックして［テーブル定義の編集］をクリックします。

［OK］をクリックすると、このメッセージがクリアされテーブル定義が表示されます。

ヒント：発生する可能性がある定義エラーの詳細については、定義エラーリストを参照してください。

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

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

メモ： DDF Builder が行った変更は自動的に保存されません。DDF Builder による修正は保存する必要があります。

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

ヒント：グリッドデータビューにおける属性の詳細については、次にグリッドデータビューで表示される属性を挙げます。を参照してください。

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

•

•

•