DDF Builder について

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

DDF Builder では行わないこと

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

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

ZenCC を使用しない理由

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

必要な知識

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

その他の有用な情報

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

メモ：このマニュアルは、トランザクショナルアクセス方法とリレーショナルの概念について理解していることを前提として説明しています。これらトランザクショナルおよびリレーショナルに関する説明や、キー、インデックス、ページタイプ、スキーマなどの一般的な用語についての定義は行いません。

DDF Builder を使用する前に理解を深めておく必要がある場合は、下記の Zen マニュアルを参照してください。デフォルトで、Zen 開発者向けドキュメントは Zen データベースエンジンのインストール時に一緒にインストールされます。

トランザクショナルアクセス

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

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

•

Zen Programmer's Guide（開発者リファレンス）

•

Btrieve API Guide（開発者リファレンス）

•

Advanced Operations Guide（上級者リファレンス）

リレーショナルアクセス

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

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

•

SQL Engine Reference（上級者リファレンス）

•

Advanced Operations Guide（上級者リファレンス）

•

Zen User's Guide（一般リファレンス）

•

Zen Programmer's Guide（開発者リファレンス）

次に行うこと

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

メモ：DDF Builder では既存の Btrieve ファイルのレコードレイアウト構造を変更できません。このユーティリティを使って新しい Btrieve ファイルを作成することはできます。

セキュリティの無効化

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

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 の起動

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

►

DDF Builder を Windows オペレーティングシステムから起動するには

［スタート］メニューまたはアプリ画面から DDF Builder にアクセスします。

DDF Builder メインウィンドウが開きます。

►

ZenCC から DDF Builder を起動するには

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

DDF Builder メインウィンドウが開きます。

図 1 DDF Builder メインウィンドウ

コマンドラインから DDF Builder を起動する

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

Windows

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

Linux および macOS

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

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

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

表 1

Linux または macOS で DDF Builder を起動するための要件

要件

説明

Zen Server または Client

同一マシンに互換性のある Zen Server または Client が既にインストールされている必要があります。『Getting Started with Zen』の Zen（Linux ベースのシステム用）のインストールを参照してください。

X Server へのアクセス

xhost コマンドは、どのクライアントが現在のマシンの X-Windows System にアクセスできるかを制御します。デフォルトで、xhost はアクセス制御をオンにします。つまり、X-Windows System を起動したユーザーのみが DDF Builder を起動できます。

X-Windows System クライアントの制限は、ターミナルウィンドウで xhost + を実行することによって解除できます。

Java Runtime Environment（JRE）

DDF Builder を実行するために必要な JRE コンポーネントは、Zen の一部としてインストールされます。DDF Builder は、Zen の一部としてインストールされる JRE のローカルバージョンを使用します。

デスクトップの所有権（macOS のみ）

デスクトップにログインしているユーザーのみが DDF Builder を起動することができます。

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

表 2

DDF Builder の実行に関するトラブルシューティングガイド

トラブルシューティングする状態

説明

"java.lang.UnsatisfiedLinkError" というエラーを受け取った。

このエラーは、ファイルブラウザーアプリケーションを使用してスクリプトファイルをダブルクリックして DDF Builder を起動しようとしたときに、よく起こります。コマンドプロンプトから DDF Builder を起動してください。

このエラーは、LD_LIBRARY_PATH 変数が設定されていない場合に発生します。builder スクリプトがこの変数を設定します。この変数は、以下のコマンドを使用して明示的に設定することもできます。

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/actianzen/lib64

macOS では、この変数は DYLD_LIBRARY_PATH になります。

DDF Builder を root またはユーザー zen-svc として実行しようとすると、"SWT no more handles" というエラーが返される。

DDF Builder を実行するには、zen-svc または root ユーザーとしてログインする必要はありません。ただし、これらのユーザーのどちらでもない場合は、zen-data グループのメンバーである必要があります。

"SWT no more handles" エラーは、X Server がクライアントへの接続を拒否したために発生します。zen-svc または root ユーザーに切り替える前に、コンソールウィンドウを開き、xhost + と入力してほかのクライアントが X Server に接続できるようにします。

これで、zen-svc または root ユーザーに切り替えることができます。

また、場合によっては DISPLAY 環境変数を設定する必要があります。zen-svc または root ユーザーとして、コンソールウィンドウで以下のコマンドを入力します。

export DISPLAY=:0.0

または

export DISPLAY=localhost:0.0

DDF Builder のエラーログファイルを表示、またはエラーをコンソールウィンドウにリダイレクトしたい。

DDF Builder エラーのログファイルは、ユーザーのホームディレクトリ下にあります。トラブルシューティングのためには、エラーをコンソールウィンドウにリダイレクトするとより便利です。

エラーをコンソールウィンドウにリダイレクトするには、DDF Builder の起動時に ‑consoleLog オプションを使用します。

builder -consoleLog

以下のエラーメッセージが返された。"データベースエンジンに接続できません。ターゲットマシンがアクセス可能で、かつエンジンが実行されていることを確認してください。"

このエラー状況は、ローカルサーバーを管理しようとした場合に発生します。

ローカルサーバーを管理するには、zen-data グループのメンバーであるか root ユーザーである必要があります。『Getting Started with Zen』の「Linux、macOS、Raspbian での Zen のアカウント管理」を参照してください。