OLE DB Provider Guide

Pervasive PSQL v11
OLE DB Provider Guide
Developing Applications Using the Pervasive OLE DB Provider
免責事項
Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用者また
はその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記載の契約条件
によってのみ許諾するものです。 Pervasive Software Inc. は、いかなる場合にも本ソフ
トウェアおよび本マニュアルに記載された内容に関するその他の一切の保証を、明示
的にも黙示的にも行いません。 Pervasive Software Inc. は、市場性、権利、特定の目的
に対する適合性、あるいは一連の取引業務や職業的な使用に関する問題などに対し、
一切の保証を行わないことを明示するとともに、利用者およびその会社がこれに同意
したものとします。
商標
Btrieve、 Client/Server in a Box、 Pervasive、 Pervasive Software および Pervasive Software
のロゴは、 Pervasive Software Inc. の登録商標です。
Built on Pervasive Software、 DataExchange、 MicroKernel Database Engine、 MicroKernel Database
Architecture、 Pervasive.SQL、 Pervasive PSQL、 Solution Network、 Ultralight、 ZDBA は Pervasive
Software Inc. の商標です。
Microsoft、 MS-DOS、 Windows、 Windows 95、 Windows 98、 Windows NT、 Windows Me、 Windows
2000、Windows 2003、Windows 2008、Windows 7、Windows 8、Windows Server 2003、Windows Server
2008、 Windows Server 2012、 Windows XP、 Win32、 Win32s、および Visual Basic は、 Microsoft
Corporation の登録商標です。
NetWare および Novell は Novell, Inc. の登録商標です。
NetWare Loadable Module、 NLM、 Novell DOS、 Transaction Tracking System、 TTS は、 Novell, Inc.
の商標です。
Sun、 Sun Microsystems、 Java、および Sun、 Solaris、 Java を含むすべての商標やロゴは、 Sun
Microsystems の商標または登録商標です。
すべての会社名および製品名は各社の商標または登録商標です。
© Copyright 2013 Pervasive Software Inc. All rights reserved. このマニュアルの全文、一部に関わり
なく複製、複写、配布をすることは、前もって発行者の書面による同意がない限り禁止します。
本製品には、 Powerdog Industries により開発されたソフトウェアが含まれています。
© Copyright 1994 Powerdog Industries.All rights reserved.
本製品には、 KeyWorks Software により開発されたソフトウェアが含まれています。
© Copyright 2002 KeyWorks Software.All rights reserved.
本製品には、 DUNDAS SOFTWARE により開発されたソフトウェアが含まれています。
© Copyright 1997-2000 DUNDAS SOFTWARE LTD. All rights reserved.
本製品には、 Apache Software Foundation Foundation （http://www.apache.org/）により開発されたソ
フトウェアが含まれています。
本製品ではフリーソフトウェアの unixODBC Driver Manager を使用しています。これは Peter
Harvey （[email protected]）によって作成され、 Nick Gorham （[email protected]）によ
り変更および拡張されたものに Pervasive Software が一部修正を加えたものです。 Pervasive
Software は、 unixODBC Driver Manager プロジェクトの LGPL 使用許諾契約書に従って、このプ
ロジェクトの現在の保守管理者にそのコード変更を提供します。 unixODBC Driver Manager の
Web ページは www.unixodbc.org にあります。このプロジェクトに関する詳細については、現在
の保守管理者である Nick Gorham （[email protected]）にお問い合せください。
GNU Lesser General Public License （LGPL）は本製品の配布メディアに含まれています。 LGPL は
www.fsf.org/licensing/licenses/lgpl.html でも見ることができます。
OLE DB Provider Guide
2014 年 5 月
目次
このマニュアルについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
このマニュアルの読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
このマニュアルの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
表記上の規則 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
1
Pervasive OLE DB プロバイダーの概要 . . . . . . . . . . . . . . . . . . . . . .
1
Pervasive OLE DB プロバイダーの概要
OLE DB プロバイダーの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
OLE DB プロバイダーのアーキテクチャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
リレーショナルパフォーマンス . .
リモート接続 . . . . . . . . . . . . .
排他的カーソル . . . . . . . . . . . .
ADO Refresh メソッドのサポート . .
以前の OLE DB プロバイダーの確認
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3
3
4
4
4
OLE DB プロバイダーと Visual Studio.NET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
Visual Studio.NET のウィザード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ASP.NET によるセキュリティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
サポートされるオブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
7
7
OLE DB のパフォーマンスに関する考慮点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
キャッシュエンジン . . . . . . . . . . . .
最高パフォーマンスのナビゲーショナル
静的カーソルと動的カーソル . . . . . . .
未使用のサービスを使用不可にする . . .
2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
8
.
.
.
.
8
8
8
8
OLE DB プロバイダーの制限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
Pervasive OLE DB プロバイダーによるプログラミング . . . . . . . . . . . . . 11
Pervasive OLE DB プロバイダーを使用するためのプログラミング概念
データベースへの接続
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
OLE DB プロバイダーへの接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
その他の作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
リモート接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
サポートされる新しい構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
以前のバージョンとの互換性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
排他的カーソル
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
OLE DB 仕様と排他的カーソル . . . . . . . . .
排他的カーソルの構文 . . . . . . . . . . . . . .
排他的カーソルの動作のまとめ . . . . . . . . .
排他的カーソルを使った Visual Basic サンプル
. . . .
. . . .
. . . .
コード
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
14
15
15
15
プログラミング上の注意 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
更新の表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
UNC パスまたはマップされたドライブを使う OLE DB プロバイダーの使用
ADO Refresh メソッドのサポート例 . . . . . . . . . . . . . . . . . . . . . . .
静的カーソルでの Seek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
リモート接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
16
16
17
17
18
iii
目次
テーブル定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
デフォルトのロックタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
初期化プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
COM+ サービスのサポート
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
COM+ サービスとは . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Visual Basic プログラマのための COM+ サービスの例 . . . . . . . . . . . . . . . . . . . . . . . . 20
Execute メソッド（ADO コマンド）
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
SELECT オペレーション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
バッチ挿入、更新および削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3
ADO/OLE DB リファレンス情報 . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Pervasive OLE DB プロバイダーを使用した一般的な操作のリファレンス
OLE DB プロバイダーと Visual Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
非ビジュアルプログラミング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
ビジュアルプログラミング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
接続の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
レコードセットの作成
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
名前付きデータベースを使用する
パスを使用する . . . . . . . . . . .
Location パラメーターを使用する .
既存の接続を使用する . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
27
27
27
27
データ間の移動およびデータ操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
レコードの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
レコードの削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
レコードの更新 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
レコードの検索
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
バッチ更新または即時更新の選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
即時更新モード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
バッチ更新モード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
ADO オブジェクトの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
ブックマークの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
イベントの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Field オブジェクトの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
トランザクションの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
4
Pervasive PSQL OLE DB プロバイダーの実装 . . . . . . . . . . . . . . . . . . 37
サポートされるプロパティ、メソッドおよびイベントのリファレンス
OLE DB プロバイダーの実装リファレンス
Command . . . . . . . . . . . . . . . .
Connection . . . . . . . . . . . . . . .
Field . . . . . . . . . . . . . . . . . . .
Fields . . . . . . . . . . . . . . . . . .
Parameter . . . . . . . . . . . . . . . .
Record . . . . . . . . . . . . . . . . . .
Recordset . . . . . . . . . . . . . . . .
Stream . . . . . . . . . . . . . . . . . .
iv
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
38
38
38
39
40
40
41
41
42
目次
ADOX 実装リファレンス
Catalog . . . . . . .
Columns . . . . . . .
Column . . . . . . .
Group . . . . . . . .
Index . . . . . . . .
Indexes . . . . . . .
Connection . . . . .
Procedure . . . . . .
Tables . . . . . . . .
Table . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Visual Studio.NET 実装リファレンス
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
43
43
43
43
44
44
44
45
45
45
45
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
v
目次
vi
このマニュアルについて
このマニュアルは、 Pervasive PSQL OLE DB プロバイダーについての手引書です。
vii
このマニュアルの読者
このマニュアルは、 Pervasive PSQL に精通し、 OLE DB プロバイダーを使用してアプリケーションを開発したい
ユーザー向けにデザインされています。
viii
このマニュアルの構成
このマニュアルでは、以下の項目について説明します。

第 1 章「Pervasive OLE DB プロバイダーの概要」
この章では、 Pervasive PSQL OLE DB プロバイダーについてご紹介します。

第 2 章「Pervasive OLE DB プロバイダーによるプログラミング」
この章では、 ActiveX Data Objects （ADO）および Pervasive PSQL OLE DB プロバイダーのプログラミング概
念について説明します。

第 3 章「ADO/OLE DB リファレンス情報」
この章では、 Pervasive PSQL OLE DB プロバイダーを使用した一般的なタスクについて説明します。

第 4 章「Pervasive PSQL OLE DB プロバイダーの実装」
この章は、 Pervasive PSQL OLE DB プロバイダーでサポートされるプロパティ、メソッドおよびイベントの
リファレンスです。
ix
表記上の規則
特段の記述がない限り、コマンド構文、コード、およびコード例では、以下の表記が使用されます。
x
大文字小文字の
区別
通常、コマンドと予約語は、大文字で表記されます。本書で
別途記述がない限り、これらの項目は大文字、小文字、ある
いはその両方を使って入力できます。たとえば、 MYPROG、
myprog、または MYprog と入力することができます。
太字
太字で表示される単語には次のようなものがあります。メ
ニュー名、ダイアログボックス名、コマンド、オプション、
ボタン、ステートメントなど。
固定幅フォント
固定幅フォントは、コマンド構文など、ユーザーが入力する
テキストに使われます。
[ ]
省略可能な情報には、［log_name］のように、角かっこが使
用されます。角かっこで囲まれていない情報は必ず指定する
必要があります。
|
縦棒は、 [file name | @file name] のように、入力する情報の選
択肢を表します。
< >
＜＞は、 /D=<5|6|7> のように、必須項目に対する選択肢
を表します。
変数
file name のように斜体で表されている語は、適切な値に置き
換える必要のある変数です。
...
［parameter...］のように、情報の後に省略記号が続く場合は、
その情報を繰り返し使用できます。
::=
記号 ::= は、ある項目が別の項目用語で定義されていること
を意味します。たとえば、 a::=b は、項目 a が b で定義されて
いることを意味します。
Pervasive OLE DB プロバイダーの
概要
1
Pervasive OLE DB プロバイダーの概要
この章では、以下の項目について説明します。

「OLE DB プロバイダーの概要」

「OLE DB プロバイダーのアーキテクチャ」

「OLE DB プロバイダーと Visual Studio.NET」

「OLE DB のパフォーマンスに関する考慮点」

「OLE DB プロバイダーの制限」
1
Pervasive OLE DB プロバイダーの概要
OLE DB プロバイダーの概要
Pervasive OLE DB プロバイダー（ADO も含む）は、 OLE DB コンシューマー（利用者）が使用するためのコン
ポーネントです。
このマニュアルでは、 OLE DB と ADO についての説明は行いません。これらについては、 Microsoft の仕様書で
詳しく説明しています。その代わり、このマニュアルでは Pervasive プロバイダーに関する具体的な事項について
説明しており、新規ユーザーとして初めて作業する際に役立ちます。
このプロバイダーがサポートするのは Pervasive PSQL v11 SP3 エンジンのみです。Pervasive PSQL v11 SP3 の OLE
DB プロバイダーを使用して、以前のバージョンの Pervasive PSQL が動作しているマシンに接続することはでき
ません。
2
OLE DB プロバイダーのアーキテクチャ
OLE DB プロバイダーのアーキテクチャ
Pervasive OLE DB は、 Microsoft が作成した OLE DB プロバイダー仕様の Pervasive Software における実装名です。
リレーショナルアクセスの場合、プロバイダーはネットーワークプロトコルを介してデータベースエンジンに
接続します。サーバーエンジンがリクエストを処理し、そのデータをプロバイダーに戻します。プロバイダーは
必要な処理を行ってクライアントにデータを渡します。プロバイダーは ODBC クライアントインターフェイス
と同じプロトコルを使用します。
次の図は、 OLE DB プロバイダーのアーキテクチャを示しています。
図 1 Pervasive PSQL OLE DB プロバイダーのアーキテクチャ
リレーショナルパフォーマンス
Pervasive OLE DB プロバイダーでは、 ODBC および JDBC ドライバーがリモートサーバーと通信する方法と同様
のアーキテクチャを使用します。サーバー側のリレーショナルエンジンを使用することによって、ストアドプロ
シージャや複雑なクエリを含め、このプロバイダーの使用によるほとんどの SQL ベースのパフォーマンスが向上
します。
リモート接続
接続文字列内で Location パラメーターを使用してリモートサーバーを指定します。
Provider=PervasiveOLEDB;Data Source=MyDBname;Location=MyServer
詳細については、「リモート接続」を参照してください。
3
Pervasive OLE DB プロバイダーの概要
排他的カーソル
データベースプログラミングにおいて、その他のクライアントがレコードのロックに遭遇する可能性が高くなる
リスクを負っても、確実に更新を行うことを優先する必要がある場合があります。
レコードセットを取得してバッチ更新を指定した場合、更新しようとした行が別のクライアントによって更新さ
れていたために、並行性違反が発生する場合があります。排他的カーソルを設定することによってこれらの状況
を回避することができます。
詳細については、「排他的カーソル」を参照してください。
ADO Refresh メソッドのサポート
Pervasive PSQL OLE DB プロバイダーでは、 Command オブジェクトの Parameters コレクションの Refresh メソッ
ドをサポートするので、ストアドプロシージャまたはパラメータークエリからパラメーター情報を取得できま
す。
詳細については、「ADO Refresh メソッドのサポート例」を参照してください。
以前の OLE DB プロバイダーの確認
現在のバージョンとの比較のために、このセクションでは以前のプロバイダーの概要について簡単に説明します。
Pervasive では Pervasive.SQL 2000i リリース Service Pack 2 で初めて OLE DB プロバイダーを装備しました。本リ
リースは第 3 世代のプロバイダーです。
最初のバージョン： Pervasive.SQL 2000i （SP2）
Pervasive の最初のプロバイダーはトランザクショナル（Btrieve）のみでした。リレーショナルアクセスの場合
は、Microsoft の ODBC to OLE DB ブリッジプロバイダーを使用する必要がありました。次の図は、最初の Pervasive
OLE DB プロバイダーのアーキテクチャを示しています。
図 2 最初の OLE DB プロバイダーのアーキテクチャ
4
OLE DB プロバイダーのアーキテクチャ
2 番目のバージョン： Pervasive.SQL 2000i （SP3、 SP4）
Pervasive では、 Pervasive.SQL 2000i でリレーショナルアクセスを可能にする最新のプロバイダーをリリースしま
した。これを使用すれば、開発者は同じ API を使ってリレーショナルアクセスおよびトランザクショナルアク
セスを行うことができます。データへの更新は、トランザクション内でカプセル化することも、リレーショナル
アクセスとトランザクショナルアクセス間でカプセル化することも可能です。さらに、このプロバイダーには
ADOX 機能がいくつか組み込まれており、 SQL 機能に加えてデータベース作成も行うことができました。
図 3 2 番目の OLE DB プロバイダーのアーキテクチャ
この 2 番目のバージョンのプロバイダーには、欠点がいくつかありました。リレーショナルエンジンがこのプロ
バイダーにカプセル化されるために、クライアントベースと見なされていました。このため、プロバイダーは行
ごとにクライアントプロセスとサーバープロセスの境界を越える必要があり、クライアント / サーバー設定の
アプリケーションではパフォーマンスの問題を引き起こしていました。
Pervasive PSQL v11 SP3 バージョンのプロバイダーは、このパフォーマンスの問題を克服するよう設計されていま
す。
Pervasive.SQL 2000i OLE DB プロバイダーの機能
このセクションでは、 Pervasive.SQL 2000i SP3 リリースの Pervasive OLE DB ドライバーに加えられた変更の概要
について説明します。
コマンドベースのレコードセットのサポート
SP3 より前の Pervasive.SQL 2000i に付属の OLE DB プロバイダーには、 SQL ステートメントのサポートが含まれ
ていませんでした。つまり、 Commnad オブジェクトがサポートされておらず、結果セットを正常に開くにはテー
ブル名が必要でした。このバージョンには SQL コマンドのサポートが含まれており、 2.5 仕様に適合しています。
SQL Server プロバイダーや ODBC ブリッジとは異なり、このプロバイダーはコマンドベースまたは完全にナビ
ゲーショナルのいずれの結果セットも開くことができます。さらに、いずれの場合もサーバー側のカーソルは、
前方のみ、静的または動的とすることができます。コマンドベースの結果セットとナビゲーショナル（テーブル
ベース）結果セットを同時に開き、処理することができます。
コマンドベースのレコードセットは SQL エンジンのパワーと柔軟性を提供しますが、サーバー側のナビゲーショ
ナル結果セットはインデックスへの直接アクセスを提供します。この機能はコマンドベースの結果セットでは使
用できません（間接アクセスはクエリオプティマイザーによって提供されます）。インデックスが使用できるこ
とにより、Seek オペレーションを実行することができます。Seek を使用するルーチンは、同じ機能を SQL ステー
トメントを介して実行する同様のルーチンに比べ、非常に効率がよくなっています。適切に使用した場合、特定
5
Pervasive OLE DB プロバイダーの概要
の値を含むレコードにすばやく位置付けることができ、サーバー側のナビゲーショナルレコードセットは、アプ
リケーションのパフォーマンスを向上させます。
ADOX
Pervasive PSQL は、データ定義言語およびセキュリティのための ADO 拡張（ADOX）をサポートしています。
ADOX はテーブルの作成、スキーマ定義の変更、およびデータベーステーブルの内容表示に使用されます。現
在、カタログ、テーブル、列、およびインデックスオブジェクトがサポートされています。テーブルおよびイン
デックスの作成はサポートされていますが、データベースの作成は現在サポートされていません。
プロバイダーのナビゲーショナルレコードセット
ナビゲーショナル結果セットを開くには、 Open メソッドのオプションで adCmdTableDirect を使用する必要があ
ります。以前のバージョンでは、 adCmdTable を使ってナビゲーショナル結果セットを開くことができました。
しかし、ADO はこれを SQL ステートメントの SELECT * FROM SQL に置き換えます。これは結果セットをコマ
ンドベースにし、インデックスが使用できなくなります。
メモ ADO はこれを別のものとして扱うため、コマンドサポートが無効の場合にインデックス機能を利用す
る既存のアプリケーションは、Open メソッド呼び出しで adCmdTableDirect を使用しない限り機能しません。
ラージバイナリオブジェクト（BLOB）
ISequentialStream のサポートが OLE DB プロバイダーに追加されました。 ADO では、これをレコードセットオ
ブジェクトの AppendChunk/GetChunk 機能に変換します。また、 BLOB データとビジュアルコントロールを相互
に転送するための複合データバインディングを行うこともできます。
6
OLE DB プロバイダーと Visual Studio.NET
OLE DB プロバイダーと Visual Studio.NET
このセクションでは、 Pervasive PSQL OLE DB プロバイダーを Visual Studio.NET と併用する場合の留意事項につ
いて説明します。
Visual Studio.NET のウィザード
ADO.NET コードを生成する Visual Studio.NET のウィザードは、 Microsoft プロバイダー向けにのみ設計されてい
ます。このため、 Pervasive PSQL ではこれらのウィザードを使用しないようにしてください。ただし、これらの
ウィザードにはコードを生成する機能しかないので、ウィザードで可能なことはユーザー自身が作成したコード
ですべて行えます。
ASP.NET によるセキュリティ
ASP.NET で動作するには、 ASP.NET および IIS （IUSR_ マシン名）で使用するユーザーアカウントの両方が必ず
以下のファイルおよびディレクトリに読み取り / 書き込みアクセスできるようにしておく必要があります。

データと DDF ファイルがあるディレクトリ

Pervasive バイナリの場所（\pvsw\bin）

dbnames.cfg （お使いのシステムの \winnt または \windows フォルダー内にあります）
サポートされるオブジェクト
Visual Studio.NET でサポートされるオブジェクトの説明については、「Visual Studio.NET 実装リファレンス」を参
照してください。
7
Pervasive OLE DB プロバイダーの概要
OLE DB のパフォーマンスに関する考慮点
このセクションでは OLE DB に関するパフォーマンスの問題について述べます。
キャッシュエンジン
Pervasive PSQL のキャッシュエンジンは、クライアント / サーバー環境で使用すると OLE DB プロバイダーのパ
フォーマンスに影響します。環境に応じて必要であれば Pervasive PSQL Control Center でキャッシュエンジンを
無効にすることができます。これについて最も影響があるのは静的カーソルです。
最高パフォーマンスのナビゲーショナル
サーバー側のナビゲーショナルレコードセットはコマンドベースのレコードセットに比べ、特定の値を含むレ
コードへの位置付けが頻繁に要求されるタスクでは、パフォーマンスの上で非常に有利です。
静的カーソルと動的カーソル
リレーショナルエンジンがテンポラリテーブルを作成しなかった場合、静的カーソルが常にこれを作成します
（テンポラリテーブルの詳細については『SQL Engine Reference』を参照してください）。これは、コマンドベー
スおよびナビゲーショナルテーブル共にそうなります。帯域幅に配慮する必要がない場合は、常にテンポラリ
テーブルを作成することのない動的カーソルがより高いパフォーマンスを生みます。ただし、帯域幅が低い場合
には、往復のコストが高すぎて動的カーソルを受け入れ難いため、その解決策として RDS を使用するとよい場合
があります。 RDS の欠点は、 Microsoft がこれをコマンドベースのみの解決策として実装したことです。つまり、
インデックス機能（Seek の使用）ができません。 RDS ベースとローカルレコードセットで同様に機能する抽象
レイヤーを実装することにより、デプロイメントに関係なくパフォーマンスを維持することができます。この抽
象の性質はアプリケーションの必要性によって異なり、ランタイムビジネスオブジェクトの形を取ることがよく
あります。
未使用のサービスを使用不可にする
OLE DB アプリケーションを開発する際、パフォーマンスを向上させる方法として、使用されていない OLE DB
サービスをオフにすることがあります。詳細については、 DBPROP_INIT_OLEDBSERVICES のドキュメントを参
照してください。
Automatic Transaction Enlistment をオフにすると、セッションの ITransactionJoin インターフェイスのインスタン
スを作成せず、プロバイダーが MTS オブジェクトを検索しないようにします。
8
OLE DB プロバイダーの制限
OLE DB プロバイダーの制限

非同期オペレーションはサポートされません。

Record および Stream オブジェクトはサポートされません。

いったんレコードセットが使用されると、 Index プロパティは静的ナビゲーショナルカーソルに設定するこ
とはできません。レコードセットの Open オペレーションを実行する前にインデックスを適切に設定してく
ださい。レコードセットを開いた後、インデックスは変更できません。
9
Pervasive OLE DB プロバイダーの概要
10
Pervasive OLE DB プロバイダーに
よるプログラミング
2
Pervasive OLE DB プロバイダーを使用するためのプログラミング概念
この章では、以下の項目について説明します。

「データベースへの接続」

「リモート接続」

「排他的カーソル」

「プログラミング上の注意」

「COM+ サービスのサポート」

「Execute メソッド（ADO コマンド）」
11
Pervasive OLE DB プロバイダーによるプログラミング
データベースへの接続
Pervasive OLE DB プロバイダーを使用する場合の一般的な疑問は、データベースへの接続方法です。このセクショ
ンでは、 OLE DB プロバイダーを使用した接続の基本事項について説明します。
OLE DB プロバイダーへの接続
接続文字列
"Provider=PervasiveOLEDB;Data Source= （データベース名またはデータファイルへのパス )"
接続とオープンの例
Private Sub Form_Load()
Dim cn As New ADODB.Connection
Dim rs As New ADODB.Recordset
' これは、特に Client Cursor Engine を使用する場合を除き、
' 常に adUseServer です。
cn.CursorLocation = adUseServer
cn.ConnectionString = "Provider=PervasiveOLEDB;Data Source=Demodata"
cn.Open
rs.Open "Billing", cn, adOpenDynamic, adLockOptimistic, adCmdTableDirect
rs.MoveFirst
MsgBox " 最初の Student ID ： " & rs.Fields("Student_ID")
rs.Close
cn.Close
End Sub
その他の作業
その他の一般的な処理については、第 3 章「ADO/OLE DB リファレンス情報」を参照してください。
12
リモート接続
リモート接続
プロバイダーはネットワークプロトコルを介してデータベースエンジンに接続します。サーバーエンジンがリ
クエストを処理し、そのデータをプロバイダーに戻します。プロバイダーは必要な処理を行ってクライアントに
データを渡します。これは ODBC クライアントと同じプロトコルを使用することによって行います。
サポートされる新しい構文
接続文字列内で Location= パラメーターを使用してリモートサーバーを指定できます。
Provider=PervasiveOLEDB;Data Source=MyDBName;Location=MyServer
メモ Data Source パラメーターは DSN ではなく、データベース名（DBＮame）を指します。 DSN は ODBC
でのみ使用します。
以前のバージョンとの互換性
現在、接続文字列で DDF へのパスを使用している場合はこのメソッドでもサポートします。
Provider=PervasiveOLEDB;Data Source=f:\mydata
以前のバージョンの Pervasive PSQL とは異なり、本リリースでは接続するサーバーにデータベース名が存在して
いる必要があります。
データベース名を指定した場合と Location を指定した場合、あるいはマップされたドライブを指定した場合でも
パフォーマンスに違いはありません。ただし、リモートサーバーに接続する方法としては Location の使用を推奨
しています。 OLE DB プロバイダーでは、マップされたドライブまたは UNC パスを使用した場合にアクセス権の
問題が発生する可能性があります。
メモ接続文字列内で OLE DB プロバイダーを使用し、マップされたドライブまたは UNC パスを Data Source
部分に指定する場合は、「UNC パスまたはマップされたドライブを使う OLE DB プロバイダーの使用」も参
照してください。
13
Pervasive OLE DB プロバイダーによるプログラミング
排他的カーソル
ほかのクライアントがレコードのロックに遭遇する可能性が高くなるリスクを負っても、作成するアプリケー
ションで確実に更新を行うことを優先する必要がある場合は排他的カーソルを使用します。
以前のバージョンの Pervasive PSQL OLE DB プロバイダーでは、排他的カーソルを使用できる ADO パラメーター
adLockPessimistic がサポートされていませんでした。
現在は、このパラメーターを Pervasive の接続文字列の拡張機能と共に使用して排他的カーソルを持つアプリケー
ションを作成することができます。
OLE DB 仕様と排他的カーソル
OLE DB 仕様では排他的カーソルを、「最新のフェッチによって単一行に行われた変更が並行性違反のために失敗
しないことを保証するカーソル」として定義しています。レコードセットを開いた後、バッチ更新されるまでは
しばらく時間がかかります。排他的カーソルを使用することは、この時間のギャップのために発生する並行性の
問題を軽減する 1 つの方法です。
プロバイダーごとに行レベルのロックの実装が異なるので、 OLE DB 仕様の排他的カーソルの定義は意図的に明
確にされていません。ここでは一般的な 2 つの実装について説明します。

（a）読み取り時に行をロックする

（b）更新の開始時に行をロックする
たとえば、次のように連続したイベントがあるとします。
1
クライアント A がレコードセットを開く
2
クライアント A が行を読み込む（a）
3
クライアント A がフィールド 1 を変更する（b）
4
クライアント A がフィールド 2 を変更する
5
クライアント A がその行を更新する
開発者から見た場合の 2 つアルゴリズムの違いは、アルゴリズム（a）では読み取りロックを使用し、アルゴリズ
ム（b）では更新ロックを使用しているという点です。次の表では、これら 2 つのアルゴリズム間の動作の違いに
ついてまとめています。
表 1 読み取りロックと更新ロック
ロックタイプ
動作
読み取りロック
読み取るたびに行をロックします。
最初の Move メソッドで行のロックを解除します。
次の行をロックします。
更新ロック
データが変更されたときに行をロックします。
Update メソッドを呼び出したときに行のロックを
解除します。
読み取りロックを使用することで、開発者は行を読み込んだときに並行性エラーを懸念することなく確実に更新
を行うことができます。ただし、これは読み取る行を常にロックします。更新ロックではデータが変更された場
合に行をロックするだけです。ただし、並行性エラーが発生するのはより遅くなる可能性があります。
このアーキテクチャの変更の詳細については、「OLE DB プロバイダーのアーキテクチャ」を参照してください。
14
排他的カーソル
排他的カーソルの構文
Pervasive の排他的カーソルの実装によって、希望する動作を選択することができます。接続文字列内の排他的
カーソルに関するパラメーターは次のとおりです。

読み取りロックまたは更新ロック（Pessimistic Read Lock=True/False）
Open メソッドの間に、この接続文字列オプションと、排他的カーソルを指定する ADO パラメーター
adLockPessimistic を併用します。
読み取りロックと更新ロックの指定
接続文字列内で Pessimistic Read Lock=True を使用すると、読み取りロックを実行します。次にそのサン
プル接続文字列を示します。
"Provider=PervasiveOLEDB;Data Source=Demodata;Pessimistic Read Lock=True"
更新ロックを実行する場合は、 Pessimistic Read Lock の値を False に変更します。
排他的カーソルの動作のまとめ
次の表では、排他的カーソルオプションを使用する効果についてまとめています。
表 2 排他的ロックのオプションとその動作のマトリックス
Pessimistic Read Lock=
動作
True
読み取り時にレコードをロックします。
既にロックされていた場合はエラーを返します。
False
更新時にレコードをロックします。
既にロックされていた場合はエラーを返します。
排他的カーソルを使った Visual Basic サンプルコード
次の Visual Basic サンプルコードの一部では、読み取りロックの排他的カーソルを使用して DEMODATA サンプ
ルデータベースの Course テーブルを開きます。
Public myRecordSet as ADODB.Recordset
myRecordSet.CursorLocation = adUseServer
myConnString = "Provider=PervasiveOLEDB;Data Source=DEMODATA;Pessimistic Read
Lock=True"
myRecordSet.Open "Course",myConnString, adOpenDynamic, adLockPessimistic,
adCmdTableDirect
myRecordSet.MoveFirst ' 最初のレコードがロックされます
15
Pervasive OLE DB プロバイダーによるプログラミング
プログラミング上の注意
次のセクションでは、 Pervasive OLE DB プロバイダーに関する注意事項を述べます。
更新の表示
adCmdTableDirect を使ってテーブルに行った更新は、コマンドベースのレコードセットから見ることができます。
たとえば、次のように連続したイベントがあるとします。

adCmdTableDirect を使用し、トランザクショナル（Btrieve）方式でテーブルを開く。

テーブルに変更を加え、 Update メソッドを呼び出す。

次に、トランザクショナル方式で行われたテーブルの更新によって変更されたデータを選択する SQL クエリ
を実行する。
このような状況では、トランザクショナル方式で行った更新は SQL クエリに表示されます。
UNC パスまたはマップされたドライブを使う OLE DB プロバイダーの使用
ここでは、接続文字列内で Pervasive OLE DB プロバイダーを使用し、マップされたドライブまたは UNC パスを
Data Source 部分に指定したときに起こる状況について説明します。たとえば、次のようにします。
Provider=PervasiveOLEDB;Data Source=\\servername\path
以前のバージョンのプロバイダーでは、この接続文字列が自動的に正しいデータベース名に解決されました。現
在のプロバイダーを使用すると、この設定でアクセス権の問題が発生する可能性があります。接続文字列内で新
しい Location パラメーターを使用する場合は、アクセス権の問題は発生しません。 Location パラメーターの詳細
については、「リモート接続」を参照してください。
クライアントがサーバーに接続しようとしたときに、そのクライアントのデータソースが UNC パスの場合、プ
ロバイダーはそのパスをデータベース名とサーバー名に解決しなければなりません。 OLE DB プロバイダーがこ
の情報を取得するには、クライアントのユーザーアカウントにそのサーバーの管理者または Power User の権限が
なければいけません。
多くの構成において、クライアントのユーザーアカウントにはこれらの必要なアクセス権がない場合がありま
す。クライアントが必要な権限を持っていない場合、 OLE DB プロバイダーでは図 4 のようなダイアログを表示
します。ユーザーはこのダイアログでデータベース名とサーバー名を入力することができます。
図 4 データベース名とサーバー名を解決するダイアログ
［上記の設定をレジストリに保存しますか？］のチェックをオンにすると、そのエントリは Windows レジストリ
に保存されるので、ここで参照した UNC またはマップされたドライブの場所を対象とするダイアログ（図 4）は
それ以降表示されません。その代わりに、データベース名はレジストリを使って解決され、これによりパフォー
マンスが向上します。使用されるレジストリの場所は次のとおりです。
SOFTWARE\Pervasive Software\OLEDB\Connections
開発者がこのダイアログをエンドユーザーに見せないようにする場合は、Windows のレジストリに必要な情報を
入力することができます。上記のキーの下位に次の書式で入力します。
16
プログラミング上の注意
名前
値
データへの UNC パス
サーバー名 ; データベース名
たとえば、次のようにします。
名前
値
\\myserver\c\pvsw\demodata
myserver;demodata
必要であれば、同じデータベース名を指す複数の UNC エントリを持つことができます。
ADO Refresh メソッドのサポート例
以下に、パラメータークエリとストアドプロシージャを使用した ADO Refresh メソッドの例を示します。
パラメータークエリを使用した例
connstr = "Provider=PervasiveOLEDB;Data Source=Demodata"
cn.Open connstr
cmd.ActiveConnection = cn
cmd.CommandType = adCmdText
cmd.CommandText = "Select * From Room where Building_Name = ?"
' パラメーターを最新の情報に更新
cmd.Parameters.Refresh
cmd.Parameters(0).Value = "Bartold Building"
cmd.Execute
ストアドプロシージャを使用した例
connstr = "Provider=PervasiveOLEDB;Data Source=Demodata"
cn.Open connstr
' ストアドプロシージャの呼び出し
cmd.ActiveConnection = cn
cmd.CommandText = "PROCOUT"
cmd.CommandType = adCmdStoredProc
cmd.Parameters.Refresh
cmd.Execute
Debug.Print cmd.Parameters(0).Value
静的カーソルでの Seek
静的カーソルで Seek を使用するには、結果セットを開く前にインデックスを設定しておく必要があります。たと
えば、次のようにします。
Dim rs AsNew ADODB.Recordset
rs.Index = "segment"
rs.Open "Simple", "Provider=PervasiveOLEDB;Data Source=MyData", adOpenStatic,
adLockOptimistic, adCmdTableDirect
rs.Seek Array(2, 9)
rs.Close
17
Pervasive OLE DB プロバイダーによるプログラミング
リモート接続
Pervasive の OLE DB プロバイダーは、リモート接続を作成することはできません。つまり、接続文字列内でリ
モートサーバーを設定することができません。ただし、同じ機能を実行する代わりの方法があります。

Pervasive プロバイダーでテスト済みの RDS を使用します。

COM+ サービスを使用してビジネスオブジェクトを開発し、 CreateObject を使用してオブジェクトを作成し
ます。たとえば、次のようにします。
Dim m_busObj As projDLL.busObj
rs As New ADODB.Recordset
Set m_busObj = CreateObject("sampProj2.TwoPhaseSampleProduct", "RemoteServer")
Set rs = m_busObj.GetData()
テーブル定義
ITableDefinition は以下の列の作成をサポートしませんが、これはその基盤となる Pervasive PSQL エンジンがサ
ポートしていないためです。

BSTR

WCHAR

VarWChar

LongVarWChar

UserDefined Types

GUID
デフォルトのロックタイプ
LockType を指定しないと、カーソルは即時更新モードに設定されます。これにより、いくつかの影響があります。

すべての変更はすぐにデータベースに転送されます（Update を呼び出す必要がありません）。

Update および UpdateBatch は実際には意味を持ちません（データベースは既に更新されているため）。ただ
し、 Supports メソッドは Update に対しては True を返しますが、 UpdateBatch には False を返します。

GetOriginalValue は使用できません。
GetOriginalValue が使用可能かどうかをプログラムで調べるには、 "Supports" メソッドの引数として adUpdateBatch
を使用する必要があります。たとえば、次のようにします。
if rs.Supports(adUpdateBatch) then
someValue = rs.fields(iCol).OriginalValue
end if
初期化プロパティ
次の表は、 OLE DB の初期化で Pervasive がサポートするプロパティと、それに対応する接続文字列識別子の一覧
です。
表 3 接続文字列識別子
18
接続文字列識別子
プロパティ
Cache Authentication
DBPROP_AUTH_CACHE_AUTHINFO
Connect Timeout
DBPROP_INIT_TIMEOUT
Data Source
DBPROP_INIT_DATASOURCE
Encrypt Password
DBPROP_AUTH_ENCRYPT_PASSWORD
プログラミング上の注意
表 3 接続文字列識別子
接続文字列識別子
プロパティ
Locale Identifier
DBPROP_INIT_LCID
Location
DBPROP_INIT_LOCATION
Password
DBPROP_AUTH_PASSWORD
Persist Encrypted
DBPROP_AUTH_PERSIST_ENCRYPTED
Persist Security Info
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO
User ID
DBPROP_AUTH_USERID
以下のプロパティを設定することもできます。

DBPROP_INIT_HWND

DBPROP_INIT_PROMPT

DBPROP_INIT_ASYNCH

DBPROP_INIT_OLEDBSERVICES
19
Pervasive OLE DB プロバイダーによるプログラミング
COM+ サービスのサポート
このセクションでは、 Pervasive の OLE DB プロバイダーが Microsoft の COM+ サービスとどのように相互作用す
るかについて説明します。
COM+ サービスとは
COM+ （Component Object Model）サービスは Microsoft 固有の技術で、マルチスレッドコンテキスト内のビジネ
スオブジェクトを作成するのに使用されます。 COM+ は主に Visual Basic プログラマのためにデザインされまし
たが、それに限定されません。 COM+ を使用すると、多階層型アプリケーションを迅速に作成できます。また
COM+ は、本来ならば開発者が実装する必要のある多くの利点を備えています。次に COM+ の利点を挙げます。

コンテキスト

同時実行

セキュリティ強化

オブジェクトプーリング

ジャストインタイムアクティベーション

キューコンポーネント

イベント
COM+ の詳細については Microsoft のドキュメントを参照してください。
COM+ サービスは、 MTS （Microsoft Transaction Server）によってもたらされる利点の拡張です。 MTS は Microsoft
の以前のビジネスオブジェクトサーバーの実装です。概して、（Microsoft および Pervasive のドキュメントにあ
る） MTS への参照は、 COM+ サービスと置き換えることができます。
Pervasive の OLE DB プロバイダーは COM+ サービスでサポートされます。COM+ サービス内で行われる ADO 呼
び出しはその他すべての ADO クライアント呼び出しと同様に動作します。
Visual Basic プログラマのための COM+ サービスの例
Visual Basic プログラマは、 MTSTransactionMode プロパティに通じている必要があります。このプロパティを
NoTransactions 以外に設定すると、Microsoft トランザクションが起動されます。この機能の詳細については COM+
サービスのマニュアルを参照してください。
次の例は、Microsoft Transaction Server の使い方を示しています。GetObjectContext の呼び出しを成功させるには、
MTSTransactionMode プロパティを NoTransactions 以外のどれかに設定する必要があります。 Microsoft
Transactions を使用すると、 Microsoft Transaction Coordinator が 2 フェーズコミットを行えるようになります。
Public Function UpdatePayroll(employeeID As Integer, salary As Currency)
On Error GoTo ErrHandler
Dim rs As New ADODB.Recordset
rs.Index = "employeeID"
rs.Open "PayrollTable", "Provider=PervasiveOLEDB;Data Source=CompanyDB",
adOpenDynamic, adLockOptimistic, adCmdTableDirect
rs.Seek employeeID, adSeekFirstEQ
If rs.EOF = True Then
GetObjectContext.SetAbort
Else
rs!salary = salary
End If
rs.Update
rs.Close
rs = Nothing
GetObjectContext.SetComplete
Exit Function
20
COM+ サービスのサポート
ErrHandler:
GetObjectContext.SetAbort
If Not IsNull(rs) Then
If rs.State = adStateOpen Then
rs.Close
End If
End If
rs = Nothing
End Function
一方、接続オブジェクトを使用する ADO トランザクションを使って、このビジネスオブジェクトを書き直すこ
とができます。そうすると、 MTSTransactionMode プロパティを NoTransactions に設定できるようになります。
Microsoft Transactions を使用しなければ、 2 フェーズコミットのオーバーヘッドはなくなります。また、トラン
ザクションをサポートしないオブジェクトはメモリに常駐させることができるのに対し、トランザクションをサ
ポートするオブジェクトは参照されるたびに構築され破壊されます。
Public Function
On Error GoTo
Dim cn As New
Dim rs As New
UpdatePayroll(employeeID As Integer, salary As Currency)
ErrHandler
Connection
ADODB.Recordset
cn.Open "Provider=PervasiveOLEDB;Data Source=CompanyDB"
cn.BeginTrans
rs.Index = "employeeID"
rs.Open "PayrollTable", cn, adOpenDynamic, adLockOptimistic, adCmdTableDirect
rs.Seek employeeID, adSeekFirstEQ
If rs.EOF = True Then
cn.RollbackTrans
Else
rs!salary = salary
End If
rs.Update
rs.Close
cn.CommitTrans
Exit Function
ErrHandler:
cn.RollbackTrans
If Not IsNull(rs) Then
If rs.State = adStateOpen Then
rs.Close
End If
End If
End Function
21
Pervasive OLE DB プロバイダーによるプログラミング
Execute メソッド（ADO コマンド）
Pervasive OLE DB プロバイダーを使用している場合、 Command オブジェクトの Execute メソッドでは、操作の種
類に基づいて RecordsAffected パラメーターが異なる結果を返します。
SELECT オペレーション
SELECT ステートメントを実行している場合、 RecordsAffected は -1 （マイナス 1）を返し、このオプションがサ
ポートされていないことを示します。たとえば、次のようにします。
cn.Open "Provider=PervasiveOLEDB;Data Source=TestData;"
SQLst = "Select * From MyData"
cmd.ActiveConnection = cn
cmd.CommandText = SQLst
Set rs = cmd.Execute(RecordsAffected)
この場合、 RecordsAffected は -1 になります。
SELECT クエリが返すレコード数を取得したい場合は、次の例のように RecordCount プロパティを使用します。
recordcount = rs.RecordCount
' Mydata のレコード数
バッチ挿入、更新および削除
RecordsAffected は、バッチ挿入、更新および削除を実行したときに、オペレーションが影響した正確なレコード
数を返します。
例 - バッチ挿入
cn.Open "Provider=PervasiveOLEDB;Data Source=TestData;"
SQLst = "Insert into MyData(utinyint_, usmallint_, uinteger_, ubigint_, char_,
character_, bit_) Values (1, 12, 13, 100, 'testdata', 'chardata', 1)"
cmd.ActiveConnection = cn
cmd.CommandText = SQLst
cmd.Execute RecordsAffected
この場合、 RecordsAffected は 1 になります。
例 - バッチ更新
SQLst = "Update MyData set char_ = 'SampleTest'
cmd.ActiveConnection = cn
cmd.CommandText = SQLst
cmd.Execute RecordsAffected
where uinteger_ = 13"
この場合、 RecordsAffected は 13 という値を持つすべてのレコード数に相当する x になります。
22
ADO/OLE DB リファレンス情報
3
Pervasive OLE DB プロバイダーを使用した一般的な操作のリファレンス
この章では、以下の項目について説明します。

「OLE DB プロバイダーと Visual Basic」

「接続の作成」

「レコードセットの作成」

「データ間の移動およびデータ操作」

「レコードの検索」

「バッチ更新または即時更新の選択」

「ADO オブジェクトの使用」

「ブックマークの使用」

「イベントの使用」

「Field オブジェクトの使用」

「トランザクションの使用」
23
ADO/OLE DB リファレンス情報
OLE DB プロバイダーと Visual Basic
このセクションには、 Pervasive OLE DB プロバイダーを Visual Basic 開発環境に組み込むのに役立つ情報が含ま
れています。
非ビジュアルプログラミング
この手順は、ビジュアルコントロールオブジェクトを使用しない ADO と OLE DB でのプログラミングの方法を
示しています。
¾
Visual Basic で OLE DB 用のプログラミングを行うには
1
VB 6 で新しいプロジェクトを開きます。
2
［プロジェクト｜参照設定］のメニュー項目をクリックし、参照設定のダイアログを表示します。
3
"Microsoft ActiveX Data Objects 2.1 Library" または "Microsoft ActiveX Data Objects 2.5 Library" が選択されてい
ることを確認して［OK］をクリックします。
4
フォームに 3 つのテキストボックスを追加します。
5
コードウィンドウを表示し、以下のコードを使用してグローバルレコードセットオブジェクトを割り当て
ます（これは General::Declarations コード領域に入れる必要があります）。
Dim myData as New ADODB.Recordset
6
Form::Load
上にレコードセットを作成するには、 Form_Load
イベントに次のコードを記述しください
（DemoData は DBNAMES エントリとして設定してあり、 Person ファイルを使用します）。
myData.CursorLocation = adUseServer
myData.Open "Person", "Provider=PervasiveOLEDB;Data Source=DemoData",
adOpenDynamic, adLockOptimistic, adCmdTableDirect
7
見つかったレコードを表示するために、以下のサブルーチンを作成します。
Private Sub DisplayFields()
Text1 = myData.Fields(0)
Text2 = myData.Fields(1)
Text3 = myData.Fields(2)
End Sub
8
フォームに 4 つのボタンを追加し、以下のコードを追加します。
Private Sub Command1_Click()
myData.MoveFirst
DisplayFields
End Sub
Private Sub Command2_Click()
myData.MovePrevious
DisplayFields
End Sub
Private Sub Command3_Click()
myData.MoveNext
DisplayFields
End Sub
Private Sub Command4_Click()
myData.MoveLast
24
OLE DB プロバイダーと Visual Basic
DisplayFields
End Sub
9
フォームがロードされたときに最初のレコードを取得するために、Form_Load の最後に次の行を追加します。
Command1_Click
10 アプリケーションを実行すると、データ間を移動するためのボタンを使用することができるようになります。
分かりやすくするためにボタンのタイトルや名前を変更することもできます。
11 更新機能を追加するためには、フォームに別のボタンを配置し、そのボタンのキャプションを " 更新 " に、
オブジェクト名を "btnUpdate" にします。
12 以下のコードを追加すると、ユーザーは最初のフィールドを更新できなくなります。並行モードは
adLockOptimistic なので、更新はカーソルが現在の行から移動したときに自動的に適用されます。また、更新
はカーソルの位置に関係なく更新するのに使用することもできます。
Private Sub btnUpdate_Click()
myData.Fields(1) = Text2
myData.Fields(2) = Text3
End Sub
ビジュアルプログラミング
Pervasive プロバイダーには初期化に必須のプロパティが 1 つあります。それは、DataSource プロパティです。OLE
DB プロバイダーは DSN を使用しないので、 DataSource プロパティにはデータベース名の値を設定する必要があ
ります。たとえば、 ADO の Connection::Open コマンドの接続文字列は、「Provider=PervasiveOLEDB;Data
Source=<data store>」になります。この <data store> にはデータベース名を指定します。
¾
プロバイダーを使用して Visual Basic でグリッドを埋めるには
1
Visual Basic 6 を起動します。
2
標準プロジェクトを開始します。
3
［プロジェクト］、［コンポーネント］のメニューオプションをクリックして［コンポーネント］ダイアログ
を表示します。
4
次のコンポーネントのチェックボックスをクリックし、［OK］をクリックします。

Microsoft ADO Data Control 6.0 (OLEDB)
Microsoft DataGrid Control 6.0 (OLEDB)
5
フォーム上にそれぞれのコントロールのコピーをドラッグアンドドロップします。
6
データコントロール上をマウスの右ボタンでクリックし、ショートカットメニューで［ADODC のプロパ
ティ］をクリックします。
7
［作成］をクリックし、接続文字列構築を呼び出します。
8
一覧から "Pervasive OLE DB Provider" を選び、［次へ］をクリックします。
9
DataSource プロパティのためのデータベース名エントリまたはパス名を入力します。
10 ［OK］をクリックします。
11 ［ADODC のプロパティ］ダイアログボックスの［レコードソース］タブをクリックします。
12
ドロップダウンリストを使って、コマンドタイプを "adCmdTable" に変更します。
13 テーブル名を入力するか、ドロップダウンリストからテーブルを 1 つ選択して［OK］をクリックします。
14 グリッドを選択し、 F4 キーを使ってプロパティを編集します。
15
ドロップダウンリストを使って、 DataSource プロパティを "Adodc1" に変更します。
16 アプリケーションを実行します。
25
ADO/OLE DB リファレンス情報
接続の作成
接続を作成するには、 CursorLocation を設定し、 ConnectionString を設定して Open を呼び出すか、または Open 呼
び出しで接続文字列を指定します。
cn.ConnectionString = "Provider=PervasiveOLEDB;Data Source=Demodata"
cn.CursorLocation = adUseServer
cn.Open
または
cn.CursorLocation = adUseServer
cn.Open "Provider=PervasiveOLEDB;Data Source=Demodata"
26
レコードセットの作成
レコードセットの作成
名前付きデータベースを使用する
Pervasive PSQL Control Center で名前付きデータベースを作成することができます。
Control Center のエクスプローラー内で、データベースを作成するデータベースエンジンを右クリックし、［新規
作成｜データベース］を選択します。これは、アプリケーションを中断することなく必要に応じてデータを移動
できるので、データストアを指定する好ましい方法です。アプリケーションから新しいディレクトリを指すため
に必要なのは、サーバーで名前付きデータベースのパス変更することだけです。それぞれのクライアントコン
ピューターで再設定を行うのではなく、 1 つの簡単な作業で済みます。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
パスを使用する
アプリケーションにパスをハードコーディングすることはお勧めしません。しかし、アプリケーションでレジス
トリエントリまたは環境変数からパスを取得することができ、次のような文字列を作成できる場合は、パスを使
用することで、名前付きデータベースを定義することなくデータストアに簡単にアクセスすることができます。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=d:\mydata\mydatabase",
adOpenDynamic, adLockBatchOptimistic, adCmdTableDirect
Location パラメーターを使用する
アプリケーションでパスをハードコーディングするのではなく、接続文字列内で Location パラメーターを使用し
てリモートデータベースに接続することができます。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=DEMODATA;Location=MyRemoteServer", adOpenDynamic, adLockBatchOptimistic,
adCmdTableDirect
既存の接続を使用する
接続を作成し、その接続を使用して複数のレコードセットを作成することができます。これは、各レコードセッ
トに個別の接続を作成するよりも効率的です。
rs.Open "Course", MyExistingConnection, adOpenDynamic, adLockBatchOptimistic,
adCmdTableDirect
27
ADO/OLE DB リファレンス情報
データ間の移動およびデータ操作
レコードセットを一度開くと、 Move x、 MoveFirst、 MoveNext、 MovePrevious および MoveLast を使用してデータ
間を移動することができます。 Move メソッドでは 1 つのパラメーターが必要です。このパラメーターは移動す
るレコード数を指します。負の数を指定すると、カーソルはレコードセットの後方に（最初のレコードに向かっ
て）移動します。
レコードの追加
新しいレコードを追加するには、 AddNew メソッドを使用します。パラメーターは必要ありませんが、呼び出し
の中でフィールドと値を指定することができます。カーソルは新たに追加されるレコードを指すので、移動する
ことなく、直ちにそのフィールドへの更新を行うことができます。
メモ Update または UpdateBatch を呼び出す前に、ヌル値を許可しないフィールドに対しては値を入れておく
必要があります。
即時更新モードでは、空のレコードがデータストアに書き込まれ、フィールドへの更新がそのまま保存されます。
バッチ更新モードでは、空のレコードを作成しますが、そのレコードは Update または UpdateBatch が呼び出され
るまで書き込まれません。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
rs.AddNew
rs!Field1 = 0
rs!Field2 = "TextValue"
rs.UpdateBatch
rs.Close
または
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
rs.AddNew Array("Field1", "Field2"), Array(0, "TextValue")
rs.UpdateBatch
rs.Close
レコードの削除
レコードを削除するには、 Delete メソッドを使用します。オプションパラメーターが 1 つあります。このパラ
メーターは削除するレコードを指します。現在、 Pervasive プロバイダーでサポートするのはデフォルトの
adAffectCurrent のみです。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockOptimistic, adCmdTableDirect
' 削除するレコードへ移動する
rs.Delete adAffectCurrent
rs.Close
28
データ間の移動およびデータ操作
レコードの更新
レコードを更新するには、適切なフィールドに、希望する値を割り当てた後で Update または UpdateBatch を呼び
出します。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
' 更新するレコードへ移動する
rs!Field4 = "Changed text"
rs.UpdateBatch
rs.Close
29
ADO/OLE DB リファレンス情報
レコードの検索
レコードの検索に使用するメソッドは、レコードセットの設定によって異なります。動的なレコードセットの場
合、 Pervasive では Index プロパティと Seek メソッドをサポートします。
Sort メソッドと Find メソッド（静的なクライアント側のカーソルでのみ動作）は Pervasive OLE DB プロバイダー
で提供されていますが、現在はサポートされておらず、 Pervasive ではこれらを使用していません。すべての検索
およびソートにおいて、 Index メソッドと Seek メソッドの方が信頼性が高く、 Pervasive エンジンを直接使用しま
す。これにより、クライアント側のレイヤーの使用に際してパフォーマンスが向上します。
メモ Seek メソッドを使用するには、レコードセットを開くときに dCmdTableDirect を指定する必要がありま
す。
Seek メソッドでは、検索する値を含むバリアント配列が必要です。 1 つまたは複数の列で構成されるインデック
スおよびその値を含む配列を、それぞれ対応する列で比較します。このため、セグメントインデックスがある場
合、現在のインデックスに含まれるセグメント数と等しい要素数でバリアント配列を宣言する必要があります。
rs.Open "Person", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
Dim VariantArray (1) as Variant
VariantArray(0) = "CA"
VariantArray(1) = "Sacramento"
rs.Index = "State_City"
rs.Seek VariantArray adSeekFirstEQ
rs.Close
30
バッチ更新または即時更新の選択
バッチ更新または即時更新の選択
ADO のデフォルトのロックタイプは読み取り専用です。このロックタイプの変更は、レコードセットの Open 呼
び出しでロックタイプパラメーターを指定し、レコードセットにその変更を書き込むのに使用するメソッドを適
用することによって変更できます。
レコードセットを更新するには、即時更新モード、単一行バッチ更新モード、または複数行バッチ更新モードの
いずれかを使用するためにロックタイプを変更します。
即時更新モード
Pervasive.SQL V8 より前の OLE DB プロバイダーではロックタイプに adLockPessimistic をサポートしていません
でした。ロックタイプを指定しない場合、 Update メソッドは必要なく、更新はフィールド単位でデータストア
に書き込まれます。この方法は効率が悪いので、その他のロックタイプが特定のアプリケーションで受け入れら
れないことが判明している場合以外は使用しないでください。
バッチ更新モード
バッチ更新モードには、単一行と複数行があります。
単一行のバッチ更新モード
ロックタイプに adLockOptimistic を使用した場合、変更の書き込みには Update メソッドを使用し、一度に 1 つの
レコードを処理するコードを記述する必要があります。 ADO をレコードセット内のほかの行で動作させるオペ
レーション、または現在行をリフレッシュさせるオペレーションはいずれも、 ADO の暗黙的な Update 呼び出し
をトリガーします。ただし、これは即時更新モードよりも非常に効率的です。以下に、即時更新モードを使用し
てレコードセットを開く例を示します。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockOptimistic, adCmdTableDirect
複数行のバッチ更新モード
ロックタイプに adLockBatchOptimistic を使用した場合、変更の書き込みには UpdateBatch メソッドを使用し、一
度に複数レコードの変更処理を行うコードを記述することができます。
これはパフォーマンスの点から見れば最良のロックタイプですが、アプリケーション設計で ADO が一度に複数
行をキャッシュして更新できるようにする必要があります。このロックタイプが必ずしも、マルチユーザー、ス
ループットの大きいアプリケーションに適しているとは限りません。以下に、バッチ更新モードを使用してレコー
ドセットを開く例を示します。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
31
ADO/OLE DB リファレンス情報
ADO オブジェクトの使用
ADO ではオブジェクトを使ってデータにアクセスし、そのデータをユーザーに提供します。 Microsoft ADO Data
Control を使用している場合は、接続とレコードセットオブジェクトのインスタンスを作成する必要はありませ
ん。ただし、接続とレコードセットの作成と破棄を直ちに行うようにする場合は、インスタンスを作成してから、
後でオブジェクトを破棄する必要があります。さらに、現在出荷されているバージョンの ADO Data Control では、
コードからレコードセットを作成し、コード内でこのレコードセットに ADO Data Control の Recordset プロパティ
を設定する場合にのみ ADO 2.1 の機能（インデックスサポートなど）を使用します（また、これはデフォルトの
ADO 2.0 ではなく、 ADO 2.1 を含めるプロジェクト参照の変更も必要です）。
オブジェクトのインスタンスを作成する場合は、 New キーワードを使用します。オブジェクトの宣言で次のよう
に記述します。
Dim cn as New ADODB.Connection
Dim rs as New ADODB.Recordset
使用する直前で次のように記述します。
Dim
Dim
Set
Set
cn
rs
cn
rs
as ADODB.Connection
as ADODB.Recordset
= New ADODB.Connection
= New ADODB.Connection
これらのオブジェクトを破棄するには、次のように記述します。
Set rs = Nothing
Set cn = Nothing
32
ブックマークの使用
ブックマークの使用
ADO で使用するブックマークは、文書の中で使用する通常のブックマークと同じで、後でその場所を見つけるこ
とができます。これは、データベース内を検索する場合、または複数のテーブルを使用する場合には特に便利で
す。バリアント変数を使用してブックマークを保存します。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTable
' ブックマークを付ける場所へ移動する
SaveMyPlace = rs.Bookmark
' その他の処理を行って、再びブックマークを付けた場所を検索する
rs.Bookmark = SaveMyPlace
rs.Close
ヒント Find メソッドの使用については、「レコードの検索」を参照してください。
33
ADO/OLE DB リファレンス情報
イベントの使用
メモ： ADO イベントを使用する際は、 1 つのイベントでほかのイベントを生成する呼び出しを行わないよう十分
に注意する必要があります。これは、無限ループに陥る可能性が高くなるからです。無限ループが発生する例を
より具体的に挙げると、MoveComplete イベントの代わりに、WillMove イベントを使用してファイルの最後（EOF）
条件を処理する場合です。
Private Sub Adodc1_WillMove(ByVal adReason As ADODB.EventReasonEnum,
adStatus As ADODB.EventStatusEnum, ByVal pRecordset As ADODB.Recordset)
If Adodc1.Recordset.EOF Then Adodc1.Recordset.MoveLast
End Sub
このコードでは、無限ループに陥り、その結果メモリがいっぱいになってスタック領域が不足するエラーが発生
します。このエラーを回避するには、 Adodc1_MoveComplete イベントを使用する必要があります。
34
Field オブジェクトの使用
Field オブジェクトの使用
レコードセット内のフィールドに値を割り当てる場合は、レコードセット名、感嘆符（!）およびフィールドを参
照するフィールド名によって指定することができます。フィールドは番号で参照することもできます。
rs.Open "Course", "Provider=PervasiveOLEDB;Data Source=Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
rs.Fields(8).Value = "Sacramento"
rs!State = "CA"
rs.UpdateBatch
rs.Close
また、 Field オブジェクトのほかのプロパティを使って、フィールドに格納されているデータの詳細情報を調べる
こともできます。たとえば、 ActualSize ではフィールド内のデータの長さを、 OriginalValue ではレコードセット
のこのインスタンスで行った変更前の元の値を、そして Type ではデータ型を知ることができます（あるフィー
ルドの値と別のフィールドの値またはメモリ内の値とを比較する方法を調べる場合に便利です）。
35
ADO/OLE DB リファレンス情報
トランザクションの使用
トランザクションは、 Connection オブジェクトを使って ADO 内に実装されています。トランザクション用に使
用できるメソッドは次のとおりです。

BeginTrans

CommitTrans

RollbackTrans
これらのメソッドにはパラメーターがありません。
ヒントトランザクションを使用するためには、接続を作成し、その接続を使ってレコードセットを作成す
る必要があります。
36
Pervasive PSQL OLE DB プロバイ
ダーの実装
4
サポートされるプロパティ、メソッドおよびイベントのリファレンス
この章では、以下の項目について説明します。

「OLE DB プロバイダーの実装リファレンス」

「ADOX 実装リファレンス」

「Visual Studio.NET 実装リファレンス」
37
Pervasive PSQL OLE DB プロバイダーの実装
OLE DB プロバイダーの実装リファレンス
このセクションでは、 Pervasive の OLE DB プロバイダーの実装に関する詳細をリストします。
メモ非同期のオペレーションはサポートされません。
Command
メソッド
サポート

CreateParameter

Execute
非サポート

Cancel
プロパティ
サポート

ActiveConnection

CommandText

CommandType

Name

Parameters

Prepared

Properties

State
Connection
メソッド
サポート

BeginTrans （ネストされたトランザクションを含む）

CommitTrans

Execute

Open

adConnectUnspecified

OpenSchema

RollbackTrans
非サポート

38
Cancel
OLE DB プロバイダーの実装リファレンス
プロパティ
サポート

Attributes

ConnectionString

CursorLocation

adUseClient は、 Microsoft のクライアントカーソルエンジンについて調査してから使用する必要があり
ます。
Errors

IsolationLevels

adXactRepeatableRead と adXactSerializable
Mode

adModeReadWrite

Properties

Provider

Version
非サポート

CommandTimeout

ConnectionTimeout

DefaultDatabase
イベント
サポート

CommitTransComplete

ConnectComplete

Disconnect

ExecuteComplete

EndOfRecordset

FieldChangeComplete

MoveComplete

RollbackTransComplete

WillExecute

WillChangeField

WillConnect

WillMove
非サポート

InfoMessage
Field
メソッド
サポート

AppendChunk

GetChunk
39
Pervasive PSQL OLE DB プロバイダーの実装
プロパティ
サポート

ActualSize

データベースに保持するサイズを指定します。
これは LongVarBinary と LongVarChar で 65K までのみ正確であり、その後、その長さは GetChunk を使っ
た場合にのみ確認することができます。
Attributes

DataFormat

DefinedSize

Name

NumericScale

OriginalValue

Precision

Properties

Status

Type

Value

非サポート

UnderlyingValue
Fields
メソッド
非サポート

Append

CancelUpdate

Delete

Refresh

Resynch

Update
プロパティ
サポート

Count

Item
Parameter
メソッド
サポート

40
AppendChunk
OLE DB プロバイダーの実装リファレンス
プロパティ
サポート

Attributes

Direction

Name

NumericScale

Precision

Properties

Size

Type

Value
Record
サポートされません
Recordset
メソッド
サポート

AddNew

Cancel

CancelBatch

CancelUpdate

Clone

CompareBookmark

Delete

Find

GetRows

GetString

Move

MoveFirst

MoveLast

MoveNext

MovePrevious

Open

Resync

Save

Seek

adCmdTableDirect を使用した場合にサポートされます
Supports

Update

UpdateBatch

41
Pervasive PSQL OLE DB プロバイダーの実装
非サポート

Requery
プロパティ
サポート

AbsolutePage

AbsolutePosition

ActiveCommand

ActiveConnection

BOF

Bookmark

CacheSize

CursorLocation

CursorType

adOpenStatic、 adOpenDynamic、および adOpenForwardOnly
DataSource

EditMode

EOF

Fields

Filter

ビューをサポートしません
Index

adCmdTableDirect で使用
LockType

adLockOptimistic、 adLockBatchOptimistic、および adLockReadOnly
MarshalOptions

MaxRecords

PageCount

PageSize

Properties

RecordCount

Sort

Source

State

Status

StayInSync

Stream
サポートされません
42
ADOX 実装リファレンス
ADOX 実装リファレンス
このセクションでは、 Pervasive の ADOX のサポートについて説明します。
Catalog
メソッド
非サポート

Create

GetObjectOwner

SetObjectOwner
プロパティ
サポート

ActiveConnection

Tables
非サポート

Groups

Procedures

Users

Views

Properties
Columns
メソッド
サポート

Append

Delete
非サポート

Refresh
プロパティ
サポート

Count

Item
Column
プロパティ
サポート

Attributes
43
Pervasive PSQL OLE DB プロバイダーの実装

DefinedSize

Name

NumericScale

ParentCatalog

Precision

Properties

Type
非サポート

RelatedColumn

SortOrder
Group
サポートされません
Index
プロパティ
サポート

Columns

IndexNulls

Name

Properties

Unique
非サポート

Clustered

PrimaryKey
Indexes
メソッド
サポート

Append

Delete
非サポート

Refresh
プロパティ
サポート

Count

Item
44
ADOX 実装リファレンス
Connection
非サポート
Procedure
非サポート
Tables
メソッド
サポート

Append

Delete
非サポート

Refresh
プロパティ
サポート

Count

Item
Table
プロパティ
サポート

Indexes

Name

ParentCatalog

Type
非サポート

DateCreated

DateModified

Keys
45
Pervasive PSQL OLE DB プロバイダーの実装
Visual Studio.NET 実装リファレンス
ここでは、 Pervasive PSQL で .NET に関してサポートされるプロパティとメソッドの一覧を示します。
OleDbCommand のメソッド
Cancel
CreateParameter
CreateParameter
Dispose
ExecuteNonQuery
メモこのメソッドでは DDL ステートメントの実行時に -1 が返される必要があります。 Pervasive PSQL OLE
DB プロバイダーでは 0 が返されます。
ExecuteReader
CloseConnection
KeyInfo
Default
SingleResult
SingleRow
ExecuteScalar
Prepare
OleDbCommand のプロパティ
Connection
CommandText
CommandTimeout
Transaction
CommandType
Text
Stored Procedure
TableDirect
CommandUpdatedRowSource
OleDbCommandBuilder
すべてサポートされます。
OleDbConnection のメソッド
Open
CreateCommand
Close
DatabaseChange
メモ Pervasive OLEDB では現在のカタログの変更をサポートしません。
BeginTransaction
GetOleDbSchemaTable
Columns
Indexes
ProviderTypes
46
Visual Studio.NET 実装リファレンス
Tables
OleDbConnection のプロパティ
ConnectionString
DataBase
DataSource
Provider
ServerVersion
State
OleDbDataAdapter のメソッド
CreateTableMappings
CloneInternals
Fill
FillSchema
GetFillParameters
OnRowUpdated
OleDbDataAdapter のプロパティ
MissingMappingsAction
MissingSchemaAction
AcceptChangesDuringFill
DeleteCommand
InsertCommand
SelectCommand
UpdateCommand
TableMappings
Columns
Table
Pervasive OLE DB プロバイダーでテストした DataColumn のプロパティ
AllowDBNull
AutoIncrement
AutoIncrementSeed
AutoIncrementStep
ColumnName
DataType
Bit
System.Boolean
Tinyint
System.Int16
Utinyint
System.Byte
Blob
System.Byte[]
Binary(8)
System.Byte[]
Clob
System.String
Char
System.String
Numeric
System.Decimal
BigInt
System.Decimal
47
Pervasive PSQL OLE DB プロバイダーの実装
ColumnName
DataType
UBigInt
System.Decimal
Currency
System.Decimal
Decimal
System.Decimal
Integer
System.Int32
UInt
System.Int64
SmallInt
System.Int16
USmallInt
System.Int32
Double
System.Double
Real
System.Single
Double
System.Double
Date
System.DateTime
Time
System.TimeSpan
TimeStamp
System.DateTime
VarChar
System.String
Identity
System.Int32
SmallIdentity
System.Int16
MaxLength
ReadOnly
Unique
OleDbDataReader のメソッド
Close
Read
GetBoolean
GetByte （次善策： GetInt16 を使用）
GetChar （サポートされません）
GetDateTime
GetDecimal
GetDouble
GetFloat （次善策： GetDouble を使用）
GetInt16
GetInt32
GetInt64 （次善策： GetDecimal を使用）
GetName
GetSchemaTable
GetString
GetTimeSpan
GetValue
GetValues
IsDBNull:
NextResult
48
Visual Studio.NET 実装リファレンス
OleDbDataReader のプロパティ
Depth
Item
FieldCount
IsClosed
RecordsAffected
Pervasive OLE DB プロバイダーでテストした DataSet のメソッド
AcceptChanges
GetChanges
Merge
HasChanges
RejectChanges
Reset
Pervasive OLE DB プロバイダーでテストした DataSet のプロパティ
CaseSensitive
DataSetName
DefaultViewManager
EnforceConstraints
HasErrors
Locale
Table
Pervasive OLE DB プロバイダーでテストした DataTable のメソッド
AcceptChanges
Clear
NewRow
Pervasive OLE DB プロバイダーでテストした DataTable のプロパティ
ChildRelations
Columns
DataSet
Rows
TableName
Pervasive OLE DB プロバイダーでテストした DataRow のメソッド
AcceptChanges
RejectChanges
Delete
IsNull
49
Pervasive PSQL OLE DB プロバイダーの実装
50

Download Report