DDF Builder は Java ユーティリティで、基となるデータ ファイル（以後、「Btrieve ファイル」と言います）に変更を加えることなく、Zen データ辞書ファイル（DDF）の表示、作成、変更が行えます。DDF Builder ではさまざまな機能を提供しますが、主に以下のような目的で使用できます。

DDF Builder には上記以外にも次のような機能があります。また、これ以外にもさらに機能があります。

DDF Builder は、Btrieve データ ファイルを変更することなく、Btrieve データ ファイルへのリレーショナル アクセスを追加することができる特殊なユーティリティです。通常、DDF Builder は日常的に使用するユーティリティではありません。DDF Builder は既存の Btrieve ファイルへのリレーショナル アクセスを追加するために必要に応じて使用するもので、データ辞書ファイルのテーブル定義を作成したり、正しく構成されていないテーブル定義へ接続するために既存のデータ辞書ファイルを変更したりします。

旧バージョンの Zen Control Center のテーブル設計では、リンク モードと非リンク モードの 2 つの作業モードを提供しているものもあります。リンク モードではテーブル定義とデータ ファイルの両方を変更することができますが、非リンク モードで変更できるのはテーブル定義のみです。DDF Builder では、IN DICTIONARY 呼び出しを使って非リンク モード同様のモードを使用することで、Btrieve ファイルを変更することなく DDF を変更します。DDF Builder では Btrieve ファイルへ書き込みを行うことはありません。

DDF Builder は既存の Btrieve データ ファイルを変更する目的には使用できません。既存の Btrieve ファイルおよび DDF を変更してリレーショナル アクセスを提供するつもりであれば DDF Builder を使用すべきではありません。その場合は、既存の Btrieve ファイルを変更する Zen Control Center やその他の Zen ユーティリティを使用することをご検討ください。

また、DDF Builder はキーの作成や変更に使用するものではありません。キーに関する操作を行う場合は、Zen Control Center の Table Editor を使用しますDDF Builder は DDF の作成や変更を目的としています。

Zen Control Center は物理データ ファイルとデータ辞書ファイルを同時に操作する、つまりリンク モードで操作することを目的としています。DDF のみを変更するために ZenCC を使用することはお勧めしません。

DDF Builder を使用する場合に最も重要なのは、作業対象のデータの構造を完全に理解しておくことです。データの構造を理解していないと、DDF Builder でテーブル定義を作成したり変更することが難しくなるため時間がかかり、このユーティリティの効果が得られません。

Zen データベースからデータがアクセスされるときに用いられるトランザクショナルとリレーショナルという 2 種類の主要なアクセス方法について理解していることも役立ちます。DDF Builder の機能の大部分は、トランザクショナル アクセスについての知識が役立ちます。それ以外の機能については、リレーショナル データベースの一般的な概念についてよく理解していることが必要です。

トランザクショナル アクセスの場合、アプリケーション プログラムは物理的または論理的のどちらの経路でもデータ レコード内を前方および後方に移動することができます。トランザクショナル API を使用することで、アプリケーション プログラムは直接制御を備え、開発者はデータの基本構造の知識に基づいてデータ アクセスを最適化することができます。Btrieve API を使用することはトランザクショナル アクセスの 1 例です。

トランザクショナル アクセスについて理解を深めるには、以下のマニュアルを参照してください。

リレーショナルとは、データがテーブル、行、列の集まりとして表されるアクセス方法です。リレーショナル モデルは、開発者を基となるデータ構造から切り離し、データを単純な表形式で表します。ODBC はリレーショナル アクセス方法の 1 例です。

リレーショナル アクセスについて理解を深めるには、以下のマニュアルを参照してください。

DDF Builder でテーブル定義に対して変更を行うと DDF の構造が変更されます。このユーティリティの使用前の注意事項として、作業対象のファイル（DDF も含む）を必ずバックアップしておいてください（Btrieve ファイルは、ファイルのページ構造内にデータが格納されるため、データ ファイルとも呼ばれます）。

Zen セキュリティ モデルが有効なデータベースに対して作業する場合、DDF Builder でそのファイルを開く前にはそのデータベースをオフラインにし、すべてのセキュリティを解除しておきます。

ユーティリティ以外にも、DDF Builder では以下のコンポーネントがあります。

ログ ファイルは DDF Builder が問題のある状態を報告するファイルです。デフォルトのインストールで、ログ ファイルは次のディレクトリにインストールされます。

C:\ProgramData\Actian\Zen\rcp\workspace-builder\.metadata

『DDF Builder User's Guide』は Zen ユーザー向けドキュメントに含まれています。

DDF Builder では、『DDF Builder』に含まれているチュートリアルで使用するファイルのセットをインストールします。このチュートリアル ファイルはデフォルトで、C:\ProgramData\Actian\Zen\DDFBuilder\tutorials にインストールされます。説明については、DDF Builder チュートリアルを参照してください。

デフォルトのインストール先については『Getting Started with Zen』のファイルはどこにインストールされますか？を参照してください。

DDF Builder の起動は、Windows オペレーティング システムから、Zen Control Center（ZenCC）内から、あるいはコマンド ラインから行うことができます。

DDF Builder は Windows、Linux または macOS でコマンド ラインから実行可能ファイルを実行することによって起動することができます。詳細については、次のトピックを参照してください。

実行可能ファイル builder.exe を実行すると、DDF Builder が起動します。『Getting Started with Zen』のファイルはどこにインストールされますか？を参照してください。

実行可能スクリプト ファイル builder を実行すると、DDF Builder が起動します。このスクリプト ファイルは、デフォルトで usr/local/actianzen/bin ディレクトリにインストールされます。

ファイル ブラウザー アプリケーションでスクリプト ファイルをダブルクリックするのではなく、コマンド プロンプトから DDF Builder を起動することをお勧めします。DDF Builder の実行に関するトラブルシューティング ガイドを参照してください。

Linux または macOS 上で DDF Builder を起動するには、以下の要件を満たしている必要があります。

DDF Builder を実行する要件に合致しているのに、実行に問題がある場合は、以下のトラブルシューティング ガイドを参考にしてください。

DDF Builder は効率を上げるために一定の情報をキャッシュします。弊社テクニカル サポートからの指示に応じてトラブルシューティング目的に、あるいはすべてのファイルを確実に再ロードするために、キャッシュをクリアする必要がある場合もあります。キャッシュは、DDF Builder をパラメーターを使ってコマンド ラインから起動した場合にのみクリアできます。

DDF Builder の全般的な理解が得られたら、DDF Builder の使用でユーザー インターフェイスの概要を参照してください。