この章では、Delphi および C++ Builder で使用する Pervasive Direct Access Components について説明します。以下の項目が含まれます。

Pervasive Data Access Components（PDAC）は、Embarcadero Delphi と C++ Builder 環境内で、Pervasive データベース エンジンに直接アクセスできるようにする、一連の Visual Component Library（VCL）コンポーネントです。これらのコンポーネントは、Borland Database Engine（BDE）のすべての機能を提供しながら、BDE の完全な代替品として動作します。PDAC により、Delphi と C++ Builder 開発者にとってはデータベース開発の選択肢が格段に増えます。

Pervasive Data Access Components でサポートされる開発環境については PDAC の Readme ファイルをお読みください。

PDAC のすべてのバージョンには、TPvSession、TPvDatabase、TPvTable、TPvBatchMove、TPvQuery、TPvStoredProc、TPvUpdateSQL、TPvSqlDatabase の非ビジュアル コンポーネントが含まれており、これらのコンポーネントのクラスがサポートされています。これら 32 ビット コンポーネントは、Embarcadero の Data Access Components のプロパティ、メソッド、およびバインド機能を再現しますが、実行時に Borland Database Engine（BDE）が存在している必要はありません。

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

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

TPvTable、TPvDatabase、TPvBatchMove および TPvSession は、完全な PDAC セットの Btrieve サブセットを構成します。これらのコンポーネントでは、リレーショナル機能を使用しておらず、実行時に Pervasive PSQL リレーショナル インターフェイスまたは ODBC を必要としません。

TPvQuery、TPvStoredProc、TPvUpdateSQL、および TPvSqlDatabase コンポーネントでは、Pervasive PSQL リレーショナル インターフェイスを使用します。

次の表は、Pervasive Direct Access Components の種類およびそれに対応する Embarcadero コンポーネントを示しています。

以下の表では、Pervasive Direct Access Components の機能を示しています。

これらのコンポーネントはスタンドアロン（つまり、Borland Database Engine（BDE）なし）で使用することができます。また、単一アプリケーション内で BDE と同時に使用することもできます。コンポーネントの使用法は対応する BDE コンポーネントと同じです。ただし、PDAC クラス、プロパティ、イベント、およびメソッドの記載については除外されます。

TPvQuery には BookmarksEnabled というブール型の新しいプロパティが追加されました。アプリケーションでブックマークを使用しない場合は、このプロパティを False に設定すると TPvQuery のパフォーマンスが向上します。デフォルト値は True です。

セキュリティで保護されたデータベースに接続しようとすると、PDAC にユーザー名とパスワードの入力を求められます。ユーザー名とパスワードを入力しなくても済むようにしたい場合は、TPvDatabase および TPvSQLDatabase で接続パラメーターを設定します。

たとえば、次のように指定します。

TPvQuery には CursorType プロパティがあり、ctCached または ctDynamic を設定できます。次の表では、このプロパティの動作を詳しく説明します。

このプロパティを変更することによって PvQuery の CursorType を変更することはできますが、これは Active が False になっている場合（実行時）に限ります。設計時にこれを変更し、クエリが Active の場合、そのクエリを非アクティブにしてからカーソルの種類を変更します（ただし、再度アクティブ化はしません）。実行時、Active が True になっている場合に PvQuery の CursorType を変更すると、例外（開いたデータセットでこのオペレーションを実行できません）がスローされます。

動的カーソル（ctDynamic）を要求したとしても、SQL ステートメントに動的カーソルを処理できない構文が含まれている場合、エンジンは接続してデータを返しますが、静的カーソルを使用します。たとえば、次のような構文が挙げられます。

カーソルが静的カーソルに変わる場合、この静的カーソルはエンジン ベースのカーソルで、ほかのクライアントによる挿入、更新または削除を見ることができません。以前のリリースの静的カーソル（カーソルの種類に ctCached を使用する）よりも正しく動作します。

カーソルが動的から静的に変わる場合は、Pervasive PSQL エンジンからそれが PDAC コンポーネントに通知され、EngineCursor という名前の読み取り専用のパブリック プロパティが設定されます。

EngineCursor プロパティは公開されていないので、設計時に［オブジェクト インスペクター］には表示されません。このプロパティには 2 つの値があります

このプロパティは変更できませんが、クエリを開いた後にその値を確認することができます。ほかのクライアントによって行われた更新がカーソルに含まれるかどうかをアプリケーション側で認識することが重要な場合などは、このプロパティを確認してください。

PDAC では、クエリまたはテーブルを開いたときに Pervasive PSQL エンジンのバージョンが適切かどうかをチェックしてエンジンのバージョン依存に伴うエラーが発生するのを完全に防ぐことができます。エンジンのバージョンが適切でない場合は例外が発生し、必要なバージョンを示すメッセージが表示されます。

PDAC は下記 Web サイトからダウンロードにより入手可能です。

PDAC コンポーネントは、アーカイブからそのコンポーネントを解凍することで任意のディレクトリ（installdir）にインストールします。PDAC コンポーネントが解凍されたら、システム上の Delphi または C++ Builder IDE がその コンポーネントの場所を確実に認識できるようにする必要があります。

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

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

Pervasive PSQL は Delphi 2006、Delphi 2007、および C++ Builder 2007 のサポートを提供します。お使いの環境に Delphi 2006、Delphi 2007、または C++ Builder 2007 を組み入れるには、以下の手順を使用します。

Delphi 2007 および C++ Builder 2007 は Delphi 2006（BDS 2006）とバイナリ互換なので、既存の Embarcadero package libraries（BPL）はすべて変更なしで動作します。Delphi 2007 および C++ Builder 2007 ではコンパイラ変数 VERSION_180 と VERSION_185 を宣言することに注意してください。

次に示す RAD Studio のエディションで、コンポーネントをコンパイラー IDE に追加するには、下記の手順に従ってください。

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

次の表では、Pervasive と Embarcadero のコンポーネントの機能の相違点を示しています。

Pervaseve Direct Access Components の TransIsolation プロパティの動作は相当する Embarcadero の動きとは違います。

トランザクションの分離レベルでは、同じテーブルで動作するとき、トランザクションがほかで同時に動作しているトランザクションと対話する方法と、ほかのトランザクションによって実行されるオペレーションをトランザクションで監視する程度を決定します。

データベースのトランザクション分離レベルを指定するには、TPvDatabase.TransIsolation プロパティを使用します。

Pervasive Direct Access Components では tiReadCommitted モードのみをサポートします。これは、トランザクションが終了するまで、ファイルへの変更をほかのユーザーが見ることができないという意味です。これは、Pervasive PSQL エンジンの下でサポートされる唯一の設定です。

PDAC のリレーショナル コンポーネントは、DSN または 名前付きデータベースなしでも、クライアント コンピューターからリモート サーバー データベースへ接続できます。サーバーにはデータベースの DSN がなければなりません。

この機能は、TPvSqlDatabase コンポートネントに追加された新しいプロパティ AliasNameIsConnectionString を使用することで動作します。詳細については、VCL と異なる特定のクラスを参照してください。

これらの手順はすべて設計時、または実行時にコードから実行することができます。

Embarcadero などのランタイム ライブラリについてはいくつかのバリエーションがありますが、エンド ユーザーに配布する PDAC アプリケーションの基本的な構築方法は 2 つです。1 つは実行時パッケージを使用する方法で、もう 1 つはアプリケーションの実行可能ファイルに PDAC ライブラリを静的にリンクする方法です。また、C++ Builder では Embarcadero ランタイム ライブラリの動的または静的リンク オプションも提供します。

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

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

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

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

PDAC アプリケーションは I*net Data Server で使用することはできません。I*net Data Server（IDS）は、Pervasive PSQL と別個にインストールできるコンポーネントではなくなりました。IDS の一部であった機能のほとんどは製品に統合されました。

ここでは、次に示すバージョンで構築と配布を行う手順を示します。

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

PDAC ライブラリをアプリケーションの実行可能ファイルに静的にリンクさせるには、［実行時パッケージを使って構築］のチェックをオフにしておきます。

コンパイル時、［実行時パッケージを使って構築］のチェックをオンにしていた場合は、アプリケーションを配布するときに、アプリケーションそのもの、drm.dll およびその他のパッケージまたは 必要な DLL と共に以下に示すパッケージ ライブラリも配布する必要があります。

これらのライブラリは、\SDK\PDAC\PDAC\Delphi2006\REDIST にあり、それぞれ個別の .DCP ファイルが含まれています。

これらのファイルは、アプリケーションの実行可能ファイルと同じサブディレクトリにインストールすることができますが、Pervasive ではターゲット コンピューターのパスに置くことをお勧めします。そうすれば、これらのファイルをほかのアプリケーションでも共有することができます。Pervasive PSQL インストール場所の BIN ディレクトリが Pervasive 実行モジュールの主ディレクトリである場合は、このディレクトリを使用するのが適切です。

さらに、Delphi の PDAC アプリケーションでは Pervasive PSQL エンジン（サーバーまたはワークグループ）または Pervasive PSQL クライアントのいずれかと、適切にインストールされ設定されているリモート サーバーが必要です。

Delphi 6 以降、Pervasive では Embarcadero 標準との互換性をより強化するようパッケージの名前付け規則を変更しました。また、Embarcadero 要件を満たすために、実行時パッケージを設定時パッケージから分けました。

旧バージョンの Delphi と PDAC から移行する場合の新しい実行時パッケージ名の解釈方法を以下に示します。

PDAC では次の 2 つのセキュリティ タイプをサポートします。

以下にこれら 2 つのセキュリティ モデルの詳細を説明します。

このセキュリティ モデルを使用する場合は、テーブルのオーナー ネームを提供します。詳細については、『Btrieve API Guide』の Btrieve オペレーション 29 の「Set Owner」を参照してください。

TPvTable には Owner: string プロパティと次のメソッドがあります。

Owner プロパティを使用すれば、オーナー ネームを設定することができます。SetOwnerOnTable メソッドを使用すれば、テーブルのオーナー ネームを設定したりクリアしたりすることができます。

Btrieve テーブルにアクセスするには、有効なオーナー ネームを提供する必要があります。

SQL/ODBC セキュリティは DDF レベル上のデータベース セキュリティです。PDAC には SQL セキュリティをセットアップする特別な方法はありません。Pervasive Control Center または ODBC ツールなどの外部プログラムを使用する必要があります。Pervasive Control Center の詳細については、『Pervasive PSQL User's Guide』を参照してください。データベースがセキュリティで保護されている場合は、テーブルを開くとき、または TpvDatabase コンポーネントにアクセスするときに、毎回ユーザー名とパスワードを入力するダイアログが表示されます。データベースにセキュリティが設定されているかどうかを調べるには、パブリック プロパティの TPvDatabase.IsSecured で確認することができます。