以下のトピックでは、Delphi および C++ Builder で使用する PSQL Direct Access Components について説明します。

Btrieve コンポーネントのセットには以下のものが含まれています。

これらのコンポーネントはリレーショナル機能を使用しておらず、実行時に リレーショナル エンジンまたは ODBC を必要としません。

コンポーネントは、次の表に示すように Embarcadero のコンポーネントに置き換わります。

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

スレッドに対する安全性とクライアント ID のサポートを提供します。この機能は、TSession VCL コンポーネントと類似しています。

TPvSession については、本章の以下のセクションを参照してください。

ログイン コントロール、トランザクション サポート、データベース接続持続性などの、非 SQL データベースのための接続に特化した機能を提供します。この機能は、TDatabase VCL コンポーネントと類似しています。

セキュリティで保護されたテーブルに接続しようとすると、PDAC にユーザー名とパスワードの入力を求められます。このようなプロンプトが表示されないようにしたい場合は、次のコードを例として用いて、TPvDatabase で接続パラメーターを設定します。（TPvTable のテーブル セキュリティも参照してください。）

TPvDatabase については、本章の以下のセクションを参照してください。

シングル テーブル アクセスと操作を提供します。この機能は、TTable VCL コンポーネントと類似しています。

MicroKernel エンジン用の PDAC セキュリティは、個々のテーブルのオーナー ネームを使用します。このセキュリティ モデルを使用する場合は、テーブルのオーナー ネームを提供します。詳細については、『Btrieve API Guide』の Set Owner（29）を参照してください。

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

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

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

実行時に CreateTable メソッドを呼び出し、このデータセットの現在の定義を使用してテーブルを作成します。

FieldDefs プロパティに値がある場合は、これらの値を使ってフィールド定義を作成します。値がない場合は、Fields プロパティを使用します。データセットを再作成するには、これらのプロパティの一方または両方に値がなければなりません。

Add メソッドを使用してフィールドのプロパティを割り当てます。

Add メソッドは以前のバージョンとの互換性を保つために提供されます。新しいフィールド定義を Item プロパティの配列に追加する場合は、AddFieldDef メソッドを使用することをお勧めします。また、これを使って ftBCD データ型の小数位と桁数も指定します。

Add メソッドは、Name、DataType、Size および Required パラメーターに渡された値を使用し、これらを新しいフィールド定義オブジェクトの個別のプロパティに割り当てます。

TPvTable については、本章の以下のセクションを参照してください。

アプリケーションの、レコードのグループあるいはテーブル全体へのデータベース オペレーションを可能にします。この機能は、TBatchMove VCL コンポーネントと類似しています。

TPvTable については、本章の以下のセクションを参照してください。

InfoPower 互換性のために PDAC に含まれています。TPvTable から直接派生され、ControlType という追加のプロパティを持ちます。

リレーショナル エンジン コンポーネントのセットには以下のものが含まれています。

コンポーネントは、次の表に示すように Embarcadero のコンポーネントに置き換わります。

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

PSQL のスレッドに対する安全性とクライアント ID のサポートを提供します。この機能は、TSession VCL コンポーネントと類似しています。

TPvSQLSession については、本章の以下のセクションを参照してください。

ログイン コントロール、トランザクション サポート、データベース接続持続性などの、PSQL データベースのための接続に特化した機能を提供します。この機能は、TDatabase VCL コンポーネントと類似しています。

セキュリティで保護されたデータベースに接続しようとすると、PDAC にユーザー名とパスワードの入力を求められます。このようなプロンプトが表示されないようにしたい場合は、次のコードを例として用いて、TPvSQLDatabase で接続パラメーターを設定します。

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

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

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

TPvSQLDatabase については、本章の以下のセクションを参照してください。

SQL ステートメントに基づいて行セットをカプセル化します。これは、複数のテーブルに対する結合やキャッシュされた更新を含む、完全なリレーショナル アクセスを提供します。この機能は、TQuery VCL コンポーネントと類似しています。

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

PvQuery.BookmarksEnabled := False

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

このプロパティを変更することによって PvQuery の CursorType を変更することはできますが、Active が False になっている場合は実行時のみに限ります。デザイン モードでこれを変更し、クエリが Active である場合は、そのクエリを非アクティブにしてからカーソルの種類を変更しますが、再アクティブ化はしません。実行時、Active が True になっている場合に PvQuery の CursorType を変更すると、"開いたデータセットでこのオペレーションを実行できません" という例外が生じる結果となります。

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

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

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

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

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

TPvQuery については、本章の以下のセクションを参照してください。

マルチテーブル結合などのほかの方法で更新できない SQL 行セットの（キャッシュ後の更新を含んだ）透過的な更新を可能にします。この機能は、TUpdateSQL VCL コンポーネントと類似しています。

TPvTable については、本章の以下のセクションを参照してください。

PSQL ストアド プロシージャへのアクセスを提供します。TpvQuery コンポーネントと同様に、パラメーター化し、行セットを返すことができます。この機能は、TStoredProc VCL コンポーネントと類似しています。

TPvQuery については、本章の以下のセクションを参照してください。

InfoPower 互換性のために PDAC に含まれています。TPvQuery から直接派生され、ControlType という追加のプロパティを持ちます。

InfoPower 互換性のために PDAC に含まれています。TPvStoredProc から直接派生され、ControlType という追加のプロパティを持ちます。

ODBC および SQL のセキュリティは DDF レベルのデータベース セキュリティです。PDAC には SQL セキュリティをセットアップする特別な方法はありません。PSQL Control Center または ODBC ツールなどの外部プログラムを使用する必要があります。PSQL Control Center の詳細については、『PSQL User's Guide』を参照してください。

データベースがセキュリティで保護されている場合は、テーブルを開くとき、または TpvDatabase コンポーネントにアクセスするときに、毎回ユーザー名とパスワードを入力するダイアログが表示されます。データベースにセキュリティが設定されているかどうかを調べるには、パブリック プロパティの TPvDatabase.IsSecured で確認することができます。セキュリティで保護されたテーブル、およびユーザー名とパスワードの入力要求も参照してください。

次の表では、PSQL と Embarcadero のコンポーネントの機能の違いについてまとめています。

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

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

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

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

ここでは、PSQL Direct Access Components のすべてのクラス、プロパティ、イベント、およびメソッドの一覧を示します。Pascal 表記法で記載し、対応する Embarcadero のコンポーネントとの相違点も示しています。

このクラスは PDAC のすべての例外クラスの上位クラスです。これには例外を生成するクラスへの参照が含まれる Owner プロパティがあります。

これは、クラスに関連するすべての DB エンジン エラーの抽象ベースのクラスです。Errors プロパティでは（TPvDBError クラスから派生するクラスの）エラーを一覧表示し、ErrorCount プロパティは Errors プロパティに含まれるエラーの総数を示します。

TPvDBError は、EPvDBEngineError 例外クラスのデータベース エンジン エラーを表すすべてのクラスに関する抽象ベースのクラスです。以下のプロパティがあります。

このクラスの例外は PDAC の Btrieve サブセットによって発生します。ErrorCode プロパティは DRM エラー コードです。EPvDrmEngineError の Errors プロパティの配列には TpvDrmError タイプのオブジェクトが含まれます。

TPvDrmError クラスは DRM エラーを示します。ErrorCode には DRM エラー コードが含まれ、NativeError には Btrieve ステータス コードが含まれます。

このクラスの例外は PDAC の SQL（リレーショナル）サブセットによって発生します。ErrorCode プロパティは最後の ODBC 呼び出しの戻り値です。EPvSqlEngineError の Errors プロパティの配列には TPvSqlError タイプのオブジェクトが含まれます。

TPvSqlError クラスは ODBC エラーを示します。

このクラスの例外は、ローカル サーバーおよびリモート サーバー上で、TPvSqlSession.AddAlias などのデータベース名や DSN 管理関数の実行中に発生します。追加のプロパティ ErrorType: TpvDbAdminEngineErrorTypes があります。ErrorType = dbmeDTI の場合、NativeError には DTI（Distributed Tuning Interface）エラー コードが含まれます。それ以外の場合、NativeError にはデータベース名および DSN 関連の関数のローカル エラー コードが含まれます（EPvSqlInstallerEngineError および EpvOwnSqlInstallerEngineError を参照）。

このクラスの例外は、ローカル サーバー上で、TPvSqlSession.AddAlias などの DSN 管理関数の実行中（TPvSqlSession.ServerName プロパティが空またはローカル サーバーの名前が設定されていた場合）に発生します。Errors には、SQLInstallerError() 関数で返される値が含まれます。

DSN 管理関数では適切なエラーがない場合があるので、このクラスの例外を発生して新しいタイプのエラーを示すことができます。NativeError の可能な値は以下のとおりです。

サポート クラスは、高レベルのコンポーネントとカプセル化した BDE 固有の機能で必要となります。これらのクラスは、可能な限り少ない変更で PDAC に 複製されています。

TPvSessionList および TPvSqlSessionList クラスは、複数のセッションを提供するアプリケーション内のセッション コンポーネントを管理します。このクラスでは、含まれるオブジェクトのタイプのみ（TSession に対応する TPvSession または TPvSqlSession）が変更されています。

TPvBlobStream および TPvSQLBlobStream クラスは、BLOB（バイナリ ラージ オブジェクト）フィールドを示すフィールド オブジェクトをアプリケーションで読み書きできるようにするストリーム オブジェクトです。これらは TBlobStream VCL クラスと同様に機能します。

TParam クラスはフィールド パラメータを表します。TParam のプロパティはフィールドの値を示すパラメーターの値を設定するのに使用します。TParams は TParam オブジェクトのリストです。PDAC の TParam と TParams ではそれぞれのインターフェイス セクションの変更はありません。これらは新しいファイルに移動するだけです。

TMasterDataLink を使用すれば、データセットでマスター/詳細関係を設定することができます。このインターフェイス セクションでの変更はありません。新しいファイルに移動するだけです。

PDAC コンポーネントで公開するインターフェイスは、BDE で動作する適切な VCL コンポーネントとほぼ一致しています。VCL コンポーネントに関する詳細情報は、Delphi/C++Builder ヘルプ システム（del?vcl.hlp または bcbvcl?.hlp ファイルで、「?」は "3"、"4" または "5" を示します）を参照してください。ただし、BDE のいくつかの機能は PSQL に存在せず、また PSQL のいくつかの機能は BDE に存在しないので、PSQL ではこれらのインターフェイス（削除または追加プロパティ/メソッド/イベント）を修正しました。これらの変更されたインターフェイスのみを以下に列挙します。その他すべてのインターフェイスは同一です。

BDE の Session および Sessions グローバル変数の代わりに、PDAC では独自のグローバル変数があります。Btrieve サブセット用に BtvSession: TPvSession と BtvSessions: TPvSessionList があり、リレーショナル サブセット用に PvSqlSession: TPvSqlSession と PvSqlSessions: TPvSqlSessionList があります。これらは、Session や Sessions 変数と同様に動作し、アプリケーションの開始時に自動的に作成され、終了時に自動的に破棄されます。

トランザクショナル サブセットの場合、PDAC では PSQL の「名前付きデータベース」をエイリアスとして使用します。

リレーショナル サブセットの場合、PDAC ではデータ ソース名（DSN）をエイリアスとして使用します。

以下のセクションでは、Embarcadero VCL とは異なるクラスを個別に説明します。

以下のプロパティが追加されました。

このセクションでは、データ型のマッピングについて詳しく説明します。

次の表は、PSQL の列のデータ型から Delphi のデータ型へのマッピングを示しています。PSQL データベースに格納されている左側のデータ型は、PDAC コンポーネントにより、右側に記載されているデータ型で表されます。

次の表は、Delphi データ型から PSQL データ型へのマッピングを示しています。PDAC を使って新しいデータベース テーブルが作成されると、左側の列に示されるフィールドのデータ型として定義された列が、PSQL によって、右側に示されるデータ型で保存されます。

次の表は、Btrieve から VCLへのデータ型のマッピングを示しています。

次の表は、VCL から Btrieve へのデータ型のマッピングを示しています。

PSQL 固有のテーブル作成メソッド（TPvTable.PvCreateTable）があります。これを使えば、フィールド タイプに関する追加パラメーターを調整することができます。以下の定義があります。

PvFieldDefs でいくつかのパラメーターを調整することができます。

上記の要素は次のような意味があります。

特定のフィールドを設定しない場合は、0（DrmType、ColumnSize の場合）、-1（BtrType の場合）、False（IsColumnCaseInsensitive の場合）、または ''（すべての文字列フィールド）を設定することができます。この場合、デフォルト値を使用します。FieldNum フィールドは必須です。

IsColumnCaseInsensitive、ACS_FileName、ACS_Name、および ACS_ID フィールドは互いに排他的になっています。つまり、これらのうち 1 つのみ設定することができます。

Btrieve 動作と一致させるために、インデックス オプションの ixCaseInsensitive は無視されます。

次に PvCreateTable メソッドの使用例を示します。