OLE DB Provider Guide

Pervasive PSQL v9
OLE DB Provider Guide
An Overview of New Features and Changed Behavior
免責事項
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 XP、 Windows Server 2003、 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 2005 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
2006 年 1 月
目次
このマニュアルについて . . . . . . . . . . . . . . . . . . . . . . . . . ix
このマニュアルの読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
このマニュアルの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
表記上の規則. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
1
Pervasive PSQL OLE DB プロバイダの概要 . . . . . . . . . . . . . . . 1-1
Pervasive OLE DB プロバイダの概要
Pervasive ADO および OLE DB サポートの概要 . . . . . . . . . . . . . . . . . . . . . . . . 1-2
OLE DB プロバイダの新機能の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
リレーショナルパフォーマンスの向上 . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
リモート接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
排他的カーソル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
ADO Refresh メソッドのサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Pervasive OLE DB のアーキテクチャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
以前の OLE DB プロバイダの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Pervasive PSQL v9 における Visual Studio.NET のサポート . . . . . . . . . . . . . . . . . . 1-10
Visual Studio.NET のウィザード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
ASP.NET によるセキュリティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
サポートされるオブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
OLE DB のパフォーマンスに関する考慮点 . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
最高パフォーマンスのナビゲーショナル . . . . . . . . . . . . . . . . . . . . . . . . 1-11
静的カーソルと動的カーソル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11
未使用のサービスを使用不可にする . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
OLE DB プロバイダの制限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
2
Pervasive OLE DB プロバイダによるプログラミング . . . . . . . . . . 2-1
Pervasive PSQL OLE DB プロバイダを使用した一般的な操作のリソース
OLE DB プロバイダを使用したデータベースへの接続 . . . . . . . . . . . . . . . . . . . . 2-2
OLE DB プロバイダへの接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
その他の作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
リモート接続. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
サポートされる新しい構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
以前のバージョンとの互換性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
排他的カーソル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
OLE DB 仕様と排他的カーソル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
iii
目次
排他的カーソルの構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
排他的カーソルの動作のまとめ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
排他的カーソルを使った Visual Basic サンプルコード . . . . . . . . . . . . . . . . 2-7
Pervasive OLE DB プロバイダを使用したプログラミング上の注意. . . . . . . . . . . . . 2-8
更新の表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
UNC パスまたはマップされたドライブを使う OLE DB プロバイダの使用 . . . . 2-8
ADO Refresh メソッドのサポート例 . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Pervasive OLE DB プロバイダを使用したプログラミング上の注意. . . . . . . . . . . . . 2-11
静的カーソルを使用した Seek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
リモート接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
テーブル定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
デフォルトのロックタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
初期化プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
COM+ サービスのサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
COM+ サービスとは. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
Visual Basic プログラマのための COM+ サービスの例 . . . . . . . . . . . . . . . . 2-14
Execute メソッド（ADO コマンド） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
SELECT オペレーション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
Batch Insert、 Update および Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
3
ADO/OLE DB リファレンス情報 . . . . . . . . . . . . . . . . . . . . . 3-1
OLE DB プロバイダの使用を始める
Pervasive PSQL OLE DB プログラミング用の Visual Basic のセットアップ . . . . . . . . 3-2
非ビジュアルプログラミング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
ビジュアルプログラミング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
接続の作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
名前付きデータベースを使ったレコードセットの作成 . . . . . . . . . . . . . . . . . . . 3-6
パスを使ったレコードセットの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Location パラメータを使ったレコードセットの作成 . . . . . . . . . . . . . . . . . . . . . 3-8
既存の接続を使用したレコードセットの作成. . . . . . . . . . . . . . . . . . . . . . . . . 3-9
データ間の移動およびデータ操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
レコードの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
レコードの削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
レコードの更新 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
レコードの検索 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
バッチ更新または即時更新の選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
即時更新モード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
バッチ更新モード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
ADO オブジェクトの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
iv
目次
ブックマークの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
イベントの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
Field オブジェクトの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
トランザクションの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
4
Pervasive PSQL OLE DB プロバイダのインプリメンテーション . . . . 4-1
Pervasive の ADO インターフェイスの説明
Pervasive PSQL OLE DB プロバイダのインプリメンテーションリファレンス . . . . . . 4-2
コマンド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Recordset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
ADOX インプリメンテーションリファレンス . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
インデックス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
Visual Studio.NET インプリメンテーションリファレンス . . . . . . . . . . . . . . . . . . 4-13
v
図
1-1
1-2
1-3
2-1
vi
Pervasive PSQL v9 OLE DB プロバイダのアーキテクチャ
最初の OLE DB プロバイダのアーキテクチャ . . . . . . .
2 番目の OLE DB プロバイダのアーキテクチャ . . . . . .
データベース名とサーバー名を解決するダイアログ . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-5
1-6
1-7
2-9
表
2-1
2-2
2-3
読み取りロックと更新ロック . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
排他的ロックのオプションとその動作のマトリックス . . . . . . . . . . . . . . . . 2-7
接続文字列識別子 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
vii
viii
このマニュアルについて
このマニュアルには、本リリースの Pervasive PSQL における新機能や拡張
機能に関する情報が記載されています。本リリースとは、 Pervasive PSQL
v9 を指します。内部バージョン番号は 9.00 です。
このマニュアルでは、本リリースの新機能や従来の最新リリース
Pervasive.SQL V8 SP3 （8.70）からの変更点について説明します。
ix
このマニュアルについて
このマニュアルの読者
このマニュアルは、 Pervasive.SQL に精通し、このソフトウェアの本リリー
スにおける変更点をお知りになりたいユーザー向けにデザインされていま
す。
本ソフトウェアの全般的な使用手順は説明していません。この製品の本リ
リースにおける新機能や変更点のみを説明することを目的としています。
x
このマニュアルの構成
このマニュアルの構成
この『OLE DB Provider Guide』では、最初に新機能の概要を述べ、次にそ
の詳細の章へのリンクを示します。章の構成は以下のとおりです。

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

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

第 3 章「ADO/OLE DB リファレンス情報」
この章では、ADO および OLE DB プログラミングの概要について説明
します。

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

「Pervasive ADO および OLE DB サポートの概要」（1-2 ページ）

「OLE DB プロバイダの新機能の概要」（1-3 ページ）

「Pervasive OLE DB のアーキテクチャ」（1-5 ページ）

「Pervasive PSQL v9 における Visual Studio.NET のサポート」

「OLE DB のパフォーマンスに関する考慮点」（1-11 ページ）

「OLE DB プロバイダの制限」（1-13 ページ）
1-1
Pervasive PSQL OLE DB プロバイダの概要
Pervasive ADO および OLE DB サポートの概要
Pervasive OLE DB プロバイダは、ADO などの OLE DB ユーザーと共に利用
します。
このマニュアルでは、OLE DB と ADO について説明していません。これら
については、 Microsoft の仕様書で詳しく説明しています。その代わり、こ
のマニュアルでは Pervasive プロバイダに関する具体的な事項について説
明しており、新規ユーザーとして初めて作業する際に役立ちます。
1-2
OLE DB プロバイダの新機能の概要
OLE DB プロバイダの新機能の概要
このセクションでは、Pervasive PSQL v9 リリースの Pervasive OLE DB ドラ
イバに加えられた変更の概要について説明します。この新しいプロバイダ
がサポートするのは Pervasive PSQL v9 エンジンのみです。 Pervasive PSQL
v9 の OLE DB プロバイダを使用して、以前のバージョンの Pervasive.SQL
が動作しているマシンに接続することはできません。
このプロバイダに追加された主な機能は次のとおりです。

プロバイダを使用したリレーショナル
マンスの向上

Location パラメータ

排他的カーソル

ADO Refresh メソッドのサポート
データベース操作のパフォー
リレーショナルパフォーマンスの向上
Pervasive OLE DB プロバイダでは、 ODBC および JDBC ドライバがリモー
トサーバーと通信する方法と同様のアーキテクチャを使用するようにな
りました。サーバー側のリレーショナルエンジンを使用することによっ
て、ストアドプロシージャや複雑なクエリを含め、このプロバイダの使用
によるほとんどの SQL ベースのパフォーマンスが向上します。
パフォーマンスの向上を可能にするプロバイダへの変更点の詳細情報につ
いては、「Pervasive OLE DB のアーキテクチャ」（1-5 ページ）を参照して
ください。
リモート接続
Pervasive PSQL v9 より前の Pervasive.SQL と共に出荷された OLE DB プロ
バイダには、リモート接続のサポートが含まれていませんでした。つまり、
リモートサーバーにマップされたドライブを作成し、リモートデータベー
スを指定するために DDF への完全なパスを使用する必要がありました。本
リリースでは接続文字列内で Location パラメータを使用してリモート
サーバーを指定できるようになりました。この新しいパラメータの使用は
従来のリモート接続の作成に比べ、より効率的で適切な方法です。
Provider=PervasiveOLEDB;Data
Source=MyDBname;Location=MyServer
詳細については、「リモート接続」（2-3 ページ）を参照してください。
1-3
Pervasive PSQL OLE DB プロバイダの概要
排他的カーソル
データベースプログラミングにおいて、その他のクライアントがレコード
のロックに遭遇する可能性が高くなるリスクを負っても、確実に更新を行
うことを優先する必要がある場合があります。
レコードセットを取得してバッチ更新を指定した場合、更新しようとした
行が別のクライアントによって更新されていたために、並行性違反が発生
する場合があります。排他的カーソルを設定することによってこれらの状
況を回避することができます。
詳細については、「排他的カーソル」（2-5 ページ）を参照してください。
ADO Refresh メソッドのサポート
Pervasive PSQL v9 OLE DB プロバイダでは、 Command オブジェクトの
Parameters コレクションの Refresh メソッドをサポートするので、ストアド
プロシージャまたはパラメータクエリからパラメータ情報を取得できま
す。
詳細については、「ADO Refresh メソッドのサポート例」（2-10 ページ）を
参照してください。
1-4
Pervasive OLE DB のアーキテクチャ
Pervasive OLE DB のアーキテクチャ
Pervasive OLE DB は、 Microsoft が作成した OLE DB プロバイダ仕様の
Pervasive Software のインプリメンテーションの名前です。
リレーショナルアクセスの場合、プロバイダはネットーワークプロトコル
を介してエンジンに接続できるようになりました。サーバーエンジンがリ
クエストを処理し、そのデータをプロバイダに戻します。プロバイダは必
要な処理を行ってクライアントにデータを渡します。プロバイダは ODBC
クライアントインターフェイスと同じプロトコルを使用します。
この新しいアーキテクチャがもたらしたのは、 ADO プログラマが ODBC
を必要としなくなったことです。これは OLE DB プロバイダとのパフォー
マンスの差によるものです。この新しいプロバイダを使用すれば、リレー
ショナルアクセスの速度で OLE DB が ODBC に劣ることはありません。
トランザクショナルアクセスは本リリースでは変更されていません。トラ
ンザクショナルエンジンへのクライアント / サーバーアクセスではパ
フォーマンスが低下するため、トランザクショナルエンジンは現在もクラ
イアント側にあります。
次の図は、新しいプロバイダのアーキテクチャを示しています。
図 1-1 Pervasive PSQL v9 OLE DB プロバイダのアーキテクチャ
1-5
Pervasive PSQL OLE DB プロバイダの概要
以前の OLE DB プロバイダの確認
現在のバージョンとの比較のために、このセクションでは以前のプロバイ
ダの概要について簡単に説明します。 Pervasive では Pervasive.SQL 2000 リ
リース Service Pack 2 で初めて OLE DB プロバイダを出荷しました。
Pervasive PSQL v9 で Pervasive は第三世代のプロバイダを出荷しています。
最初のバージョン： Pervasive.SQL 2000 （SP2）
Pervasive の最初のプロバイダはトランザクショナル（Btrieve）のみでした。
リレーショナルアクセスの場合は、 Microsoft の ODBC to OLE DB ブリッ
ジプロバイダを使用する必要がありました。次の図は、最初の Pervasive
OLE DB プロバイダのアーキテクチャを示しています。
図 1-2 最初の OLE DB プロバイダのアーキテクチャ
1-6
Pervasive OLE DB のアーキテクチャ
2 番目のバージョン： Pervasive.SQL 2000i （SP3、 SP4）
Prvasive では、 Pervasive.SQL 2000i でリレーショナルアクセスを可能にす
る最新のプロバイダをリリースしました。これを使用すれば、開発者は同
じ API を使ってリレーショナルアクセスおよびトランザクショナルアク
セスを行うことができます。データへの更新は、トランザクション内でカ
プセル化することも、リレーショナルアクセスとトランザクショナルアク
セス間でカプセル化することも可能です。さらに、このプロバイダには
ADOX 機能がいくつか組み込まれており、SQL 機能に加えてデータベース
作成も行うことができました。
図 1-3 2 番目の OLE DB プロバイダのアーキテクチャ
この 2 番目のバージョンのプロバイダには、欠点がいくつかありました。
リレーショナルエンジンがこのプロバイダにカプセル化されるために、ク
ライアントベースと見なされていました。このため、プロバイダは行ごと
にクライアントプロセスとサーバープロセスの境界を越える必要があり、
クライアント / サーバー設定のアプリケーションではパフォーマンスの問
題を引き起こしていました。
Pervasive PSQL v9 バージョンのプロバイダは、このパフォーマンスの問題
を克服するよう設計されています。
Pervasive.SQL 2000 OLE DB プロバイダの機能
このセクションでは、Pervasive.SQL 2000 SP3 リリースの Pervasive OLE DB
ドライバに加えられた変更の概要について説明します。
1-7
Pervasive PSQL OLE DB プロバイダの概要
コマンドベースのレコードセットのサポート
SP3 より前の Pervasive.SQL 2000 と共に出荷された OLE DB プロバイダに
は、 SQL ステートメントのサポートが含まれていませんでした。つまり、
Commnad オブジェクトがサポートされておらず、結果セットを正常に開く
にはテーブル名が必要でした。このバージョンには SQL コマンドのサポー
トが含まれており、 2.5 仕様に適合しています。 SQL Server プロバイダや
ODBC ブリッジとは異なり、このプロバイダはコマンドベースまたは完全
にナビゲーショナルのいずれの結果セットも開くことができます。さらに、
いずれの場合もサーバー側のカーソルは、前方のみ、静的または動的とす
ることができます。コマンドベースの結果セットとナビゲーショナル
（テーブルベース）結果セットを同時に開き、処理することができます。
コマンドベースのレコードセットは SQL エンジンのパワーと柔軟性を提
供しますが、サーバー側のナビゲーショナル結果セットはインデックスへ
の直接アクセスを提供します。この機能はコマンドベースの結果セットで
は使用できません（間接アクセスはクエリオプティマイザによって提供さ
れます）。インデックスが使用できることにより、 Seek オペレーションを
実行することができます。Seek を使用するルーチンは、同じ機能を SQL ス
テートメントを介して実行する同様のルーチンに比べ、非常に効率がよく
なっています。適切に使用した場合、特定の値を含むレコードにすばやく
位置付けることができ、サーバー側のナビゲーショナルレコードセット
は、アプリケーションのパフォーマンスを向上させます。
ADOX
Pervasive PSQL は、データ定義言語およびセキュリティのための ADO 拡張
（ADOX）をサポートしています。 ADOX はテーブルの作成、スキーマ定
義の変更、およびデータベーステーブルの内容表示に使用されます。現在、
カタログ、テーブル、列、およびインデックスオブジェクトがサポートさ
れています。テーブルおよびインデックスの作成はサポートされています
が、データベースの作成は現在サポートされていません。
プロバイダのナビゲーショナルレコードセット
ナビゲーショナル結果セットを開くには、 Open メソッドのオプションで
adCmdTableDirect を使用する必要があります。以前のバージョンでは、
adCmdTable を使ってナビゲーショナル結果セットを開くことができまし
た。しかし、 ADO はこれを SQL ステートメントの SELECT * FROM SQL
に置き換えます。これは結果セットをコマンドベースにし、インデックス
が使用できなくなります。
1-8
Pervasive OLE DB のアーキテクチャ
メモ ADO はこれを別のものとして扱うため、コマンドサポートが無
効の場合にインデックス機能を利用する既存のアプリケーションは、
Open メソッド呼び出しで adCmdTableDirect を使用しない限り機能し
ません。
ラージバイナリオブジェクト（BLOB）
ISequentialStream のサポートが OLE DB プロバイダに追加されました。
ADO では、これをレコードセットオブジェクトの AppendChunk/GetChunk
機能に変換します。また、 BLOB データとビジュアルコントロールを相互
に転送するための複合データバインディングを行うこともできます。
1-9
Pervasive PSQL OLE DB プロバイダの概要
Pervasive PSQL v9 における Visual Studio.NET のサポート
このセクションでは、 Pervasive PSQL v9 を 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 インプリメンテーションリファレンス」（4-13 ページ）
を参照してください。
1-10
OLE DB のパフォーマンスに関する考慮点
OLE DB のパフォーマンスに関する考慮点
プロバイダのリレーショナル側において、そのパフォーマンスは以前のリ
リースから格段に向上しました。
接続が切断されたカーソルや複雑な SQL クエリを含め、ODBC のパフォー
マンスが Pervasive OLE DB プロバイダのパフォーマンスを上回るようなこ
とがなくなりました。
メモ Pervasive PSQL のキャッシュエンジンは、クライアント / サー
バー環境で使用すると OLE DB プロバイダのパフォーマンスに影響し
ます。環境に応じて必要であれば Pervasive Control Center でキャッシュ
エンジンを無効にすることができます。これについて最も影響がある
のは静的カーソルです。
プロバイダに行ったアーキテクチャの変更点については、「Pervasive OLE
DB のアーキテクチャ」（1-5 ページ）を参照してください。
最高パフォーマンスのナビゲーショナル
前に述べたように、サーバー側のナビゲーショナルレコードセットはコマ
ンドベースのレコードセットに比べ、特定の値を含むレコードへの位置付
けが頻繁に要求されるタスクでは、パフォーマンスの上で非常に有利です。
静的カーソルと動的カーソル
静的カーソルは、リレーショナルエンジンによって作成されなかった場合
は常にテンポラリテーブルを作成します（テンポラリテーブルの詳細につ
いては『SQL Engine Reference』を参照してください）。これは、コマンド
ベースおよびナビゲーショナルテーブル共にそうなります。帯域幅が問題
にならない場合は、動的カーソルが、テンポラリテーブルをいつも作成し
ないので、より高いパフォーマンスを提供します。ただし、帯域幅が低い
場合は、動的カーソルを容認するには往復のコストは高いものとなるため、
その解決策として RDS を使用するとよい場合があります。 RDS の欠点は、
Microsoft がこれをコマンドベースのみの解決策として実装したことで、イ
ンデックス機能（Seek の使用）ができないことを意味します。 RDS ベース
とローカルレコードセットで同様に働く抽象レイヤを実装することによ
り、展開に関係なくパフォーマンスは維持されます。この抽象の性質は、
アプリケーションの要求に依存し、よくランタイムビジネスオブジェクト
の形を取ります。
1-11
Pervasive PSQL OLE DB プロバイダの概要
未使用のサービスを使用不可にする
OLE DB アプリケーションを開発する際、パフォーマンスを向上させる方
法として、使用されていない OLE DB サービスをオフにすることがありま
す。詳細については、 DBPROP_INIT_OLEDBSERVICES のドキュメントを
参照してください。
Automatic Transaction Enlistment をオフにすると、セッションの ITransactionJoin
インターフェイスのインスタンスを作成せず、プロバイダが MTS オブジェ
クトを検索しないようにします。
1-12
OLE DB プロバイダの制限
OLE DB プロバイダの制限

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

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

いったんレコードセットが使用されると、 Index プロパティは静的ナ
ビゲーショナルカーソルに設定することはできません。レコードセッ
トの Open オペレーションを実行する前にインデックスを適切に設定
してください。レコードセットをオープンした後、インデックスは変
更できません。
1-13
Pervasive PSQL OLE DB プロバイダの概要
1-14
Pervasive OLE DB プロバイダ
によるプログラミング
2
Pervasive PSQL OLE DB プロバイダを使用した一般的な操作のリソース
この章は、以下の概要セクションから構成されています。

「OLE DB プロバイダを使用したデータベースへの接続」（2-2 ページ）

「リモート接続」（2-3 ページ）

「排他的カーソル」（2-5 ページ）

「Pervasive OLE DB プロバイダを使用したプログラミング上の注意」
（2-11 ページ）

「COM+ サービスのサポート」（2-14 ページ）

「Execute メソッド（ADO コマンド）」（2-17 ページ）
2-1
Pervasive OLE DB プロバイダによるプログラミング
OLE DB プロバイダを使用したデータベースへの接続
Pervasive OLE DB プロバイダを使用する場合の一般的な疑問は、データ
ベースへの接続方法です。このセクションでは、 OLE DB プロバイダを使
用した接続の基本を説明します。
OLE DB プロバイダへの接続
接続文字列
"Provider=PervasiveOLEDB;Data Source= （データファイルの
DB 名またはパス )"
接続とオープンの例
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 リファレンス
情報」を参照してください。
2-2
リモート接続
リモート接続
以前のバージョンのプロバイダでは、リモートアクセスするためには DDF
への完全なパスを指定する必要がありました。
現在、プロバイダはネットーワークプロトコルを介してエンジンに接続で
きるようになりました。サーバーエンジンがリクエストを処理し、その
データをプロバイダに戻します。プロバイダは必要な処理を行ってクライ
アントにデータを渡します。これは ODBC クライアントと同じプロトコル
を使用することによって行います。
トランザクショナルアクセスは変更されていません。トランザクショナル
エンジンをリモート操作するとパフォーマンスが低下するので、このエン
ジンは現在もクライアント側にあります。
サポートされる新しい構文
接続文字列内で Location= パラメータを使用してリモートサーバーを指
定できます。
Provider=PervasiveOLEDB;Data
Source=MyDBname;Location=MyServer
メモ Data Source パラメータは DSN ではなく、データベース名
（DBname）を指します。 DSN は ODBC でのみ使用します。
以前のバージョンとの互換性
現在、接続文字列で DDF へのパスを使用している場合でも、Pervasive PSQL
v9 でサポートします。
Provider=PervasiveOLEDB;Data Source=f:\mydata
以前のバージョンの Pervasive.SQL とは異なり、本リリースでは接続する
サーバーにデータベース名が存在している必要があります。
データベース名を指定した場合と Location を指定した場合、あるいはマッ
プされたドライブを指定した場合でもパフォーマンスに違いはありませ
ん。ただし、リモートサーバーに接続する方法としては現在 Location の使
用を推奨しています。 Pervasive PSQL v9 プロバイダでは、マップされたド
ライブまたは UNC パス使用した場合にアクセス権の問題が発生する可能
性があります。
2-3
Pervasive OLE DB プロバイダによるプログラミング
メモ接続文字列内で OLE DB プロバイダを使用し、マップされたド
ライブまたは UNC パスを Data Source 部分に指定する場合は、「UNC
パスまたはマップされたドライブを使う OLE DB プロバイダの使用」
（2-8 ページ）も参照してください。
2-4
排他的カーソル
排他的カーソル
ほかのクライアントがレコードのロックに遭遇する可能性が高くなるリス
クを負っても、作成するアプリケーションで確実に更新を行うことを優先
する必要がある場合は排他的カーソルを使用します。
以前のバージョンの Pervasive.SQL 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-5
Pervasive OLE DB プロバイダによるプログラミング
開発者側から見れば、この 2 つアルゴリズムの違いは、アルゴリズム（a）
では読み取りロックを使用し、アルゴリズム（b）では更新ロックを使用し
ているという点です。次の表では、これら 2 つのアルゴリズム間の動作の
違いについてまとめています。
表 2-1
読み取りロックと更新ロック
ロックタイプ
動作
読み取りロック
読み取るたびに行をロックします。
最初の Move メソッドで行のロックを解除します。
次の行をロックします。
更新ロック
データが変更されたときに行をロックします。
Update メソッドを呼び出したときに行のロックを
解除します。
読み取りロックを使用することで、開発者は行を読み込んだときに並行性
エラーを懸念することなく確実に更新を行うことができます。ただし、こ
れは読み取る行を常にロックします。更新ロックではデータが変更された
場合に行をロックするだけです。ただし、並行性エラーが発生するのはよ
り遅くなる可能性があります。
このアーキテクチャの変更の詳細については、「Pervasive OLE DB のアーキ
テクチャ」（1-5 ページ）を参照してください。
排他的カーソルの構文
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-6
排他的カーソル
排他的カーソルの動作のまとめ
次の表では、排他的カーソルオプションを使用する効果についてまとめて
います。
表 2-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 ' 最初のレコードがロックされます
2-7
Pervasive OLE DB プロバイダによるプログラミング
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
以前のバージョンのプロバイダでは、この接続文字列が自動的に正しい
データベース名に解決されました。 Pervasive PSQL v9 プロバイダでは、こ
の設定でアクセス権の問題が発生する可能性があります。接続文字列内で
新しい Location パラメータを使用する場合は、アクセス権の問題は発生し
ません。 Location パラメータの詳細については、「リモート接続」（2-3 ペー
ジ）を参照してください。
クライアントがサーバーに接続しようとしたときに、そのクライアントの
データソースが UNC パスの場合、プロバイダはそのパスをデータベース
名とサーバー名に解決しなければなりません。 OLE DB プロバイダがこの
情報を取得するには、クライアントのユーザーアカウントにそのサーバー
の管理者または Power User の権限がなければいけません。
多くの設定の中で、クライアントのユーザーアカウントにはこれらの必要
なアクセス権がない場合があります。クライアントが必要な権限を持って
いない場合、 OLE DB プロバイダでは図 2-1 （2-9 ページ）のようなダイア
2-8
Pervasive OLE DB プロバイダを使用したプログラミング上の注意
ログを表示します。ユーザーはこのダイアログでデータベース名とサー
バー名を入力することができます。
図 2-1 データベース名とサーバー名を解決するダイアログ
［上の設定をレジストリに保存しますか？］のチェックをオンにすると、そ
のエントリは Windows レジストリに保存されるので、ここで参照した UNC
またはマップされたドライブの場所を対象とするダイアログ（図 2-1）は
それ以降表示されません。その代わりに、データベース名はレジストリを
使って解決され、これによりパフォーマンスが向上します。使用されるレ
ジストリのロケーションは次のとおりです。
SOFTWARE\Pervasive Software\OLEDB\Connections
開発者がこのダイアログをエンドユーザーに見せないようにする場合は、
Windows のレジストリに必要な情報を入力することができます。上記の
キーの下位に次の書式で入力します。
名前
値
データへの UNC パス
サーバー名 ; データベース名
たとえば、次のようになります。
名前
値
\\myserver\c\pvsw\demodata
myserver;demodata
必要であれば、同じデータベース名を指す複数の UNC エントリを持つこ
とができます。
2-9
Pervasive OLE DB プロバイダによるプログラミング
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 = ?"
'Refresh パラメータ
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
2-10
Pervasive OLE DB プロバイダを使用したプログラミング上の注意
Pervasive OLE DB プロバイダを使用したプログラミング上の
注意
以下のセクションでは、 Pervasive OLE DB プロバイダについての注意の一
覧を示します。
静的カーソルを使用した 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
リモート接続
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
2-11
Pervasive OLE DB プロバイダによるプログラミング

LongVarWChar

UserDefined Types

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

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

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

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

DBPROP_INIT_HWND

DBPROP_INIT_PROMPT

DBPROP_INIT_ASYNCH

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

コンテキスト

並行性

セキュリティの追加

オブジェクトのプーリング

ジャストインタイムのアクティブ化

待ち行列に入れられるコンポーネント

イベント
COM+ の詳細については Microsoft のドキュメントを参照してください。
COM+ サービスは MTS （Microsoft Transaction Server）によって提供される
利点の拡張です。 MTS は Microsoft の以前のビジネスオブジェクトサー
バーインプリメンテーションです。一般的に、 MTS への参照（Microsoft
および Pervasive ドキュメントにある）が COM+ サービスによって置き換
えられます。
Pervasive の OLE DB プロバイダは COM+ サービスでサポートされます。
COM+ サービス内で行われる ADO 呼び出しはその他すべての ADO クラ
イアント呼び出しと同様に動作します。
Visual Basic プログラマのための COM+ サービスの例
Visual Basic プログラマは、 MTSTransactionMode プロパティに通じている
必要があります。このプロパティに NoTransactions 以外を設定すると、
Microsoft Transactions を起動します。この機能の詳細については COM+
サービスのマニュアルを参照してください。
次の例は Microsoft Transactions の使用法を示します。GetObjectContext の呼
び出しを成功させるには、 MTSTransactionMode プロパティに NoTransactions
以外を設定する必要があります。 Microsoft Transactions を使用すると、
Microsoft Transaction Coordinator が 2 段階のコミットを行えるようになります。
2-14
COM+ サービスのサポート
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
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 UpdatePayroll(employeeID As
Integer, salary As Currency)
On Error GoTo ErrHandler
Dim cn As New Connection
Dim rs As New ADODB.Recordset
cn.Open "Provider=PervasiveOLEDB;Data
Source=CompanyDB"
cn.BeginTrans
2-15
Pervasive OLE DB プロバイダによるプログラミング
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
2-16
Execute メソッド（ADO コマンド）
Execute メソッド（ADO コマンド）
Pervasive OLE DB プロバイダを使用する場合、コマンドの 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 のレコード数
Batch Insert、 Update および Delete
RecordsAffected は、 Batch Insert、 Update、 Delete を実行したときに、オペ
レーションが影響した正確なレコード数を返します。
例 - Batch Insert
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 に等しくなります。
2-17
Pervasive OLE DB プロバイダによるプログラミング
例 - Batch Update
SQLst = "Update MyData set char_ = ‘SampleTest’
uinteger_ = 13"
cmd.ActiveConnection = cn
cmd.CommandText = SQLst
cmd.Execute RecordsAffected
where
この場合、 RecordsAffected は x に等しくなり、 13 という値を持つすべての
レコード数になります。
2-18
ADO/OLE DB リファレンス情報
3
OLE DB プロバイダの使用を始める
この章では、 Pervasive の ADO インターフェイスについて説明します。こ
の章では、以下の項目について説明します。

「Pervasive PSQL OLE DB プログラミング用の Visual Basic のセット
アップ」（3-2 ページ）

「接続の作成」（3-5 ページ）

「名前付きデータベースを使ったレコードセットの作成」（3-6 ページ）

「パスを使ったレコードセットの作成」（3-7 ページ）

「Location パラメータを使ったレコードセットの作成」（3-8 ページ）

「既存の接続を使用したレコードセットの作成」（3-9 ページ）

「データ間の移動およびデータ操作」（3-10 ページ）

「レコードの検索」（3-12 ページ）

「バッチ更新または即時更新の選択」（3-13 ページ）

「ADO オブジェクトの使用」（3-15 ページ）

「ブックマークの使用」（3-16 ページ）

「イベントの使用」（3-17 ページ）

「Field オブジェクトの使用」（3-18 ページ）

「トランザクションの使用」（3-19 ページ）
3-1
ADO/OLE DB リファレンス情報
Pervasive PSQL 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
3-2
Pervasive PSQL OLE DB プログラミング用の Visual Basic のセットアップ
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
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
3-3
ADO/OLE DB リファレンス情報
ビジュアルプログラミング
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 アプリケーションを実行します。
3-4
接続の作成
接続の作成
接続を作成するには、 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"
3-5
ADO/OLE DB リファレンス情報
名前付きデータベースを使ったレコードセットの作成
名前付きデータベースは Pervasive PSQL Control Center で作成することがで
きます。
Control Center のエクスプローラ内で、データベースを作成するデータベー
スエンジンを右クリックし、［新規作成｜データベース］を選択します。こ
れは、アプリケーションを中断することなく必要に応じてデータを移動で
きるので、データストアを指定する好ましい方法です。アプリケーション
から新しいディレクトリを指すために必要なのは、サーバーで名前付き
データベースのパス変更することだけです。それぞれのクライアントコン
ピュータで再設定を行うのではなく、 1 つの簡単な作業で済みます。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=Demodata", adOpenDynamic, adLockBatchOptimistic,
adCmdTableDirect
3-6
パスを使ったレコードセットの作成
パスを使ったレコードセットの作成
アプリケーションにパスをハードコーディングすることはお勧めしませ
ん。しかし、アプリケーションでレジストリエントリまたは環境変数から
パスを取得することができ、次のような文字列を作成できる場合は、パス
を使用することで、名前付きデーターベースを定義することなくデータス
トアに簡単にアクセスすることができます。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=C:\Pvsw\Demodata", adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
3-7
ADO/OLE DB リファレンス情報
Location パラメータを使ったレコードセットの作成
アプリケーションでパスをコード記述するのではなく、接続文字列内で
Location パラメータを使用してリモートデータベースに接続することがで
きます。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=DEMODATA;Location=MyRemoteServer",
adOpenDynamic, adLockBatchOptimistic, adCmdTableDirect
3-8
既存の接続を使用したレコードセットの作成
既存の接続を使用したレコードセットの作成
接続を作成し、その接続を使用して複数のレコードセットを作成すること
ができます。これは、各レコードセットに個別の接続を作成するよりも効
率的です。
rs.Open "Course", MyExistingConnection, adOpenDynamic,
adLockBatchOptimistic, adCmdTableDirect
3-9
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
3-10
データ間の移動およびデータ操作
レコードの削除
レコードを削除するには、 Delete メソッドを使用します。オプションパラ
メータが 1 つあります。このパラメータは削除するレコードを指します。
現在、 Pervasive プロバイダでサポートするのはデフォルトの adAffectCurrent
のみです。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=Demodata", adOpenDynamic, adLockOptimistic,
adCmdTableDirect
' 削除するレコードへ移動する
rs.Delete adAffectCurrent
rs.Close
レコードの更新
レコードを更新するには、適切なフィールドに、希望する値を割り当てた
後で Update または UpdateBatch を呼び出します。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=Demodata", adOpenDynamic, adLockBatchOptimistic,
adCmdTableDirect
' 更新するレコードへ移動する
rs!Field4 = "Changed text"
rs.UpdateBatch
rs.Close
3-11
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
3-12
バッチ更新または即時更新の選択
バッチ更新または即時更新の選択
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 メソッドを使用し、一度に複数レコードの変更処理を行う
コードを記述することができます。
3-13
ADO/OLE DB リファレンス情報
これはパフォーマンスの点から見れば最良のロックタイプですが、アプリ
ケーション設計で ADO が一度に複数行をキャッシュして更新できるよう
にする必要があります。このロックタイプが必ずしも、マルチユーザー、
スループットの大きいアプリケーションに適しているとは限りません。以
下に、バッチ更新モードを使用してレコードセットを開く例を示します。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=Demodata", adOpenDynamic, adLockBatchOptimistic,
adCmdTableDirect
3-14
ADO オブジェクトの使用
ADO オブジェクトの使用
ADO ではオブジェクトを使ってデータにアクセスし、そのデータをユー
ザーに提供します。 Microsoft ADO Data Control を使用している場合は、接
続とレコードセットオブジェクトのインスタンスを作成する必要はあり
ません。ただし、接続とレコードセットの作成と破棄を直ちに行うように
する場合は、インスタンスを作成してから、後でオブジェクトを破棄する
必要があります。さらに、現在出荷されているバージョンの ADO Data
Control では、コードからレコードセットを作成し、コード内でこのレコー
ドセットに ADO Data Control の Recordset プロパティを設定する場合にの
み ADO 2.1 の機能（インデックスサポートなど）を使用します（また、こ
れはデフォルトの ADO2.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
3-15
ADO/OLE DB リファレンス情報
ブックマークの使用
ADO で使用するブックマークは、文書の中で使用する通常のブックマーク
と同じで、後でその場所を見つけることができます。これは、データーベー
ス内を検索する場合、または複数のテーブルを使用する場合には特に便利
です。バリアント変数を使用してブックマークを保存します。
rs.Open "Course", "Provider=PervasiveOLEDB;Data
Source=Demodata", adOpenDynamic, adLockBatchOptimistic,
adCmdTable
' ブックマークを付ける場所へ移動する
SaveMyPlace = rs.Bookmark
' その他の処理を行って、再びブックマークを付けた場所を検索する
rs.Bookmark = SaveMyPlace
rs.Close
ヒント Find メソッドの使用については、「レコードの検索」を参照し
てください。
3-16
イベントの使用
イベントの使用
メモ： 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 イベントを使用しなければなりません。
3-17
ADO/OLE DB リファレンス情報
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 では
データ型を知ることができます（あるフィールドの値と別のフィールドの
値またはメモリ内の値とを比較する方法を調べる場合に便利です）。
3-18
トランザクションの使用
トランザクションの使用
トランザクションは、 Connection オブジェクトを使って ADO 内に実装さ
れています。トランザクション用に使用できるメソッドは次のとおりです。

BeginTrans

CommitTrans

RollbackTrans
これらのメソッドにはパラメータがありません。
ヒントトランザクションを使用するためには、接続を作成し、その
接続を使ってレコードセットを作成する必要があります。
3-19
ADO/OLE DB リファレンス情報
3-20
Pervasive PSQL OLE DB プロ
バイダのインプリメンテー
ション
4
Pervasive の ADO インターフェイスの説明
この章では、以下の項目について説明します。

「Pervasive PSQL OLE DB プロバイダのインプリメンテーションリ
ファレンス」（4-2 ページ）

「ADOX インプリメンテーションリファレンス」（4-9 ページ）

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

CreateParameter

Execute
非サポート

Cancel
プロパティ
サポート

ActiveConnection

CommandText

CommandType

Name

Parameters

Prepared

Properties

State
Connection
メソッド
サポート

4-2
BeginTrans （ネストされたトランザクションを含む）
Pervasive PSQL OLE DB プロバイダのインプリメンテーションリファレンス

CommitTrans

Execute

Open

adConnectUnspecified

OpenSchema

RollbackTrans
非サポート

Cancel
プロパティ
サポート

Attributes

ConnectionString

CursorLocation

adUseClient は、 Microsoft のクライアントカーソルエンジンにつ
いて調査してから使用しなければなりません。

Errors

IsolationLevels

adXactRepeatableRead と adXactSerializable
Mode

adModeReadWrite

Properties

Provider

Version
非サポート

CommandTimeout

ConnectionTimeout

DefaultDatabase
イベント
サポート

CommitTransComplete

ConnectComplete

Disconnect
4-3
Pervasive PSQL OLE DB プロバイダのインプリメンテーション

ExecuteComplete

EndOfRecordset

FieldChangeComplete

MoveComplete

RollbackTransComplete

WillExecute

WillChangeField

WillConnect

WillMove
非サポート

InfoMessage
Field
メソッド
サポート

AppendChunk

GetChunk
プロパティ
サポート

4-4
ActualSize

これはデータベースに保持するサイズを指定します。

これは LongVarBinary と LongVarChar でちょうど 65K になり、そ
の後、その長さは GetChunk を使った場合にのみ見つけることが
できます。

Attributes

DataFormat

DefinedSize

Name

NumericScale

OriginalValue

Precision

Properties

Status
Pervasive PSQL OLE DB プロバイダのインプリメンテーションリファレンス

Type

Value
非サポート

UnderlyingValue
Fields
メソッド
非サポート

Append

CancelUpdate

Delete

Refresh

Resynch

Update
プロパティ
サポート

Count

Item
Parameter
メソッド
サポート

Appendchunk
プロパティ
サポート

Attributes

Direction

Name

NumericScale
4-5
Pervasive PSQL OLE DB プロバイダのインプリメンテーション

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

4-6
adCmdTableDirect を使用した場合にサポートされます
Pervasive PSQL OLE DB プロバイダのインプリメンテーションリファレンス

Supports

Update

UpdateBatch
非サポート

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
4-7
Pervasive PSQL OLE DB プロバイダのインプリメンテーション

Source

State

Status

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

Create

GetObjectOwner

SetObjectOwner
プロパティ
サポート

ActiveConnection

Tables
非サポート

Groups

Procedures

Users

Views

Properties
列
メソッド
サポート

Append

Delete
非サポート

Refresh
4-9
Pervasive PSQL OLE DB プロバイダのインプリメンテーション
プロパティ
サポート

Count

Item
Column
プロパティ
サポート

Attributes

DefinedSize

Name

NumericScale

ParentCatalog

Precision

Properties

Type
非サポート

RelatedColumn

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

Columns

IndexNulls

Name

Properties

Unique
ADOX インプリメンテーションリファレンス
非サポート

Clustered

PrimaryKey
インデックス
メソッド
サポート

Append

Delete
非サポート

Refresh
プロパティ
サポート

Count

Item
Connection
非サポート
Procedure
非サポート
Tables
メソッド
サポート

Append

Delete
非サポート

Refresh
4-11
Pervasive PSQL OLE DB プロバイダのインプリメンテーション
プロパティ
サポート

Count

Item
Table
プロパティ
サポート

Indexes

Name

ParentCatalog

Type
非サポート
4-12

DateCreated

DateModified

Keys
Visual Studio.NET インプリメンテーションリファレンス
Visual Studio.NET インプリメンテーションリファレンス
ここでは、 Pervasive PSQL で .NET に関してサポートされるプロパティと
メソッドの一覧を示します。
OleDbCommand のメソッド
Cancel
CreateParameter
CreateParameter
Dispose
ExecuteNonQuery
メモこのメソッドでは DDL ステートメントの実行時に -1 が返され
る必要があります。 Pervasive PSQL OLE DB プロバイダでは 0 が返さ
れます。
ExecuteReader
CloseConnection
KeyInfo
Default
SingleResutl
SingleRow
ExecuteScalar
Prepare
OleDbCommand のプロパティ
Connection
CommandText
CommandTimeout
Transaction
CommandType
Text
Stored Procedure
TableDirect
CommandUpdatedRowSource
OleDbCommandBuilder
すべてサポートされます。
4-13
Pervasive PSQL OLE DB プロバイダのインプリメンテーション
OleDbConnection のメソッド
Open
CreateCommand
Close
DatabaseChange
メモ Pervasive OLEDB では現在のカタログの変更をサポートしませ
ん。
BeginTransaction
GetOleDbSchemaTable
Columns
Indexes
ProviderTypes
Tables
OleDbConnection のプロパティ
ConnectionString
DataBase
DataSource
Provider
ServerVersion
State
OleDbDataAdapter のメソッド
CreateTableMappings
CloneInternals
Fill
FillSchema
GetFillParameters
OnRowUpdated
OleDbDataAdapter のプロパティ
MissingMappingsAction
MissingSchemaAction
AcceptChangesDuringFill
DeleteCommand
InsertCommand
SelectCommand
4-14
Visual Studio.NET インプリメンテーションリファレンス
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
UBigInt
System.Decimal
Currency
System.Decimal
Decimal
System.Decimal
Int
System.Int32
UInt
System.Int64
SmallInt
System.Int16
USmallInt
System.Int32
Double
System.Double
Real
System.Single
4-15
Pervasive PSQL OLE DB プロバイダのインプリメンテーション
ColumnName
DataType
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
4-16
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
4-17
Pervasive PSQL OLE DB プロバイダのインプリメンテーション
Pervasive OLE DB プロバイダでテストした DataRow のメ
ソッド
AcceptChanges
RejectChanges
Delete
IsNull
4-18
索引
A
ADO.................................................. 1-1, 3-1, 4-1
C
COM+ サービス .......................................... 2-14
M
Microsoft Transaction Server ....................... 2-14
MTS .............................................................. 2-14
O
OLE DB ............................................ 1-1, 3-1, 4-1
索引 1
2 索引

Download Report