Direct Access Components リファレンス

Zen Direct Access Component	置き換える Embarcadero コンポーネント
TPvBatchMove	TBatchMove
TPvDatabase	TDatabase
TPvSession	TSession
TPvTable、TwwPvTable	TTable

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

TPvSession

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

関連情報

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

•

TPvSessionList/TpvSqlSessionList クラス（サポートクラス）

•

グローバル変数（VCL との全般的な違い）

•

TPvSession と TPvSqlSession（VCL と異なる特定のクラス）

•

TPvSession に関する注記（VCL と異なる特定のクラス）

TPvDatabase

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

TPvDatabase と Embarcadero のコンポーネントの機能の相違点

•

DriverName、Locale、および TTraceFlags プロパティは削除されています。

•

ハンドルのタイプが DRM_DBID に変更されます。

•

IsSQLBased は常に False を返します。

•

TransIsolation に指定できる値は、tiDirtyRead と tiReadCommitted（デフォルト）の 2 つのみです。

セキュリティで保護されたテーブル、およびユーザー名とパスワードの入力要求

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

PvSession.ServerName:='ServerName';

PvSession.SessionName:='session1';

PvSession.Active:=True;

PvDatabase.AliasName:= 'DatabaseName';

PvDatabase.DatabaseName:='DB';

PvDatabase.SessionName:='session1';

PvDatabase.Params.Clear();

// ここでユーザー名とパスワードを指定して

// データベースに接続する

PvDatabase.Params.Add('User Name=UserName');

PvDatabase.Params.Add('password=Password');

PvDatabase.Connected:=True;

PvTable.DatabaseName:='DB';

PvTable.SessionName:='session1';

PvTable.TableName:='person';

PvTable.Active:=True;

関連情報

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

•

TransIsolation プロパティの相違点（PDAC と Embarcadero のコンポーネントの相違点）

•

TPvDatabase と TPvSqlDatabase（VCL と異なる特定のクラス）

•

TPvDatabase に関する注記（VCL と異なる特定のクラス）

TPvTable

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

TPvTable と Embarcadero のコンポーネントの機能の相違点

•

すべてのエイリアス管理機能で「名前付きデータベース」管理を行います。

•

TDBDataSet からではなく TPvDataSet から継承します。

•

TableLevel、UpdateObject、UnlockTable、OpenIndexFile、CloseIndexFile の各プロパティは既に削除されており、TableType が無視されます。

•

設計時と実行時のどちらででも、DSN、Zen 名前付きデータベース、あるいはデータベースへの完全修飾パスとして、Database Name プロパティを利用できます。

テーブルセキュリティ

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

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

SetOwnerOnTable(AOwner: string; AccessMode: integer)

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

表 1

PDAC アクセスモード

コード

説明

すべてのアクセスモードでオーナーネームが必要（データ暗号化なし）

読み取り専用アクセスにはオーナーネームは必要なし（データ暗号化なし）

すべてのアクセスモードでオーナーネームが必要（データ暗号化あり）

読み取り専用アクセスにはオーナーネームは必要なし（データ暗号化あり）

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

テーブルの作成

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

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

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

procedure Add(const Name: string; DataType: TFieldType; Size: Word; Required: Boolean);

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

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

メモ：フィールドがヌル値を許可する場合、Required に False を設定します。

AutoInc フィールドで autoincrement プロパティをアクティブにするには、このフィールドに固有のインデックスを作成します。

また、現在のリリースでは、PDAC は BIGIDENTITY データ型をサポートしていません。

Delphi のコード例

PvTable1.DatabaseName := 'TestData';

PvTable1.TableName := 'TestData1';

with PvTable1.FieldDefs do

begin

Clear;

Add('F_autoinc', ftAutoInc, 0, True);

Add('F_currency', ftCurrency, 0, False);

Add('F_integer', ftInteger, 0, False);

Add('F_word', ftWord, 0, False);

Add('F_fixchar', ftFixedchar, 30, False);

Add('F_varbin', tString, 25, False);

Add('F_blob', ftBlob, 60, False);

end;

with PvTable1.FieldDefs.AddFieldDef do

Precision := 10; //小数位

Required := false;

end;

with PvTable1.IndexDefs do

begin

Clear;

Add('Index1', 'F_autoinc', [ixPrimary, ixUnique]);

Add('Index2', 'F_integer', [ixCaseInsensitive]);

end;

PvTable1.CreateTable;

C++Builder のコード例

PvTable1->DatabaseName="TestData";

PvTable1->TableName="Test1";

PvTable1->FieldDefs->Clear();

PvTable1->FieldDefs->Add("F_autoinc", ftAutoInc, 0, True);

PvTable1->FieldDefs->Add("F_integer", ftInteger, 0, False);

PvTable1->FieldDefs->Add("F_Curr", ftCurrency, 0, False);

PvTable1->FieldDefs->Add("F_Word", ftWord, 0, False);

PvTable1->FieldDefs->Add("F_fixchar", ftFixedChar, 0, False);

PvTable1->FieldDefs->Add("F_String", ftString, 20, False);

PvTable1->FieldDefs->Add("F_blob", ftBlob, 60, False);

TFieldDef *FieldDef = PvTable1->FieldDefs->AddFieldDef();

FieldDef->Name="F_BCD";

FieldDef->DataType=ftBCD;

FieldDef->Size=2;

FieldDef->Precision=10;

FieldDef->Required=False;

PvTable1->IndexDefs->Clear();

PvTable1->IndexDefs-> Add("Index1","F_autoinc",TIndexOptions() <<ixPrimary << ixUnique);

PvTable1->CreateTable();

関連情報

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

•

TransIsolation プロパティの相違点（PDAC と Embarcadero のコンポーネントの相違点）

•

TPvTable、TPvQuery および TPvStoredProc（VCL と異なる特定のクラス）

•

TPvTable に関する注記（VCL と異なる特定のクラス）

•

Zen および Embarcadero のデータ型

TPvBatchMove

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

関連情報

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

•

TPvBatchMove（VCL と異なる特定のクラス）

TwwPvTable

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

リレーショナルエンジンコンポーネント

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

•

•

•

•

•

•

•

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

Zen Direct Access Component	置き換える Embarcadero コンポーネント
TPvQuery、TwwPvQuery	TQuery
TPvSqlDatabase	TDatabase
TPvSqlSession	TSession
TpvStoredProc、TwwPvStoredProc	TStoredProc
TPvUpdateSQL	TUpdateSQL

TPvSQLSession

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

TPvSQLSession と Embarcadero のコンポーネントの機能の相違点

•

すべてのエイリアス管理機能で DSN 管理を行います。

•

Handle プロパティのタイプが SQLHENV に変更されます。

•

AddStandardAlias メソッドではデフォルトの設定でエンジン DSN を追加します。

•

'UpdateDsnType:TDsnTypes' プロパティが追加されています。TDsnTypes = (dsnSystem, dsnUser)。UpdateDsnType の意味は次のとおりです。

•

DeleteAlias 関数の場合は、DSN ユーザーが System または User DSN のどちらを削除するのか。

•

AddAlias および GetAliasParameters 関数の場合は、どの DSN タイプにするのか。

•

TPvSessionList/TpvSqlSessionList クラス（サポートクラス）

•

グローバル変数（VCL との全般的な違い）

•

TPvSession と TPvSqlSession（VCL と異なる特定のクラス）

•

TPvSqlSession に関する注記（VCL と異なる特定のクラス）

TPvSQLDatabase

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

TPvDatabase と Embarcadero のコンポーネントの機能の相違点

•

Handle プロパティのタイプが SQLHDBC に変更されています。

•

IsSQLBased プロパティは常に True になります。

•

Tables と StoredProcs プロパティには、それぞれ TsqlTablesInfoCollection、TsqlStoredProcInfoCollection というタイプがあります。

セキュリティで保護されたデータベース、およびユーザー名とパスワードの入力要求

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

PvSession.ServerName:='ServerName';

PvSession.SessionName:='session1';

PvSession.Active:=True;

PvDatabase.AliasName:= 'DatabaseName';

PvDatabase.DatabaseName:='DB';

PvDatabase.SessionName:='session1';

PvDatabase.Params.Clear();

// ここでユーザー名とパスワードを指定して

// データベースに接続する

PvDatabase.Params.Add('User Name=UserName');

PvDatabase.Params.Add('password=Password');

PvDatabase.Connected:=True;

PvTable.DatabaseName:='DB';

PvTable.SessionName:='session1';

PvTable.TableName:='person';

PvTable.Active:=True;

クライアントからの、DSN を使用しない接続

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

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

Delphi のフォーム上に PvSQLDatabase を配置します。

架空の DatabaseName を設定します。これは何でもかまいません。

プロパティ AliasNameIsConnectionString を True に設定します。

AliasName プロパティ（または AliasName は空のままで DatabaseName）に「接続文字列」を設定します。

「接続文字列」とは、次の例に示すように、サーバー上の DSN やサーバーの名前などを含む、ODBC への完全な接続文字列です。

DRIVER={Pervasive ODBC Client Interface};ServerName=DSLINUX2; ServerDSN=DEMODATA; UID=myuserid;PWD=mypassword

メモ：接続文字列には引用符や改行はありません。お使いのエディターで行を折り返している場合、プロパティエディターでは単一行にしてください。

ユーザー名とパスワードが必要な場合、接続文字列の一部としてこれらを含めることができます。接続文字列にユーザー名とパスワードが含まれない場合、LoginPrompt プロパティが True であれば、標準のデータベースログインダイアログが表示されます。

データベースを Connected に設定して通常どおり使用します。

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

•

TPvDatabase と TPvSqlDatabase（VCL と異なる特定のクラス）

•

TPvSqlDatabase に関する注記（VCL と異なる特定のクラス）

TPvQuery

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

TPvQuery と Embarcadero のコンポーネントの機能の相違点

•

TQuery からの継承です。

•

Handle プロパティのタイプが SQLHSTMT に変更されています。

•

DBHandle プロパティのタイプが SQLHDBC に変更されています。

•

StmtHandle プロパティが削除されています。

•

Text プロパティは常に SQL プロパティからのテキストを返します。

•

CheckOpen メソッドが削除されています。

•

'LoadBlobOnOpen' プロパティが True のときは、クエリオープンですべての BLOB がメモリにキャッシュされます。LoadBlobOnOpen が False のときは、BLOB は必要時に読み込まれます。

BookMarksEnabled プロパティ

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

PvQuery.BookmarksEnabled := False

カーソル管理

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

カーソルの種類	動作
ctCached	この設定は旧バージョンで使用可能だった完全キャッシュ、完全静的カーソルマネージャーに相当します。レコードを返す前に ResultSet オブジェクトに各レコードを読み込みます。これはテーブルが大きい場合には速度が遅くなりますが、LookUp などのオペレーション用に開いた後では速くなります。
ctDynamic	この設定がデフォルトです。これはデータベースエンジンの動的カーソルを使用し、ctCached と比較した場合（特に大きなテーブルを扱う場合）、ほとんどのオペレーションでパフォーマンスが大いに向上します。