OLE DB Provider Guide

Pervasive PSQL v10 SP3
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 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 2009 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/）により開発さ
れたソフトウェアが含まれています。 Apache Software License を参照してください。
本製品ではフリーソフトウェアの unixODBC Driver Manager を使用しています。これは Peter
Harvey （pharvey@codebydesign.com）によって作成され、 Nick Gorham （nick@easysoft.com）
により変更および拡張されたものに Pervasive Software が一部修正を加えたものです。Pervasive
Software は、 unixODBC Driver Manager プロジェクトの LGPL 使用許諾契約書に従って、この
プロジェクトの現在の保守管理者にそのコード変更を提供します。 unixODBC Driver Manager の
Web ページは www.unixodbc.org にあります。このプロジェクトに関する詳細については、現在
の保守管理者である Nick Gorham （nick@easysoft.com）にお問い合せください。
GNU Lesser General Public License （LGPL）は本製品の配布メディアに含まれています。 LGPL
は www.fsf.org/licensing/licenses/lgpl.html でも見ることができます。
OLE DB Provider Guide
2009 年 11 月
目次
このマニュアルについて . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
このマニュアルの読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
このマニュアルの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
表記上の規則. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
1
Pervasive OLE DB プロバイダーの概要 . . . . . . . . . . . . . . . . . 1-1
Pervasive OLE DB プロバイダーの概要
Pervasive OLE DB の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Pervasive OLE DB のアーキテクチャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
リレーショナルパフォーマンス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
リモート接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
排他的カーソル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
ADO Refresh メソッドのサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
以前の OLE DB プロバイダーの確認. . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Visual Studio.NET のサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Visual Studio.NET のウィザード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
ASP.NET によるセキュリティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
サポートされるオブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
OLE DB のパフォーマンスに関する考慮点 . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
キャッシュエンジン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
最高パフォーマンスのナビゲーショナル . . . . . . . . . . . . . . . . . . . . . . . . 1-9
静的カーソルと動的カーソル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
未使用のサービスを使用不可にする . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
OLE DB プロバイダーの制限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
2
Pervasive OLE DB プロバイダーによるプログラミング . . . . . . . . . 2-1
Pervasive OLE DB プロバイダーを使用するためのプログラミング概念
OLE DB プロバイダーを使用したデータベースへの接続 . . . . . . . . . . . . . . . . . . 2-2
OLE DB プロバイダーへの接続. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
その他の作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
リモート接続. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
サポートされる新しい構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
以前のバージョンとの互換性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
排他的カーソル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
OLE DB 仕様と排他的カーソル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
排他的カーソルの構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
iii
目次
排他的カーソルの動作のまとめ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
バッチ挿入、更新および削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
3
ADO/OLE DB リファレンス情報 . . . . . . . . . . . . . . . . . . . . . 3-1
Pervasive 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
ブックマークの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
iv
目次
イベントの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
Field オブジェクトの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
トランザクションの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
4
Pervasive PSQL OLE DB プロバイダーの実装 . . . . . . . . . . . . . . 4-1
サポートされるプロパティ、メソッドおよびイベントのリファレンス
Pervasive PSQL OLE DB プロバイダーの実装リファレンス . . . . . . . . . . . . . . . . . 4-2
Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Recordset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
ADOX 実装リファレンス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Visual Studio.NET 実装リファレンス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
v
図
1-1
1-2
1-3
2-1
vi
Pervasive PSQL OLE DB プロバイダーのアーキテクチャ
最初の OLE DB プロバイダーのアーキテクチャ . . . . .
2 番目の OLE DB プロバイダーのアーキテクチャ . . . .
データベース名とサーバー名を解決するダイアログ . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-3
1-5
1-6
2-9
表
2-1
2-2
2-3
読み取りロックと更新ロック . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
排他的ロックのオプションとその動作のマトリックス . . . . . . . . . . . . . . . . 2-7
接続文字列識別子 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
vii
viii
このマニュアルについて
このマニュアルは、 Pervasive PSQL OLE DB プロバイダーについての手引
書です。
ix
このマニュアルの読者
このマニュアルは、 Pervasive PSQL に精通し、 OLE DB プロバイダーを使
用してアプリケーションを開発したいユーザー向けにデザインされていま
す。
x
このマニュアルの構成
このマニュアルでは、以下の項目について説明します。

第 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 プロバイダーでサポートされるプ
ロパティ、メソッドおよびイベントのリファレンスです。
このマニュアルの巻末には索引が用意されています。
xi
表記上の規則
特段の記述がない限り、コマンド構文、コード、およびコード例では、以
下の表記が使用されます。
xii
大文字小文字の
区別
通常、コマンドと予約語は、大文字で表記されます。本書で
別途記述がない限り、これらの項目は大文字、小文字、ある
いはその両方を使って入力できます。たとえば、 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 プロバイダーの概要
ここでは、以下の項目について説明します。

「Pervasive OLE DB の概要」（1-2 ページ）

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

「Visual Studio.NET のサポート」（1-8 ページ）

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

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

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

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

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

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

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

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

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

「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 ではなく、データベース名
（DBＮame）を指します。 DSN は ODBC でのみ使用します。
以前のバージョンとの互換性
現在、接続文字列で DDF へのパスを使用している場合はこのメソッドでも
サポートします。
Provider=PervasiveOLEDB;Data Source=f:\mydata
以前のバージョンの Pervasive PSQL とは異なり、本リリースでは接続する
サーバーにデータベース名が存在している必要があります。
データベース名を指定した場合と Location を指定した場合、あるいはマッ
プされたドライブを指定した場合でもパフォーマンスに違いはありませ
ん。ただし、リモートサーバーに接続する方法としては Location の使用を
推奨しています。 OLE DB プロバイダーでは、マップされたドライブまた
は UNC パスを使用した場合にアクセス権の問題が発生する可能性があり
ます。
2-3
Pervasive OLE DB プロバイダーによるプログラミング
メモ接続文字列内で OLE DB プロバイダーを使用し、マップされた
ドライブまたは UNC パスを Data Source 部分に指定する場合は、「UNC
パスまたはマップされたドライブを使う OLE DB プロバイダーの使
用」（2-8 ページ）も参照してください。
2-4
排他的カーソル
排他的カーソル
ほかのクライアントがレコードのロックに遭遇する可能性が高くなるリス
クを負っても、作成するアプリケーションで確実に更新を行うことを優先
する必要がある場合は排他的カーソルを使用します。
以前のバージョンの 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 つのアルゴリズム間の動作の違い
についてまとめています。
2-5
Pervasive OLE DB プロバイダーによるプログラミング
表 2-1 読み取りロックと更新ロック
ロックタイプ
動作
読み取りロック
読み取るたびに行をロックします。
最初の Move メソッドで行のロックを解除します。
次の行をロックします。
更新ロック
データが変更されたときに行をロックします。
Update メソッドを呼び出したときに行のロックを
解除します。
読み取りロックを使用することで、開発者は行を読み込んだときに並行性
エラーを懸念することなく確実に更新を行うことができます。ただし、こ
れは読み取る行を常にロックします。更新ロックではデータが変更された
場合に行をロックするだけです。ただし、並行性エラーが発生するのはよ
り遅くなる可能性があります。
このアーキテクチャの変更の詳細については、「Pervasive OLE DB のアーキ
テクチャ」（1-3 ページ）を参照してください。
排他的カーソルの構文
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
以前のバージョンのプロバイダーでは、この接続文字列が自動的に正しい
データベース名に解決されました。現在のプロバイダーを使用すると、こ
の設定でアクセス権の問題が発生する可能性があります。接続文字列内で
新しい 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 = ?"
' パラメーターを最新の情報に更新
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

LongVarWChar

UserDefined Types

GUID
2-11
Pervasive OLE DB プロバイダーによるプログラミング
デフォルトのロックタイプ
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
Persist Security Info
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO
User ID
DBPROP_AUTH_USERID
Pervasive OLE DB ドライバーを使用する上での注意
以下のプロパティを設定することもできます。

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
rs.Index = "employeeID"
2-15
Pervasive OLE DB プロバイダーによるプログラミング
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 のレコード数
バッチ挿入、更新および削除
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 に相当します。
2-17
Pervasive OLE DB プロバイダーによるプログラミング
例 - バッチ更新
SQLst = "Update MyData set char_ = 'SampleTest'
uinteger_ = 13"
cmd.ActiveConnection = cn
cmd.CommandText = SQLst
cmd.Execute RecordsAffected
where
この場合、RecordsAffected は 13 という値を持つすべてのレコード数に相当
する x になります。
2-18
ADO/OLE DB リファレンス情報
3
Pervasive OLE DB プロバイダーを使用した一般的な操作のリファレンス
この章では、以下の項目について説明します。

「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=d:\mydata\mydatabase", 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 メソッドを使用し、一度に複数レコードの変更処理を行う
コードを記述することができます。
これはパフォーマンスの点から見れば最良のロックタイプですが、アプリ
ケーション設計で ADO が一度に複数行をキャッシュして更新できるよう
3-13
ADO/OLE DB リファレンス情報
にする必要があります。このロックタイプが必ずしも、マルチユーザー、
スループットの大きいアプリケーションに適しているとは限りません。以
下に、バッチ更新モードを使用してレコードセットを開く例を示します。
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 の機能（インデックスサポートなど）を使用します（また、こ
れはデフォルトの 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
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 PSQL OLE DB プロバイダーの実装リファレンス」（4-2 ペー
ジ）

「ADOX 実装リファレンス」（4-8 ページ）

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

CreateParameter

Execute
非サポート

Cancel
プロパティ
サポート
Connection

ActiveConnection

CommandText

CommandType

Name

Parameters

Prepared

Properties

State
メソッド
サポート

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

CommitTrans

Execute

Open

4-2
adConnectUnspecified
Pervasive PSQL OLE DB プロバイダーの実装リファレンス

OpenSchema

RollbackTrans
非サポート

Cancel
プロパティ
サポート

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
4-3
Pervasive PSQL OLE DB プロバイダーの実装

WillExecute

WillChangeField

WillConnect

WillMove
非サポート

Field
InfoMessage
メソッド
サポート

AppendChunk

GetChunk
プロパティ
サポート

ActualSize

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

DataFormat

DefinedSize

Name

NumericScale

OriginalValue

Precision

Properties

Status

Type

Value

非サポート

4-4
UnderlyingValue
Pervasive PSQL OLE DB プロバイダーの実装リファレンス
Fields
メソッド
非サポート

Append

CancelUpdate

Delete

Refresh

Resynch

Update
プロパティ
サポート
Parameter

Count

Item
メソッド
サポート

AppendChunk
プロパティ
サポート
Record

Attributes

Direction

Name

NumericScale

Precision

Properties

Size

Type

Value
サポートされません
4-5
Pervasive PSQL OLE DB プロバイダーの実装
Recordset
メソッド
サポート

AddNew

Cancel

CancelBatch

CancelUpdate

Clone

CompareBookmark

Delete

Find

GetRows

GetString

Move

MoveFirst

MoveLast

MoveNext

MovePrevious

Open

Resync

Save

Seek

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

Update

UpdateBatch

非サポート

Requery
プロパティ
サポート
4-6

AbsolutePage

AbsolutePosition

ActiveCommand

ActiveConnection
Pervasive PSQL OLE DB プロバイダーの実装リファレンス

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
サポートされません
4-7
Pervasive PSQL OLE DB プロバイダーの実装
ADOX 実装リファレンス
このセクションでは、 Pervasive の ADOX のサポートについて説明します。
Catalog
メソッド
非サポート

Create

GetObjectOwner

SetObjectOwner
プロパティ
サポート

ActiveConnection

Tables
非サポート
Columns

Groups

Procedures

Users

Views

Properties
メソッド
サポート

Append

Delete
非サポート

Refresh
プロパティ
サポート
4-8

Count

Item
ADOX 実装リファレンス
Column
プロパティ
サポート

Attributes

DefinedSize

Name

NumericScale

ParentCatalog

Precision

Properties

Type
非サポート

RelatedColumn

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

Columns

IndexNulls

Name

Properties

Unique
非サポート
Indexes

Clustered

PrimaryKey
メソッド
サポート

Append

Delete
非サポート

Refresh
4-9
Pervasive PSQL OLE DB プロバイダーの実装
プロパティ
サポート

Count

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

Append

Delete
非サポート

Refresh
プロパティ
サポート
Table

Count

Item
プロパティ
サポート

Indexes

Name

ParentCatalog

Type
非サポート
4-10

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
SingleResult
SingleRow
ExecuteScalar
Prepare
OleDbCommand のプロパティ
Connection
CommandText
CommandTimeout
Transaction
CommandType
Text
Stored Procedure
TableDirect
CommandUpdatedRowSource
OleDbCommandBuilder
すべてサポートされます。
4-11
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
UpdateCommand
TableMappings
Columns
Table
4-12
Visual Studio.NET 実装リファレンス
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
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
4-13
Pervasive PSQL OLE DB プロバイダーの実装
ColumnName
DataType
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
OleDbDataReader のプロパティ
Depth
Item
FieldCount
IsClosed
RecordsAffected
4-14
Visual Studio.NET 実装リファレンス
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
4-15
Pervasive PSQL OLE DB プロバイダーの実装
4-16
索引
A
C
ADO
Field オブジェク .................................... 3-18
OLE DB でのオブジェクトの使用...... 3-15
OLE DB の使用........................................ 3-1
イベント ................................................. 3-17
拡張と OLE DB........................................ 1-7
実装 ........................................................... 4-1
接続文字列 ............................................... 3-5
即時更新モード ..................................... 3-13
データ間の移動 ..................................... 3-10
デフォルトのロックタイプ ................ 3-13
トランザクション ................................. 3-19
バッチ更新モード ................................. 3-13
ブックマーク ......................................... 3-16
レコードセットと Location パラメーター 3-8
レコードセットと既存の接続............... 3-9
レコードセットと名前付きデータベース 3-6
レコードセットとパス ........................... 3-7
レコードの検索 ..................................... 3-12
レコードの更新 ..................................... 3-11
レコードの削除 ..................................... 3-11
レコードの追加 ..................................... 3-10
ADO Refresh メソッド
サポート ................................................... 1-4
例 ............................................................. 2-10
ADOX
Catalog のプロパティ ............................. 4-8
Catalog のメソッド ................................. 4-8
Columns のプロパティ ........................... 4-8
Columns のメソッド ............................... 4-8
Column のプロパティ ............................. 4-9
Index のプロパティ ................................. 4-9
Index のメソッド ..................................... 4-9
Tables のプロパティ ............................. 4-10
Tables のメソッド ................................. 4-10
Table のプロパティ ............................... 4-10
実装リファレンス ................................... 4-8
ASP.NET セキュリティ
Visual Studio.NET .................................... 1-8
COM+ サービス .......................................... 2-14
F
Field オブジェク
ADO で使用 ........................................... 3-18
I
ISequentialStream
OLE DB でサポート ................................ 1-7
M
Microsoft Transaction Server ....................... 2-14
MTS .............................................................. 2-14
O
OLE DB .......................................................... 1-1
ADO Refresh メソッド ............................ 2-8
ADO Refresh メソッドのサポート ........ 1-4
ADO 拡張 ................................................. 1-7
COM+ サービス ..................................... 2-14
Command のプロパティ ......................... 4-2
Command のメソッド ............................. 4-2
Connection のイベント ............................ 4-2
Connection のプロパティ ........................ 4-2
Connection のメソッド ............................ 4-2
Execute メソッド ................................... 2-17
Fields のプロパティ ......................... 4-4, 4-5
Fields のメソッド .................................... 4-5
Field のメソッド ...................................... 4-4
ISequentialStream サポート .................... 1-7
Parameter のプロパティ .......................... 4-5
Parameter のメソッド .............................. 4-5
Recordset のプロパティ .......................... 4-6
Recordset のメソッド .............................. 4-6
SELECT オペレーション ..................... 2-17
UNC パスまたはマップされたドライブの使
用 ........................................................... 2-8
Visual Basic のセットアップ.................. 3-2
Visual Studio.NET のサポート ............... 1-8
索引 1
以前のプロバイダーの確認 ................... 1-4
キャッシュエンジン .............................. 1-9
更新の表示 ............................................... 2-8
更新ロック ............................................... 2-6
実装 ........................................................... 4-1
初期化プロパティ ................................. 2-12
静的および動的カーソル ....................... 1-9
静的カーソルを使用した Seek ............ 2-11
制約 ......................................................... 1-10
接続 ........................................................... 2-2
接続文字列の識別 ................................. 2-12
データベースに接続する ....................... 2-2
データベースへの接続 ........................... 2-2
テーブル定義 ......................................... 2-11
デフォルトのロックタイプ ................ 2-12
ナビゲーショナルパフォーマンス ...... 1-9
ナビヘーショナルレコードセット ...... 1-7
排他的カーソル ................................ 1-4, 2-5
排他的カーソル構文 ............................... 2-6
排他的カーソルの動作 ........................... 2-7
バッチ挿入、更新および削除 ............. 2-17
パフォーマンスに関する考慮点 ........... 1-9
未使用のサービスを使用不可にする ... 1-9
読み取りロック ....................................... 2-6
ラージバイナリオブジェクトのサポート 17
リモート接続 .................................... 1-4, 2-3
リモート接続構文 ................................... 2-3
リレーショナルパフォーマンス .......... 1-4
R
Refresh メソッド , ADO
OLE DB でサポート ................................ 1-4
例 ............................................................. 2-10
V
Visual Basic コードサンプル
排他的カーソルの使用 ........................... 2-7
Visual Studio.NET
ASP.NET セキュリティ .......................... 1-8
DataColumn のプロパティ .................... 4-13
DataRow のメソッド ............................. 4-15
DataSet のプロパティ ............................ 4-15
DataSet のメソッド ................................ 4-15
DataTable のプロパティ ........................ 4-15
DataTable のメソッド ............................ 4-15
2 索引
OleDbCommandBuilder.......................... 4-11
OleDbCommand のプロパティ ............. 4-11
OleDbCommand のメソッド ................. 4-11
OleDbConnection のプロパティ ........... 4-12
OleDbConnection のメソッド ............... 4-12
OleDbDataAdapter のプロパティ ......... 4-12
OleDbDataAdapter のメソッド ............. 4-12
OleDbDataReader のプロパティ .......... 4-14
OleDbDataReader のメソッド .............. 4-14
ウィザード ............................................... 1-8
サポートされるオブジェクト ............... 1-8
実装リファレンス ................................. 4-10
い
イベント
ADO で使用 ........................................... 3-17
う
ウィザード
Visual Studio.NET .................................... 1-8
か
カーソル , 静的
OLE DB で................................................ 1-9
Seek 操作 ................................................ 2-11
カーソル , 動的
OLE DB で................................................ 1-9
カーソル , 排他的 .................................. 1-4, 2-5
VB サンプルコード ............................... 2-7
構文 ........................................................... 2-6
動作 ........................................................... 2-7
き
キャッシュエンジン
OLE DB で................................................ 1-9
さ
サービス , 未使用のものを使用不可にする
OLE DB で................................................ 1-9
サポートされるオブジェクト
Visual Studio.NET .................................... 1-8
サポートされる構文
OLE DB リモート接続用........................ 2-3
せ
ら
静的カーソル
seek の使用............................................. 2-11
接続
OLE DB プロバイダーへ........................ 2-2
OLE DB プロバイダーを使用してデータ
ベースへ ............................................... 2-2
接続 , リモート
OLE DB で....................................... 1-4, 2-11
OLE DB を使用........................................ 2-3
以前のバージョンとの互換性............... 2-3
接続文字列の識別
OLE DB 用.............................................. 2-12
ラージバイナリオブジェクト
OLE DB でサポート ................................ 1-7
と
れ
トランザクション
ADO で使用 ........................................... 3-19
な
ナビゲーショナルパフォーマンス
OLE DB で................................................ 1-9
ナビヘーショナルレコードセット
OLE DB プロバイダー............................ 1-7
は
排他的カーソル
OLE DB で......................................... 1-4, 2-5
OLE DB での動作.................................... 2-7
VB サンプルコード ............................... 2-7
構文 ........................................................... 2-6
バイナリオブジェクト , ラージ
OLE DB でサポート ................................ 1-7
パフォーマンス , リレーショナル
OLE DB プロバイダーの使用................ 1-4
り
リモート接続 .............................................. 2-11
OLE DB で................................................ 1-4
OLE DB を使用........................................ 2-3
OLE DB を使用した新しい構文............ 2-3
以前のバージョンとの互換性 ............... 2-3
リレーショナル
OLE DB プロバイダーの使用によるパ
フォーマンス ....................................... 1-4
例 , ADO Refresh メソッド ........................ 2-10
レコードセット
ADO で使用 ....................... 3-6, 3-7, 3-8, 3-9
ろ
ロック
読み取りと更新 ....................................... 2-6
ロック , 更新
OLE DB で................................................ 2-6
ロック , 読み取り
OLE DB で................................................ 2-6
ロックタイプ
ADO 用のデフォルト ........................... 3-13
ふ
ブックマーク
ADO で使用 ........................................... 3-16
プロバイダー , OLE DB で
以前のプロバイダーの確認 ................... 1-4
み
未使用のサービスを使用不可にする
OLE DB で................................................ 1-9
索引 3
4 索引

Download Report