Direct Access Components の使用方法

Zen Direct Access Components は、Borland Delphi と C++Builder 環境内で、Zen データベースエンジンへ直接トランザクショナルおよびリレーショナルアクセスできるようにする、一連の Visual Component Library（VCL）コンポーネントです。この SDK は、以前は "Pervasive Direct Access Components（PDAC）" と呼ばれていました。この略称 PDAC は現在も SDK で使用されています。Zen v15 より前のリリースでは、これらのランタイムコンポーネントは統合され、Zen データベースの 32 ビットおよび 64 ビットの \bin ディレクトリに .bpl ファイルとしてインストールされていました。v15 以降、これらのコンポーネンは Zen インストールから削除されましたが、ダウンロードにより入手される SDK で引き続き利用することができます。これには、RAD Studio 用の設計時コンポーネントも含まれています。

サポートされる開発環境については、PDAC のリリースノートを参照してください。

PDAC のすべてのバージョンには、次の非ビジュアルコンポーネントが含まれています。

これらの 32 ビットコンポーネントのサポートクラスも提供されています。これらのコンポーネントは、Embarcadero の Data Access Components のプロパティ、メソッド、およびバインド機能を再現でき、実行時に Borland Database Engine（BDE）が存在している必要はありません。

これらのコンポーネントはパッケージ形式で提供され、組み込みコントロールの設計時および実行時に必要なすべての機能を提供します。これらは BDE コンポーネントと同様の方法で Embarcadero データアウェアコントロールにバインドします。また、完全に互換性のある、サードパーティのバウンドコントロールにもバインドします。

Woll2Woll InfoPower コンポーネントとの相互運用性のための特別なコンポーネント（wwPvTable、wwPvQuery および wwPvStoredProc）が装備されています。

PDAC では、クエリまたはテーブルを開いたときにデータベースエンジンのバージョンを確認して、エンジンのバージョン依存に伴うエラーが発生しないようにしています。エンジンのバージョンが不適切な場合は、必要なバージョンを示す例外を返します。

SQL クエリテキストを事前解析しないで、エンジンへ直接送ることができます。

このプロパティは、データベースに格納されている文字は OEM（DOS）コードページによってエンコードされているため、データベースを使用する前にこれらの文字を ANSI（Windows）コードページに変換する必要があることを示します。

PDAC 用の SDK ダウンロードを参照してください。これは弊社 Web サイトにあります。

PDAC は、アーカイブからそのコンポーネントをディレクトリ（installdir）に展開することでインストールします。システム上の Delphi または C++Builder IDE が、その展開されたコンポーネントの場所を認識できることを確認してください。

C++Builder のプロジェクトオプションに、PDAC のためのインクルードパスとライブラリパスを反映させるためには以下の手順に従います。これらはデフォルトのオプションとして追加することができます。そのため、Zen コンポーネントを使用しているすべてのプロジェクトに必要というわけではありません。

C++Builder で［プロジェクト］>［オプション］を選択して、［ディレクトリ/条件］タブをクリックします。

［インクルードパス］に installdir\sdk\pdac\Delphi?\include を追加します。ここで、installdir は PDAC をインストールしたディレクトリを示します。疑問符（?）は使用している RAD Studio のバージョンに置き換えます。

さらに［ライブラリパス］に、installdir\sdk\pdac\Delphi?\lib と、installdir\sdk\pdac\Delphi?\lib\dcu をセミコロン（;）で区切って追加します。疑問符（?）は使用している RAD Studio のバージョンに置き換えます。

インクルードパスとライブラリパスを正しく設定すると、Direct Access Components を対応する Embarcadero コンポーネントとまったく同様に使用できるようになります。

Zen では Delphi 6 以降のすべての Delphi バージョンをサポートします。お使いの IDE に Delphi または C++Builder を組み入れるには、次の手順を使用します。

Delphi または C++Builder で［コンポーネント］>［パッケージのインストール］>［追加］をクリックします。

お使いの環境に合ったコンポーネントを選択すると、VCL プロジェクトに Zen が表示されるようになります。これで、PvTable または PvQuery を追加して、PDAC を使用するアプリケーションを構築することが可能になりました。

Embarcadero などのランタイムライブラリ用にはいくつかのバリエーションがありますが、エンドユーザーに配布する PDAC アプリケーションは 2 つの方法で構築できます。1 つは実行時パッケージを使用する方法、もう 1 つはアプリケーションの実行可能ファイルに PDAC ライブラリを静的にリンクする方法です。また、C++Builder では Embarcadero ライブラリの動的または静的リンクも提供します。PDAC アプリケーションを正常に実行させるためには、Zen のクライアントまたはエンジン（Enterprise Server、Cloud Server、Workgroup）のいずれかがターゲットコンピューターに適切にインストールされている必要があります。

実行時パッケージを使用する場合はいくつかの利点があります。最小の実行可能ファイルを提供することができます。これは、リンクの遅い環境で実行可能ファイルまたは更新のダウンロードや転送を行う必要がある場合には重要になります。このオプションを使用すれば、PDAC および Embarcadero のランタイムバイナリを共有することができ、多くの Embarcadero および PDAC アプリケーションを使用する環境内のディスク容量やメモリを大幅に節約することができます。

欠点は、より多くのファイルを配布し、それらを最新のものにしておく必要があること、またその共有ファイルは、共有サブディレクトリにサードパーティ製の不適切なバージョンの共有ファイルがインストールされることによって影響を受ける恐れがあることです。実行時パッケージを使用しない場合は、アプリケーションと drm.dll のみを配布する必要があります。PDAC ライブラリは実行可能ファイルに静的にリンクされるため、それに伴ってサイズは大きくなります。

実行時パッケージを使用する場合、開発者はアプリケーションの実行可能ファイルおよび PDAC ライブラリ（PDAC インストールの redist サブディレクトリ内）の両方と、Embarcadero ランタイムライブラリまたはその他のランタイムライブラリ（コンパイラの bin ディレクトリにある borlndmm.dll が必要になることが多い）をエンドユーザーに配布する必要があります。

Embarcadero の各コンパイラには、redist ディレクトリがあります。このディレクトリには、.bpl ライブラリが含まれており、これらのライブラリは［実行時パッケージを使って構築］オプションを使ってコンパイルされたアプリケーションと一緒に配布する必要があります。

Delphi IDE で以下のように適切なオプションを設定します。

実行時にアプリケーションと PDAC ライブラリとを動的にリンクさせるには、［実行時パッケージを使って構築］のチェックをオンにし、適切な PDAC パッケージを編集ボックスのリストへ追加します。

PDAC ライブラリを実行可能ファイルに静的にリンクさせるには、［実行時パッケージを使って構築］チェックボックスをオフにしておきます。コンパイル時にこの設定をオンにしていた場合は、アプリケーションを配布するときに、ライブラリとその他必要なパッケージや DLL も配布する必要があります。

ファイル名の桁位置	可能な値	説明
1	p	PSQL（Zen 製品の以前の名前）
2	c、b または s	Common、Btrieve または SQL
3 － 5	リリースによって異なる	PDAC コンポーネントのメジャーおよびマイナーバージョン
6	r、d	実行時または設計時
7 － 9	リリースによって異なる	これらのコンポーネントを適用する Delphi バージョン