Pervasive Data Provider for .NET Guide and ……責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記

Pervasive PSQL v10 SP3

Pervasive Data Provider for .NET Guide and Reference

Developing Applications with Data Provider for .NET

免責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用

者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記載の契約条件によってのみ許諾するものです。Pervasive Software Inc. は、いかな

る場合にも本ソフトウェアおよび本マニュアルに記載された内容に関するその他の一切の保証を、明示的にも黙示的にも行いません。 Pervasive Software Inc.は、市場性、権利、特定の目的に対する適合性、あるいは一連の取引業務や職業的な使用に関する問題などに対し、一切の保証を行わないことを明示するとともに、利用者およびその会社がこれに同意したものとします。

商標 Btrieve、 Client/Server in a Box、 Pervasive、 Pervasive Software および PervasiveSoftware のロゴは、 Pervasive Software Inc. の登録商標です。

Built on Pervasive Software、 DataExchange、 MicroKernel Database Engine、 MicroKernelDatabase 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 2008 Pervasive Software Inc. All rights reserved. このマニュアルの全文、一部に関

わりなく複製、複写、配布をすることは、前もって発行者の書面による同意がない限り禁止しま

す。

本製品には、 Data Direct により開発されたソフトウェアが含まれています。 Copyright 2005 DataDirect, Inc. All rights reserved.

Pervasive Data Provider for .NET Guide and Reference2009 年 11 月

目次

このマニュアルについて . . . . . . . . . . . . . . . . . . . . . . . . . . . xiiiPervasive PSQL ADO.NET データプロバイダーとは . . . . . . . . . . . . . . . . . . . . . xivPervasive PSQL ADO.NET データプロバイダー本リリースの新機能 . . . . . . . . . . . . xvPervasive PSQL ADO.NET データプロバイダーの本リリースで廃止された機能 . . . . . xviこのマニュアルの使用法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii表記上の規則. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

1 クイックスタート . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1データベースへの接続

サポートされる .NET Framework のバージョン . . . . . . . . . . . . . . . . . . . . . . . . 1-2データベースへの接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

例：プロバイダー固有のオブジェクトの使用 . . . . . . . . . . . . . . . . . . . . . 1-3例：共通プログラミングモデルの使用 . . . . . . . . . . . . . . . . . . . . . . . . . 1-5例： Pervasive Common Assembly の使用 . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

基本的な接続文字列の定義. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8

2 ADO.NET データプロバイダーの使用 . . . . . . . . . . . . . . . . . .2-1ADO.NET データプロバイダーについて

Pervasive PSQL データプロバイダーについて . . . . . . . . . . . . . . . . . . . . . . . . . 2-2名前空間 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2アセンブリ名 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

接続文字列の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3接続文字列の使用に関するガイドライン . . . . . . . . . . . . . . . . . . . . . . . . 2-3接続文字列オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

アプリケーションのパフォーマンスに関する考慮点 . . . . . . . . . . . . . . . . . . . . . 2-13接続文字列オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14

データ型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15Pervasive データ型から .NET Framework データ型へのマッピング . . . . . . . . . . 2-15パラメーターデータ型のマッピング . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17ストリームオブジェクトでサポートされるデータ型 . . . . . . . . . . . . . . . . . 2-20

長いデータパラメーターへの入力としてストリームを使用する . . . . . . . . . . . . . . 2-21パラメーターマーカー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22パラメーター配列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23ストアドプロシージャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24トランザクションのサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25

iii

目次

スレッドのサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-26Unicode のサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27分離レベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-28SQL エスケープシーケンス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29イベント処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30エラー処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-31.NET オブジェクトの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32.NET 用アプリケーション開発のためのその他のリソース . . . . . . . . . . . . . . . . . 2-33

3 ADO.NET の高度な機能 . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1接続プールの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

接続プールの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2プールへの接続の追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3プールからの接続の削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3プール内の停止接続の処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4接続プールのパフォーマンスの追跡 . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5

ステートメントキャッシングの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6ステートメントキャッシングの有効化 . . . . . . . . . . . . . . . . . . . . . . . . . 3-6ステートメントキャッシング手法の選択 . . . . . . . . . . . . . . . . . . . . . . . 3-7

接続フェイルオーバーの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8クライアントロードバランスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10接続の再試行機能の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11接続フェイルオーバーの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12セキュリティの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14

コードへのアクセス権限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14セキュリティの属性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14

Pervasive Bulk Load の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15Pervasive Bulk Load で使用するシナリオ . . . . . . . . . . . . . . . . . . . . . . . . 3-15Pervasive Common Assembly. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16

バルクロードデータファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17バルクロード構成ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18バルクロードプロトコルの決定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19文字セットの変換 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19外部オーバーフローファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-20バルクコピー操作とトランザクション . . . . . . . . . . . . . . . . . . . . . . . . . 3-21

診断機能の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22メソッド呼び出しのトレース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22PerfMon のサポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23接続統計情報によるパフォーマンスの分析 . . . . . . . . . . . . . . . . . . . . . . 3-24

iv

目次

統計情報項目の有効化と取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25

4 Visual Studio でのデータプロバイダーの使用 . . . . . . . . . . . . . .4-1統合開発環境を一般的なタスクに使用する

接続の追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2サーバーエクスプローラーでの接続の追加 . . . . . . . . . . . . . . . . . . . . . . 4-2データソース構成ウィザードによる接続の追加 . . . . . . . . . . . . . . . . . . . . 4-11［サーバー名］ノードの定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12

Visual Studio の Pervasive Performance Tuning Wizard . . . . . . . . . . . . . . . . . . . . . 4-14プロバイダー固有テンプレートの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

プロジェクトの新規作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18既存のプロジェクトへのテンプレートの追加 . . . . . . . . . . . . . . . . . . . . . 4-20

Pervasive Visual Studio Wizard の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21Add Table Wizard でのテーブルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21Add View Wizard でのビューの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26

ツールボックスからのコンポーネントの追加 . . . . . . . . . . . . . . . . . . . . . . . . . 4-29データプロバイダー統合のシナリオ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31

5 Microsoft Enterprise Library の使用 . . . . . . . . . . . . . . . . . . . .5-1アプリケーションでのデータアクセスアプリケーションブロックの使用

データアクセスアプリケーションブロックの概要 . . . . . . . . . . . . . . . . . . . . . 5-2DAAB の使用に適する場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2汎用クラスおよびデータベース固有のクラス . . . . . . . . . . . . . . . . . . . . . 5-2

DAAB の構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4新しい DAAB エントリを追加するには . . . . . . . . . . . . . . . . . . . . . . . . . 5-4アプリケーションへのデータアクセスアプリケーションブロックの追加 . . . . 5-5

アプリケーションコードでのデータアクセスアプリケーションブロックの使用. . . . 5-6アプリケーションブロックを使用する上でのその他のリソース . . . . . . . . . . . . . . 5-7

6 サポートされる .NET オブジェクト . . . . . . . . . . . . . . . . . . . .6-1.NET オブジェクトの使用

.NET のベースクラス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2データプロバイダー固有のクラス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

PsqlBulkCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3PsqlBulkCopyColumnMapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4PsqlBulkCopyColumnMappingCollection. . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

PsqlCommand オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4PsqlCommandBuilder オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

v

目次

PsqlConnection オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9PsqlConnectionStringBuilder オブジェクト . . . . . . . . . . . . . . . . . . . . . . . 6-11PsqlDataAdapter オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11PsqlDataReader オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12PsqlError オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13PsqlErrorCollection オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13PsqlException オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14PsqlFactory オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15PsqlInfoMessageEventArgs オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . 6-15PsqlParameter オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16PsqlParameterCollection オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17PsqlTrace オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18PsqlTransaction オブジェクト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

Pervasive Common Assembly クラス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20CsvDataReader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20CsvDataWriter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-22DbBulkCopy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23DbBulkCopyColumnMapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23DbBulkCopyColumnMappingCollection . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23

7 スキーマ情報の入手 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1データベースのメタデータの検索および取り出し

GetSchemaTable メソッドによって返される列 . . . . . . . . . . . . . . . . . . . . . . . . 7-2GetSchema メソッドによるスキーマメタデータの取得 . . . . . . . . . . . . . . . . . . . 7-5

MetaDataCollections スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . 7-5DataSourceInformation スキーマコレクション . . . . . . . . . . . . . . . . . . . . . 7-6DataTypes コレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7ReservedWords コレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9Restrictions コレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

追加のスキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10Columns スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10ForeignKeys スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12Indexes スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13PrimaryKeys スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14ProcedureParameters スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . 7-15Procedures スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17TablePrivileges スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . 7-18Tables スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19Views スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20

vi

目次

8 .NET の SQL エスケープシーケンス . . . . . . . . . . . . . . . . . . .8-1エスケープシーケンスの使用

日付、時刻、タイムスタンプのエスケープシーケンス . . . . . . . . . . . . . . . . . . . 8-2スカラー関数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3外部結合のエスケープシーケンス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

9 ロックレベルと分離レベル . . . . . . . . . . . . . . . . . . . . . . . .9-1ロックレベルと分離レベルの使用

ロック . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2分離レベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3ロックモードとレベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6

10 パフォーマンスの最適化を図る .NET アプリケーションの設計 . . . . .10-1.NET アプリケーションの適化

データの取得. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2アーキテクチャについての理解 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2長いデータの取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2取得するデータのサイズの縮小 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3CommandBuilder オブジェクトの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3正しいデータ型の選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4

.NET オブジェクトとメソッドの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5ストアドプロシージャの引数としてのパラメーターマーカーの使用 . . . . . . . 10-5

.NET アプリケーションの設計 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6接続の管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6ネイティブの管理プロバイダーの使用 . . . . . . . . . . . . . . . . . . . . . . . . . 10-6

データの更新. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7切断された DataSet の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7データソースへの変更の同期 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7

11 バルクロード構成ファイル . . . . . . . . . . . . . . . . . . . . . . . .11-1バルクデータ構成ファイルのサンプル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2バルクデータ構成ファイル用の XML スキーマ定義 . . . . . . . . . . . . . . . . . . . . . 11-3

12 IANA コードマッピング . . . . . . . . . . . . . . . . . . . . . . . . .12-1

13 用語集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-1共通の用語の定義

.NET アーキテクチャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1

vii

目次

ADO.NET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1

アセンブリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1アンマネージコード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2共通言語ランタイム（CLR ： Common Language Rruntime） . . . . . . . . . . . . . . 13-2クライアントロードバランス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2グローバルアセンブリキャッシュ（GAC） . . . . . . . . . . . . . . . . . . . . . . 13-2厳密な名前 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2コードアクセスセキュリティ（CAS） . . . . . . . . . . . . . . . . . . . . . . . . . 13-3スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3ストリーム . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3接続の再試行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3接続プール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3接続フェイルオーバー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3名前空間 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3パフォーマンスモニター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4バルクロード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4分離レベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4マネージコード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4ロードバランス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4ロックレベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5

viii

ix

図

3-1 接続フェイルオーバー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83-2 クライアントロードバランスの例 . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103-3 2 つのデータソース間での Pervasive Bulk Load の使用 . . . . . . . . . . . . . . . . 3-163-4 ODBC から ADO.NET へのデータのコピー . . . . . . . . . . . . . . . . . . . . . . . 3-164-1 Pervasive Performance Tuning Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-154-2 Pervasive Performance Tuning Wizard の［Result］ダイアログ . . . . . . . . . . . . . 4-16

表

1-1 サポートされる Microsoft .NET Framework のバージョン . . . . . . . . . . . . . . . 1-21-2 Pervasive PSQL で低限必要な接続文字列オプション . . . . . . . . . . . . . . . . 1-82-1 接続文字列オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42-2 Pervasive PSQL 列コレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-122-3 Pervasive データ型のマッピング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-152-4 System.Data.DbTypes から PsqlDbTypes へのマッピング. . . . . . . . . . . . . . . . 2-182-5 .NET Framework 型から PsqlDbType へのマッピング . . . . . . . . . . . . . . . . . 2-192-6 サポートされるストリームオブジェクト . . . . . . . . . . . . . . . . . . . . . . . 2-203-1 ステートメントキャッシュ動作の要約 . . . . . . . . . . . . . . . . . . . . . . . . . 3-73-2 文字セット変換の例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-203-3 PerfMon カウンター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-246-1 PsqlCommand オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . 6-46-2 PsqlCommand オブジェクトのパブリックメソッド . . . . . . . . . . . . . . . . . . 6-76-3 PsqlCommandBuilder オブジェクトのパブリックプロパティ . . . . . . . . . . . . 6-76-4 PsqlCommandBuilder オブジェクトのパブリックメソッド . . . . . . . . . . . . . . 6-86-5 PsqlConnection オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . 6-96-6 PsqlConnection オブジェクトのパブリックメソッド . . . . . . . . . . . . . . . . . 6-106-7 PsqlDataAdapter オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . 6-116-8 PsqlDataReader オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . 6-126-9 PsqlDataReader オブジェクトでサポートされるメソッド . . . . . . . . . . . . . . . 6-126-10 PsqlError オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . . . . 6-136-11 PsqlErrorCollection オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . 6-136-12 PsqlErrorCollection オブジェクトのパブリックメソッド . . . . . . . . . . . . . . . 6-136-13 PsqlException オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . . 6-146-14 PsqlFactory オブジェクトのメソッド . . . . . . . . . . . . . . . . . . . . . . . . . . 6-156-15 PsqlInfoMessageEventArgs のパブリックプロパティ . . . . . . . . . . . . . . . . . 6-156-16 PsqlParameter オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . . 6-166-17 PsqlParameterCollection のパブリックプロパティ . . . . . . . . . . . . . . . . . . . 6-176-18 PsqlParameterCollection オブジェクトのパブリックメソッド . . . . . . . . . . . . 6-186-19 PsqlTrace のパブリックプロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-186-20 PsqlTrace オブジェクトのパブリックメソッド . . . . . . . . . . . . . . . . . . . . 6-196-21 PsqlTransaction オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . 6-196-22 PsqlTransaction オブジェクトのパブリックメソッド . . . . . . . . . . . . . . . . . 6-196-23 CsvDataReader オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . 6-206-24 CsvDataReader オブジェクトのパブリックメソッド . . . . . . . . . . . . . . . . . 6-216-25 CsvDataWriter オブジェクトのパブリックプロパティ . . . . . . . . . . . . . . . . 6-226-26 CsvDataWriter オブジェクトのパブリックメソッド . . . . . . . . . . . . . . . . . . 6-227-1 PsqlDataReader の GetSchemaTable で返される列. . . . . . . . . . . . . . . . . . . . 7-2

x

7-2 MetaDataCollections スキーマコレクションによって返される列 . . . . . . . . . . . 7-57-3 DataSourceInformation コレクションによって返される列名 . . . . . . . . . . . . . . 7-67-4 DataTypes コレクションによって返される列名. . . . . . . . . . . . . . . . . . . . . 7-77-5 ReservedWords スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . 7-97-6 Restrictions コレクションによって返される列名 . . . . . . . . . . . . . . . . . . . . 7-97-7 Columns スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-107-8 ForeignKeys スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-127-9 Indexes スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-137-10 PrimaryKeys スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-157-11 ProcedureParameters スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . 7-157-12 Procedures スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-187-13 TablePrivileges スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . 7-187-14 Tables スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-197-15 Views スキーマコレクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-208-1 サポートされるスカラー関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-39-1 分離レベルとデータの一貫性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-412-1 IANA コードページマッピング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1

xi

xii

このマニュアルについて

このマニュアルは、Pervasive PSQL ADO.NET プロバイダーについての手引

書です。データプロバイダーには、 .NET Framework バージョン 2.0、 3.0、3.5 および 3.5 SP1 に準拠している Microsoft .NET Software Development Kit(SDK) Framework バージョン 2.0 が必要です。

xiii

Pervasive PSQL ADO.NET データプロバイダーとは

Pervasive PSQL データプロバイダーは、マネージコードのみで構築された

ADO.NET マネージデータプロバイダーです。データプロバイダーは、ネ

イティブのワイヤプロトコルプロバイダーです。したがって、データプロバイダーが、データベースクライアントの形式のアンマネージコード

（.NET Framework 外のコード）を呼び出す必要はありません。

Pervasive PSQL 32 ビットデータプロバイダーを使用すれば、以下のプラッ

トフォームから Pervasive PSQL v10.x データベースに接続することができ

ます。

Windows Server 2008

Windows Vista

Windows Server 2003

Windows XP サービスパック 2 以上

Windows 2000 サービスパック 3 以上

Pervasive PSQL 64 ビットデータプロバイダーは、AMD 社の Opteron や Intel社の EM64T （Extended Memory 64 Technology）を組み込んだ Xeon などの

x64 プロセッサでサポートされます。このデータプロバイダーを使用すれ

ば、以下のプラットフォームから Pervasive PSQL v10.x データベースに接

続することができます。

Windows Server 2003 x64 Editions

Windows XP Professional x64 Edition

xiv

Pervasive PSQL ADO.NET データプロバイダー本リリースの新機能

リリース 3.2 の注目点

Microsoft .NET Framework バージョン 3.5 SP1 のサポート

System.Transaction のサポート

MGEN ネイティブ適化のサポート

Pervasive PSQL v10.10 のサポート

Pervasive Bulk Load。DbBulkCopy クラスは共通プログラミングモデル

でのデータのバルクロードに対応しています。さらに、データプロバ

イダーにはプロバイダー固有のバルクロードクラスがあります。

接続統計情報のサポート

スキーマオプションの接続文字列オプションを使用すると、返される

スキーマメタデータを指定することができます。

ネイティブパラメーターマーカーおよびパラメーターバインディン

グのサポート

Enterprise Access Libraries 3.1 のサポート。 DAAB （データアクセスアプリケーションブロック）のサポートを含みます。

Initial Command Timeout 接続文字列オプションは接続確立時の初期コ

マンドタイムアウトを指定します。

Visual Studio 2008 のサポート

その他の機能

ステートメントキャッシングのサポート

DbBulkCopy インターフェイスを提供する Pervasive Common アセ

ンブリ

xv

Pervasive PSQL ADO.NET データプロバイダーの本リリースで廃止された機能

このリリースで廃止された機能はありません。

xvi

このマニュアルの使用法

このマニュアルは、お使いのオペレーティングシステムとその各種コマン

ド、デレクトリ定義およびエンドユーザーアプリケーションからデータ

ベースへアクセスする方法に関して精通しているユーザーを対象としてい

ます。

このマニュアルには以下の情報が記載されています。

「クイックスタート」では、 .NET データプロバイダーを使用したデー

タベースへの接続について説明します。

「ADO.NET データプロバイダーの使用」では、 Pervasive PSQL データ

プロバイダーと一緒に .NET アプリケーションを使用する方法、また

.NET 環境で .NET アプリケーションを開発する方法について説明しま

す。

「ADO.NET の高度な機能」では、接続プーリング、ステートメント

キャッシング、設定セキュリティ、および Pervasive Bulk Load を含む

データプロバイダーの高度な機能について説明します。

「Visual Studio でのデータプロバイダーの使用」では、 Pervasive PSQLデータプロバイダーおよび Visual Studio Performance Wizard を使用す

る方法について説明します。

「Microsoft Enterprise Library の使用」では DAAB （データアクセスアプリケーションブロック）の設定方法とアプリケーションコードでの

使用法について説明します。

「サポートされる .NET オブジェクト」では、 Pervasive PSQL データプロバイダーによってサポートされる、 .NET パブリックオブジェクト、

プロパティ、メソッドについて説明します。

「スキーマ情報の入手」では、 Pervasive PSQL データプロバイダーで

サポートされるスキーマコレクションについて説明します。

「.NET の SQL エスケープシーケンス」では、 Pervasive PSQL データ

プロバイダーでサポートされるスカラー関数について説明します。使

用しているデータストアが、ここで説明しているすべての関数をサ

ポートしていないことがあります。

「ロックレベルと分離レベル」では、ロックレベルと分離レベルにつ

いて、およびこれらの設定が取得するデータにどのように影響するか

について説明します。

「パフォーマンスの適化を図る .NET アプリケーションの設計」で

は、アプリケーションのコードを適化して、パフォーマンスを向上

させる方法を説明します。

「バルクロード構成ファイル」には、バルクロード操作中に作成され

るファイルのサンプルがあります。

xvii

「IANA コードマッピング」はも広範に使用されている IBM コード

ページを IANA コードページ名にマップします。

このマニュアルには用語集もあります。

メモこのマニュアルでは、参考情報が掲載されている Web サイトの

URL を記載しています。Web コンテンツは頻繁に変わるものであるた

め、記載されている URL が、このマニュアルの発行後に変わる可能性

もあります。

xviii

表記上の規則

このマニュアルでは、次の表記規則を使用しています。

表記上の規則説明

斜体新たな用語を表記する場合、あるいは強調する場合に使用され

ます。

太字重要性を強調します。また、操作上で使用するボタン、メ

ニュー、およびアイコンの名前に使用する場合もあります。

大文字ファイル名を示します。また、大文字と小文字を区別する操作

環境の場合は、大文字と小文字を正確に記載します。

固定スペース

フォント

構文例や指定する値、あるいは返される結果を示します。

固定スペース

フォントの斜体

filename のように、指定する値のプレースフォルダ名を示し

ます。

縦棒｜メニューやそれに関連付けられるコマンドを区切ります。たと

えば、［ファイル｜コピー］を選択－これは［ファイル］メ

ニューから［コピー］を選択することを意味します。また、半

角の場合は論理和 OR を示し、項目を区切るのに使用します。

大かっこ［］オプション項目を示します。たとえば、 SELECT [DISTINCT]というステートメントの場合、 DISTINCT は省略可能なキー

ワードです。

中かっこ { } 1 個の項目を選択する必要があることを示します。たとえば、

{yes | no} と表記される場合、 yes または no のいずれかを指定

する必要があります。

省略記号 ... 直前の項目を続けて何度でも繰り返せることを示します。閉じ

るかっこの後に省略記号がある場合は、中かっこで囲まれてい

る情報を繰り返せることを示します。

xix

xx

1
クイックスタート
データベースへの接続

ここでは、 Pervasive PSQL データプロバイダーをインストールした後で、

データベースに接続する基本的な操作について説明します。データプロバ

イダーの機能を大限利用するには、このマニュアルのほかの章もお読み

ください。

1-1


サポートされる .NET Framework のバージョン

Pervasive PSQL データプロバイダー 3.2 は、.NET Framework バージョン 2.0を使用してビルドされています。

表 1-1 は、 Pervasive PSQL 3.x データプロバイダーでサポートされる .NETFramework バージョンの一覧を示しています。 64 ビット環境用に作成され

たアプリケーションは、 .NET Framework バージョン 2.0 （x64）でコンパイ

ルする必要があります。

.NET Framework および Pervasive PSQL データプロバイダーの以前のバー

ジョン用として書かれた既存のコードは、 Pervasive PSQL 3.2 データプロ

バイダーと互換性があります。アプリケーションは .NET Framework 2.0 を使用して再コンパイルする必要があることに注意してください。

ただし、お使いのアプリケーションが .NET Framework バージョン 1.x を要

求する場合は、 Pervasive PSQL 2.1 データプロバイダーを使用する必要が

あります。

表 1-1 サポートされる Microsoft .NET Framework のバージョン

データプロバイダーのバージョン .NET Framework のバージョン

32 ビット Pervasive PSQL データプロ

バイダー

バージョン 2.0、 3.0、 3.5 SP1 （x86）

64 ビット Pervasive PSQL データプロ

バイダー

バージョン 2.0、3.0、および 3.5 SP1（x64）

1-2


データベースへの接続 Pervasive PSQL データプロバイダーをインストールすると、接続文字列を

使ってアプリケーションとデータベースを接続できるようになります。接

続の属性については、「接続文字列オプション」（2-4 ページ）を参照して

ください。

例：プロバイダー固有のオブジェクトの使用

次の例はプロバイダー固有のオブジェクトを使用した例です。C# を使って

Visual Studio で開発したアプリケーションから Pervasive PSQL データプロ

バイダーを使用しています。

1 ソリューションエクスプローラーで［参照設定］を右クリックします。

2 ［参照の追加］をクリックし、コンポーネントリストから "PervasivePSQL Data Provider" を選択します。このデータプロバイダーがコン

ポーネントリストにない場合は、［参照］タブをクリックしてデータ

プロバイダーアセンブリがあるディレクトリへ移動します。

1-3


3 ［OK］をクリックします。これで、ソリューションエクスプローラー

に Pervasive PSQL データプロバイダーが含まれるようになります。

4 次の C# コード例のように、データプロバイダーの名前空間をアプリ

ケーションの先頭に追加します。

// Pervasive PSQL へアクセスします

using System.Data;

using System.Data.Common;using Pervasive.Data.SqlClient;

5 サーバーの接続情報と例外処理のコードを追加します。

DbProviderFactory Factory = DbProviderFactories.GetFactory("Pervasive.Data.SqlClient");

DbConnection Conn = Factory.CreateConnection();

Conn.ConnectionString = "ServerDSN=DEMODATA;Host=localhost";

try

1-4


{

// 接続を開く

Conn.Open();

Console.WriteLine("接続成功 !");}

catch(PsqlException ex)

{

// 接続に失敗

Console.WriteLine(ex.Message);

}

6 接続を閉じます。

// 接続を閉じる

Conn.Close();

例：共通プログラミングモデルの使用

次の例は、 C# と共通プログラミングモデルを使用して Visual Studio で開

発したアプリケーションから Pervasive PSQL データベースに接続する方法

を示します。

1 アプリケーションの先頭部分を調べます。 ADO.NET 名前空間が記述

されていることを確認します。

// ファクトリを使用して Pervasive にアクセスします

using System.Data;

using System.Data.Common;

2 サーバーの接続情報および例外処理のコードを追加し、接続を閉じま

す。

DbProviderFactoryfactory =

DbProviderFactories("Pervasive.Data.SqlClient");DbConnection Conn = factory.createConnection();

Conn.CommandText = "ServerDSN=DEMODATA;Host=localhost;";

try

{ Conn.Open();

Console.WriteLine("接続成功 !");}catch (Exception ex)

{

// 接続に失敗しました


1-5


}

// 接続を閉じます

Conn.Close();

例： Pervasive Common Assembly の使用

共通プログラミングモデルに適合するアプリケーションで Pervasive BulkLoad などの機能を使用したい場合は、 Pervasive Common Assembly を含め

ることを選択できます。アプリケーションで Pervasive Bulk Load ユーザー

を使用する方法については、「Pervasive Bulk Load の使用」（3-15 ページ）を

参照してください。

次の例は、 C# と共通プログラミングモデルを使用して Visual Studio で開

発したアプリケーションで Pervasive Common Assembly を使用する方法を

示します。

1 アプリケーションの先頭部分を調べます。 .NET Framework および

Pervasive PSQL データプロバイダーの名前空間が記述されていること

を確認します。

// ファクトリを使用して Pervasive PSQL にアクセスします

using System.Data;

using System.Data.Common;

using Pervasive.Data.Common;

2 サーバーの接続情報および例外処理のコードを追加し、接続を閉じま

す。

// このコードは、バルクコピー操作を Pervasive PSQL // データベースから別のデータベースに対して行います


DbConnection sourceConnection = Factory.CreateConnection();

sourceConnection.ConnectionString = "Host=Server1;ServerDSN=DEMODATA;";

sourceConnection.Open();

DbCommand command = sourceConnection.CreateCommand();

command.CommandText = "SELECT * FROM test";

DbDataReader reader = command.ExecuteReader();

DbConnection destinationConnection = Factory.CreateConnection();

1-6


destinationConnection.ConnectionString = "Host= server2;ServerDSN=DEMODATA";

destinationConnection.Open();

DbBulkCopy bulkCopy = new DbBulkCopy(destinationConnection);

bulkCopy.DestinationTableName = "test";

try

{ bulkCopy.WriteToServer(reader);

} // 試行終了

catch (DbException ex)

{


} //catch の終了

finally{

reader.Close();

MessageBox.Show("終了 ");} //完了

1-7


基本的な接続文字列の定義

データプロバイダーでは、特定のデータベースサーバーへの接続に必要な

情報の指定に接続文字列を使用します。この接続情報は接続文字列オプ

ションで定義されます。

接続文字列オプションは次のような形式です。

" オプション =値 "

接続文字列オプション値の各ペアはセミコロンで区切ります。たとえば、

次のようになります。

"ServerDSN=Demodata;UID=test;PWD=test;ServerName=localhost"

サポートされるすべての接続文字列オプションの詳細については、「接続文

字列オプション」（2-4 ページ）を参照してください。

メモ：

接続文字列オプション名内のスペースは任意です。

接続文字列オプションでは大文字と小文字が区別されません。たとえ

ば、 User ID と user id は同じです。ただし、 User ID や Password などい

くつかのオプションの値の中には大文字と小文字が区別されるものも

あります。

表 1-2 は、 Pervasive PSQL サーバーへの接続に必要な低限のオプション

の名前とその説明です。

表 1-2 Pervasive PSQL で最低限必要な接続文字列オプション

オプション説明

Server DSN 接続するサーバーのデータソース名を、DEMODATA のように指

定します。

Host 接続する Pervasive PSQL サーバーの名前または IP アドレスを

指定します。たとえば、 Accountingserver などのサーバー

名を指定できます。あるいは、199.226.22.34 などの IP アド

レスを指定できます。

デフォルトの初期値は localhost です。

1-8

2
ADO.NET データプロバイダーの使用
ADO.NET データプロバイダーについて

Pervasive PSQL データプロバイダーを使用すれば、 .NET 対応アプリケー

ションやアプリケーションサーバーからデータアクセスが可能になりま

す。 Pervasive PSQL データプロバイダーはインターネットまたはイントラ

ネット経由で、主要なデータストアへの高パフォーマンスなポイントツー

ポイントアクセスおよび n 層アクセスを提供します。 Pervasive PSQL デー

タプロバイダーは、 .NET 環境向けに適化されているので、現在使用し

ているシステムに .NET 技術を組み込み、その機能を拡張してパフォーマ

ンスを向上させることができます。

この章では、以下の項目について説明します。

「Pervasive PSQL データプロバイダーについて」（2-2 ページ）

「接続文字列の使用」（2-3 ページ）

「アプリケーションのパフォーマンスに関する考慮点」（2-13 ページ）

「データ型」（2-15 ページ）

「長いデータパラメーターへの入力としてストリームを使用する」（2-21 ページ）

「パラメーターマーカー」（2-22 ページ）

「パラメーター配列」（2-23 ページ）

「ストアドプロシージャ」（2-24 ページ）

「トランザクションのサポート」（2-25 ページ）

「スレッドのサポート」（2-26 ページ）

「Unicode のサポート」（2-27 ページ）

「分離レベル」（2-28 ページ）

「SQL エスケープシーケンス」（2-29 ページ）

「イベント処理」（2-30 ページ）

「エラー処理」（2-31 ページ）

「.NET オブジェクトの使用」（2-32 ページ）

「.NET 用アプリケーション開発のためのその他のリソース」（2-33 ペー

ジ）

2-1


Pervasive PSQL データプロバイダーについて

Pervasive PSQL データプロバイダーは、 Microsoft .NET Framework Version2.0 Software Development Kit（SDK）に準拠しています。Pervasive PSQL デー

タプロバイダーはマネージコードのみで構築されており、実行およびデー

タベースへの接続は完全に共通言語ランタイム（CLR）内で行うことがで

きます。

クライアントライブラリや COM コンポーネントなどネイティブオペレー

ティングシステムで実行するコードはアンマネージコードと言います。マ

ネージコードとアンマネージコードは 1 つのアプリケーション内に混在さ

せることができます。ただし、アンマネージコードは共通言語ランタイム

の外部にまで影響が及ぶため、現実的には複雑になり、パフォーマンスも

低下します。また、セキュリティの危険にさらすことにもなりかねません。

名前空間

Pervasive PSQL データプロバイダーの名前空間は Pervasive.Data.SqlClient です。Pervasive PSQL データベースに接続するときに、Pervasive.Data.SqlClient名前空間で PsqlConnection オブジェクトと PsqlCommand オブジェクトを使

用します。

次のコードは、 Pervasive PSQL データプロバイダーの名前空間をアプリ

ケーションに組み込む方法を示しています。

C#

// Pervasive PSQL へアクセスしますusing System.Data;using System.Data.Common;using Pervasive.Data.SqlClient;

Visual Basic

' Pervasive PSQL へアクセスImports System.DataImports System.Data.CommonImports Pervasive.Data.SqlClient

アセンブリ名

Pervasive PSQL データプロバイダー用の厳密な名前のアセンブリは、イン

ストール時にグローバルアセンブリキャッシュ（Global Assembly Cache ：

GAC）に配置されます。アセンブリ名は Pervasive.Data.SqlClient.dll です。

Pervasive.Data.Common アセンブリには、バルクロードのサポートなどの機

能が含まれます。

Pervasive PSQL アセンブリは厳密な名前を持ちます。

2-2

接続文字列の使用

接続文字列の使用接続の動作は、接続文字列や PsqlConnection オブジェクトのプロパティを

使って定義することができます。

しかし、接続文字列内の値の設定を接続プロパティによって変更すること

はできません。

接続文字列の基本形式は、セミコロンで区切られた一連の「キーワード /値」のペアを含んでいます。次に、 Pervasive PSQL データプロバイダー用

の単純な接続文字列のキーワードと値の例を示します。

"Server DSN=SERVERDEMO;Host=localhost"

接続文字列の使用に関するガイドライン

接続文字列を指定する際には、次のガイドラインを用います。

接続文字列オプション名内のスペースは任意です。たとえば、接続文

字列には Min Pool Size でも MinPoolSize でも指定できます。

接続文字列オプションでは大文字と小文字が区別されません。たとえ

ば、 Password と password は同じです。ただし、 User ID や Password などのオプションの値には大小文字が区別されるものもあります。

セミコロン、一重引用符、または二重引用符の入った値を含めるには、

その値を二重引用符で囲みます。値にセミコロンと二重引用符の両方

が入っている場合は、一重引用符を使って値を囲みます。

値が二重引用符で始まる場合も一重引用符を使用できます。逆に、値

が一重引用符で始まる場合は二重引用符を使用します。値に一重引用

符と二重引用符のどちらも入っている場合は、値を囲むのに使用する

文字が値の中に現れるたびに、その文字を 2 つ重ねる必要があります。

先頭または末尾のスペースを文字列値に含めるには、その値を一重引

用符または二重引用符で囲む必要があります。整数値や、ブール値、

列挙値を一重引用符または二重引用符で囲んでも、値の前後のスペー

スは無視されます。ただし、文字列リテラルのキーワード内あるいは

値内のスペースは維持されます。接続文字列内で一重引用符または二

重引用符を使用する場合、それが値内の先頭または末尾の文字でなけ

れば、区切り文字なしで使用できます（たとえば、 ServerDSN=Development'sServer または ServerDSN=my"dev"Server）。

接続文字列オプションの値で特殊文字を使用することができます。特

殊文字をエスケープするには、その値を一重引用符または二重引用符

で囲みます。

また、等号文字（=）の繰り返しを接続文字列で使用することもでき

ます。たとえば、次のようにします。

Initialization String=update mytable set col1 == 'foo'"

2-3


接続文字列に無効な接続文字列オプションが含まれている場合には、

接続はエラーを返そうとします。たとえば、 Alternate Servers を定義し

ていないのに Load Balancing の値を指定すると、エラーが返されます。

接続文字列に接続文字列オプションが重複して含まれている場合に

は、データプロバイダーは接続文字列内で後に現れる接続文字列オ

プションを使用します。たとえば、次に示す接続文字列では、

Connection Timeout が異なる値で 2 回現れます。データプロバイダー

は 2 番目の値を使用するので、試行した接続を終了するまでに 35 秒待

ちます。

"ServerDSN=SERVERDEMO;Host=localhost;Connection Timeout=15;Min Pool Size=50;Connection Timeout=35"

接続文字列オプションの一覧については、「接続文字列オプション」（2-4ページ）を参照してください。

接続文字列オプション

表 2-1 では Pervasive PSQL データプロバイダーでサポートされる接続オプ

ションとその説明を一覧にして表示します。

表 2-1 接続文字列オプション


Alternate Servers プライマリデータベースサーバーが使用不可能の場合、データプロバイダーが

接続を試みる代替データベースサーバーの一覧を指定します。この接続文字列

オプションに値を指定すると、データプロバイダーに対して接続フェイルオー

バー機能が有効になります。

この値は、代替サーバーごとに接続情報を定義する文字列の形式で指定する必

要があります。デフォルトのポート値 1583 を使用しない場合は、各代替サー

バーの名前または IP アドレスと、ポート番号を指定する必要があります。文字

列は次のような形式です。

"Host= ホスト値 ;Port= ポート値 [, ...]"

たとえば、 Alternate Servers 値を次のように指定すると、接続フェイルオーバー

用に 2 つの代替サーバーが定義されます。

Alternate Servers="Host=AcctServer;Port=1584, Host=123.456.78.90;Port=1584"

接続フェイルオーバーの説明やこの機能で設定できるその他の接続文字列オプ

ションに関する情報については、「接続フェイルオーバーの使用」（3-8 ページ）

を参照してください。

Connection Reset {True | False}。アプリケーションで再使用するための接続プールから接続を削除

する場合、その状態を接続の初期設定状態にリセットするかどうかを指定しま

す。状態をリセットすると、再使用される接続のパフォーマンスが低下します。

これは新しい接続ではサーバーに対して余分なコマンドを実行する必要がある

ためです。

False （デフォルトの初期値）に設定すると、データプロバイダーは接続の状態

をリセットしません。

2-4


Connection Retry Count データプロバイダーがプライマリサーバーへの接続を試行し、その初期接続が

失敗した後に代替サーバーへの接続を試行する回数を指定します。

0 から 65535 の整数値を指定できます。 0 （デフォルト値）に設定すると、デー

タプロバイダーは、初期接続の試行に失敗した後に再接続を試行しません。

接続を再試行している間に接続が成功しなかった場合、データプロバイダーは、

接続を試行した後のサーバーで生成されたエラーを返します。

このオプションと試行間隔を指定する Connection Retry Delay オプションは、接

続フェイルオーバーに関して使用することができます。接続フェイルオーバー

の説明やこの機能で設定できるその他の接続文字列オプションに関する情報に

ついては、「接続フェイルオーバーの設定」（3-12 ページ）を参照してください。

Connection Retry Delay 初期接続の試行に失敗した後、プライマリサーバーまたは（指定した場合には）

代替サーバーへの接続を再試行するまでの試行間隔を秒数で指定します。

0 から 65535 までの整数値が指定できます。デフォルトの初期値は 3 （秒）です。

0 に設定すると、接続の再試行に待ち時間はありません。

メモ：このオプションは Connection Retry Count 接続文字列オプションに 0 を設

定している場合は作用しません。

このオプションと、データプロバイダーが初の接続の試行に失敗した後に接

続を試行する回数を指定する Connection Retry Count 接続文字列オプションは、

接続フェイルオーバーに関して使用することができます。接続フェイルオー

バーの説明やこの機能で設定できるその他の接続文字列オプションに関する情

報については、「接続フェイルオーバーの設定」（3-12 ページ）を参照してくだ

さい。

Connection Timeout サーバーへの接続の試行が失敗した後、接続されないでいる間の秒数を指定し

ます。接続フェイルオーバーが有効になっている場合、このオプションは接続

の試行ごとに適用されます。

0 に設定すると、データプロバイダーが接続の試行でタイムアウトすることは

ありません。

デフォルトの初期値は 15 秒です。

Database Name 接続するデータベースの内部名を指定します。 ServerDSN が定義されていない

Pervasive PSQL データソースに接続する必要がある場合は、このオプションを

使用します。

デフォルト値は空文字列です。

メモ： 1 つの接続文字列に Database Name と Server DSN 接続文字列オプション

を混在させることはできません。

別名： DBQ

Enable Trace {0 | 1}。トレースを有効にするかどうかを指定します。

0 （デフォルトの初期値）に設定すると、トレースは有効になりません。



2-5


Encoding データベースに格納されている文字列データの翻訳に使用する、IANA 名または

Windows コードページを指定します。

デフォルト値は空文字列で、現在の Windows Active Code Page （ACP）が使用さ

れます。

Encrypt {Not specified | Always | Never}。データプロバイダーが暗号化されたネットワー

ク通信（ワイヤ暗号化とも呼ばれます）を使用するかどうかを決定します。

Always に設定すると、データプロバイダーは暗号化を使用します。サーバーで

ワイヤ暗号化が許可されない場合はエラーが返されます。

Never に設定すると、データプロバイダーは暗号化を使用しません。サーバー

でワイヤ暗号化を要求された場合はエラーが返されます。

接続文字列で暗号化を指定しないと（デフォルト）、データプロバイダーはサー

バー設定の " 必要な場合 " と同等の値を反映します。

メモ：この接続文字列オプションはパフォーマンスに悪影響を与えることがあ

ります。詳細については、「アプリケーションのパフォーマンスに関する考慮点」

（2-13 ページ）を参照してください。

Encryption {Low | Medium | High}。データプロバイダーが許可する暗号化の低レベルを

決定します。

デフォルトの初期値は Medium （中）です。

これらの値の意味は使用する暗号化モジュールに応じて変わります。デフォル

トの暗号化モジュールでは、これらの値はそれぞれ 40 ビット、 56 ビット、およ

び 128 ビット暗号化に対応しています。

Enlist {True | False}。スレッドの現在のトランザクションコンテキストの作成中に、

データプロバイダーが接続への参加を自動的に試行するかどうかを指定しま

す。

メモ： Pervasive PSQL は分散トランザクションをサポートしないため、スレッ

ドの現在のトランザクションコンテキストでの接続への参加試行は失敗しま

す。

False に設定すると、データプロバイダーは接続への自動的な参加試行を行いま

せん。

True （デフォルトの初期値）に設定すると、現在のトランザクションコンテキ

ストが存在する場合にデータプロバイダーはエラーを返します。現在のトラン

ザクションコンテキストが存在しない場合、データプロバイダーは警告を発し

ます。

Host 接続する Pervasive PSQL サーバーの名前または IP アドレスを指定します。たと

えば、 Accountingserver などのサーバー名を指定できます。あるいは、

199.226.22.34 などの IP アドレスを指定できます。

デフォルトの初期値は localhost です。

別名： Server、 Server Name



2-6


Initial Command Timeout データプロバイダーが実行の試行を終了してエラーを生成するまでのデフォル

トの待機時間（秒単位のタイムアウト）を指定します。このオプションは、ア

プリケーションのコードに変更を加えることなく、 PsqlCommand オブジェクト

の CommandTimeout プロパティと同じ機能を提供します。その後、アプリケー

ションは CommandTimeout プロパティを使用して Initial Command Timeout 接続

文字列オプションを上書きすることができます。

デフォルトの初期値は 30 です。

たとえば、次の C# コード例では、接続文字列はコマンドの実行試行を終了する

までに 60 秒待機するよう指示しています。アプリケーションは、次に、 45 秒の

CommandTimeout を指定し、接続文字列で指定した値を上書きします。

PsqlCommand command = new PsqlCommand();PsqlConnection conn = new PsqlConnection("...; Initial

Command Timeout=60; ...");conn .Open();command.Connection = conn;// command.CommandTimeout は 60 を返しますcommand.CommandTimeout = 45;// command.CommandTimeout は 45 を返します

command = new PsqlCommand();command.CommandTimeout = 45;command.Connection = conn;// command.CommandTimeout は、依然として 45 を返します

メモ： CommandTimeout オプションの初期値に、サーバーのデッドロック検出

およびタイムアウトの大値より大きい値を設定します。これによって、アプ

リケーションはタイムアウトした場合により意味のある応答を受け取ることが

できます。

Initialization String セッションの設定を管理するために、データベースへの接続後直ちに発行され

るステートメントを指定します。

デフォルトの初期値は空文字列です。

例：NULL で埋められた CHAR 列を処理するには、次のように値を設定します。

Initialization String=SET ANSI PADDING ON

メモ：何らかの理由でステートメントが失敗した場合、Pervasive PSQL サーバー

への接続は失敗します。データプロバイダーは、サーバーから返されたエラー

を含む例外をスローします。

Load Balance Timeout 接続プールで接続を保持する秒数を指定します。接続プールマネージャーは定

期的にすべてのプールをチェックし、その存続時間を超過した接続を閉じたり

排除します。 Min Pool Size オプションの指定によって、一部の接続でこの値を

無視させることができます。

値は、 0 から 65335 までの任意の整数を指定できます。

0 （デフォルトの初期値）に設定すると、接続のタイムアウトは上限値になりま

す。

別名： Connection Lifetime



2-7


Load Balancing {True | False}。データプロバイダーがプライマリデータベースサーバーや代替

データベースサーバーへの接続において、クライアントロードバランスを使用

するかどうかを決定します。代替サーバーのリストは Alternate Servers 接続オプ

ションで指定されます。

True に設定すると、データプロバイダーはランダムな順序でデータベースサー

バーに接続しようとします。ロードバランスに関する詳細については、「クライ

アントロードバランスの使用」（3-10 ページ）を参照してください。

False （デフォルトの初期値）に設定すると、クライアントロードバランスは使

用されず、データプロバイダーはシーケンシャル（初にプライマリサーバー、

次に代替サーバーの指定された順）に各サーバーへ接続します。

メモ：このオプションは、Alternate Servers 接続文字列オプションで代替サーバー

が指定されていなければ作用しません。

Load Balancing 接続文字列オプションは、接続フェイルオーバーに関して使用す

ることができる任意の設定です。接続フェイルオーバーの説明やこの機能で設

定できるその他の接続文字列オプションに関する情報については、「接続フェイ

ルオーバーの設定」（3-12 ページ）を参照してください。

Max Pool Size 1 つのプール内の大接続数を指定します。大数に達したら、それ以上の接続

を接続プールに追加することはできません。



Max Statement Cache Size ステートメントキャッシュに保持できるステートメントの大数を指定しま

す。この値には 0、または 1 以上の整数を指定できます。

キャッシュサイズに 0 を設定すると、ステートメントキャッシングを無効にし

ます。


ほとんどの場合、ステートメントキャッシングを使用するとパフォーマンスが

向上します。このオプションがパフォーマンスに与える影響については、「アプ

リケーションのパフォーマンスに関する考慮点」（2-13 ページ）を参照してくだ

さい。

Min Pool Size 接続プールが初に作成されたとき、そのプールで開いている、もしくは置い

ておく接続の小数（下限）を指定します。接続プール内の一部の接続が LoadBalance Timeout 値を超えたとしても、接続プールにはこの小数の接続が保持

されます。


0 （デフォルトの初期値）に設定した場合、接続が閉じられて接続プールに送ら

れると、プールには元の接続のみが含まれます。

小プールサイズに 1 から 65535 の整数を設定すると、指定された数の接続の

複製がプールに保持されます。

プールがパフォーマンスに与える影響については、「アプリケーションのパ

フォーマンスに関する考慮点」（2-13 ページ）を参照してください。



2-8


Parameter Mode ネイティブパラメーターマーカーおよびバインディングの動作を指定します。

これにより、アプリケーションはプロバイダー固有の SQL コードを再利用でき、

Pervasive PSQL データプロバイダーへの移行を簡単にすることができます。

ANSI （デフォルトの初期値）に設定すると、 ? 文字はパラメーターマーカーと

して処理され、序数としてバインドされます。アプリケーションは BindByNameプロパティの動作をコマンド単位で切り替えられます。

BindByOrdinal に設定した場合、ネイティブパラメーターマーカーが使用され、

ストアドプロシージャおよび標準コマンド用に序数としてバインドされます。

BindByName に設定した場合、ネイティブパラメーターマーカーが使用され、

ストアドプロシージャおよび標準コマンド用に名前でバインドされます。

Password Pervasive PSQL データベースへの接続に使用するパスワード（大文字小文字の

区別なし）を指定します。パスワードは、データベースでセキュリティが有効

な場合にのみ必要です。パスワードが必要な場合は、システム管理者からパス

ワードを入手してください。

別名： PWD

Persist Security Info {True | False}。セキュリティで保護された情報を ConnectionString プロパティに

クリアテキストで表示するかどうかを指定します。

True に設定すると、 Password 接続文字列オプションの値はクリアテキストで表

示されます。

False （デフォルトの初期値）に設定すると、データプロバイダーはセキュリ

ティで保護された情報をクリアテキストで表示しません。

Pooling {True | False}。接続をプールするかどうかを指定します。接続プールに関する詳

細については、「接続プールの使用」（3-2 ページ）を参照してください。

True （デフォルトの初期値）に設定すると、接続プールが有効になります。

プールがパフォーマンスに与える影響については、「アプリケーションのパ

フォーマンスに関する考慮点」（2-13 ページ）を参照してください。

Port Pervasive PSQL データベースで動作しているリスナーの TCP ポートを指定しま

す。

デフォルトのポート番号は 1583 です。

PVTranslate {Auto | Nothing}。クライアントが、サーバーと適合するエンコードをネゴシエ

イトするかどうかを指定します。

Auto に設定した場合、データプロバイダーはサーバーのコードページを取得し

て、データをサーバーのコードページに変換します。

Nothing に設定すると変換は行われません。

Schema Collection Timeout 試行したスキーマコレクション操作が失敗した後、完了されないでいる間の秒

数を指定します。

0 に設定すると、データプロバイダーがスキーマコレクション操作の試行でタ

イムアウトすることはありません。




2-9


Schema Options 返されるデータベースメタデータを指定します。デフォルトで、データプロバ

イダーは、パフォーマンスに悪影響を与えるデータベースメタデータを返さな

いようにしてパフォーマンスを適化します。アプリケーションでデータベー

スメタデータを必要とする場合は、メタデータの名前または 16 進値を指定しま

す。

このオプションはパフォーマンスに影響することがあります。

ShowColumnDefaults または 0x04 を設定すると、列のデフォルトが返されます。

ShowParameterDefaults または 0x08 を設定すると、列のデフォルトが返されます。

FixProcedureParamDirection または 0x10 を設定すると、プロシージャ定義が返さ

れます。

ShowProcedureDefinitions または 0x20 を設定すると、プロシージャ定義が返され

ます。

ShowViewDefinitions または 0x40 を設定すると、ビュー定義が返されます。

ShowAll または 0xFFFFFFFF を設定すると、すべてのデータベースメタデータ

が返されます。

たとえば、プロシージャ定義の説明を返すには Options=ShowProcedureDefinitionsまたは Schema Options=0x20 を指定します。

複数の除外されたメタデータを表示するには、名前をカンマ区切りのリストで指

定するか、制限したい列コレクションの 16 進値の合計を指定します。たとえば、

プロシージャ定義とビュー定義（それぞれ 16 進値で 0x20 と 0x40）を返すには、Schema Options=ShowProcedureDefinitions, ShowViewDefinitionsまたは Schema Options=0x60 と指定します。

データプロバイダーが追加できるメタデータの名前および 16 進値については、

表 2-2 を参照してください。

メモ：この接続文字列オプションはパフォーマンスに悪影響を与えることがあ

ります。詳細については、「アプリケーションのパフォーマンスに関する考慮点」

（2-13 ページ）を参照してください。

Server DSN サーバー上のデータソースの名前、たとえば Server DSN=SERVERDEMO を指

定します。

デフォルト値は SERVERDEMO です。

メモ： 1 つの接続文字列に Database Name と Server DSN 接続文字列オプション

を混在させることはできません。



2-10


Statement Cache Mode ステートメントキャッシュモードを指定します。Statement Cache Mode はステー

トメントのキャッシュ動作を制御します。ステートメントは自動的にキャッ

シュされるか、またはコマンドが明示的にマークした場合にのみキャッシュさ

れます。

Auto に設定すると、ステートメントキャッシングは PsqlCommand プロパティ

の StatementCacheBehavior に暗黙的にマークされたステートメントに対して有

効になります。これらのコマンドは明示的にマークされたコマンドより低い優

先順位を持ちます。つまり、ステートメントプールが大ステートメント数に

達した場合、Cache とマークされたステートメント用の余地を作るため、Implicitとマークされたステートメントが初に削除されます。

ExplicitOnly （デフォルトの初期値）を設定すると、 StatementCacheBehavior によって Cache とマークされたステートメントのみがキャッシュされます。

ほとんどの場合、ステートメントキャッシングを有効にするとパフォーマンス

が向上します。このオプションがパフォーマンスに与える影響については、「ア

プリケーションのパフォーマンスに関する考慮点」（2-13 ページ）を参照してく

ださい。

Timestamp {DateTime | String}。データプロバイダーで、 Pervasive のタイムスタンプを文字

列として格納および取得するかどうかを指定します。

DateTime に設定するか、もしくは定義しない（デフォルト）と、データプロバ

イダーはタイムスタンプを .NET DateTime 型にマップします。この設定はネイ

ティブな精度が必要な場合、たとえば、 TimeStamp を含む PsqlCommandBuilderを使用する場合に適しています。

String に設定すると、タイムスタンプは文字列として返されます。データプロ

バイダーは、 Pervasive タイムスタンプを .NET String 型にマップします。

TimeType {DateTime | TimeSpan}。 Pervasive の Time を ADO.NET データプロバイダーの

Timespan または DateTime として取得するかどうかを指定します。

DateTime に設定すると、データプロバイダーは SQL の TIME 型を .NET のSystem.DateTime 型にマップします。

TimeSpan に設定すると、データプロバイダーは SQL の TIME 型を .NET のSystem.DateTimeSpan 型にマップします。

Trace File トレースファイルのパスと名前を指定します。

デフォルトの初期値は \PVSW_NETTrace.txt です。このファイルが存在しない場

合はデータプロバイダーが作成します。

Use Current Schema この接続文字列オプションはサポートされていません。これを設定すると、デー

タプロバイダーは例外をスローします。

User ID Pervasive PSQL データベースへの接続に使用するデフォルトの Pervasive PSQLユーザー名を指定します。

別名： UID



2-11


表 2-2 に、データプロバイダーが、返すデータから除外する列コレクション

の名前と 16 進値を挙げます。これは、スキーマオプションの接続文字列オ

プションでサポートされる値です。複数の値を指定するには、名前をカンマ

区切りのリストで指定するか、返したい列コレクションの 16 進値の合計を指

定します。たとえば、テーブルと列コレクションの説明およびプロシージャ

定義を返したい場合、 Schema Option=ShowProcedureDefinitions,ShowViewDefinitions または Schema Option=0x60 と指定します。

表 2-2 Pervasive PSQL 列コレクション

名前 16 進数の値コレクション / 列

ShowColumnDefaultsa 0x04 Columns/COLUMN_DEFAULT

ShowParameterDefaults 0x08 ProcedureColumns//PARAMETER_DEFAULT

FixProcedureParamDirection 0x10 ProcedureColumns/PARAMETER_TYPE

ShowProcedureDefinitions 0x20 Procedures/PROCEDURE_DEFINITION

ShowViewDefinitions 0x40 Views/VIEW_DEFINITION

ShowAll 0x7F All

a COLUMN_HAS_DEFAULT は、常にヌル値を返します。

2-12

アプリケーションのパフォーマンスに関する考慮点

アプリケーションのパフォーマンスに関する考慮点

アプリケーションのパフォーマンスは、接続文字列オプション、および、

いくつかのデータプロバイダーオブジェクトのプロパティに設定された

値の影響を受けます。

接続文字列オプション

Encrypt ：データ暗号化は、データの暗号化と復号化で必要となる追加オー

バーヘッド（主に CPU 使用）のため、パフォーマンスに悪影響を与えます。

Max Statement Cache Size：アプリケーションが使用する全プリペアドステートメントをキャッシュすれば、高のパフォーマンスを提供できるよ

うに思われます。しかし、この手法では、接続プールを使ってステートメ

ントキャッシングを実装した場合、データベースサーバーのメモリに負担

をかける結果になります。この場合、プールされた接続はそれぞれステー

トメントキャッシュを持ち、アプリケーションが使用する全プリペアドステートメントを含むことになります。キャッシュされた全ステートメント

は、データベースサーバーのメモリにも保持されます。

Pooling ：データプロバイダーが接続プールを使用できるようにしている

場合、パフォーマンスに影響する以下の追加オプションを定義できます。

Load Balance Timeout：接続をプールに保持する時間を定義できます。

プールマネージャーは、接続がプールに返されたときに接続の作成時

間をチェックします。作成時間を現在の時間と比較し、時間の間隔が

Load Balance Timeout オプションの値を超えていたら、接続を破棄しま

す。 Min Pool Size オプションの指定によって、一部の接続でこの値を

無視させることができます。

Connection Reset ：再利用される接続を初期設定に戻すと、その接続

はサーバーに対して余分なコマンドを発行する必要が生じるため、パ

フォーマンスに悪影響を与えます。

Max Pool Size：プールに格納できる接続数の大値の設定が低すぎる

と、接続が使用可能になるまでの時間が延期されます。大値の設定

が高すぎると、リソースを無駄に消費します。

Min Pool Size ：接続プールは、一意な接続文字列を使って初にデー

タベースへ接続したときに作成されます。 Min Pool Size が指定されて

いる場合、プールには小数の接続が格納されます。接続プール内の

一部の接続が Load Balance Timeout 値を超えたとしても、接続プール

にはこの小数の接続が保持されます。

Schema Options ：ある種のデータベースメタデータを返すことは、パ

フォーマンスに影響を与えます。アプリケーションのパフォーマンスを

適化するため、データプロバイダーは、パフォーマンスに悪影響を与える

プロシージャ定義やビュー定義などのデータベースメタデータを返さな

2-13


いようにします。アプリケーションがこれらのデータベースメタデータを

必要とする場合は、明確にそれを返すよう要求する必要があります。

複数の種類の除外されたメタデータを返すには、名前をカンマ区切りリス

トで指定するか、返したい列コレクションの 16 進値の合計を指定します。

たとえば、プロシージャ定義とビュー定義を返すには以下のいずれかを指

定します。

Schema Option=ShowProcedureDefinitions, ShowViewDefinitions

Schema Options=0x60

Statement Cache Mode：ほとんどの場合、ステートメントキャッシングを

有効にするとパフォーマンスが向上します。プリペアドステートメント（コ

マンドインスタンス）のキャッシングを有効にするには、このオプション

を Auto に設定します。アプリケーションが、暗黙的にステートメント

キャッシュに含めるとマークされたプリペアドステートメントを持つ場合

は、この設定を使用します。または、暗黙的に含めるステートメントがい

くつかあり、その他は明示的に含める場合、この設定を使用します。ステー

トメントキャッシュに Cache とマークされたプリペアドステートメントの

みを含めたい場合は、 1） Command オブジェクトの StatementCacheBehaviorプロパティに Cache を設定し、 2）このオプションに ExplicitOnly を設定し

ます。

プロパティ

StatementCacheBehavior：アプリケーションがその存続期間中にプリペア

ドステートメントを複数回再使用する場合、ステートメントキャッシュを

使用することによってパフォーマンスに影響を及ぼすことができます。こ

のプロパティは、プリペアドステートメント（Command オブジェクトの

インスタンス）がステートメントキャッシング中にどのように処理される

かを決定します。

Cache に設定すると、プリペアドステートメントはステートメントキャッ

シュに含められます。

Implicit に設定して Statement Cache Mode 接続文字列オプションに Auto を設定すると、プリペアドステートメントはステートメントキャッシュに含

められます。

DoNotCache に設定すると、プリペアドステートメントはステートメント

キャッシュから除外されます。

特定のステートメントをキャッシングすることによるパフォーマンスへの

影響を判断するには、接続統計情報を使用できます（「接続統計情報による

パフォーマンスの分析」（3-24 ページ）を参照してください）。

2-14

データ型

データ型

表 2-3 から 2-6 は、 Pervasive PSQL データプロバイダーでサポートされる

データ型を示しています。

表 2-3 は、 Pervasive データ型と .NET Framework 型の対応表です。

表 2-4 は、 System.Data.DbType のみが指定されている場合にデータプロバイダーが使用するデータ型の対応表です。

表 2-5 は、プロバイダー固有のデータ型も System.Data.DbType も指定

されていない場合に、データプロバイダーがデータ型を推定するため

に使用するデータ型の対応表です。

表 2-6 は、長いデータパラメーターへの入力としてストリームが使用

される場合にデ―タプロバイダーが使用するデータ型の対応表です。

Pervasive データ型から .NET Framework データ型へのマッピング

表 2-3 では Pervasive PSQL データプロバイダーでサポートされるデータ型

と、対応する .NET Framework 型を示します。この表で、DataAdapter を使っ

て DataSet を埋めるときに使用するデータ型を確認してください。

また、この表では DataReader オブジェクトを直接使用する場合にデータへ

アクセスするための適切なアクセサーも示します。

［Pervasive データ型］列は、ネイティブなデータ型の名前を示してい

ます。

［PsqlDbType］列は、Pervasive PSQL データプロバイダーのデータ型の

列挙を示します。基本的には、ネイティブデータ型と PsqlDbType とは 1 対 1 で対応しています。ただし、Pervasive データ型 NUMBER は、

Decimal または Double のどちらにも対応しているので、この限りでは

ありません。

［.NET Framework 型］列は .NET Framework で使用可能な基本データ型

を示します。

［.NET Framework 型指定されたアクセサー］列は、 DataReader を使用

する場合に、この型の列へのアクセスに使用する必要があるメソッド

を示します。

表 2-3 Pervasive データ型のマッピング

Pervasive データ型 PsqlDbType .NET Framework 型 .NET Framework 型指定

されたアクセサー

BFLOAT4 BFloat4 Single GetSingle( )

BFLOAT8 BFloat8 Double GetDouble()

2-15


BIGINT BigInt Int64 GetDecimal( )

BINARY Binary Byte[] GetBytes( )

BIT Bit Byte[] GetBytes( )

CHAR Char String

Char[]

GetString( )

GetChars( )

CURRENCY Currency Decimal GetDecimal( )

DATE Date DateTime GetDateTime()

DATE/TIME DateTimea DateTime GetDateTime()

DECIMAL Decimal Decimal GetDecimal( )

DOUBLE Double Double GetDouble()

FLOAT Float Double GetDouble()

IDENTITY Identity Int32 GetInt32( )

INTEGER Integer Int32 GetInt32( )

LONGVARBINARY LongVarBinary Byte[] GetBytes( )

LONGVARCHAR LongVarChar Byte[] GetBytes( )

MONEY Money Decimal GetDecimal( )

NUMERIC Decimal Decimal GetDecimal( )

NUMERICSA DecimalSA Decimal GetDecimal( )

NUMERICSTS DecimalSTS Decimal GetDecimal( )

REAL Real Single GetSingle( )

SMALLIDENTITY SmallIdentity Int16 GetInt16( )

SMALLINT SmallInt Int16 GetInt16( )

TIME Time Timespanb GetValue()

TIMESTAMP Timestamp DateTime GetDateTime()

TINYINT TinyInt SByte GetByte( )




2-16

データ型

パラメーターデータ型のマッピング

パラメーターのデータ型は、データプロバイダーごとに固有のものを使用

します。 Pervasive PSQL データプロバイダーは、パラメーター値をサー

バーに送信する前にネイティブの形式に変換する必要があります。アプリ

ケーションでパラメーターを記述するもよい方法は、データプロバイ

ダー固有の型の列挙を使用することです。

汎用プログラミングでは、データプロバイダー固有の型を使用できない場

合があります。プロバイダー固有の DB 型が指定されていない場合は、パ

ラメーター値の System.Data.DbType または .NET Framework 型からデータ

型が推定されます。

Pervasive PSQL データプロバイダーは、次の順序でパラメーターのデータ

型を推定します。

データプロバイダー固有のデータ型が指定されている場合は、それを

使用します。

System.Data.DbType は指定されているけれども、データプロバイダー

固有のデータ型が指定されていない場合は、 System.Data.DbType から

データ型を推定します。

データプロバイダー固有のデータ型も System.Data.DbType も指定さ

れていない場合は、 .NET Framework 型からデータ型を推定します。

表 2-4 では System.Data.DbType のみが指定された場合に Pervasive PSQL で推定されるデータ型を示します。

UBIGINT UBigInt UInt64 GetUInt64()

UNIQUE_IDENTIFIER UniqueIdentifier* String GetString( )

UINTEGER UInteger UInt32 GetUInt32( )

USMALLINT USmallInt UInt16 GetUInt16( )

UTINYINT UTinyInt Byte GetByte( )

VARCHAR VarChar String

Char[]

GetString( )

GetChars( )

a Pervasive PSQL 9.5 以上でサポートされます。

b timetype 接続オプションの設定によって異なります。




2-17


表 2-4 System.Data.DbTypes から PsqlDbTypes へのマッピング

System.Data.DbType PsqlDbType

AnsiString VarChar

AnsiStringFixedLength Char

Binary Binary

Boolean Integer

Byte Integer

Currency Currency

Date Date

DateTime DateTimea

a Pervasive PSQL v9.5 以上でサポートされます。

Decimal Decimal または Money

Double Double

Float Float

GUID UniqueIdentifier*

Int16 SmallInt

Int32 Integer

Int64 BigInt

Sbyte Integer

Single BFloat4

String VarChar

StringFixedLength Char

Time Time

Uint16 USmallInt

Uint32 UInteger

Uint64 UBigInt

VarNumeric Decimal

2-18

データ型

表 2-5 では、プロバイダー固有のデータ型も System.Data.DbType も指定さ

れない場合に、データプロバイダーがデータ型を推定するために使用する

対応表を示します。

表 2-5 .NET Framework 型から PsqlDbType へのマッピング

.NET Framework 型 PsqlDbType

Boolean Integer

Byte Integer

Byte[] Binary

DateTime Timestamp

Decimal Decimal

Double Double

Int16 SmallInt

Int32 Integer

Int64 BigInt

Single BFloat4

String VarChar

Uint16 USmallInt

Uint32 UInteger

Uint64 UBigInt

2-19


ストリームオブジェクトでサポートされるデータ型

Pervasive PSQL プロバイダーは、表 2-6 に挙げられているデータ型に対し、

長いデータパラメーターへの入力としてストリームを使用することをサ

ポートしています。

ストリームの説明については、「長いデータパラメーターへの入力として

ストリームを使用する」（2-21 ページ）を参照してください。

表 2-6 サポートされるストリームオブジェクト

プロバイダーデータ型サポートされるストリーム型

LONGVARBINARY Stream

LONGVARCHAR TextReader

2-20

長いデータパラメーターへの入力としてストリームを使用する

長いデータパラメーターへの入力としてストリームを使用するビデオクリップや大量のドキュメントなど非常に大きなバイナリ値やテ

キスト値を表すために、不連続なメモリの使用を許可することによって、

パフォーマンス、機能性、スケーラビリティが向上します。

バイナリデータの読み取りに使用されるストリームオブジェクトは

System.IO.Stream オブジェクトから派生し、Framework データ型の byte[] を使用します。

System.IO.BufferedStream

System.IO.FileStream

System.IO.MemoryStream

System.Net.Sockets.NetworkStream

System.Security.Cryptography.CryptoStream

テキストデータを読み込むために使用するストリームオブジェクトは

System.IO.TextReader オブジェクトから派生し、 Framework データ型の

string を使用します。

System.IO.StreamReader

System.IO.StringReader

ストリームを使用できるようにするには、 PsqlParameter オブジェクトの

Value プロパティにストリームの特定のインスタンスを設定します

（「PsqlParameter オブジェクト」（6-16 ページ）を参照してください）。コマ

ンドが実行されると、データプロバイダーはストリームから読み込んで値

を抽出します。

データプロバイダーに付属する用例には、ランダムに生成されるデータを

使用して LONGVARCHAR 列と LONGVARBINARY 列にデータを挿入す

るコード例が含まれています。また、用例では、ストリームオブジェクト

を LONGVARCHAR 列および LONGVARBINARY 列への入力として使用

する方法も示しています。

2-21


パラメーターマーカー

パラメーターマーカー（ストアドプロシージャで使用するものも含む）は、

Pervasive PSQL データプロバイダーでは SQL ステートメントで ? 記号を使

用することによって指定されます。

UPDATE emp SET job = ?, sal = ?WHERE empno = ?

パラメーターには名前が付いていないため、 SQL ステートメントにあるパ

ラメーターの順番どおりにバインドされなければなりません。つまり、

PsqlParameterCollection オブジェクトの Add() メソッド（Parameter オブジェ

クトをコレクションに追加する）の呼び出しは、コマンドテキストに現れ

る "?" の順番どおりに発生する必要があるということです。

2-22

パラメーター配列

パラメーター配列パラメーター配列のバインドは通常 Insert ステートメントで使用され、

テーブルを埋めるために必要な時間を短縮します。アプリケーションは

1 回のコマンド実行で複数のパラメーター値の行を指定することができま

す。それらの値を 1 回の往復（バックエンドデータベース本来の能力に

よって異なる）でデータベースサーバーに送ることができます。

Pervasive PSQL データプロバイダーでは Insert および Update ステートメン

トに対して入力パラメーター配列をサポートします。

2-23


ストアドプロシージャ

アプリケーションでストアドプロシージャを使用できるようにするには、

次の手順に従ってください。

PsqlCommand オブジェクトの CommandText プロパティにストアドプロシージャ名を設定します。

MyCommand.CommandText = "GetEmpSalary";

PsqlCommand オブジェクトの CommandType プロパティに StoredProcedureを設定します。

MyCommand.CommandType = CommandType.StoredProcedure;

必要に応じてパラメーター引数を指定します。アプリケーションでは

PsqlCommand オブジェクトのパラメーターコレクションに、ストアド

プロシージャの引数の順序どおりにパラメーターを追加してくださ

い。ただし、アプリケーションでは PsqlCommand オブジェクトの

CommandText プロパティでパラメーターマーカーを指定する必要は

ありません。

ストアドプロシージャから戻り値を取得するには、アプリケーションで

PsqlCommand オブジェクトのパラメーターコレクションにパラメーター

を余分に追加する必要があります。このパラメーターの ParameterDirectionプロパティを ParameterDirection.ReturnValue に設定します。戻り値の取得

用のパラメーターは、パラメーターコレクションのどこにあってもかまい

ません。これは、このパラメーターが、 PsqlCommand オブジェクトの Textプロパティにある特定のパラメーターマーカーに対応していないためで

す。

ストアドプロシージャからの戻り値がない場合は、ParameterDirection プロ

パティにバインドされているパラメーターは無視されます。

ストアドプロシージャがデータベースから ReturnValue を返しても、アプ

リケーションでそのパラメーターをバインドしていない場合は、データプロバイダーによってその値が破棄されます。

2-24

トランザクションのサポート

トランザクションのサポート

Pervasive PSQL データプロバイダーは、完全に .NET Framework 内で実装

されるトランザクションのサポートにはマネージコードのみを使用しま

す。

ローカルトランザクションは基盤となるデータベースの内部的なトラン

ザクションマネージャーを使用します。

アプリケーションでは PsqlConnection オブジェクトで BeginTransaction を呼び出すことによって PsqlTransaction オブジェクトを作成します。トラン

ザクションのコミットや中止などその後の操作は PsqlTransaction オブジェ

クトで実行されます。

2-25


スレッドのサポート PsqlConnection オブジェクトはスレッドセーフです。それぞれ別のスレッ

ドでアクセスする複数の PsqlCommand オブジェクトが、同時に 1 つの接続

を使用できます。

別々のスレッドでほかのパブリックオブジェクトやデータプロバイダー

固有のオブジェクトに同時にアクセスするのはスレッドセーフではあり

ません。

2-26

Unicode のサポート

Unicode のサポート Pervasive PSQL データプロバイダーでは、 .NET Framework SDK の規定に

従って Unicode をサポートします。これは、データプロバイダーでは

Unicode UTF-16 エンコーディングで文字を表わすことを意味します。

データプロバイダーは UTF-16 文字をデータベースで使用されている形式

に変換し、 .NET Framework 文字列をアプリケーションに返します。たとえ

ば、Pervasive PSQL データベースコードページが拡張 ASCII 形式である場

合、 Pervasive PSQL データプロバイダーは拡張 ASCII を使用してデータ

ベースに送られた文字を表します。その後、データプロバイダーはアプリ

ケーションに送り戻される前に、返された拡張 ASCII 文字を変換します。

Unicode と国際的な文字の .NET Framework 実装に関する詳細については、

.NET Framework SDK のドキュメントを参照してください。

2-27


分離レベル Pervasive PSQL では ReadCommitted と Serializable の分離レベルをサポート

します。 Pervasive PSQL はレコードレベルのロックをサポートします。詳

細については「ロックレベルと分離レベル」（9-1 ページ）を参照してくだ

さい。

2-28

SQL エスケープシーケンス

SQL エスケープシーケンス Pervasive PSQL データプロバイダーでサポートする SQL エスケープシー

ケンスの説明については、「.NET の SQL エスケープシーケンス」（8-1 ペー

ジ）を参照してください。

2-29


イベント処理イベントハンドラーは PsqlInfoMessageEventArgs 型の引数を受け取りま

す。これにはイベントに関するデータが含まれています。詳細については、

「PsqlInfoMessageEventArgs オブジェクト」（6-15 ページ）を参照してくださ

い。

このイベントは次のように定義されます。

public event PsqlInfoMessageEventHandler InfoMessage;

データベースサーバーから送られる警告や情報メッセージを処理したいク

ライアントは、このイベントを受け取るために PsqlInfoMessageEventHandlerデリゲートを作成してください。

これらのイベントを使用して、パッケージ、ストアドプロシージャ、また

はストアド関数（これらはすべてコマンドを作成します）の作成時に発生

するエラーを取得することがでます。パッケージ、ストアドプロシージャ

またはストアド関数で作成されたコマンドをコンパイルするときに

Pervasive PSQL でエラーが検出されると、有効ではありませんがオブジェ

クトが作成されます。イベントが送られ、エラー発生したことを示します。

次のコードでは、PsqlConnection オブジェクトの InfoMessage イベントを処

理するメソッドを表わすデリゲートを定義しています。

[Serializable]public delegate void PsqlInfoMessageEventHandler( object sender PsqlInfoMessageEventArgs e );

ここで、 sender はイベントを生成したオブジェクト、 e は警告を説明する

PsqlInfoMessageEventArgs オブジェクトです。イベントとデリゲートの詳細

については、 Microsoft .NET Framework SDK のドキュメントを参照してく

ださい。

2-30

エラー処理

エラー処理 PsqlError オブジェクトは、 Pervasive PSQL サーバーで生成されたエラーや

警告に関する情報を収集します。詳細については、「PsqlError オブジェク

ト」（6-13 ページ）を参照してください。

PsqlException オブジェクトは、 Pervasive PSQL サーバーがエラーを返した

ときに作成されスローされます。データプロバイダーによって生成された

例外は標準のランタイム例外として返されます。詳細については、

「PsqlException オブジェクト」（6-14 ページ）を参照してください。

2-31


.NET オブジェクトの使用 Pervasive PSQL データプロバイダーでは .NET パブリックオブジェクトを

サポートし、それらをシールドオブジェクト（封印されたオブジェクト）

として公開します。

詳細については、「サポートされる .NET オブジェクト」（6-1 ページ）を参

照してください。

2-32

.NET 用アプリケーション開発のためのその他のリソース

.NET 用アプリケーション開発のためのその他のリソース

データコンシューマーアプリケーションの開発者は、 Microsoft .NET の仕

様やオブジェクト指向のプログラミング技術に精通している必要がありま

す。

Microsoft では以下のような ADO.NET に関する豊富な情報（主に英語）を

Web 上で提供しています。

「Microsoft .NET へのアップグレード」 - 「ADO プログラマのための

ADO.NET」http://msdn.microsoft.com/ja-jp/library/aa302323.aspx

「.NET Framework データプロバイダーによるデータのアクセス」 http://msdn.microsoft.com/ja-jp/library/aa735598(VS.71).aspx

「ADO.NET 2.0 基本クラスおよびファクトリによる汎用的なコーディ

ング」

http://www.microsoft.com/japan/msdn/vs05/adonet/vsgenerics.aspx

「セキュリティポリシーにおける善の実施」

http://msdn2.microsoft.com/en-us/library/sa4se9bc(vs.71).aspx

「サービスコンポーネントの作成」

http://msdn.microsoft.com/ja-jp/library/3x7357ez.aspx

「DataSet の作成および使用」

http://msdn.microsoft.com/ja-jp/library/aa719836(VS.71).aspx

「XML と DataSet」http://msdn.microsoft.com/ja-jp/library/aa735754(VS.71).aspx

2-33

http://msdn2.microsoft.com/ja-jp/library/aa302323.aspx


http://www.microsoft.com/japan/msdn/vs05/adonet/vsgenerics.aspx

http://msdn2.microsoft.com/en-us/library/sa4se9bc(vs.71).aspx

http://msdn.microsoft.com/ja-jp/library/3x7357ez.aspx




2-34

3
ADO.NET の高度な機能
この章には、データプロバイダーの高度な機能を説明する以下のセクショ

ンが含まれます。

「接続プールの使用」（3-2 ページ）

「ステートメントキャッシングの使用」（3-6 ページ）

「接続フェイルオーバーの使用」（3-8 ページ）

「クライアントロードバランスの使用」（3-10 ページ）

「接続の再試行機能の使用」（3-11 ページ）

「セキュリティの設定」（3-14 ページ）

「Pervasive Bulk Load の使用」（3-15 ページ）

「診断機能の使用」（3-22 ページ）

3-1


接続プールの使用接続プールを使用すれば、作成済みの接続を再利用できるので、データプロバイダーはデータベースに接続するたびに新しい接続を作成する必要が

なくなります。Pervasive PSQL データプロバイダーでは .NET クライアント

アプリケーションで自動的に接続プールを使用できるようになりました。

接続プールの動作は、接続文字列オプション（「接続文字列オプション」（2-4 ページ）を参照）によって制御することができます。たとえば、接続プー

ル数、プール内の接続数、接続が破棄されるまでの時間（秒数）を定義す

ることができます。

ADO.NET の接続プールは .NET Framework によって提供されません。

ADO.NET データプロバイダー自体に実装する必要があります。

接続プールの作成

各接続プールは、それぞれ特有の接続文字列と関連付けられます。デフォ

ルトでは、接続プールは一意な接続文字列を使って初にデータベースに

接続したときに作成されます。プールには、プールの小限のサイズまで

接続が格納されます。プールが大限のサイズに達するまで、接続がプー

ルに追加されていきます。

プールは、その中で接続が開いている限り、あるいは、Connection オブジェ

クトへの参照を持つアプリケーションによって使用されており、そのオブ

ジェクトに開いている接続がある限り、アクティブであり続けます。

新しい接続を開いたとき、その接続文字列が既存のプールと一致しない場

合は、新しいプールを作成する必要があります。同じ接続文字列を使用す

ることで、アプリケーションのパフォーマンスやスケーラビリティを向上

させることができます。

以下の C# コード例では、3 つの新しい PsqlConnection オブジェクトが作成

されます。ただし、これらのオブジェクトを管理するために必要な接続プー

ルは 2 つのみです。 1 番目と 2 番目の接続文字列では、ユーザー ID とパス

ワードに割り当てられる値だけが異なることに注意してください。


DbConnection conn1 = Factory.CreateConnection();conn1.ConnectionString =

"ServerDSN=DEMODATA;UserID=test;Password=test;Host=localhost";

conn1.Open();// プール A が作成されます

3-2

接続プールの使用

DbConnection conn2 = Factory.CreateConnection();conn2.ConnectionString =

"ServerDSN=DEMODATA2;UserID=lucy;Password=quake;Host=localhost";

conn2.Open();// 接続文字列が異なるため、プール B が作成されますDbConnection conn3 = Factory.CreateConnection();conn3.ConnectionString =

"ServerDSN=DEMODATA;UserID=test;Password=test;Host=localhost";

conn3.Open();// conn3 は conn1 と一緒にプール A に入ります

プールへの接続の追加

接続プールは、アプリケーションが使用する一意な接続文字列を作成して

いる中に作成されます。プールが作成されると、 Min Pool Size 接続文字

列オプションによって設定される、プールの必要小限のサイズ条件を満

たすだけの接続がプールに格納されます。アプリケーションが Min PoolSize を超える接続を使用する場合、データプロバイダーは Max Pool Size 接続文字列オプション（プール内の大接続数を設定します）の値になるま

で、プールに接続を追加割り当てします。

Connection.Open(...) メソッドを呼び出すアプリケーションで Connection オブジェクトが要求されたとき、プールから使用可能な接続が入手できる場

合には、接続はプールから取得されます。使用可能な接続とは、現在ほか

の有効な Connection オブジェクトによって使用されておらず、合致する分

散トランザクションコンテキストを持ち（妥当な場合）、サーバーへの有

効なリンクを持っている接続と定義付けられます。

プールの大サイズに達し、かつ入手できる使用可能な接続がない場合に

は、要求はデータプロバイダーのキューに入れられます。データプロバイ

ダーは使用可能な接続をアプリケーションへ返すために、 ConnectionTimeout 接続文字列オプションの値が示す時間だけ待ちます。この時間が

経過しても接続が入手可能にならなかった場合は、データプロバイダーは

アプリケーションにエラーを返します。

重要：PsqlConnection オブジェクトの Close() または Dispose() メソッドを使

用して接続を閉じると、その接続はプールに追加されるか戻されます。ア

プリケーションで Close() メソッドを使用した場合、接続文字列の設定は

Open() メソッドを呼び出す前の状態にとどまります。 Dispose メソッドを

使用して接続を閉じた場合には、接続文字列の設定は消去され、デフォル

トの設定に戻されます。

プールからの接続の削除

接続プールから接続が削除されるのは、Load Balance Timeout 接続文字列オ

プションで決められた存続時間が過ぎた場合や、接続文字列の一致する新

3-3


しい接続がアプリケーションによって開始された（PsqlConnection.Open()が呼び出された）場合です。

接続プールの接続をアプリケーションに返す前に、プールマネージャーは

その接続がサーバー側で閉じられているかどうかを確認します。接続が有

効でなくなっていれば、プールマネージャーはその接続を破棄し、プール

から別の入手可能で有効な接続を返します。

.NET Framework Version 2.0 で導入された Connection オブジェクトの ClearPool および Clear All Pools メソッドは、接続プールを空にします。ClearPoolは特定の接続に関連付けられている接続プールを空にします。対照的に、

ClearAllPools はデータプロバイダーによって使用されるすべての接続

プールを空にします。メソッドを呼び出すときに使用中だった接続は、閉

じるときに破棄されます。

メモ：デフォルトで、無効な接続を破棄することによって、接続数が MinPool Size 属性で指定した数より少なくなった場合、新しい接続はアプリ

ケーションで必要になるまで作成されません。

プール内の停止接続の処理

アイドル状態の接続が、そのデータベースへの物理的接続を失った場合に

は何が起こるのでしょうか。たとえば、データベースサーバーが再起動さ

れたり、ネットワークが一時的に中断されるとします。プール内の既存の

Connection オブジェクトを使って接続しようとするアプリケーションは、

データベースへの物理的接続が失われているため、エラーを受け取る可能

性があります。

Pervasive PSQL データプロバイダーはこの状況をユーザーに意識させない

で処理します。 Connection.Open() では、データプロバイダーは単に接続

プールから接続を返すだけなので、アプリケーションはこのとき何のエ

ラーも受け取りません。 SQL ステートメントを実行するために Connectionオブジェクトが初めて使用されたとき（たとえば、Command オブジェクト

の Execute メソッドを介して）、データプロバイダーはサーバーへの物理的

接続が失われていることを検出し、 SQL ステートメントを実行する前に

サーバーへの再接続を試みます。データプロバイダーがサーバーへ再接続

できた場合、アプリケーションには SQL の実行結果が返され、エラーは何

も返されません。データプロバイダーはこのシームレスな再接続を試みる

際、接続フェイルオーバーオプションが有効になっていればそれを利用し

ます。プライマリサーバーが使用できないときはバックアップサーバーへ

接続するようデータプロバイダーを構成する方法については、「接続フェ

イルオーバーの使用」（3-8 ページ）を参照してください。

メモ：データプロバイダーは、SQL ステートメントの実行時にデータベー

スサーバーへの再接続を試みることができるため、ステートメントが実行

されるときに接続エラーをアプリケーションへ返すことができます。デー

タプロバイダーがサーバーに再接続できない（たとえば、サーバーがまだ

ダウンしている）場合、実行メソッドは再接続の試行が失敗したことと、

その接続が失敗した理由の詳細を知らせるエラーをスローします。

3-4

接続プールの使用

この接続プール内の停止接続を処理する技術には、接続プールメカニズム

を超越して高のパフォーマンスを得られるという効果があります。一部

のデータプロバイダーは、接続がアイドル状態である間、ダミーの SQLステートメントを使って定期的にサーバーに ping を実行します。その他の

データプロバイダーは、アプリケーションから接続プール内の接続の使用

を要求されたときにサーバーに ping を実行します。これらの手法はいずれ

もデータベースサーバーへの往復を追加するため、結局のところ、アプリ

ケーションの通常の操作が発生している間ずっと、アプリケーションの速

度が落ちます。

接続プールのパフォーマンスの追跡

PSQL データプロバイダーは、このデータプロバイダーを使用するアプリ

ケーションの調整およびデバッグが行える PerfMon カウンターのセットを

インストールします。 PerfMon カウンターの詳細については、「PerfMon のサポート」（3-23 ページ）を参照してください。

3-5


ステートメントキャッシングの使用ステートメントキャッシュは、プリペアドステートメントのグループまた

は Command オブジェクトのインスタンスで、アプリケーションによって

再使用が可能です。ステートメントキャッシュを使用するとアプリケー

ションのパフォーマンスを向上させることができます。これは、プリペア

ドステートメントの動作が、そのステートメントがアプリケーションの存

続期間中に何度再使用されたとしても、 1 度だけ実行されるためです。

キャッシュ内のステートメントの有効性を分析することができます（「接続

統計情報によるパフォーマンスの分析」（3-24 ページ）を参照してくださ

い）。

ステートメントキャッシュは物理接続に属します。実行された後、プリペ

アドステートメントはステートメントキャッシュに置かれ、接続が閉じら

れるまで保持されます。

ステートメントキャッシングは複数のデータソースをまたいで使用でき、

ADO.NET Entity Framework および Data Access Application Blocks を使う

Microsoft Enterprise Libraries のような抽象化技術の下で使用できます。

ステートメントキャッシングの有効化

デフォルトで、ステートメントキャッシングは無効になっています。

Pervasive PSQL 3.1 データプロバイダーを使用する既存のアプリケーショ

ンで、アプリケーションコードをまったく変更せず、ステートメント

キャッシングを有効にするには、Statement Cache Mode 接続文字列オプショ

ンに Auto を設定します。この場合は、すべてのステートメントをステート

メントキャッシュに置くことができます。

キャッシュすると明示的にマークしたステートメントのみをステートメン

トキャッシュに置くように、ステートメントキャッシングを設定すること

もできます。これを行うには、そのステートメントの Command オブジェ

クトの StatementCacheBehavior プロパティに Cache を設定し、 StatementCache Mode 接続文字列オプションに ExplicitOnly を設定します。

表 3-1 はステートメントキャッシング設定とその影響を要約したもので

す。

3-6

ステートメントキャッシングの使用

ステートメントキャッシング手法の選択

ステートメントキャッシングを使用すると、アプリケーションの存続期間

中にプリペアドステートメントを複数回再使用するアプリケーションは

パフォーマンスが向上します。ステートメントキャッシュのサイズは MaxStatement Cache Size 接続文字列オプションに設定します。ステートメント

キャッシュのスペースが限られている場合は、 1 度しか使用されないプリ

ペアドステートメントをキャッシュしないでください。

アプリケーションが使用する全プリペアドステートメントをキャッシュ

すれば、高のパフォーマンスを提供できるように思われます。しかし、

この手法では、接続プールを使ってステートメントキャッシングを実装し

た場合、データベースのメモリに負担をかける結果になります。この場合、

プールされた接続はそれぞれステートメントキャッシュを持ち、アプリ

ケーションが使用する全プリペアドステートメントを含むことになりま

す。これらのプールされたプリペアドステートメントは、すべてデータ

ベースのメモリにも保持されます。

表 3-1 ステートメントキャッシュ動作の要約

設定

動作 StatementCacheBehavior Statement Cache Mode

ステートメントを明示的にステートメント

キャッシュに追加します。

Cache ExplicitOnly （デフォルト）

ステートメントをステートメントキャッシュ

に追加します。必要に応じ、ステートメント

は、Cache とマークされたステートメント用の

場所を空けるために削除されます。

Implicit （デフォルト） Auto

ステートメントをステートメントキャッシュ

から明確に除外します。

DoNotCache Auto または ExplicitOnly

3-7


接続フェイルオーバーの使用接続フェイルオーバーによって、ハードウェア障害やトラフィックの過負

荷などが原因でプライマリデータベースサーバーが利用できなくなった

場合でも、アプリケーションは代替またはバックアップデータベースサー

バーに接続することができます。接続フェイルオーバーは、重要な .NETアプリケーションが依存するデータを常に使用可能な状態にします。

プライマリサーバーが接続を受け入れない場合に接続を試行する代替

データベースのリストを設定することで、 Pervasive PSQL データプロバイ

ダーにおける接続フェイルオーバー機能をカスタマイズすることができま

す。接続が成功するまで、あるいはすべての代替データベースへの接続を

指定した回数試行するまで、接続の試行が続けられます。

たとえば、図 3-1 は複数のデータベースサーバーを持つ環境を示していま

す。データベースサーバー A はプライマリデータベースサーバー、デー

タベースサーバー B は 1 番目の代替サーバー、そしてデータベースサー

バー C は 2 番目の代替サーバーとして設計されています。

図 3-1 接続フェイルオーバー

まず、アプリケーションはプライマリデータベースであるデータベース

サーバー A （1）に接続を試みます。接続フェイルオーバー機能を有効に

すると、アプリケーションがデータベースサーバー A に接続できなかった

場合はデータベースサーバー B （2）に接続を試みます。その接続の試行

も失敗した場合、アプリケーションはデータベースサーバー C （3）に接

続を試みます。

このシナリオで、低でもどれか 1 つのサーバーへは接続できると思われ

ますが、接続にすべて失敗した場合、データプロバイダーはプライマリ

サーバーと各代替データベースに対し指定の回数分だけ接続を再試行させ

ることができます。接続の再試行（Connection Retry Count）機能を使用

3-8

接続フェイルオーバーの使用

すれば、試行回数を指定することができます。接続の試行間隔（ConnectionRetry Delay）機能を使用すれば、接続の試行間隔を秒数で指定することも

できます。接続の再試行の詳細については、「接続の再試行機能の使用」（3-11 ページ）を参照してください。

Pervasive PSQL データプロバイダーは、現在対象としている代替サーバー

との通信が確立できなかった場合にのみ、次の代替サーバーへフェイル

オーバーします。データプロバイダーがデータベースとの通信に成功した

が、ログイン情報が正しくないなどの原因でそのデータベースが接続要求

を拒否した場合、データプロバイダーは例外を生成し、代替サーバーリス

ト内の次のデータベースへは接続を試行しません。これは、各代替サーバー

がプライマリサーバーのミラーであり、認証パラメーターや関連情報がす

べて同じであることが前提です。

接続フェイルオーバーでは新しい接続のみを保護し、トランザクションや

クエリの状態は保持しません。ご使用のデータプロバイダーにおける接続

フェイルオーバーの設定の詳細については、「接続フェイルオーバーの設

定」（3-12 ページ）を参照してください。

3-9


クライアントロードバランスの使用

クライアントロードバランスは接続フェイルオーバーと共に動作して

ユーザーの環境で新しい接続を分散することで、接続要求に対応できない

サーバーがないようにします。接続フェイルオーバーとクライアントロー

ドバランスがどちらも有効な場合、プライマリデータベースおよび代替

データベースへ接続が試行される順序はランダムです。

たとえば、図 3-2 に示すようにクライアントロードバランスが有効になっ

ているとします。

図 3-2 クライアントロードバランスの例

まず、データベースサーバー B への接続が試行されます（1）。それから

データベースサーバー C への接続が試行され（2）、続いてデータベース

サーバー A への接続が試行されます（3）。その後、これと同じ順序で接続

が試行されます。対照的に、このシナリオでクライアントロードバランス

が無効だった場合、各データベースへの接続の試行はシーケンシャルな順

序で行われます。つまり、初にプライマリサーバーに試行したら、その

後は代替サーバーリスト内のエントリ順に基づいて代替サーバーに試行

します。

ご使用のデータプロバイダーにおけるクライアントとロードバランスの

設定の詳細については、「接続フェイルオーバーの設定」（3-12 ページ）を


3-10

接続の再試行機能の使用

接続の再試行機能の使用接続の再試行では、データプロバイダーが初の接続の試行に失敗した後

に、プライマリサーバーおよび（設定している場合）代替サーバーへ接続

を試行する回数を定義します。接続の再試行は、システム復旧の有力な方

策となります。たとえば、停電などの電力障害によりクライアントとサー

バーの両方が動作しなくなってしまうシナリオを考えてみましょう。電力

が復旧してすべてのコンピューターが再起動される際、サーバーが自身の

スタートアップルーチンを完了する前にクライアントがそのサーバーに

接続しようとするかもしれません。接続の再試行が有効な場合、クライア

ントアプリケーションは、サーバー側で接続が正しく受け入れられるよう

になるまで接続を何度も試行し続けることができます。

接続の再試行は、サーバーが 1 つしかない環境でも使用できますが、複数

サーバーを持つ環境における接続フェイルオーバーシナリオの補完機能

としても使用できます。

接続文字列オプションを使用すると、データプロバイダーが接続を試行す

る回数や接続の試行間隔を秒単位で指定できます。接続の再試行に対する

設定の詳細については、「接続フェイルオーバーの設定」（3-12 ページ）を


3-11


接続フェイルオーバーの設定接続フェイルオーバーによって、ハードウェア障害やトラフィックの過負

荷などが原因でプライマリデータベースサーバーが利用できなくなった

場合でも、アプリケーションは代替またはバックアップデータベースサー

バーに接続することができます。

接続フェイルオーバーに関する詳細については、「接続フェイルオーバーの

使用」（3-8 ページ）を参照してください。

接続フェイルオーバーを別のサーバーに構成するには、プライマリサー

バーが接続を受け入れない場合に接続を試行する代替データベースサー

バーのリストを指定する必要があります。これを行うには Alternate Servers接続文字列オプションを使用します。接続の確立に成功するまで、あるい

はリストにエントリされるすべての代替データベースへの接続を 1 回ずつ

試行（デフォルト）するまで、接続の試行が続けられます。

任意で、以下の接続フェイルオーバー機能も指定することができます。

データプロバイダーが初に接続を試行した後に、プライマリサー

バーおよび代替サーバーへ接続を試行する回数。デフォルトでは、デー

タプロバイダーは接続を再試行しません。この機能を設定するには

Connection Retry Count 接続文字列オプションを使用します。

プライマリサーバーと代替サーバーへの接続の試行間隔（秒数）。デ

フォルトの間隔は 3 秒です。この機能を設定するには Connection RetryDelay 接続文字列オプションを使用します。

データプロバイダーがプライマリサーバーおよび代替サーバーへの

接続を試行する際、ロードバランスを使用するかどうか。ロードバラ

ンスが有効な場合、データプロバイダーは接続の試行順序のパターン

をシーケンシャルではなくランダムにします。デフォルトでは、ロー

ドバランスは使用されません。この機能を設定するには Load Balancing接続文字列オプションを使用します。

接続文字列を使用して、データプロバイダーに対し接続フェイルオーバー

を使用するよう指示します。「接続文字列の使用」（2-3 ページ）を参照し

てください。

次の C# コードには、 Pervasive PSQL データプロバイダーで接続フェイル

オーバー機能と、その接続オプションであるロードバランス、接続の再試

行、および接続の再試行の間隔をすべて使用するように設定する接続文字

列が含まれています。

Conn = new PsqlConnection Conn = new PsqlConnection();Conn = new PsqlConnection("Host=myServer; User ID=test; Password=secret; ServerDSN=SERVERDEMO; Alternate Servers="Host=AcctServer, Host=AcctServer2"; Connection Retry Count=4;

3-12

接続フェイルオーバーの設定

Connection Retry Delay=5; Load Balancing=true; Connection Timeout=60")

具体的に説明すると、この接続文字列の設定は Pervasive PSQL データプロ

バイダーで、 2 つの代替サーバーを接続フェイルオーバーサーバーとして

使用すること、初の接続の試行に失敗した場合はさらに 4 回接続を再試

行すること、試行間隔は 5 秒間とし、プライマリサーバーと代替サーバー

への接続の試行順序はランダムとすることを示しています。接続の試行は

1 回当り 60 秒間持続し、試行する順序は初に行ったランダム順序がその

まま後まで使用されます。

3-13


セキュリティの設定 Pervasive PSQL データプロバイダーは、接続での暗号化されたネットワー

ク通信（ワイヤ暗号化とも呼ばれます）をサポートします（暗号化設定の

詳細については、「接続文字列の使用」（2-3 ページ）を参照してください）。

デフォルトでは、データプロバイダーはサーバーの設定を反映します。

データプロバイダーで許可される暗号化のレベルは、使用される暗号化モ

ジュールによって異なります。デフォルトの暗号化モジュールでは、デー

タプロバイダーは 40 ビット、56 ビット、および 128 ビット暗号化をサポー

トしています。

データ暗号化はパフォーマンスに悪影響を与えることがあります。詳細に

ついては、「アプリケーションのパフォーマンスに関する考慮点」（2-13ペー

ジ）を参照してください。

暗号化に加え、 Pervasive PSQL データプロバイダーは .NET Framework で定義されるセキュリティ権限を通してセキュリティを実装します。

コードへのアクセス権限

Pervasive PSQL データプロバイダーをロードして実行するためには

FullTrust 権限を設定する必要があります。これは、 System.Data のクラスが

FullTrust 権限を継承しなければならないためです。これらのクラスは、す

べての ADO.NET データプロバイダーで DataAdapter を実装するために必

要です。

セキュリティの属性

Pervasive PSQL データプロバイダーには AllowPartiallyTrustedCallers 属性

がマークされています。

3-14

Pervasive Bulk Load の使用

Pervasive Bulk Load の使用 Pervasive Bulk Load は、すべてのバルクロードの要求に対して 1 か所です

べてを行えるワンストップ手法を提供します。これは、 Pervasive PSQL およびこのバルクロード機能をサポートするすべての DataDirect Connect 製品にバルクロード操作を行う上で単純かつ一貫性があります。つまり、標

準ベースの API バルクインターフェイスを使用してバルクロードアプリ

ケーションを記述し、それから、その仕事を実行するためにすぐにデータ

ベースのデータプロバイダーまたはドライバーをプラグインすることが

できます。

データを Pervasive、 Oracle、 DB2、および Sybase にロードする必要がある

とします。これまでは、バルクロード操作のためにデータベースベンダー

製のツールを使用するか、独自のツールを作成する必要がありました。今

では、 Pervasive Bulk Load に組み込まれた相互運用性により、作業は非常

に簡単になりました。もう 1 つの利点は、 Pervasive Bulk Load がマネージ

コードのみを使用するために別のベンダー製の基盤となるユーティリティ

やライブラリを必要としないことです。

異なるデータストア間でのバルクロード操作は、クエリの結果をカンマ区

切り値（CSV）形式ファイルであるバルクロードデータファイルに残す

ことによって完成されます。このファイルは Pervasive PSQL データプロバ

イダーおよびバルクロードをサポートする DataDirect Connect forADO.NET データプロバイダー間で使用できます。さらに、バルクロード

データファイルは、 DataDirect Connect 製品やバルクロード機能をサポー

トするデータプロバイダーで使用できます。たとえば、Pervasive PSQL デー

タプロバイダーで生成された CSV ファイルは、バルクロード対応の

DataDirect Connect for ODBC driver で使用できます。

Pervasive Bulk Load で使用するシナリオ

Pervasive PSQL データプロバイダーで Pervasive Bulk Load を使用する 2 つの方法を次に示します。

Pervasive PSQL の新しいバージョンにアップグレードした後、図 3-3に示すように、 Pervasive PSQL v9 データソースから inventory データ

を Pervasive PSQL v10.10 データソースにコピーします。

3-15


図 3-3 2 つのデータソース間での Pervasive Bulk Load の使用

Oracle データベースからデータをエクスポートした後、その結果を

Pervasive PSQL データベースに移行します。

図 3-4 は、データを ADO.NET データベースサーバーにコピーする

ODBC 環境を示しています。

図 3-4 ODBC から ADO.NET へのデータのコピー

この図で、ODBC アプリケーションは CSV ファイルへデータをエクスポー

トするコードを含み、 ADO.NET アプリケーションは CSV ファイルを指定

して開くコードを含みます。 Pervasive PSQL データプロバイダーおよび

DataDirect ODBC ドライバーは一貫した形式を使用するため、これらの標

準インターフェイスを介して相互運用性がサポートされます。

Pervasive Common AssemblyADO.NET 用の Pervasive Bulk Load の実装は、事実上の業界標準である

Microsoft SqlBulkCopy クラスの定義を使用し、強力な組み込み機能を追加

してバルク操作の信頼性をより高めるため、柔軟性に加えて相互運用性も

高めます。

3-16


Pervasive PSQL データプロバイダーには、 Pervasive Bulk Load をサポート

するためのプロバイダー固有のクラスが含まれます。詳細については、

「データプロバイダー固有のクラス」（6-3 ページ）（6-3 ページ）を参照し

てください。共通プログラミングモデルを使用する場合は、 PervasiveCommon Assembly のクラスを使用できます（「Pervasive Common Assemblyクラス」（6-20 ページ）を参照してください）。

Pervasive.Data.Common アセンブリには、バルクデータ形式間の機能を提供

する CsvDataReader および CsvDataWriter などの Pervasive Bulk Load に対応

したクラスが含まれています。

共通アセンブリは、共通プログラミングモデルを使用するバルクロード

クラスのサポート機能も拡張します。つまり、 SqlBulkCopy パターンが新

しい DbBulkCopy 階層で使用できるようになりました。

データプロバイダーの将来のバージョンには、共通プログラミングモデル

技術を拡張するほかの機能が含められます。Pervasive.Data.Common アセン

ブリが対応しているクラスの詳細については、「Pervasive Common Assemblyクラス」（6-20 ページ）を参照してください。

バルクロードデータファイル

異なるデータストア間でのクエリの結果は、カンマ区切り値（CSV）形式

ファイルであるバルクロードデータファイルに保存されます。BulkFile プロパティで定義されるファイル名は、バルクデータの読み書きに使用され

ます。ファイル名に拡張子が含まれない場合は、 ".CSV" と見なされます。

例

Pervasive PSQL ソーステーブルの GBMAXTABLE には 4 つの列が含まれて

います。次の C# コード例は CsvDataWriter が作成する GBMAXTABLE.csvおよび GBMAXTABLE.xml を書き出します。

メモこの例では DbDataReader クラスを使用します。

cmd.CommandText = "SELECT * FROM GBMAXTABLE ORDER BY INTEGERCOL";DbDataReader reader = cmd.ExecuteReader();CsvDataWriter csvWriter = new CsvDataWriter();csvWriter.WriteToFile("\\NC1\net\PSQL\GBMAXTABLE\

GBMAXTABLE.csv", reader);

バルクロードデータファイルの GBMAXTABLE.csv には、次のようなク

エリの結果が含まれます。

1,0x6263,"bc","bc"2,0x636465,"cde","cde"3,0x64656667,"defg","defg"4,0x6566676869,"efghi","efghi"

3-17


5,0x666768696a6b,"fghijk","fghijk"6,0x6768696a6b6c6d,"ghijklm","ghijklm"7,0x68696a6b6c6d6e6f,"hijklmno","hijklmno"8,0x696a6b6c6d6e6f7071,"ijklmnopq","ijklmnopq"9,0x6a6b6c6d6e6f70717273,"jklmnopqrs","jklmnopqrs"10,0x6b,"k","k"

GBMAXTABLE.xml ファイルは、このバルクロードデータファイルの形

式を指定するバルクロードの設定ファイルです。これについて次のセク

ションで説明します。

バルクロード構成ファイル

バルクロード構成ファイルは、 CsvDataWriter.WriteToFile メソッドが呼び

出されたときに作成されます（詳細については「CsvDataWriter」（6-22 ペー

ジ）を参照してください）。

バルクロード構成ファイルは、バルクロードデータファイル内の列の名

前とデータ型を定義します。これらの名前とデータ型は、データのエクス

ポート元のテーブルや結果セットと同様に定義します。

バルクデータファイルが作成できなかったり XML 構成ファイルに記述さ

れているスキーマに準拠していない場合は、例外がスローされます。 XMLスキーマ定義の使用法については、「バルクデータ構成ファイル用の XMLスキーマ定義」（11-3 ページ）を参照してください。

構成ファイルを持たないバルクロードデータファイルが読み込まれた場

合は、以下のデフォルトが想定されます。

すべてのデータは文字データとして読み取られます。カンマの間にあ

る値は、それぞれ文字データとして読み取られます。

デフォルトの文字セットは、バルクロード CSV ファイルが現在読み

取られているプラットフォームの文字セットです。詳細については、

「文字セットの変換」（3-19 ページ）を参照してください。

バルクロード設定ファイルは、バルクデータファイルについて記述され

ており、基となる XML スキーマによってサポートされます。 XML スキー

マについては次で定義されています。

http://www.datadirect.com/ns/bulk/BulkData.xsd

例

前のセクションで示したバルクロードデータファイルは、バルクロード

構成ファイルの GBMAXTABLE.xml で定義されています。このファイルに

は、テーブル内の 4 つの列のそれぞれについてデータ型とその他の情報が

記述されています。

<?xml version="1.0" encoding="utf-8"?><table codepage="UTF-16LE"

xsi:noNamespaceSchemaLocation="http://www.datadirect.com/ns/bulk/BulkData.xsd"

3-18



xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<row><column datatype="DECIMAL" precision="38" scale="0" nullable="false">INTEGERCOL</column>

<column datatype="VARBINARY" length="10" nullable="true">VARBINCOL</column>

<column datatype="VARCHAR" length="10" sourcecodepage="Windows-1252" externalfilecodepage="Windows-1252" nullable="true">VCHARCOL</column>

<column datatype="VARCHAR" length="10" sourcecodepage="Windows-1252" externalfilecodepage="Windows-1252" nullable="true">UNIVCHARCOL</column>

</row></table>

バルクロードプロトコルの決定

バルク操作は、専用のバルクプロトコルを使用して実行できます。つまり、

データプロバイダーは基となるデータベースのプロトコルを使用します。

場合によっては、専用のバルクプロトコルが使用できない場合がありま

す。たとえば、ロードしようとするデータが、専用のバルクプロトコルが

対応していないデータ型の場合です。その場合、データプロバイダーは配

列バインドなどの非バルク手法を自動的に使用してバルク操作を実行し、

適なアプリケーション稼働時間を継続します。

文字セットの変換

時には、異なる文字セットを使用するデータベース間でデータをバルク

ロードする必要があります。

Pervasive PSQL データプロバイダーでは、デフォルトのソース文字データ、

つまり CsvDataReader からの出力および CsvDataWriter への入力は Unicode（UTF-16）です。ソース文字データは、常に CSV ファイルのコードページ

に変換されます。しきい値を超えてデータが外部のオーバーフローファイ

ルに書き出された場合、ソース文字データはバルク構成 XML スキーマで

定義されている externalfilecodepage 属性で指定されたコードページに変換

されます（「バルクデータ構成ファイル用の XML スキーマ定義」（11-3 ペー

ジ）を参照してください）。構成ファイルで externalfilecodepage の値が定義

されていない場合は CSV ファイルのコードページが使用されます。

不要な変換処理を行わないためには、CSV および外部ファイルの文字デー

タを Unicode （UTF-16）にするのが良の方法です。以下のいずれかの状

況では、アプリケーションにデータを別のコードページで保存させたい場

合があります。

3-19


データが ADO.NET で書き出され ODBC で読み取られる。この場合、

読み取り（および関連する文字変換）は ODBC によって行われます。

文字データが既に正しいコードページである場合、文字変換は不要で

す。

空白が考慮の対象となる。文字データがよりコンパクトに表されるか

どうかは、コードページによって異なります。たとえば、 ASCII デー

タは 1 文字が 1 バイトで、 UTF-16 は 1 文字が 2 バイトです。

構成ファイルでは、任意で文字型の列ごとに 2 番目のコードページを定義

することができます。文字データが CharacterThreshold プロパティで定義し

た値を超え、別個のファイルに格納される場合（「外部オーバーフローファ

イル」（3-20 ページ）を参照してください）、この値はそのファイルのコー

ドページを定義します。

この値を省略したりソース列で定義されたコードページが不明の場合は、

CSV ファイルに定義されたコードページが使用されます。

外部オーバーフローファイル

CsvDataWriter オブジェクトの BinaryThreshold または CharacterThreshold プロパティの値がしきい値を超えた場合、別のファイルが生成されてバイナ

リまたは文字データを格納します。これらのオーバーフローファイルは、

バルクデータファイルと同じディレクトリにあります。

オーバーフローファイルに文字データが含まれる場合、ファイルの文字

セットは CSV バルク構成ファイルで指定された文字セットが決定します。

ファイル名には CSV ファイル名と拡張子 ".lob" が含まれます（たとえば、

CSV_filename_nnnnnn.lob）。これらのファイルは CSV ファイルと同じ場所

に存在します。 _000001.lob から開始して 1 ずつ大きくなります。

表 3-2 文字セット変換の例

ソース文字列のコードページバルク CSV ファイル定義外部ファイルへの書き出しに使用される

コードページ

不明 UTF-16 UTF-16

US ANSI UTF-16 US ANSI。各文字は 1 バイトを占めるの

みであるため、必要な領域に関しては

も効率的なコードページです。

EBCDIC などの非対応コード

ページ

UTF-16LE。この値は CsvCharacterSetNameを使用して設定できます。

レベル調整コードページ

3-20


バルクコピー操作とトランザクション

デフォルトで、バルクコピー操作はトランザクションの一部ではなく分離

した操作として実行されます。つまり、エラーが発生しても操作をロール

バックするチャンスはないということです。

Pervasive PSQL では、既存のトランザクション内でバルクコピー操作を行

うことができます。複数の手順で存在するトランザクションの一部として

バルクコピー操作を定義することができます。この手法を使うと、複数の

バルクコピー操作を同じトランザクション内で実行し、トランザクション

全体をコミットまたはロールバックすることができます。

エラー発生時にバルクコピー操作のすべてまたは一部をロールバックす

る方法については、Microsoft のオンラインヘルプで " トランザクションと

バルクコピー操作（ADO.NET） " を参照してください。

3-21


診断機能の使用 .NET Framework では、プログラムを再コンパイルすることなくエンドユー

ザーが問題を特定するのに役立つ Trace クラスを提供します。

Pervasive PSQL データプロバイダーはさらに以下の診断機能を実現します。

メソッド呼び出しのトレース機能

アプリケーションの接続情報を監視できるフックの実行

メソッド呼び出しのトレース

トレース機能は、環境変数または PsqlTrace クラスを使って有効にできま

す。データプロバイダーは、パブリックメソッドの全呼び出しの入力引数

と、そのメソッドの出力および戻り値（ユーザーが呼び出したものすべて）

をトレースします。各呼び出しには、メソッドの開始（ENTER）と終了

（EXIT）のエントリがあります。

デバッグ中、機密事項のデータがプライベート変数または内部変数として

格納され、アクセスが同じアセンブリに制限されたとしても、そのデータ

を読み取ることができます。セキュリティを維持するために、トレースログはパスワードを 5 つのアスタリスク（*****）で示します。

環境変数の使用

環境変数を使用してトレースを有効にするということは、アプリケーショ

ンを変更しなくてもよいということです。ただし、環境変数の値を変更し

たら、その新しい値を有効にするにはアプリケーションの再起動が必要に

なります。

トレースを有効にして制御するには、次の環境変数を設定します。

次の環境変数を有効にしてトレースを制御するよう設定します。

PVSW_Trace_File トレースファイルのパスと名前を指定します。デ

フォルトは \PVSW_NETTrace.txtlse です。

PVSW_Recreate_Trace 1 に設定すると、アプリケーションを開始するたび

にトレースファイルが再作成されます。 0 （デフォ

ルト）に設定すると、トレースファイルは追加さ

れます。環境変数の値を変更した場合は、その新し

い値を有効にするためにアプリケーションを再起

動する必要があります。

PVSW_Enable_Trace 1 以上に設定すると、トレースが有効になります。

0 （デフォルト）に設定すると、トレースは無効に

なります。

3-22

診断機能の使用

メモ： SettingEnableTrace = 1 でトレース処理が開始されます。したがって、

EnableTrace を設定する前にトレースファイル用のプロパティ値を定義し

ておく必要があります。いったんトレース処理が開始されたら、 TraceFileおよび RecreateTrace プロパティの値を変更することはできません。

静的メソッドの使用

ユーザーによっては、トレースを有効にするのに、データプロバイダーの

Trace クラスの静的メソッドを使用する方が便利だと思われるかもしれま

せん。以下の C# コードでは、 .NET Trace オブジェクトの静的メソッドを

使用して、トレースファイルの名前を MyTrace.txt とする PsqlTrace クラス

を作成します。この値は環境変数で設定した値よりも優先されます。これ

以降、データプロバイダーへの呼び出しはすべて MyTrace.txt へトレース

されます。

PsqlTrace.TraceFile="C:\\MyTrace.txt";PsqlTrace.RecreateTrace = 1;PsqlTrace.EnableTrace = 1;

トレースは次のような形式で出力されます。

<Correlation#> <Timestamp> <CurrentThreadName>

<Object Address> <ObjectName.MethodName> ENTER ( または EXIT) Argument #1 :<Argument#1 Value> Argument #2 :<Argument#2 Value> ...

RETURN:<Method ReturnValue> // EXIT のみ

この場合、

Correlation# は重複のない番号で、これによって、アプリケーション内の同

じメソッド呼び出しの ENTER エントリと EXIT エントリを符合させます。

Value は、個々の関数呼び出しに固有のオブジェクトのハッシュコードです。

デバッグ中、機密事項のデータがプライベート変数または内部変数として

格納され、アクセスが同じアセンブリに制限されたとしても、そのデータ

を読み取ることができます。セキュリティを維持するために、トレースログはパスワードを 5 つのアスタリスク（*****）で示します。

PerfMon のサポート

パフォーマンスモニター（PerfMon）や VS パフォーマンスモニター

（VSPerfMon）ユーティリティを使用すると、アプリケーションのパラメー

ターを記録し、その結果をレポートやグラフにして見ることができます。

また、パフォーマンスモニターではアプリケーションの CLR （共通言語ラ

ンタイム）例外の回数や頻度を確認することもできます。加えて、使用中

の接続数や接続プール数を分析して、ネットワークの負荷を調整すること

ができます。

3-23


Pervasive PSQL データプロバイダーは、このデータプロバイダーを使用す

るアプリケーションの調整およびデバッグが行える PerfMon カウンターの

セットをインストールします。データプロバイダーのカウンターは、パ

フォーマンスモニターの［Pervasive PSQL ADO.NET Data Provider］という

カテゴリ名の下に置かれます。

表 3-3 では、アプリケーションの接続を調整するために使用できる各種

PerfMon カウンターについて説明します。

PerfMon とパフォーマンスカウンターの使用法の詳細については、

Microsoft ドキュメントライブラリを参照してください。

接続統計情報によるパフォーマンスの分析

.NET Framework 2.0 は実行時の統計情報が導入され、情報は各接続を基準

として収集されます。 Pervasive PSQL データプロバイダーは、広範な実行

時統計情報項目に対応しています。これらの統計情報項目が提供する情報

は、以下に役立ちます。

アプリケーションパフォーマンスの自動分析

アプリケーションパフォーマンスの傾向の特定

接続での問題の検出および通知の送信

データ接続での問題修正の優先順位決定

統計情報項目の計測がパフォーマンスに与える影響はわずかです。良の

結果を得るためには、ネットワーク分析またはアプリケーションのパ

フォーマンス作用分析時にのみ統計情報の収集を有効にすることを考慮し

てください。

表 3-3 PerfMon カウンター

カウンター説明

Current # of Connection Pools プロセスに関連付けられている現在のプール

数。

Current # of Pooled Connections プロセスに関連付けられているすべてのプー

ルにある現在の接続数。

Current # of Pooled and Non-Pooled Connections

プールされている接続とプールされていない

接続の現在の数。

Peak # of Pooled Connections プロセスの開始後、すべての接続プールにおい

てカウントされた大の接続数。

Total # of Failed Connects プロセスの開始後、何らかの理由でエラーに

なった接続を開くために試行した合計回数。

Total # of Failed Commands プロセスの開始後、何らかの理由でエラーに

なったコマンドの実行総数。

3-24

診断機能の使用

概要

統計情報収集は、すべての Connection オブジェクトで、それらが使用可能

である限り有効にできます。たとえば、アプリケーションで、ビジネス分

析の実行に関連する複雑なトランザクションのセットを開始する前に統計

情報を有効にし、タスクの完了時に統計情報を無効にするように定義でき

ます。データプロバイダーがサーバーに対して待機させられた時間および

返された行数をタスクの完了直後に取得できますし、後から取得すること

もできます。アプリケーションはタスクの後で統計情報を無効にするた

め、統計情報項目は関心のある期間だけ計測されます。

統計情報項目は、機能上 5 つのカテゴリに分類されます。

ネットワークレイヤ項目は、送受信されるバイト数およびパケット

数、データプロバイダーがサーバーの応答を待った時間などのネット

ワーク動作に関連する値を取得します。

集計項目は、サーバーとのやりとりごとに送受信されたバイト数など

の計算値を返します。

行処理の統計情報項目は、アプリケーションが読み取らなかった行の

処理に必要な時間とリソースに関する情報を提供します。

ステートメント統計情報項目は、実行されたステートメントおよびス

トアドプロシージャの数に関する値を返します。

ステートメントキャッシュ統計情報項目はステートメントキャッ

シュ内でのステートメントの動作を説明する値を返します（ステート

メントキャッシュの使用法については「ステートメントキャッシング

の使用」（3-6 ページ）を参照してください）。

統計情報項目の有効化と取得

Connection オブジェクトを作成すると、 StatisticsEnabled プロパティを使用

して統計情報の収集を有効にすることができます。データプロバイダー

は、接続が開かれると統計情報項目のカウントを開始し、 ResetStatistics が呼び出されるまで継続します。接続を閉じた後 ResetStatistics を呼び出さず

に再度開くと、統計情報項目のカウントは接続が閉じられた時点から継続

されます。

RetrieveStatistics メソッドを呼び出すと、 1 つまたは複数の統計情報項目の

カウントを取得します。返される値は、 RetrieveStatistics メソッドが呼び出

された時点での " 適切な時期のスナップショット " となります。

統計情報収集および取得の範囲を定義できます。次の C# コード例では、統

計情報項目は Task A 作業でのみ計測され、 Task B 作業処理後に取得され

ます。

3-25


connection.StatisticsEnabled = true; // Task A 作業を行いますconnection.StatisticsEnabled = false; // Task B 作業を行いますIDictionary currentStatistics = connection.RetrieveStatistics();

すべての統計情報項目を表示するには、次の C# コード例のようなコード

を使用することができます。

foreach (DictionaryEntry entry in currentStatistics) { Console.WriteLine(entry.Key.ToString() + ":" + entry.Value.ToString());}Console.WriteLine();

SocketReads および SocketWrites 統計情報項目のみを表示するには、次の C#コード例のようなコードを使用できます。

foreach (DictionaryEntry entry in currentStatistics) { Console.WriteLine("SocketReads = {0}", currentStatistics["SocketReads"]); Console.WriteLine("SocketWrites = {0}", currentStatistics["SocketWrites"]);}

Console.WriteLine();

3-26

4
Visual Studio でのデータプロバイダーの使用
統合開発環境を一般的なタスクに使用する

Pervasive PSQL データプロバイダーは Visual Studio への統合に対応してい

ます。つまり、開発者は Microsoft Visual Studio のグラフィカルユーザー

インターフェイスを使用して、さまざまなタスクを実行できます。

ここでは、 Pervasive PSQL データプロバイダーの機能がどのようにして

Visual Studio に組み込まれるかを説明します。

この章では、以下の項目について説明します。

「接続の追加」（4-2 ページ）

「Visual Studio の Pervasive Performance Tuning Wizard」（4-14 ページ）

「プロバイダー固有テンプレートの使用」（4-18 ページ）

「Pervasive Visual Studio Wizard の使用」（4-21 ページ）

「ツールボックスからのコンポーネントの追加」（4-29 ページ）

「データプロバイダー統合のシナリオ」（4-31 ページ）

4-1


接続の追加 Visual Studio では、いくつかの方法で接続を追加することができます。

「サーバーエクスプローラーでの接続の追加」（4-2 ページ）

「データソース構成ウィザードによる接続の追加」（4-11 ページ）

サーバーエクスプローラーでの接続の追加

接続を追加するには

1 ［データ接続］ノードを右クリックします。

2 ［接続の追加］をクリックします。［接続の追加］ウィンドウが表示さ

れます。

4-2

接続の追加

3 ［データソース］フィールドに Pervasive PSQL データプロバイダーが

表示されている場合は、手順 6 へ進みます。そうでない場合は、［変

更］ボタンをクリックします。

4 ［データソースの変更］ウィンドウが表示されます。

5 ［データソースの変更］ウィンドウで、次の手順を実行します。

a. ［データソース］リストボックスで "Pervasive PSQL Database"を選択します。

b. ［データプロバイダー］ドロップダウンリストで "ADO.NETPervasive PSQL Provider" を選択します。

c. ほかの接続でもこれらの選択を使用したい場合は、［常にこれを選

択する］チェックボックスをオンにします。

d. ［OK］をクリックして［接続の追加］ウィンドウに戻ります。

6 ［接続の追加］ウィンドウで、次の手順を実行します。

a. ホスト名（Host）を入力します。

b. ユーザー ID （User ID）とパスワード（Password）を入力します。

これらの値は認証で必要となります。

c. （任意）サーバーエクスプローラーで定義した接続インスタンスの

存続期間中パスワードを保存したい場合は、［Save my password］チェックボックスをオンにします。

d. （省略可能）［データベース］入力フィールドで、接続するデータ

ベースの名前を入力します。

7 さらにプロバイダー固有のプロパティ値を指定する場合は、［詳細設

定］ボタンをクリックします。

4-3


［プロパティの詳細］ダイアログボックスの値を変更するには、対象

フィールドで新しい値を選択するか、値を入力して Enter キーを押し

ます。この値が接続文字列に追加され、プロパティの説明の下にある

フィールドに表示されます。デフォルトの値を受け入れる場合は、接

続文字列フィールドを変更せずそのままにしておきます。必要な変更

を加えたら、［OK］をクリックして［接続の追加］ウィンドウに戻り

ます。

Advanced（詳細）

Encoding ：データベースに格納されている文字列データの翻訳に使用

する、 ANSI 名または Windows コードページを入力します。デフォル

トでは、 Windows コードページが使用されます。

Initial Command Timeout：データプロバイダーが実行の試行を終了し

てエラーを生成するまでのデフォルトの待機時間（秒単位のタイムア

ウト）を指定します。このオプションは、アプリケーションのコード

に変更を加えることなく、 PsqlCommand オブジェクトの

CommandTimeout プロパティと同じ機能を提供します。その後、アプリ

ケーションは CommandTimeout プロパティを使用して Initial CommandTimeout 接続文字列オプションを上書きすることができます。


メモ：CommandTimeout オプションの初期値に、サーバーのデッドロッ

ク検出およびタイムアウトの大値より大きい値を設定します。これ

によって、アプリケーションはタイムアウトした場合により意味のあ

る応答を受け取ることができます。

Initialization String ：セッションの設定を管理するために、データベー

スへの接続後直ちに発行されるステートメントを入力します。

4-4

接続の追加

例： NULL で埋められた CHAR 列を処理するには、次のように値を設

定します。

Initialization String=SET ANSI PADDING ON

メモ：何らかの理由でステートメントが失敗した場合、サーバーへの

接続は失敗します。データプロバイダーは、サーバーから返されたエ

ラーを含む例外をスローします。

Parameter Mode ：ネイティブパラメーターマーカーおよびバイン

ディングの動作を選択します。これにより、アプリケーションはプロ

バイダー固有の SQL コードを再利用でき、Pervasive PSQL データプロ

バイダーへの移行を簡単にすることができます。

ANSI （デフォルト）に設定すると、 ? 文字はパラメーターマーカーと

して処理され、序数としてバインドされます。

BindByOrdinal に設定した場合、ネイティブパラメーターマーカーが

使用され、序数としてバインドされます。

BindByName に設定した場合、ネイティブパラメーターマーカーが使

用され、名前としてバインドされます。

PVTranslate：クライアントが、適合するエンコードをサーバーとネゴ

シエイトするかどうかを選択します。

Auto に設定した場合、データプロバイダーはサーバーのコードページ

を取得して、データをサーバーのコードページに変換します。

Nothing （デフォルトの初期値）に設定すると変換は起こりません。

Timestamp ： Pervasive のタイムスタンプを文字列として格納および取

得するかどうかを選択します。

DataTime （デフォルトの初期値）に設定すると、データプロバイダー

はタイムスタンプを DateTime にマップします。この設定はネイティブ

な精度が必要な場合、たとえば、タイムスタンプを含む

CommandBuilder を使用する場合に適しています。

String に設定すると、データプロバイダーは Pervasive タイムスタンプ

を文字列としてマップします。

TimeType ： Pervasive の Time を ADO.NET データプロバイダーの

Timespan または DateTime として取得するかどうかを指定します。

DateTime に設定すると、データプロバイダーは SQL の TIME 型を

.NET の System.DateTime 型にマップします。

TimeSpan に設定すると、データプロバイダーは SQL の TIME 型を

.NET の System.DateTimeSpan 型にマップします。

4-5


Connection Pooling（接続プール）

Connection Reset ：アプリケーションで再使用するための接続プール

から接続を削除する場合、その状態を接続の初期設定状態にリセット

するかどうかを選択します。

False （デフォルトの初期値）に設定すると、データプロバイダーは接

続の状態をリセットしません。

Connection Timeout ：サーバーへの接続の試行が失敗した後、接続さ

れないでいる間の秒数を入力します。接続フェイルオーバーが有効に

なっている場合、このオプションは接続の試行ごとに適用されます。

0 に設定すると、データプロバイダーが接続の試行でタイムアウトす

ることはありません。


Load Balance Timeout ：接続プールで接続を保持する秒数を入力しま

す。接続プールマネージャーは定期的にすべてのプールをチェック

し、この値を超過した接続を閉じたり排除します。 Min Pool Size オプ

ションの指定によって、一部の接続は Load Balance Timeout に指定さ

れた値を無視することができます。


0 （デフォルトの初期値）に設定すると、接続のタイムアウトは上限値

になります。

接続の存続時間については、「プールからの接続の削除」（3-3 ページ）

を参照してください。

Max Pool Size ： 1 つのプール内の大接続数を入力します。大数に

達したら、それ以上の接続を接続プールに追加することはできません。



Min Pool Size ：接続プールが作成されたとき、そのプールで開いてい

る、もしくは置いておく接続の小数（下限）を入力します。接続プー

ル内の一部の接続が Load Balance Timeout 値を超えたとしても、接続

プールにはこの小数の接続が保持されます。


0 （デフォルトの初期値）に設定すると、接続プールが作成されたと

き、プール内に追加の接続は置かれません。

Pooling ： True （デフォルトの初期値）に設定すると、接続プールは有

効になります。

4-6

接続の追加

Failover（フェイルオーバー）

Alternate Servers：プライマリデータベースサーバーが使用不可能な

場合、データプロバイダーが接続を試みる代替データベースサーバー

の一覧を入力します。このプロパティに値を指定すると、データプロ

バイダーに対して接続フェイルオーバー機能が有効になります。

たとえば、 Alternate Servers 値を次のように指定すると、接続フェイル

オーバー用に 2 つの代替サーバーが定義されます。

Alternate Servers="Host=AcctServer;Port=1584, Host=123.456.78.90;Port=1584"

Connection Retry Count ：データプロバイダーがプライマリサーバー

への接続を試行し、その初期接続が失敗した後に代替サーバーへの接

続を試行する回数を入力します。


0 （デフォルトの初期値）に設定すると、再接続の試行回数は制限され

ません。

Connection Retry Delay ：初期接続の試行に失敗した後、プライマリ

サーバーまたは（指定した場合には）代替サーバーへの接続を再試行

するまでの試行間隔を秒数で入力します。


このプロパティは Connection Retry Count プロパティに 0 を設定してい

る場合は作用しません。

Load Balancing：データプロバイダーがプライマリデータベースサー

バーや代替データベースサーバーへの接続において、クライアント

ロードバランスを使用するかどうかを、 True または False を選択して

決定します。

False （デフォルトの初期値）に設定すると、データプロバイダーはク

ライアントロードバランスを使用しません。

Performance（パフォーマンス）

Enlist ： True または False を選択して、スレッドの現在のトランザク

ションコンテキストの作成中に、データプロバイダーが接続への参加

を自動的に試行するかどうかを指定します。

メモ：Pervasive PSQL は分散トランザクションをサポートしないため、

スレッドの現在のトランザクションコンテキストでの接続への参加

試行は失敗します。

False に設定すると、データプロバイダーは接続への自動的な参加試

行を行いません。

4-7


True （デフォルトの初期値）に設定すると、現在のトランザクション

コンテキストが存在する場合にデータプロバイダーはエラーを返し

ます。現在のトランザクションコンテキストが存在しない場合、デー

タプロバイダーは警告を発します。

Max Statement Cache Size：この接続のステートメントキャッシュに

保持できる、アプリケーションが生成するステートメントの大数を

入力します。

この値には 0、または 1 以上の整数を指定できます。

0 に設定すると、ステートメントキャッシュは無効になります。

1 以上の整数を設定すると、その値はステートメントキャッシュに保

持できるステートメント数を決定します。


Statement Cache Mode ：接続存続期間のステートメントキャッシュ

モードを選択します。詳細については、「ステートメントキャッシン

グの使用」（3-6 ページ）を参照してください。

Auto に設定すると、ステートメントキャッシュは有効になります。

Command のプロパティ StatementCacheBehavior で Implicit とマークさ

れているステートメントがキャッシュされます。これらのコマンドは

明示的にマークされたコマンドより低い優先順位を持ちます。つまり、

ステートメントプールが大ステートメント数に達した場合、 Cacheとマークされたステートメント用の余地を作るため、Implicit とマーク

されたステートメントが初に削除されます。

ExplicitOnly （デフォルトの初期値）を設定すると、

StatementCacheBehavior によって Cache とマークされたコマンドのみ

がキャッシュされます。

Schema Information（スキーマ情報）

Schema Collection Timeout：試行したスキーマコレクション操作が失

敗した後、完了されないでいる間の秒数を入力します。


Schema Options：返されるデータベースメタデータを指定します。デ

フォルトで、データプロバイダーは、パフォーマンスに悪影響を与え

るデータベースメタデータを返さないようにしてパフォーマンスを

適化します。アプリケーションでデータベースメタデータを必要と

する場合は、メタデータの名前または 16 進値を指定します。

このオプションはパフォーマンスに影響することがあります。

ShowColumnDefaults または 0x04 を設定すると、列のデフォルトが返

されます。

4-8

接続の追加

ShowParameterDefaults または 0x08 を設定すると、列のデフォルトが返

されます。

FixProcedureParamDirection または 0x10 を設定すると、プロシージャ定

義が返されます。

ShowProcedureDefinitions または 0x20 を設定すると、プロシージャ定

義が返されます。

ShowViewDefinitions または 0x40 を設定すると、ビュー定義が返され

ます。

ShowAll または 0xFFFFFFFF を設定すると、すべてのデータベースメタデータが返されます。

たとえば、プロシージャ定義の説明を返すには

Options=ShowProcedureDefinitions または Schema Options=0x20 を指定

します。

複数の除外されたメタデータを表示するには、名前をカンマ区切りの

リストで指定するか、制限したい列コレクションの 16 進値の合計を指

定します。

データプロバイダーが追加できるメタデータの名前および 16 進値に

ついては、表 2-2 を参照してください。

Use Current Schema：この接続文字列オプションはサポートされてい

ません。これを設定すると、データプロバイダーは例外をスローしま

す。

Security（セキュリティ）

Encrypt ：データプロバイダーが暗号化されたネットワーク通信（ワ

イヤ暗号化とも呼ばれます）を使用するかどうかを選択します。

If Needed （デフォルトの初期値）に設定すると、データプロバイダー

はサーバーの設定を反映します。

Always に設定すると、データプロバイダーは暗号化を使用します。

サーバーでワイヤ暗号化が許可されない場合はエラーが返されます。

Never に設定すると、データプロバイダーは暗号化を使用しません。

サーバーでワイヤ暗号化を要求された場合はエラーが返されます。

Encryption ：データプロバイダーが許可する暗号化の低レベルを選

択します。これらの値の意味は使用する暗号化モジュールに応じて変

わります。デフォルトの暗号化モジュールでは、値 Low、 Medium、

High はそれぞれ 40 ビット、 56 ビット、 128 ビット暗号化に対応して

います。

デフォルトの初期値は Medium （中）です。

4-9


Password：Pervasive PSQL データベースへの接続に使用するパスワー

ド（大文字小文字の区別なし）を入力します。パスワードは、データ

ベースでセキュリティが有効な場合にのみ必要です。パスワードが必

要な場合は、システム管理者からパスワードを入手してください。

Persist Security Info：セキュリティで保護された情報を ConnectionStringプロパティにクリアテキストで表示するかどうかを選択します。

True に設定すると、Password 接続文字列オプションの値はクリアテキ

ストで表示されます。

False （デフォルトの初期値）に設定すると、データプロバイダーはセ

キュリティで保護された情報をクリアテキストで表示しません。

User ID：Pervasive PSQL データベースへの接続に使用するデフォルト

の Pervasive PSQL ユーザー名を入力します。

Standard Connection（標準接続）

Database Name：接続するデータベースの内部名を特定する文字列を

入力します。

このフィールドに値を入力した場合は、 Server DSN フィールドを使用

できません。

Host ：接続する Pervasive PSQL サーバーの名前または IP アドレスを

入力します。

Port ： Pervasive PSQL データベースで動作しているリスナーの TCPポートを入力します。

デフォルトのポート番号は 1583 です。

Server DSN： DEMODATA など、サーバー上のデータソースの名前

です。

このフィールドに値を入力した場合は、 Database Name フィールドを

使用できません。

Tracing（トレース）

Enable Trace ： 1 以上の値を入力すると、トレースが有効になります。

0 （デフォルトの初期値）に設定すると、トレースは有効になりません。

Trace File ：トレースファイルのパスと名前を入力します。デフォル

トの初期値は \PVSW_NETTrace.txt です。このトレースファイルが存

在しない場合はデータプロバイダーが作成します。

8 ［接続の確認］をクリックします。構成処理中のどの時点であっても、

［接続の確認］をクリックして、［接続の追加］ウィンドウで指定した

接続プロパティを使ってデータソースへ接続してみることができま

す。

4-10

接続の追加

データプロバイダーは接続に成功したら、その接続を停止した

後、 " テスト接続に成功しました " というメッセージを表示しま

す。［OK］をクリックします。

不適当な環境であるか、または接続値が正しくないためにデータ

プロバイダーが接続できない場合は、適切なエラーメッセージが

表示されます。

［OK］をクリックします。

メモ：接続フェイルオーバー機能で使用するための代替サーバーを構

成している場合には、［接続の確認］ボタンでテストされるのはプライ

マリサーバーのみで、代替サーバーはテストされないということを承

知しておいてください。

9 ［OK］または［キャンセル］をクリックします。［OK］をクリックし

た場合は、指定した値がデータソースへ接続するときのデフォルトに

なります。これらのデフォルト設定は、この手順を使ってデータソー

スを再構成することによって変更できます。また、これらの代わりの

値を含む接続文字列を使ってデータソースに接続すれば、デフォルト

設定を無効にすることができます。

データソース構成ウィザードによる接続の追加

データソース構成ウィザードを使用して、アプリケーションに新しい接続

を追加することができます。

接続を追加するには

1 Visual Studio の［データ］メニューから［新しいデータソースの追加］

を選択します。データソース構成ウィザードが表示されます。

2 ［データベース］を選択し、［次へ］をクリックします。［データ接続の

選択］ウィンドウが表示されます。

4-11


3 ［新しい接続］をクリックします。［接続の追加］ウィンドウが表示さ

れます。「サーバーエクスプローラーでの接続の追加」（4-2 ページ）

の手順 2 から処理を続けます。

［サーバー名］ノードの定義

［サーバー名］ノードは、現在接続されているデータベースを示す上位レ

ベルのノードについて説明します。ノードの名前は F2 キーを押して変更

できます。ただし、デフォルトで、次のスキーマに従って名前を表示する

必要があります。

ホスト .データベース名 . ユーザー名

ソリューションエクスプローラーで［サーバー名］ノードを選択すると、

プロパティパネルが表示されます。

4-12

接続の追加

プロパティにデフォルト値がある場合、またはデフォルト以外の値を明示

的に設定した場合は、プロパティとその値がプロパティパネルに表示され

ます。

たとえば、前の図で Database Name プロパティが DEMODATA と定義され

ていると、その値が表示されます。一方、 AlternateServers プロパティのデ

フォルト値は変更されなかったので、AlternateServers はプロパティパネル

に表示されません。

4-13


Visual Studio の Pervasive Performance Tuning Wizard

Pervasive Performance Tuning Wizard は、アプリケーションについて一連の

質問を通して手順を段階的に案内します。ウィザードに対する答えに基づ

き、 Pervasive PSQL データプロバイダーのパフォーマンスに関する接続文

字列オプションに適な設定が用意されます。

Visual Studio から Pervasive Performance Tuning Wizard を起動すると、以下

のことが行えます。

パフォーマンスに関する接続文字列オプションの値を生成します。こ

れらの値は接続文字列にコピーされます。

既存の接続を変更します。

お使いの環境に適化された接続文字列を持つ、あらかじめ設定され

た新規アプリケーションを生成します。 Performance Tuning Wizard はアプリケーションの種類および使用する ADO.NET コードのバージョ

ンを選択するオプションを提供します。

Pervasive Performance Tuning Wizard を使用するには

1 Performance Tuning Wizard を起動するには次のいずれかを行います。

新しい接続を作成するには、［ツール｜Pervasive｜Run PervasivePerformance Tuning Wizard］をクリックします。 PerformanceTuning Wizard の Welcome ダイアログが表示されたら、［Next］を

クリックします。手順 2 から処理を続けます。

既存の接続を変更するには、サーバーエクスプローラーでデータ

接続を右クリックし、［Pervasive Performance Tuning Wizard の実行］をクリックします。 Performance Tuning Wizard の Welcomeダイアログが表示されたら、［Next］をクリックします。手順 2 から処理を続けます。

2 ウィザードは、お使いの環境に関する一連の質問を行います。［Next］をクリックしてウィザードの処理を進めます。

図 4-1 は、尋ねられる質問の例を示します。

4-14


図 4-1 Pervasive Performance Tuning Wizard

3 データプロバイダーに関する質問に答え終わると、［Result］ダイア

ログが表示され、接続文字列が表示されます。図 4-2 は PervasivePerformance Tuning Wizard が生成するパフォーマンスに関する接続文

字列オプションを示します。

4-15


図 4-2 Pervasive Performance Tuning Wizard の［Result］ダイアログ

次のいずれかの動作を選択します。

接続文字列をほかのアプリケーションでも使用できるようにする

には（デフォルトの初期値）、［Copy the connection string toclipboard］をクリックします。この接続文字列をほかのアプリ

ケーションでも使用できます。

Performance Tuning Wizard を既存の接続から起動した場合は、

［Re-configure the connection with the additional PerformanceTuning Wizard connection string options］をクリックします。

新規アプリケーションを作成するには、［Generate a newapplication pre-configured with these connection settings］をク

リックします。この例では、 Pervasive Project テンプレートを使用

して Pervasive アプリケーションを生成します。プロバイダー固有

のテンプレートの詳細については、「プロジェクトの新規作成」（4-18 ページ）を参照してください。

新規アプリケーションの場合は以下の追加情報を定義します。

ADO.NET 1.x 仕様に準拠したアプリケーションを作成するに

は、［Using ADO.NET 1.0 provider-specific interfaces］を選択

します。

ADO.NET 共通プログラミングモデルを使用するアプリケー

ションを作成するには、［Using ADO.NET 2.0 commonprogramming interfaces］を選択します。

4-16


プロジェクトの場所を入力するか［Browse］をクリックし

て、場所を選択します。

プロジェクトの種類を選択します。デフォルトでは、ウィザー

ドは C# アプリケーションを作成します。

4 ［Finish］をクリックして Pervasive Performance Tuning Wizard を終了し

ます。

4-17


プロバイダー固有テンプレートの使用

Visual Studio は SQL レベル調整などの機能を自動的に含めるアプリケー

ションの構築を助けるテンプレートのセットを提供します。

プロジェクトの新規作成 Visual Studio で新規プロジェクトを作成する場合、 Pervasive PSQL データ

プロバイダー固有のテンプレートを使用するか、汎用コードを持つアプリ

ケーションを作成するテンプレートを使用することができます。

次の例では、 Pervasive PSQL データプロバイダー用のテンプレートを使用

して Visual Studio で新規プロジェクトを作成します。

1 ［ファイル｜新規作成｜プロジェクト］をクリックします。［新しいプ

ロジェクト］ダイアログが表示されます。

2 プロジェクトの種類ペインで［Visual C#］を選択します。

3 ［新しいプロジェクト］ダイアログのフィールドに必要な変更を加えます。

a. テンプレートペインで Pervasive PSQL Project を選択します。

b. ［プロジェクト名］フィールドに My Pervasive Project などの名前

を入力するか、デフォルトの名前をそのまま使用します。

c. ［場所］フィールドでプロジェクトを保存する場所を入力するか、

［参照］をクリックしてそのディレクトリに移動します。

4-18

プロバイダー固有テンプレートの使用

d. ［ソリューション名］フィールドにソリューションの名前を入力し

ます。

e. Visual Studio 2008 をお使いの場合は、ウィンドウの上部にあるド

ロップダウンリストで使用する .NET Framework を選択できます。

4 ［OK］をクリックします。

5 新規プロジェクトがソリューションエクスプローラーに表示されま

す。Pervasive PSQL ADO.NET データプロバイダー用の名前空間が、プ

ロジェクトに自動的に追加されます。

メモ： ADO.NET 2.0 共通プログラミングモデルを使用している場合は、

Pervasive Generic Provider Project テンプレートを選択してください。この場

合、プロジェクトはアセンブリへの特定の参照を必要としません。

4-19


既存のプロジェクトへのテンプレートの追加

Pervasive PSQL テンプレートを既存のプロジェクトに追加するには

1 ソリューションエクスプローラーでプロジェクトを右クリックし、

［追加｜新しい項目］をクリックします。

2 ［新しい項目の追加］ダイアログで Pervasive PSQL Class を選択しま

す。

3 ［追加］をクリックします。 Pervasive PSQL データプロバイダー用の

クラスがプロジェクトに追加されます。

4-20

Pervasive Visual Studio Wizard の使用


ウィザードは、アプリケーション作成時に一般的に実行される作業です。

「Add Table Wizard でのテーブルの作成」（4-21 ページ）

「Add View Wizard でのビューの作成」（4-26 ページ）

この手順を開始する前に、「プロジェクトの新規作成」（4-18 ページ）で説

明したように Pervasive テンプレートを使用してプロジェクトを作成し、

データ接続を追加します。

Add Table Wizard でのテーブルの作成

Visual Studio で Pervasive PSQL ADO.NET Add Table Wizard を使用して、新

規テーブルをすばやく簡単に定義できます。

1 ［表示｜サーバーエクスプローラー］をクリックします。

2 データソース接続をダブルクリックして、その下部のノードを表示し

ます。

3 ［Tables］ノードを右クリックし、［Add New Table］をクリックしま

す。 Pervasive ADO.NET Add Table Wizard が表示されます。

4 ［Next］をクリックします。［Specify Table Name］ダイアログが表示さ

れます。

5 ［Table Name］フィールドにテーブルの名前を入力します。

6 ［Next］をクリックします。［Specify Column(s)］ダイアログが表示さ

れます。

4-21


7 新規テーブルの列を定義します。この選択により、データ型オプショ

ンペインに追加フィールドが表示されます。

［Add］をクリックしてテーブルに列を追加します。列名とデータ

型のフィールドが編集可能になります。

［Column Name］フィールドに列の名前を入力します。列のデータ型を選択し、必要に応じて追加情報を指定します。

文字データ型を選択した場合は、 Data Type Options ペインに

［Length］フィールドが表示されます。列の大サイズをバイ

ト単位で入力します。

数値を選択した場合、 Data Type Options ペインに［Precision］と［Scale］フィールドが表示されます。

列にヌル値を含むことができる場合は、［Allow Null］チェック

ボックスをオンにします。

テーブルから列を削除するには、列名を選択して［Remove］を

クリックします。

8 ［Next］をクリックします。［Specify Primary Key］ダイアログが表示さ

れます。

4-22


テーブルに主キーを指定したくない場合は［No Primary Key］を

クリックし、［Next］をクリックします。［Specify Unique Key(s)］ダイアログが表示されます。手順 11 から処理を続けます。

テーブルに主キーを指定する場合は［Create Primary Key］をク

リックして手順 9 に進みます。

9 ［Specify Primary Key］ダイアログのフィールドを完成します。

［Primary Key Name］フィールドで主キーの名前を入力するか、デ

フォルトの名前をそのまま使用します。

［Available Columns］フィールドから列を選択して［Selected Columns］フィールドへ移動します。

10 ［Next］をクリックします。［Specify Unique Key(s)］ダイアログが表示

されます。

11 （省略可能）テーブルに 1 つ以上の一意なキーを指定します。

テーブルに一意なキーを指定したくない場合は、［Next］をクリッ

クします。［Specify Foreign Key(s)］ダイアログが表示されます。

手順 14 から処理を続けます。

テーブルに 1 つ以上の一意なキーを指定する場合は、手順 12 から

処理を続けます。

4-23


12 ［Add］をクリックします。ダイアログ上のフィールドが選択可能にな

ります。

［Unique Keys］ドロップダウンリストで一意なキーを選択します。

［Unique Key Name］フィールドで名前を編集するか、デフォル

トの名前をそのまま使用します。［Available Columns］リストボックスで一意なキーの指定に使用

する列を 1 つ以上選択し、［Selected Columns］リストボックス

に移動します。

13 ［Next］をクリックします。［Specify Foreign Key(s)］ダイアログが表示

されます。

4-24


14 （省略可能）テーブルに 1 つ以上の外部キーを指定します。

テーブルに外部キーを指定したくない場合は、［Next］をクリッ

クします。［Review SQL］ダイアログが表示されます。手順 17 から処理を続けます。

テーブルに 1 つ以上の外部キーを指定する場合は、手順 15 から処

理を続けます。

15 ［Add］をクリックします。ダイアログ上のフィールドが選択可能にな

ります。

［Foreign Keys］ドロップダウンリストで外部キーを選択します。

［Foreign Key Name］フィールドで名前を編集するか、デフォル

トの名前をそのまま使用します。

［Table Schema］ドロップダウンリストでテーブルスキーマを選

択します。

［Table Name］ドロップダウンリストでテーブルを選択します。

［Foreign Table Column］ドロップダウンリストで、外部キーの

指定に使用する 1 つ以上の外部キーを選択します。

［Parent Table Column］ドロップダウンリストで、親テーブルか

ら対応する列を選択します。

16 ［Next］をクリックします。［Review SQL］ダイアログが表示されます。

4-25


17 選択した内容によって生成された SQL ステートメントを確認します。

SQL ステートメントに問題がなければ、［Finish］をクリックしま

す。作成したテーブルは、サーバーエクスプローラー内のこの接

続の［Tables］ノード下に表示されます。

SQL ステートメントを追加したい場合、たとえば、ビューや特定

のキーワードを追加するには、手順 18 から処理を続けます。

18 ［Edit SQL］チェックボックスをオンにします。［Generated SQL］フィー

ルド内のテキストが編集可能になります。

メモ：［Edit SQL］チェックボックスをオンにすると、［Back］ボタン

が無効になります。

19 SQL ステートメントの変更に問題がなければ［Finish］をクリックし

ます。作成したテーブルは、サーバーエクスプローラー内のこの接続

の［Tables］ノード下に表示されます。

Add View Wizard でのビューの作成

Visual Studio で Pervasive Add View Wizard を使用して、新規ビューをすば

やく簡単に定義できます。

1 ［表示｜サーバーエクスプローラー］をクリックします。

2 データソース接続をダブルクリックして、その下部のノードを表示し

ます。

3 ［Views］ノードを右クリックし、［Add New View］をクリックします。

Pervasive Add View Wizard の Welcome ダイアログが表示されます。

4-26


4 ［Next］をクリックします。［Specify View Name］ダイアログが表示さ

れます。

5 ［View Name］フィールドにビューの名前を入力します。

6 ［Next］をクリックします。［Select Table(s) and/or Column(s)］ダイアロ

グが表示されます。

7 ［List of Tables and columns］リストボックスでビューを構成するテー

ブルまたは列を選択し、それを［Selected Columns］列に移動します。

8 ［Next］をクリックします。［Review SQL］ダイアログが表示されます。

9 選択した内容によって生成された SQL ステートメントを確認します。

4-27


SQL ステートメントに問題がなければ、［Finish］をクリックしま

す。作成したビューは、サーバーエクスプローラー内のこの接続

の［ビュー］ノード下に表示されます。

SQL ステートメントを追加したい場合、たとえば、ビューや特定

のキーワードを追加するには、手順 10 から処理を続けます。

10 ［Edit SQL］チェックボックスをオンにします。［Generated SQL］フィー

ルド内のテキストが編集可能になります。

メモ：［Edit SQL］チェックボックスをオンにすると、［Back］ボタン

が無効になります。

11 SQL ステートメントの変更に問題がなければ［Finish］をクリックし

ます。作成したビューは、サーバーエクスプローラー内のこの接続の

［ビュー］ノード下に表示されます。

4-28

ツールボックスからのコンポーネントの追加

ツールボックスからのコンポーネントの追加 Visual Studio のツールボックスから Windows フォームアプリケーションに

コンポーネントを追加することができます。Windows フォームアプリケー

ションの作成については、 Visual Studio オンラインヘルプを参照してくだ

さい。

この手順を開始する前に、Windows フォームアプリケーションを作成して

データ接続を追加してください。

Windows フォームアプリケーションに Pervasive PSQL データプロバ

イダーコンポーネントを追加するには

1 ［表示｜ツールボックス］をクリックします。ツールボックスで

Pervasive ADO.NET Provider が表示されるまで下へスクロールします。

2 PsqlCommand ウィジェットを選択して Windows フォームアプリケー

ションにドラッグします。

4-29


3 必要に応じて、アプリケーションへのウィジェットの追加を続けます。

4-30

データプロバイダー統合のシナリオ

データプロバイダー統合のシナリオ Pervasive PSQL データプロバイダーは Visual Studio に統合されているた

め、多くのデータアクセス作業を簡略化することができます。たとえば、

データベースへの接続を作成した後、クエリビルダーを使用してクエリを

作成することができます。

クエリビルダーによって、データベースクエリをグラフィカルに設計でき

ます。

単純なクエリを作成するには

1 データソース接続を確立します（「Pervasive Visual Studio Wizard の使

用」（4-21 ページ）を参照してください）。

2 サーバーエクスプローラーでデータソースを選択します。

3 ［Tables］を右クリックし、次に［新しいクエリ］をクリックします。

4 ［テーブルの追加］ウィンドウが表示されます。使用するデータが入っ

ているテーブルを選択したら、［追加］をクリックします。

5 ［閉じる］をクリックして、［テーブルの追加］ウィンドウを閉じます。

6 返したい列を選択します。この例では、 employee テーブルの id、 nameおよび salary 列を選択します。

4-31


7 ツールバーの［SQL の実行］ボタンをクリックします。

8 クエリビルダーの結果ペインで返された結果を調べます。

4-32

5
Microsoft Enterprise Library の使用
アプリケーションでのデータアクセスアプリケーションブロックの使用

Microsoft Enterprise Library を使用すると、データアクセスのような一般的

なタスクを移植性の高いコードにラッピングすることによって、ある

DBMS から別の DBMS へのアプリケーションの移行を容易にし、アプリ

ケーション開発を簡略化することができます。データアクセスアプリケー

ションブロック（DAAB）のクラスは ADO.NET でも頻繁に使用される

機能へのアクセスを提供します。アプリケーションは、アプリケーション

レイヤーを介してデータを渡したり、変更されたデータをデータベースに

返したりするような作業に DAAB を使用できます。 DAAB を使用すると、

アプリケーションを新規作成または修正するたびに同じデータアクセス

作業のコードを書き続ける必要がなくなるため、時間をより生産的に使う

ことができます。

Pervasive PSQL データプロバイダーは、データアクセスアプリケーショ

ンブロックで使用できます。ここでは、アプリケーションでデータアクセ

スアプリケーションブロックを使用する方法を説明します。

5-1


データアクセスアプリケーションブロックの概要

データアクセスアプリケーションブロック（DAAB）は、開発者が

ADO.NET で常用されるコードを日常的なデータベース作業用の標準化さ

れたコードに置き換えることを可能にしました。データベースクラスには

次のようなオーバーロードメソッドがあります。

スカラー値または XmlReaders を返す

どのパラメーターが必要かを判断しそれらを作成する

トランザクションにコマンドを含める

アプリケーションで特定の DBMS 機能を扱う必要がある場合は、PervasivePSQL データプロバイダーを使用できます。

DAAB の使用に適する場合

DAAB には、データベースにアクセスするも一般的なメソッドを簡略化

する少数のメソッドがあります。それぞれのメソッドは、データを取得し

てデータベースへの接続を管理するのに必要なロジックをカプセル化しま

す。アプリケーションが標準データアクセス技法を使用する場合は、アプ

リケーションブロックの使用を考慮してください。

DAAB は ADO.NET と一緒に使用して、 ADO.NET 用のアプリケーション作

成時の効率と生産性を向上させます。抽象データベースクラスは、

DbCommand クラスで使用されるのと同じ ExecuteNonQuery、ExecuteReader、ExecuteScalar などのいくつかのメソッドを提供します。データベース固有

のコードを使用している場合は、OracleCommand のようなデータプロバイ

ダー固有のクラスを提供します。

開発中にはデフォルトの DAAB を使用するのが便利ですが、その結果作成

されたアプリケーションは移植性に欠けます。プロバイダー固有の

Pervasive PSQL DAAB を使用すると、アプリケーションには Pervasive PSQLデータプロバイダーの SQL レベル調整機能が含められます。アプリケー

ションが複数のデータベースにアクセスする必要があろうと、目的のデー

タソースが変更されると予想されていようと、より高い柔軟性を持つこと

ができます。

汎用クラスおよびデータベース固有のクラス

アプリケーションブロックは、異種のデータベースで同じコードを使用で

きるコードを ADO.NET に補完します。 DAAB を Pervasive PSQL データ

ベースプロバイダーと一緒に使用する場合、次の 2 つの選択肢がありま

す。

GenericDatabase クラス

プロバイダー固有の Pervasive PSQL DAAB 実装

5-2

データアクセスアプリケーションブロックの概要

GenericDatabase クラスオプションは、データベースの動作に特殊な制御を

必要とするアプリケーションにはあまり適しません。移植性のためには、

プロバイダー固有のソリューションが適な方法です。

アプリケーションでデータを特殊な方法で取得する必要がある場合、また

は、 Pervasive PSQL 固有の機能を利用するためにコードのカスタマイズが

必要な場合は、 Pervasive PSQL データプロバイダーがより適しています。

5-3


DAAB の構成

アプリケーションで DAAB を使用できるよう構成する前に、環境を設定す

る必要があります。

1 まず、 http://msdn.microsoft.com/ja-jp/library/aa480453(en-us).aspx から

Microsoft Enterprise Library 3.1 （May 2007）をダウンロードします。

2 データプロバイダーの Pervasive PSQL DAAB プロジェクトを開きます

（プロジェクトは、Pervasive PSQL ADO.NET SDK インストールの一部

としてインストールされます）。プロジェクトは、All Users\ApplicationData 下の Pervasive Software\PSQL\ado.net\3.2\samples\EnterpriseLibrary にあります。

注意： "Application Data" の場所は、オペレーティングシステムおよび

オペレーティングシステムのビットアーキテクチャによって異なり

ます。『Getting Started With Pervasive PSQL』の「Pervasive PSQL ファ

イルがインストールされる場所」（7-2 ページ）を参照してください。

3 プロジェクトをコンパイルして出力ディレクトリを書き留めます。

データアクセスアプリケーションブロックの構成は、次の 2 つの手順か

ら成ります。

「新しい DAAB エントリを追加するには」（5-4 ページ）

「アプリケーションへのデータアクセスアプリケーションブロック

の追加」（5-5 ページ）

新しい DAAB エントリを追加するには

ここで、 Enterprise Library Configuration ツールを使用して新規 DAAB エン

トリを追加します。

1 ［Enterprise Library Configuration］を右クリックし、［New Application］を選択します。

2 ［Application Configuration］を右クリックし、次に［New ｜ Data AccessApplication Block］を選択します。 Enterprise Library Configuration ウィ

ンドウが現れます。

3 ［Name］フィールドに DAAB ブロックの名前を入力します。

4 ［ConnectionString］フィールドに接続文字列を入力します。

5 ［ProviderName］フィールドに「Pervasive.Data.SqlClient」と

入力します。

6 ［Custom Provider Mappings］を右クリックして［New ｜ ProviderMappings］を選択します。

5-4

http://msdn.microsoft.com/ja-jp/library/aa480453(en-us).aspx

DAAB の構成

7 ［Name］フィールドに手順 2 で入力した DAAB 名または手順 5 で入力

したデータプロバイダー名を入力します。

8 ［TypeName］フィールドで［...］（参照）ボタンをクリックし、構築す

る Pervasive PSQL DAAB のデバッグ出力ディレクトリに移動します。

次に、 TypeName を選択します。たとえば、 Pervasive PSQL TypeNameは Pervasive.EnterpriseLibrary.Data.Pervasive.dll です。

9 ［Enterprise Library Configuration］ウィンドウは当分開いたままにして

おき、次のセクションを完了するまで構成を保存しないでください。

アプリケーションへのデータアクセスアプリケーションブロックの追加

DAAB を新規または既存のアプリケーションに追加するには、以下の手順

を行います。

1 Visual Studio 2005 ソリューションに次の 2 つの参照を追加します。

Enterprise Library Shared LibraryEnterprise Library Data Access Application Block

2 ソースコードに次のディレクティブを追加します。

using Microsoft.Practices.EnterpriseLibrary.Data;

using System.Data;

3 ソリューションをリビルドして新しい従属物が確実に機能するように

します。

4 現在のソリューションでの出力の Debug または Release パスの場所を

決定して、 Enterprise Library Configuration ウィンドウに戻ります（「新

しい DAAB エントリを追加するには」（5-4 ページ）を参照してくださ

い）。

5 ［Application Configuration］ノードを右クリックします。

6 現在のソリューションの Debug または Release 出力ディレクトリに移

動し、現在のソリューションの .exe ファイルを見つけます。

7 ファイル名を 1 回クリックし、 .config を名前に追加します（たとえば

MyPSQLconfig）。

8 保存するファイルの種類に "All Files" が選択されていることを確認し

て［Save］を選択します。

9 ファイルエクスプローラーを使用して、Pervasive DAAB ディレクトリ

から Pervasive.EnterpriseLibrary.Data.Pervasive.dll をコピーします。

10 この DLL のコピーを現在のソリューションの Debug または Release 出力ディレクトリのいずれかに配置します。

5-5


アプリケーションコードでのデータアクセスアプリケーションブロックの使用

これで DAAB の構成が終わったので、この DAAB 上にアプリケーション

を構築することができます。

下の例では、 DAAB MyPSQL および DatabaseFactory を使用して PervasivePSQL データソースによって支持される Database オブジェクトのインスタ

ンスを生成します。

using System;using System.Data.Common;using System.Text;using Microsoft.Practices.EnterpriseLibrary.Data;using System.Data;

namespace DAAB_Test_App_1{ class Program { static void Main(string[] args) {

Database database = DatabaseFactory.CreateDatabase("MyPSQL"); DataSet ds = database.ExecuteDataSet(CommandType.TableDirect, "SQLCOMMANDTEST_NC_2003SERVER_1");

} }}

これで、 Microsoft Enterprise Library DAAB コーディングパターンは自由に

使用できます。

5-6

アプリケーションブロックを使用する上でのその他のリソース

アプリケーションブロックを使用する上でのその他のリソース

次のソースは、アプリケーションブロック使用に関する追加情報を提供し

ます。

Microsoft patterns & practices Developer Center にはアプリケーションブロックに関するセクションが含まれています。

データアクセスアプリケーションブロックを使用する作業やアプリ

ケーションの概要については、次のサイトで "Introduction to the DataAccess Application Block" を参照してください。

http://msdn.microsoft.com/en-us/library/cc309168.aspx

Microsoft Channel 9 Enterprise Library FAQ にはアプリケーションブロックの使用に関する概念情報が含まれています。次のサイトを参照

してください。

http://channel9.msdn.com/wiki/default.aspx/Channel9.EnterpriseLibraryFAQ

5-7

http://msdn2.microsoft.com/en-us/library/aa480458.aspx

http://msdn2.microsoft.com/en-us/library/aa480458.aspx

http://msdn.microsoft.com/en-us/library/cc309168.aspx

http://channel9.msdn.com/wiki/default.aspx/Channel9.EnterpriseLibraryFAQ


5-8

6
サポートされる .NET オブジェクト
.NET オブジェクトの使用

ADO.NET 2.0 は、アプリケーションおよびデータソース間のより汎用的な

追加インターフェイスを提供する新しいクラスのセットを提供します。

ADO.NET 2.0 より以前に使われていたものは、アプリケーションが使用す

るデータプロバイダーのそれぞれの特定のインスタンスに、データプロバ

イダーをより密接な要因の 1 つとして含めることを選択しました。それと

は対照的に、ADO.NET 2.0 は、今日の ODBC および JDBC が行うのと非常

によく似た、 1 つの API でアプリケーションに異種のデータソースのセッ

トの操作を許可する新しいベースクラスのセットを提供します。つまり、

ADO.NET 2.0 では、すべてのデータクラスはベースクラスから派生し、特

定の専用名前空間である System.Data.Common に存在します。

データプロバイダーでは、以下が使用できます。

「.NET のベースクラス」（6-2 ページ）

「データプロバイダー固有のクラス」（6-3 ページ）

「Pervasive Common Assembly クラス」（6-20 ページ）

6-1


.NET のベースクラス

ADO.NET 1.0 および ADO.NET 1.1 データプロバイダーのインターフェイ

スは、アプリケーションの互換性を維持するために構築されました。

ADO.NET 2.0 のベースクラスは以下の追加機能を提供します。

DbCommand

DbCommandBuilder

DbConnection

DbDataAdaptor

DbDataReader

DBDataPermission

DbParameter

DbParameterCollection

DbConnectionStringBuilder

DbTransaction

日々のプログラミングという観点から、これらのクラスは抽象実装として

提供されます。つまり、これらは直接インスタンス化できず、プロバイダー

ファクトリで使用する必要があります。各データプロバイダーは、

DbFactory クラスから派生する一連の静的メソッドを含む PsqlFactory のよ

うな Factory クラスを提供する必要があります。これらの静的メソッドは、

それぞれベースクラスのインスタンスを生成するファクトリメソッドで

す。

これは、データプロバイダーのインストール時に .NET Framework に登録

されます。これにより、共通 .NET Framework DbFactory は、アプリケー

ションが必要とする登録済みデータプロバイダーを見つけて、データソー

スへの接続を確立するための共通メカニズムを提供することができます。

終的に、.NET Framework は ADO.NET データソース用の完全に成熟した

共通プログラミング API を提供します。

6-2

データプロバイダー固有のクラス


Pervasive PSQL データプロバイダーはすべての .NET パブリックオブジェ

クトをサポートしています。 Pervasive PSQL データプロバイダーでは、固

有のプレフィックス「Psql 」を .NET のパブリックオブジェクトに付けま

す（例： PsqlCommand）。

この付録では、以下のオブジェクトについて説明します。

「PsqlBulkCopy」（6-3 ページ）

「PsqlBulkCopyColumnMapping」（6-4 ページ）

「PsqlBulkCopyColumnMappingCollection」（6-4 ページ）

「PsqlCommand オブジェクト」（6-4 ページ）

「PsqlCommandBuilder オブジェクト」（6-7 ページ）

「PsqlConnection オブジェクト」（6-9 ページ）

「PsqlConnectionStringBuilder オブジェクト」（6-11 ページ）

「PsqlDataAdapter オブジェクト」（6-11 ページ）

「PsqlDataReader オブジェクト」（6-12 ページ）

「PsqlError オブジェクト」（6-13 ページ）

「PsqlErrorCollection オブジェクト」（6-13 ページ）

「PsqlException オブジェクト」（6-14 ページ）

「PsqlFactory オブジェクト」（6-15 ページ）

「PsqlInfoMessageEventArgs オブジェクト」（6-15 ページ）

「PsqlParameter オブジェクト」（6-16 ページ）

「PsqlParameterCollection オブジェクト」（6-17 ページ）

「PsqlTrace オブジェクト」（6-18 ページ）

「PsqlTransaction オブジェクト」（6-19 ページ）

パブリックオブジェクトに関する詳細については、 Microsoft .NETFramework Version 2.0 SDK のドキュメントを参照してください。

PsqlBulkCopyPsqlBulkCopy オブジェクトは ADO.NET Bulk API に類似した API パターン

を使用し、プロバイダー固有のプロパティやメソッドを持ちません。サポー

トされるプロパティおよびメソッドについては、データプロバイダーのオ

ンラインヘルプおよび Microsoft .NET Framework SDK のマニュアルを参照


6-3


PsqlBulkCopyColumnMappingPsqlBulkCopyColumnMapping オブジェクトは ADO.NET Bulk API に類似し

た API パターンを使用し、プロバイダー固有のプロパティやメソッドを持

ちません。サポートされるプロパティおよびメソッドについては、データ

プロバイダーのオンラインヘルプおよび Microsoft .NET Framework SDK のマニュアルを参照してください。

PsqlBulkCopyColumnMappingCollectionPsqlBulkCopyColumnMappingCollection オブジェクトは MicrosoftSqlBulkCopyColumnMappingCollection クラスに類似した API パターンに従

い、プロバイダー固有のプロパティやメソッドを持ちません。サポートさ

れるプロパティおよびメソッドについては、データプロバイダーのオンラ

インヘルプおよび Microsoft .NET Framework SDK のマニュアルを参照して

ください。

PsqlCommand オブジェクト

表 6-1 では、PsqlCommand オブジェクトのパブリックプロパティについて

説明します。

表 6-1 PsqlCommand オブジェクトのパブリックプロパティ

プロパティ説明

AddRowID ROWID を SQL ステートメント選択リストの一部として追加します。

True に設定した場合、 PsqlCommandBuilder を使用する際には、より効率的な

Insert、 Delete、および Update コマンドを生成するために、 ROWID に返された値

が利用されます。

False （デフォルトの初期値）に設定すると、データプロバイダーは ROWID 列を選択リストに追加しません。

ArrayBindCount 使用されるパラメーターの行数を指定します。アプリケーションでは、パラメー

ター配列バインドを使用するコマンドを実行する前にこのプロパティを設定し

ておく必要があります。この数はパラメーター値ごとに設定される各配列の長さ

と等しくなるようにしてください。

デフォルトの初期値は 0 で、アプリケーションはパラメーター配列バインドを使

用しません。

6-4


ArrayBindStatus 行の状態値の配列を返します。このプロパティは、パラメーター配列バインドを

使用するコマンドを実行した後、アプリケーションで行ごとの状態を調べること

ができるようにします。このプロパティの型は PsqlRowStatus の配列です。

パラメーター配列バインドは単独のアトミック操作として実行されます。つま

り、操作が成功した場合はすべてのエントリに OK が設定されますが、失敗した

場合にはどのエントリにも OK が設定されないということです。

PsqlRowStatus 列挙で設定可能な値は以下のとおりです。

OK。操作は正常に終了しました。エントリはすべて OK としてマークされま

す。

Failed。操作は失敗しました。データプロバイダーでは、エラーが発生した

行以外のすべてのステータスエントリにこの値を割り当てます。

SchemaViolation。操作が失敗した場合、データプロバイダーはこの値をエラー

が発生した行に割り当てます。

BindByName ストアドプロシージャの実行時にデータプロバイダーが名前付きパラメーター

をどのように処理するかを指定します。アプリケーションは、ストアドプロシー

ジャに対して名前付きパラメーターまたはパラメーターのデフォルト値を使用

できます。

True に設定すると、データプロバイダーは Pervasive PSQL サーバーへのパラメー

ターバインドに PsqlParameter オブジェクトで提供されるパラメーターの名前を

使用します。

別の方法として、ユーザーは以下の方法のいずれかを使用して名前付きパラメー

ターのデフォルト値を指定することができます。

アプリケーションは名前付きパラメーターを使用してパラメーターをバイン

ドしますが、アプリケーションがデフォルト値を使用したい

PsqlParameterCollection には PsqlParameter オブジェクトを追加しません。

アプリケーションは PsqlParameter オブジェクトの Value プロパティにヌルを

設定します。データプロバイダーはこのパラメーターをサーバーに送信せず、

ストアドプロシージャ実行時にパラメーターのデフォルト値を使用します。

BindByName に True を設定して Parameter Mode 接続文字列オプションが

BindByName または BindByOrdinal と定義されている場合、接続文字列に定義さ

れたこれらの値は Command オブジェクトの存続期間中、無効にされます。

False （デフォルトの初期値）に設定すると、データプロバイダーは PsqlParameterオブジェクトで提供されるパラメーターの名前を無視し、パラメーターが CreateProcedure ステートメントで指定されたのと同じ順序であるものと仮定します。

CommandText データソースで実行するテキストコマンドを取得または設定します。

ストアドプロシージャを使う場合、 CommandText にはそのストアドプロシー

ジャの名前を設定します。たとえば次のようになります。

myCmd.CommandText = "GetEmpSalary";



6-5


CommandTimeout コマンド実行の試行を終了し、エラーを生成するまでの待機時間を取得または設

定します。


CommandTimeout プロパティには、サーバーで大のデフォルトのタイムアウト

値よりも大きな値を設定することをお勧めします。これによって、アプリケー

ションはタイムアウトした場合にもっと意味のある応答を得られるようになり

ます。

CommandType CommandText プロパティの解釈方法を指示または指定します。

ストアドプロシージャを使用するには、 CommandType に StoredProcedure を設定

します。

Connection この IDbCommand のインスタンスで使用する IDbConnection を取得または設定し

ます。

Parameters PsqlParameterCollection を取得します。

RowSetSize この Command オブジェクトで実行されるクエリによって返される行数を、実行

時に指定される値までに制限します。 Read-Write プロパティは符号付き整数で

す。

有効な値は 0 から 2147483647 です。

0 （デフォルトの初期値）を設定すると、データプロバイダーは返される行数を

制限しません。

StatementCacheBehavior ステートメントキャッシュの動作を取得、または PsqlStatementCacheBehavior 列挙のいずれかの値のステートメントキャッシュ動作を設定します。詳細につい

ては、「ステートメントキャッシングの有効化」（3-6ページ）を参照してください。

Implicit （デフォルト）に設定すると、 Statement Cache Mode 接続文字列オプショ

ンに Auto が設定され、ステートメントキャッシュは暗黙的に行われます。

Cache に設定して Statement Cache Mode 接続文字列オプションに ExplicitOnly を設定すると、ステートメントは Cache がキャッシュされていると認識します。

DoNotCache に設定すると、ステートメントキャッシュは行われません。

Transaction PsqlCommand オブジェクトを実行するトランザクションを取得または設定しま

す。

UpdatedRowSource DataAdapter の Update メソッドで DataRow が使用されたとき、コマンドの結果を

DataRow に適用する方法を取得または設定します。

UpdateBatchSize プロパティに 1 以外の値が設定されると、 UpdateCommand、DeleteCommand および InsertCommand の UpdatedRowSource プロパティには Noneまたは OutputParameters が設定されます。

None を設定すると、返されたパラメーターや行は無視されます。

OutputParameters を設定すると、出力パラメーターは DataSet の変更された行に

マップされます。



6-6


表 6-2 では、PsqlCommand オブジェクトのパブリックメソッドについて説

明します。

PsqlCommandBuilder オブジェクト PsqlCommandBuilder オブジェクトを使用すると、パフォーマンスに悪影響

を及ぼす恐れがあります。同時実行が制限されるため、PsqlCommandBuilderでは効率のよい SQL ステートメントを生成することができません。多くの

場合、エンドユーザーの方が、PsqlCommandBuilder オブジェクトで生成さ

れるものより効率のよい Update ステートメントや Delete ステートメント

を作成することができます。

表 6-3 では、PsqlCommandBuilder オブジェクトのパブリックプロパティに

ついて説明します。

表 6-4 では、PsqlCommandBuilder オブジェクトのパブリックメソッドにつ

いて説明します。

表 6-2 PsqlCommand オブジェクトのパブリックメソッド

メソッド説明

Cancel IDbCommand の実行のキャンセルを試みます。

CreateParameter IDbDataParameter オブジェクトの新しいインスタンスを作成します。

Dispose コンポーネントで使用したリソースを解放します。オーバーロードされます。

ExecuteNonQuery PsqlConnection オブジェクトに対して SQL ステートメントを実行し、影響を受け

た行数を返します。これは結果を返さないコマンドを対象としたメソッドです。

ExecuteReader 接続に対して CommandText を実行し、 IDataReader を構築します。

ExecuteScalar クエリを実行し、そのクエリが返す結果セットの初の行の初の列を返しま

す。残りの行も列も無視されます。

Prepare Pervasive PSQL のインスタンスに対する準備済みのコマンドを作成します。

メモ： Prepare メソッドは本リリースのデータプロバイダーでは無効です。

表 6-3 PsqlCommandBuilder オブジェクトのパブリックプロパティ


DataAdapter この PsqlCommandBuilder に関連付けられている PsqlDataAdapter オブジェクトを

取得または設定します。

6-7


表 6-4 PsqlCommandBuilder オブジェクトのパブリックメソッド

メソッド説明

DeriveParameters PsqlCommand で指定したストアドプロシージャのパラメーター情報を取得し、

指定した PsqlCommand オブジェクトの Parameters コレクションにパラメーター

を格納します。

GetDeleteCommand アプリケーションが PsqlDataAdapter に対して Delete を呼び出したときに、デー

タベースで削除処理を実行するための、自動生成された PsqlCommand オブジェ

クトを取得します。

GetInsertCommand アプリケーションが PsqlDataAdapter に対して Insert を呼び出したときに、データ

ベースで挿入処理を実行するための、自動生成された PsqlCommand オブジェク

トを取得します。

GetUpdateCommand アプリケーションが PsqlDataAdapter に対して Update を呼び出したときに、デー

タベースで更新処理を実行するための、自動生成された PsqlCommand オブジェ

クトを取得します。

QuoteIdentifier 正しいカタログの中に引用符で囲まれていない識別子があると、その識別子の引

用符で囲まれた正しい形式を返します。識別子内の埋め込み引用符もすべて適切

にエスケープされます。

UnquoteIdentifier 引用符で囲まれた識別子があると、その識別子の引用符で囲まれていない正しい

形式を返します。識別子内の埋め込み引用符のエスケープ処理も適切に除かれま

す。

6-8


PsqlConnection オブジェクト表 6-5 では、 PsqlConnection オブジェクトのパブリックプロパティについ

て説明します。いくつかのプロパティでは、対応する接続文字列オプショ

ンに指定された値を返します。接続文字列オプションとは異なり、

PsqlConnection プロパティ名にはスペースは含められません。

表 6-5 PsqlConnection オブジェクトのパブリックプロパティ


ConnectionString データベースを開くために使用する文字列を取得または設定します。設定可能な

値の説明については、「接続文字列オプション」（2-4 ページ）を参照してください。

ConnectionTimeout データプロバイダーが接続の試行を中断してエラーを生成するまでの、接続の

確立を待機する時間を取得または設定します。

ConnectTimeout プロパティまたは Connection Timeout 接続文字列オプションを使

用すると、接続がタイムアウトするのを待つ時間を設定できます。

接続フェイルオーバーが有効になっている（AlternateServers プロパティに代替

データベースサーバーが 1 つ以上定義されている）場合は、代替サーバーへの

接続の試行ごとにこのプロパティが適用されます。接続の再試行も有効になって

いる（Connection Retry Count 接続文字列オプションに 0 より大きい整数が設定さ

れている）場合は、再試行ごとに ConnectionTimeout プロパティが適用されます。

Database 現在のデータベースの名前、または接続を開くときに使用するデータベースの名

前を取得します。

Host Host 接続文字列オプションに指定された値を返します。読み取り専用です。

Port Port 接続文字列オプションに指定された値を返します。読み取り専用です。

ServerDSN Server DSN 接続文字列オプションに指定された値を返します。読み取り専用で

す。 Server DSN は ODBC エンジン DSN ではなく、 Pervasive PSQL データベース

名を指定します。

ServerName Server Name 接続文字列オプションに指定された値を返します。読み取り専用で

す。

ServerVersion このオブジェクトが現在接続している Pervasive PSQL サーバーのバージョンが

示された文字列を返します。

PsqlConnection オブジェクトが現在接続されていない場合、データプロバイダー

では InvalidOperation 例外を生成します。

State 現在の接続の状態を取得します。

StatisticsEnabled 統計情報の収集を有効にします。

True に設定すると、現在の接続に関する統計情報の収集が有効になります。

6-9


表 6-6 では、 PsqlConnection オブジェクトのパブリックメソッドについて

説明します。

PsqlConnection オブジェクトの InfoMessage イベントを使用すると、データ

ベースから警告や情報メッセージを取得することができます。データベー

スからエラーが返される場合は、例外が発生します。データベースサー

バーから送られる警告や情報メッセージを処理したいクライアントは、

PsqlInfoMessageEventHandler デリゲートを作成してこのイベントに登録し

てください。

InfoMessage イベントでは、このイベントに関するデータを含む

PsqlInfoMessageEventArgs の引数を受け取ります。

表 6-6 PsqlConnection オブジェクトのパブリックメソッド

メソッド説明

BeginTransaction データベーストランザクションを開始します。

オーバーロードされた BeginTransaction(IsolationLevel) メソッドの使用時、データ

プロバイダーでは ReadCommitted および Serializable 分離レベルが使用できます。

詳細については、「分離レベル」（2-28 ページ）を参照してください。

ChangeDatabase 開いている Connection オブジェクトの現在のデータベースを変更します。

ClearAllPools データプロバイダーの接続プールを空にします。

ClearPool 接続に関連付けられている接続プールを空にします。

呼び出し時、接続プールに関連付けられている追加の接続が使用中である場合、

それらには適切なマーク付けがされ、 Close を呼び出した時点で破棄されます。

Close データベースへの接続を閉じます。

CreateCommand PsqlConnection に関連付けられている PsqlCommand オブジェクトを作成し、返し

ます。

Dispose PsqlConnection オブジェクトで使用したリソースを解放します。

Open PsqlConnection オブジェクトの ConnectionString プロパティで指定した設定を使

用して、データベース接続を開きます。

ResetStatistics 接続上の現在の統計収集セッションのすべての値をゼロにリセットします。

接続が閉じられて接続プールに戻ると、統計情報収集はオフに切り替えられてカ

ウントがリセットされます。

RetrieveStatistics 統計情報収集が有効になっている接続の一連の統計情報を取得します。返される

" 名前 = 値 " の組み合わせは、このメソッドが呼び出された時点の接続状態のス

ナップショットを形成します。

6-10


PsqlConnectionStringBuilder オブジェクト PsqlConnectionStringBuilder プロパティ名は PsqlConnection オブジェクトの

接続文字列オプション名と同じです。ただし、接続文字列オプション名は

単語の間にスペースを入れることができます。たとえば、接続文字列オプ

ション Min Pool Size はプロパティ名 MinPoolSize に相当します。接続文字

列オプションの詳細については、「接続文字列オプション」（2-4 ページ）を


PsqlConnectionStringBuilder オブジェクトにはプロバイダー固有のメソッド

はありません。サポートされるメソッドの情報については、データプロバ

イダーのオンラインヘルプおよび Microsoft .NET Framework SDK ドキュメ

ントを参照してください。

PsqlDataAdapter オブジェクト

PsqlDataAdapter オブジェクトは PsqlCommand オブジェクトを使って

Pervasive PSQL データベースに対して SQL コマンドを実行し、取得した

データを DataSet に読み込んだり、 DataSet で変更されたデータをデータ

ベースと照合したりします。

表 6-7 では、 PsqlDataAdapter オブジェクトのパブリックプロパティについ

て説明します。

表 6-7 PsqlDataAdapter オブジェクトのパブリックプロパティ


UpdateBatchSize バッチで実行可能なコマンド数を指定する値を取得または設定します。

アプリケーションで切断された DataSet を使用してこれらの DataSet を更新する

場合、このプロパティの値を 1 より大きく設定することにより、積極的にパ

フォーマンスを操作することができます。デフォルトでは、データプロバイダー

は利用可能な大バッチサイズの使用を試みます。ただし、これがアプリケー

ションでの適なパフォーマンスに一致するとは限りません。 DataSet で通常更

新する行数に基づいて値を設定します。たとえば、 50 未満の行を更新する場合、

このプロパティの推奨設定は 25 です。

0 に設定すると、 PsqlDataAdapter はデータソースで利用可能な大バッチサイ

ズを使用します。 InsertCommand、 UpdateCommand、および DeleteCommand のUpdatedRowSource プロパティは、 None または OutputParameters に設定する必要

があります。

1 に設定すると、バッチ更新は無効になります。

1 より大きい値に設定すると、バッチ内で指定した数のコマンドが実行されます。

InsertCommand、UpdateCommand、および DeleteCommand の UpdatedRowSource プロパティは、 None または OutputParameters に設定する必要があります。

DeleteCommand Pervasive PSQL データソースからレコードを削除するための SQL ステートメン

トを取得または設定します。

InsertCommand Pervasive PSQL データソースに新しいレコードを挿入するための SQL ステート

メントを取得または設定します。

6-11


PsqlDataReader オブジェクト PsqlDataReader オブジェクトは、データベースから読み取り専用のレコー

ドを取得する前方スクロールカーソルです。PsqlDataAdapter を使用するよ

りもパフォーマンスは高くなりますが、結果セットは変更できません。

表 6-8 では、 PsqlDataReader オブジェクトのパブリックプロパティについ


表 6-9 では、 PsqlDataReader オブジェクトのパブリックメソッドの一部に

ついて説明します。

SelectCommand Pervasive PSQL データベースのレコードを選択するための SQL ステートメント

を取得または設定します。

UpdateCommand データソースのレコードを更新するための SQL ステートメントを取得または設

定します。

表 6-7 PsqlDataAdapter オブジェクトのパブリックプロパティ


表 6-8 PsqlDataReader オブジェクトのパブリックプロパティ


Depth 現在の行の入れ子の深さを示す値を取得します。

HasRows この PsqlDataReader に 1 行以上の行が格納されているかどうかを示す値を取得し

ます。

IsClosed データリーダーが閉じているかどうかを示す値を取得します。

RecordsAffected SQL ステートメントの実行によって変更、挿入または削除された行数を取得しま

す。

表 6-9 PsqlDataReader オブジェクトでサポートされるメソッド

メソッド説明

Close DataReader を閉じます。 DataReader オブジェクトの使用を終了するときは必ず

Close メソッドを呼び出してください。

GetSchemaTable PsqlDataReader の列メタデータを記述する DataTable を返します。詳細について

は、表 7-1 を参照してください。

NextResult バッチ SQL ステートメントの結果を読み込むときに、データリーダーを次の結

果に進めます。

Read IDataReader を次の結果に進めます。

6-12


PsqlError オブジェクト PsqlError オブジェクトは、 Pervasive PSQL サーバーで生成されたエラーや

警告に関する情報を収集します。

表 6-10 では、 PsqlError オブジェクトのパブリックプロパティについて説

明します。

PsqlErrorCollection オブジェクト PsqlErrorCollection オブジェクトは、 PsqlException によって作成され、

Pervasive PSQL サーバーによって生成されたすべてのエラーを格納します。

表 6-11 では、 PsqlErrorCollection オブジェクトでサポートされるプロバイ

ダー固有のパブリックプロパティについて説明します。サポートされるそ

の他のプロパティおよびメソッドの情報については、データプロバイダー

のオンラインヘルプおよび Microsoft .NET Framework SDK ドキュメントを


表 6-12 では、 PsqlErrorCollection オブジェクトのパブリックメソッドにつ

いて説明します。

表 6-10 PsqlError オブジェクトのパブリックプロパティ


Message Pervasive PSQL サーバーから返されるエラーメッセージテキストを取得します。

Number Pervasive PSQL から返されるエラー番号を取得します。

SQLState Pervasive PSQL データプロバイダーが例外をスローしたときに SQLState の文字

列表記を取得します。例外に対応するエラーがない場合は 0 です。このプロパ

ティは読み取り専用です。

表 6-11 PsqlErrorCollection オブジェクトのパブリックプロパティ


Count Pervasive PSQL サーバーで生成される PsqlError オブジェクトの数を取得します。

表 6-12 PsqlErrorCollection オブジェクトのパブリックメソッド

メソッド説明

CopyTo PsqlError オブジェクトを ErrorCollection から指定した配列にコピーします。

GetEnumerator 指定した配列の IEnumerator インターフェイスを返します。

6-13


PsqlException オブジェクトプロバイダー固有の例外は System.Data interface インターフェイスから直

接派生します。 System.Exception オブジェクト全般で直接使用できるのは、

Message プロパティなどのパブリックプロパティおよびメソッドのみで

す。 SQLState および Number プロパティは、プロバイダー固有のコードを

介して、または参照を使用してのみアクセスできます。

ADO.NET 2.0 は、 DbException クラスに新しいプロパティ Data を導入しま

した。このプロパティは、例外に関する追加のユーザー定義情報を提供す

る、キーと値の組のコレクションを返します。 Pervasive PSQL データプロ

バイダーは、 SQLState、 Number、および ErrorPosition などのキー / 値ペア

のコレクションを取得します。

Psql.Data.SqlClient プレフィックスは各キーに適用されます。たとえば、次

のようになります。

Psql.Data.SqlClient.Data["SQLState"] = 28000;

複数のエラーが存在する場合、表 6-13 で説明しているプロパティは後に

生成されたエラーに対して適用されます。複数のエラーが発生したかどう

かを判断するには、このオブジェクトの Errors プロパティで返される

PsqlErrorCollection の Count プロパティをチェックします。詳細については、

「PsqlErrorCollection オブジェクト」（6-13 ページ）を参照してください。

表 6-13 PsqlException オブジェクトのパブリックプロパティ


Errors PsqlError オブジェクトのうち 1 つの PsqlErrorCollection を取得または設定します。

Message Pervasive PSQL サーバーから返されるエラーメッセージテキストを指定します。

Number Pervasive PSQL サーバーから返される数を取得または設定します。

SQLState Pervasive PSQL データプロバイダーが例外をスローしたときに SQLState の文字

列表記を返します。例外に対応するエラーがない場合は 0 です。このプロパティ

は読み取り専用です。

6-14


PsqlFactory オブジェクトプロバイダーファクトリクラスを使用すると、ユーザーは汎用オブジェク

トのプログラムを作成できます。 DbProviderFactory からインスタンス化す

れば、ファクトリが正しいタイプの具体的なクラスを生成します。

表 6-14 は、Pervasive PSQL データプロバイダーの選択や DbProviderFactoryのインスタンス化を調整するために使用される静的メソッドを示していま

す。

PsqlInfoMessageEventArgs オブジェクト PsqlInfoMessageEventArgs オブジェクトは、 PsqlInfoMessageEventHandler に入力として渡され、 Pervasive PSQL サーバーで生成される警告に関する情

報を格納します。

表 6-15 では、 PsqlInfoMessageEventArgs オブジェクトのパブリックプロパ

ティについて説明します。

表 6-14 PsqlFactory オブジェクトのメソッド

メソッド説明

CreateCommand 厳密に型指定された DbCommand インスタンスを返します。

CreateCommandBuilder 厳密に型指定された DbCommandBuilder インスタンスを返します。

CreateConnection 厳密に型指定された DbConnection インスタンスを返します。

CreateConnectionStringBuilder 厳密に型指定された DbConnectionString インスタンスを返します。

CreateDataAdapter 厳密に型指定された DbDataAdapter インスタンスを返します。

CreateDataSourceEnumerator 厳密に型指定された PsqlDataSourceEnumerator インスタンスを返します。

CreateParameter 厳密に型指定された DbParameter インスタンスを返します。

表 6-15 PsqlInfoMessageEventArgs のパブリックプロパティ


Errors Pervasive PSQL サーバーから送られる警告のコレクションを格納する

PsqlErrorCollection を指定します。詳細については、「PsqlErrorCollection オブジェ

クト」（6-13 ページ）を参照してください。

Message Pervasive PSQL サーバーから返される新のテキストメッセージを返します。複

数の警告が発生したかどうかを判断するには、アプリケーションはこのオブジェ

クトの Errors プロパティで返される PsqlErrorCollection の Count プロパティを調

べる必要があります。

6-15


PsqlParameter オブジェクト PsqlParameter オブジェクトは PsqlCommand オブジェクトのパラメーター

を表します。

表 6-16 では、 PsqlParameter オブジェクトのパブリックプロパティについ


表 6-16 PsqlParameter オブジェクトのパブリックプロパティ


ArrayBindStatus PsqlParameterStatus エントリの配列内のすべての値を null としてバインドする

必要があるかどうかを決定します。 PsqlParameterStatus 列挙はエントリ

NullValue を含んでいます。

このプロパティを設定しなければ、値は null になりません。配列の長さは、

PsqlCommand オブジェクトの ArrayBindCount プロパティで指定された値と一

致する必要があります（「PsqlCommand オブジェクト」（6-4 ページ）を参照し

てください）。

デフォルトの初期値は null です。

DbType パラメーターの DbType を取得または設定します。

Direction パラメーターが入力専用、出力専用、双方向、あるいはストアドプロシージャ

の戻り値パラメーターかどうかを示す値を取得または設定します。

IsNullable パラメーターが null 値を受け入れるかどうかを示す値を取得または設定しま

す。

ParameterName PsqlParameter オブジェクトの名前を設定または取得します。

Precision Value プロパティを表す場合の大桁数を取得または設定します。

Scale Value プロパティを解決する小数点以下の桁数を取得または設定します。

Size 列内のデータの大サイズをバイト単位で取得または設定します。

SourceColumn DataSet に割り当てられており、Value プロパティの読み込みまたは返却に使用

されるソース列の名前を取得または設定します。

SourceColumnNullMapping ソース列がヌル値を許可するかどうかを示す値を設定または取得します。

6-16


PsqlParameterCollection オブジェクト PsqlParameterCollection オブジェクトは PsqlCommand に関するパラメー

ターのコレクションです。また、DataSet の列へのマッピングも含まれてい

ます。

表 6-17 では、 PsqlParameterCollection オブジェクトのパブリックプロパ

ティについて説明します。

SourceVersion Value プロパティの読み込み時に使用する DataRowVersion を取得または設定

します。

Value パラメーターの値を取得または設定します。


メモ：配列バインドが有効な場合（「PsqlCommand オブジェクト」（6-4 ページ）

の ArrayBindCount プロパティを参照してください）、このプロパティは値の配

列として指定されます。各配列の長さは ArrayBindCount プロパティの値と一

致させる必要があります。バイナリ型の列に配列の値を指定する場合、その

データは実質的には byte[] として指定されます。これはバイトの配列の配列で

す。データプロバイダーは複数のパラメーターにバインドするパラメーター

配列を使用するような場合には、「ジャグ（Jagged）」配列を予測します。

ストアドプロシージャパラメーターに null を設定すると、データプロバイ

ダーはそのパラメーターをサーバーに送りません。代わりに、ストアドプロ

シージャを実行する際はパラメーターのデフォルト値が使用されます。

表 6-16 PsqlParameter オブジェクトのパブリックプロパティ


表 6-17 PsqlParameterCollection のパブリックプロパティ


Count コレクション内の PsqlParameter オブジェクトの数を取得します。

IsFixedSize PsqlParameterCollection が固定サイズかどうかを示す値を取得します。

IsReadOnly PsqlParameterCollection が読み取り専用かどうかを示す値を取得します。

IsSynchronized PsqlParameterCollection がスレッドセーフかどうかを示す値を取得します。

Item 指定されたインデックス位置にあるパラメーターを返します。 C# の場合、この

プロパティは IDataParameterCollection クラス用のインデクサーです。

SynchRoot PsqlParameterCollection への同期アクセスに使用するオブジェクトを取得します。

6-17


表 6-18 では、 PsqlParameterCollection オブジェクトのパブリックメソッド

について説明します。

PsqlTrace オブジェクト PsqlTrace オブジェクトは、開発時に問題をデバッグするためアプリケー

ションによって作成されます。PsqlTrace オブジェクトのプロパティを設定

すると、その値を優先し環境変数の設定を無効にします。詳細については、

「接続文字列オプション」（2-4 ページ）を参照してください。アプリケー

ションが終的なものになったら、PsqlTrace オブジェクトへの参照を必ず

削除してください。

次のコードでは MyTrace.txt という名前の Trace オブジェクトを作成してい

ます。その結果、データプロバイダーへの呼び出しはすべてそのファイル

へトレースされます。

PsqlTrace MyTraceObject = new PsqlTrace(); MyTraceObject.TraceFile="C:\\MyTrace.txt"; MyTraceObject.RecreateTrace = 1; MyTraceObject.EnableTrace = 1;

表 6-19 では、 PsqlTrace オブジェクトのパブリックプロパティについて説

明します。

表 6-18 PsqlParameterCollection オブジェクトのパブリックメソッド

メソッド説明

Contains コレクション内のパラメーターに、指定したソーステーブル名が格納されてい

るかどうかを示す値を取得します。

IndexOf コレクション内における IDataParameter の位置を取得します。

RemoveAt コレクションから IDataParameter を削除します。

表 6-19 PsqlTrace のパブリックプロパティ


EnableTrace 1 以上に設定すると、トレースが有効になります。

デフォルトの初期値は 0 で、トレースは無効です。

RecreateTrace 1 に設定すると、アプリケーションを開始するたびにトレースファイルが再作成

されます。

0 （デフォルトの初期値）に設定すると、トレースファイルは追加されます。

6-18


表 6-20 では、 PsqlTrace オブジェクトのパブリックメソッドについて説明

します。

PsqlTransaction オブジェクト表 6-21 では、PsqlTransaction オブジェクトのパブリックプロパティについ


表 6-22 では、PsqlTransaction オブジェクトのパブリックメソッドについて

説明します。

TraceFile トレースファイルのパスと名前を指定します。

デフォルトの初期値は \PVSWNET_Trace.txt です。このファイルが存在しない場

合はデータプロバイダーが作成します。

メモ： EnableTrace でトレースを有効にするよう設定するとトレース処理が開始します。したがって、

EnableTrace を設定する前にトレースファイル用のプロパティ値を定義しておく必要があります。いったん

トレース処理が開始されたら、 TraceFile および RecreateTrace プロパティの値を変更することはできません。

表 6-19 PsqlTrace のパブリックプロパティ


表 6-20 PsqlTrace オブジェクトのパブリックメソッド

メソッド説明

DumpFootprints 1 つのデータプロバイダーのすべてのソースファイルのフットプリントを表示

します。

表 6-21 PsqlTransaction オブジェクトのパブリックプロパティ


Connection トランザクションに関連付けられる PsqlConnection オブジェクトを指定します。

詳細については、「PsqlConnection オブジェクト」（6-9 ページ）を参照してくださ

い。

IsolationLevel トランザクション全体の分離レベルを定義します。値を変更すると、その新しい

値が実行時に使用されます。

表 6-22 PsqlTransaction オブジェクトのパブリックメソッド

メソッド説明

Commit 派生クラスで上書きされた場合、その結果生じる 1 つ以上の例外の根本原因であ

る Exception を返します。

Rollback トランザクションをコミットする前に、そのトランザクションで行った変更を取

り消します。

6-19


Pervasive Common Assembly クラス

Pervasive PSQL データプロバイダーでは、バルクロードなどの拡張機能を

提供する追加クラスが使用できます。すべてのクラスはマネージコードの

みで作成されています。以下のクラスが Pervasive.Data.Common.dll アセン

ブリで提供されます。

「CsvDataReader」（6-20 ページ）

「CsvDataWriter」（6-22 ページ）

「DbBulkCopy」（6-23 ページ）

「DbBulkCopyColumnMapping」（6-23 ページ）

「DbBulkCopyColumnMapping」（6-23 ページ）

バルクロードに使用されるクラスは、汎用プログラミングモデルを実装し

ます。これらは、 DataDirect Bulk Load をサポートする任意の DataDirectTechnolgies ADO.NET データプロバイダーまたは ODBC ドライバーおよび

サポートされる任意のデータベースと共に使用することができます。

CsvDataReaderCsvDataReader クラスは、 Pervasive Bulk Load が定義した CSV ファイル形

式用の DataReader 構文を提供します。

表 6-23 は、 CsvDataWriter オブジェクトのパブリックプロパティの一覧で

す。

表 6-23 CsvDataReader オブジェクトのパブリックプロパティ


BulkConfigFile WriteToFile メソッドが呼び出されたときに作成された CSV バルク構成ファイル

を指定します。バルクロード構成ファイルは、バルクロードデータファイル内

の列の名前とデータ型を、データをエクスポートしたテーブルや結果セットと同

じ方法で定義します。バルクロード構成ファイルは、基となる XML スキーマに

よってサポートされます。CSV バルク構成ファイルの例については、「バルクロー

ド構成ファイル」（11-1 ページ）を参照してください。

パスには絶対パスを使用します。そうしないと、ファイルは現在の作業ディレク

トリにあるものと見なされます。

メモ：このプロパティは Open() 呼び出しの前および Close() 呼び出しの後にのみ

設定できます。それ以外の場合、 InvalidOperationException がスローされます。

6-20


表 6-24 は CsvDataReader オブジェクトのパブリックメソッドの一覧です。

BulkFile CSV 形式のバルクデータを含むバルクロードデータファイルを指定します。こ

のファイル名は、バルクデータの書き出し（エクスポート）および読み込み（イ

ンポート）で使用されます。指定したファイル名に拡張子が含まれない場合は、

".csv" と見なされます。

パスには絶対パスを使用します。そうしない場合、ファイルはデフォルトで現在

の作業ディレクトリにあるものと見なされます。この値が設定されていないと、

InvalidOperationException がスローされます。



ReadBufferSize バルクロードを使用してデータソースからデータをインポートする場合の読み

取りバッファーのサイズを指定します。

デフォルトの初期値は 2048 KB です。

ゼロまたはゼロより小さい値を設定すると、System.ArgumentOutOfRangeExceptionがスローされます。

RowOffset バルクロード読み取りを開始する行を指定します。RowOffset は先頭行（第 1 行）

からの相対位置です。


ゼロまたはゼロより小さい値を設定すると、System.ArgumentOutOfRangeExceptionがスローされます。



SequentialAccess パフォーマンス改善のための手法で列にアクセスするかどうかを決定します。

デフォルトの初期値は False です。



表 6-23 CsvDataReader オブジェクトのパブリックプロパティ


表 6-24 CsvDataReader オブジェクトのパブリックメソッド


Open 処理に必要なバルクファイルのインスタンスおよび関連付けられたメタデータ

ファイルを開きます。

6-21


CsvDataWriterCsvDataWriter クラスは、 Pervasive Bulk Load によって書き出される CSVファイル形式の Pervasive DataWriter 構文を提供します。

詳細については、データプロバイダーのオンラインヘルプを参照してくだ

さい。

表 6-25 は、 CsvDataWriter オブジェクトのパブリックプロパティの一覧で

す。

表 6-26 は CsvDataWriter オブジェクトのパブリックメソッドの一覧です。

表 6-25 CsvDataWriter オブジェクトのパブリックプロパティ


BinaryThreshold バルクアンロード中にバイナリデータを格納するのに、どのサイズでファイル

を分けて生成するかを決定するしきい値（KB 単位）を指定します。


ゼロより小さい値を指定すると System.ArgumentOutOfRangeException がスローさ

れます。

CharacterThreshold バルクアンロード中に文字データを格納するのに、どのサイズでファイルを分け

て生成するかを決定するしきい値（KB 単位）を指定します。


ゼロより小さい値を指定すると System.ArgumentOutOfRangeException がスローさ

れます。

CsvCharacterSetName サポートされる IANA コードページの中から、使用されるコードページ名を値

で指定します。サポートされる値については、「IANA コードマッピング」（12-1ページ）を参照してください。

アプリケーションは、 PsqlConnection.DatabaseCharacterSetName プロパティを使用

してデータベースに設定されている文字セットを取得できます。

認識されない CharacterSetName を使用すると、無効な文字セットが使用されたこ

とを示す例外がスローされます。

デフォルトの初期値は UTF-16 です。

このプロパティは、 CSV データファイルおよび追加されるオーバーフローファ

イルでこの文字セットが必ず使用されるようにします。

表 6-26 CsvDataWriter オブジェクトのパブリックメソッド


Open 処理に必要なバルクファイルのインスタンスおよび関連付けられたメタデータ

ファイルを開きます。

WriteToFile IDataReader の内容をバルクデータファイルに書き出します。

6-22


DbBulkCopyDbBulkCopy クラスは 1 つのデータソースから別のデータソースへ行をコ

ピーするのを容易にします。

DbBulkCopy オブジェクトは、事実上の業界標準である MicrosoftSqlBulkCopy クラスの定義に従っており、プロバイダー固有のプロパティ

やメソッドを持ちません。サポートされるプロパティおよびメソッドにつ

いては、データプロバイダーのオンラインヘルプおよび Microsoft .NETFramework SDK のマニュアルを参照してください。

DbBulkCopyColumnMappingDbBulkCopyColumnMapping クラスは、データソーステーブルから宛先

テーブルへの列のマップを表します。

DbBulkCopyColumnMapping オブジェクトは、事実上の業界標準である

Microsoft SqlBulkCopyColumnMapping クラスの定義に従っており、プロバ

イダー固有のプロパティやメソッドを持ちません。サポートされるプロパ

ティおよびメソッドについては、データプロバイダーのオンラインヘルプ

および Microsoft .NET Framework SDK のマニュアルを参照してください。

DbBulkCopyColumnMappingCollectionDbBulkCopyColumnMappingCollection クラスは DbBulkCopyColumnMappingオブジェクトのコレクションです。

DbBulkCopyColumnMappingCollection オブジェクトは、事実上の業界標準

である Microsoft SqlBulkCopyColumnMappingCollection クラスの定義に従っ

ており、プロバイダー固有のプロパティやメソッドを持ちません。サポー

トされるプロパティおよびメソッドについては、データプロバイダーのオ

ンラインヘルプおよび Microsoft .NET Framework SDK のマニュアルを参照


6-23


6-24

7
スキーマ情報の入手
データベースのメタデータの検索および取り出し

アプリケーションは、データベースのメタデータを検索して返すよう、デー

タプロバイダーに要求することができます。各データプロバイダー固有の

スキーマコレクションは、テーブルや列などのデータベーススキーマ要素

を公開します。データプロバイダーは Connection クラスの GetSchema メソッドを使用します。スキーマ情報は「GetSchemaTable メソッドによって

返される列」（7-2 ページ）で説明されているように、結果セットからも取

得できます。

データプロバイダーにもプロバイダー固有のスキーマコレクションが含

まれています。スキーマコレクション名 MetaDataCollections を使用する

と、サポートされるスキーマコレクションの一覧と、それらがサポートす

る制限の数を返すことができます。

7-1


GetSchemaTable メソッドによって返される列 PsqlDataReader が開いている間は、結果セットからスキーマ情報を取得す

ることができます。PsqlDataReader.GetSchemaTable() で生成された結果セッ

トは、表 7-1 に説明されている列を、指定された順序で返します。

表 7-1 PsqlDataReader の GetSchemaTable で返される列

列説明

ColumnName 列の名前。列名は一意でない場合もあります。判断できない場合は、 null 値が

返されます。この名前は、現在のビュー内またはコマンドテキスト内の列に

対する新の名前変更を常に反映した名前になります。

ColumnOrdinal 列の序数。この列に null 値を含めることはできません。行のブックマーク列

（ある場合）はゼロになります。その他の列は 1 から順に番号が付けられます。

ColumnSize 列の値に許容される大長。固定長データ型を使用する列では、そのデータ型

のサイズになります。

NumericPrecision 列の精度。これは ProviderType での列の定義方法によって決まります。

ProviderType が数値データ型の場合、これは列の大精度になります。

ProviderType が数値データ型以外の場合は、 null 値になります。

NumericScale 小数点の右側の桁数。これは、 ProviderType が DBTYPE_DECIMAL または

DBTYPE_NUMERIC の場合です。それ以外の場合は、 null 値になります。

この値は、 ProviderType での列の定義方法によって決まります。

DataType 列を .NET Framework の型にマップします。

ProviderType 列のデータ型のインジケーター。この列に null 値を含めることはできません。

列のデータ型が行によって異なる場合は、 Object である必要があります。

IsLong 非常に長いデータを格納する BLOB が列に含まれている場合に設定されます。

このフラグの設定は、データ型の、PROVIDER_TYPES 行セット内の IS_LONG列の値に対応します。

非常に長いデータの定義は、プロバイダーによって異なります。

AllowDBNull コンシューマーが列に null 値を設定できる場合や、コンシューマーが列に null値を設定できるかどうかをデータプロバイダーが判断できない場合に、設定

されます。それ以外の場合は、設定されません。

列を null 値に設定できない場合でも、null 値が含まれている可能性があります。

IsReadOnly 列を変更できるかどうかを決定します。

列が変更できない場合は true、それ以外の場合は false です。

IsRowVersion 書き込み禁止で、行の識別以外に意味のない値を持つ永続的な行 ID が列に格

納されている場合に、設定されます。

7-2

GetSchemaTable メソッドによって返される列

IsUnique 列自体がキーを構成しているか、あるいは、その列だけに適用される UNIQUE型の制約があるかどうかを示します。

true に設定した場合、ベーステーブル（BaseTableName で返されるテーブル）

の行は、この列に同じ値を格納できません。

false （デフォルトの初期値）に設定した場合は、ベーステーブルでこの列に重

複する値を格納できます。

IsKey 列のセットが行セットの 1 行を一意に識別するかどうかを指定します。この列

のセットは、ベーステーブルの主キー、一意の制約、または重複のないイン

デックスから生成することができます。

列が、行セット内の列のセットのうちの 1 つで、これらを基に行を一意に識別

する場合は true です。列が行を一意に識別する必要がない場合は false です。

IsAutoIncrement 新しい行に固定インクリメントで値を割り当てるかどうかを指定します。

VARIANT_TRUE に設定すると、列は新しい行に固定インクリメントで値を割

り当てます。

VARIANT_FALSE （デフォルトの初期値）に設定すると、列は新しい行に固定

インクリメントで値を割り当てません。

BaseSchemaName 列を格納している、データベース内のスキーマの名前。基本スキーマ名を判断

できない場合は null 値です。


BaseCatalogName 列を格納している、データストア内のカタログの名前。基本カタログ名を判

断できない場合は null 値が使用されます。


BaseTableName 列を格納している、データストア内のテーブルまたはビューの名前。基本テー

ブル名を判断できない場合は null 値が使用されます。


BaseColumnName データストア内での列名。エイリアスが使用された場合は、ColumnName 列に

返される列名とは異なることがあります。基本列名を判断できない場合や、

データベース内の列から派生した行セット列であるのにそれと一致しない場

合は、 null 値が使用されます。


IsAliased 列の名前がエイリアスであるかどうかを指定します。列名がエイリアスであれ

ば、値 true が返されます。そうでなければ、 false が返されます。

IsExpression 列の名前が式であるかどうかを指定します。列が式であれば、値 true が返され

ます。そうでなければ、 false が返されます。


列説明

7-3


IsIdentity 列の名前が ID 列であるかどうかを指定します。列が ID 列であれば、値 true が返されます。そうでなければ、 false が返されます。

IsHidden 列の名前が非表示であるかどうかを指定します。列が表示されない場合は、値

true が返されます。そうでなければ、 false が返されます。


列説明

7-4

GetSchema メソッドによるスキーマメタデータの取得


アプリケーションでデータプロバイダーおよびデータソースに関するス

キーマメタデータを取得する場合は、Connection オブジェクトの GetSchemaメソッドを使用を使用します。各プロバイダーには 5 つの標準メタデータ

コレクションも含め、多数のスキーマコレクションが実装されています。

「MetaDataCollections スキーマコレクション」（7-5 ページ）

「DataSourceInformation スキーマコレクション」（7-6 ページ）

「DataTypes コレクション」（7-7 ページ）

「ReservedWords コレクション」（7-9 ページ）

「Restrictions コレクション」（7-9 ページ）

追加のコレクションを指定したら、データプロバイダーからスキーマ情報

を返す機能がサポートされるようにしておく必要があります。

データプロバイダーでサポートされるその他のコレクションの詳細につい

ては、「追加のスキーマコレクション」（7-10 ページ）を参照してください。

メモ：各 ColumnName で必要なデータ型など、さらなるバックグラウンド

機能要件については、 .NET Framework ドキュメントを参照してください。

MetaDataCollections スキーマコレクション

MetaDataCollections スキーマコレクションは、ログインしているユーザー

が利用できるスキーマコレクションの一覧です。 MetaDataCollection は、

表 7-2 に記載されているサポートされる列を任意の順序で返すことができ

ます。

表 7-2 MetaDataCollections スキーマコレクションによって返される列

列名説明

CollectionName コレクションを返すために GetSchema メソッドに渡すコレクションの名前。

NumberOfRestrictions コレクションに指定されている可能性のある制限の数。

NumberOfIdentifierParts 複合識別子 / データベースオブジェクト名の構成要素の数。

7-5


DataSourceInformation スキーマコレクション

DataSourceInformation スキーマコレクションは、表 7-3 に記載されている

サポートされる列を任意の順序で返すことができます。 1 行のみ返される

ことに注意してください。

表 7-3 DataSourceInformation コレクションによって返される列名

列名説明

CompositeIdentifierSeparatorPattern 複合識別子内の複合識別子に一致する正規表現。

DataSourceProductName データプロバイダーがアクセスする製品の名前。

DataSourceProductVersion データプロバイダーがアクセスする製品のバージョンをデータ

ソースのネイティブ形式で示します。

DataSourceProductVersionNormalized データソースの標準化されたバージョン。これにより、

String.Compare() を使ってバージョンを比較できるようになります。

GroupByBehavior GROUP BY 句内の列と、選択リスト内の集計されない列の間の関係

を指定します。

Host データプロバイダーが接続しているホスト。

IdentifierCase 引用符で囲まれていない識別子の大文字小文字を区別して処理す

るかどうかを示します。

IdentifierPattern 識別子に一致する正規表現で、識別子の適合値を持ちます。

OrderByColumnsInSelect ORDER BY 句内の列は選択リスト内にある必要があるかどうかを

指定します。 true の値は、当該列が選択リストに存在しなければな

らないことを示し、false の値は選択リストに存在しなくてもよいこ

とを示します。

ParameterMarkerFormat パラメーターの書式設定方法を示す書式文字列。

ParameterMarkerPattern パラメーターマーカーに一致する正規表現。もしあれば、パラメー

ター名の適合値を持ちます。

ParameterNameMaxLength パラメーター名の大長（文字単位）。

ParameterNamePattern 有効なパラメーター名に一致する正規表現。

QuotedIdentifierCase 引用符で囲まれた識別子の大文字小文字を区別して処理するかど

うかを示します。

QuotedIdentifierPattern 引用符で囲まれた識別子に一致する正規表現で、引用符の付いてい

ない識別子自体の適合値を持ちます。

StatementSeparatorPattern ステートメント区切り文字に一致する正規表現。

7-6


DataTypes コレクション

表 7-4 では、 DataTypes スキーマコレクションでサポートされる列につい

て説明します。列は任意の順序で取得できます。

StringLiteralPattern 文字列リテラルに一致する正規表現で、リテラル自体の適合値を持

ちます。

SupportedJoinOperators データソースでサポートされる、 SQL 結合ステートメントの種類

を指定します。

表 7-3 DataSourceInformation コレクションによって返される列名

列名説明

表 7-4 DataTypes コレクションによって返される列名

列名説明

ColumnSize 数値以外の列またはパラメーターの長さは、この型の大長もしくは、データプロ

バイダーがこの型に対して定義している長さを参照します。

CreateFormat CREATE TABLE など、この列をデータ定義ステートメントに追加する方法を示す書

式文字列。

CreateParameters このデータ型の列を作成するときに指定する必要のある作成パラメーター。各作成

パラメーターは文字列で、それらを提供する順にカンマで区切って列挙します。

たとえば、 SQL データ型の DECIMAL には精度と小数点以下の桁数が必要です。こ

の場合は、文字列 "精度 , 小数位 " を作成パラメーターに含める必要があります。

精度 10、小数位 2 の DECIMAL 列を作成するテキストコマンドでは、 CreateFormat列の値を "DECIMAL({0},{1})" とすることができます。完全な型指定は

DECIMAL(10,2) となります。

DataType データ型に対する .NET Framework 型の名前。

IsAutoIncrementable データ型の値を自動インクリメントするかどうかを指定します。

true ：このデータ型の値は自動インクリメントできます。

false ：このデータ型の値は自動インクリメントできません。

IsBestMatch このデータ型は、データストア内のすべてのデータ型と、 DataType 列の値によって

示される .NET Framework データ型の間で適なものであるかどうかを指定します。

true ：適なデータ型です。

false ：適なデータ型ではありません。

IsCaseSensitive データ型は文字型で、大文字小文字を区別するかどうかを指定します。

true ：文字型で、大文字小文字を区別します。

false ：文字型でないか、もしくは大文字小文字を区別しません。

7-7


IsConcurrencyType true ：このデータ型は行が変更されるたびにデータベースによって更新され、列の値

は以前のあらゆる値と異なるものになります。

false ：このデータ型は行が変更されるたびにデータベースによって更新されません。

IsFixedLength true ：データ定義言語（DDL）によって作成されるこのデータ型の列は固定長になり

ます。

false ： DDL によって作成されるこのデータ型の列は可変長になります。

IsFixedPrecisionScale true ：データ型は固定の精度と小数点以下の桁数を持ちます。

false ：データ型は固定の精度と小数点以下の桁数を持ちません。

IsLiteralsSupported true ：データ型をリテラルで表すことができます。

false ：データ型をリテラルで表すことはできません。

IsLong true ：データ型は非常に長いデータを格納します。非常に長いデータの定義は、プロ

バイダーによって異なります。

false ：データ型は非常に長いデータを格納しません。

IsNullable true ：データ型はヌル値を許可します。

false ：データ型はヌル値を許可しません。

IsSearchable true ：データ型は非常に長いデータを格納します。非常に長いデータの定義は、プロ

バイダーによって異なります。

false ：データ型は非常に長いデータを格納しません。

IsSearchableWithLike true ： LIKE 述部で使用できません。

false ： LIKE 述部で使用できません。

IsUnisgned true ：データ型は符号なしです。

false ：データ型は符号付きです。

LiteralPrefix 指定されたリテラルに適用するプレフィックス。

LiteralSuffix 指定されたリテラルに適用するサフィックス。

MaximumScale 型インジケーターが数値型の場合は、これは小数点の右側に割り当てられる大桁

数になります。

それ以外の場合、これは DBNull.Value になります。

MinimumScale 型インジケーターが数値型の場合は、これは小数点の右側に割り当てられる小桁

数になります。

それ以外の場合、これは DBNull.Value になります。

ProviderDbType パラメーターの型を指定する場合に使用する必要のあるプロバイダー固有の型の値。

TypeName プロバイダー固有のデータ型名。

表 7-4 DataTypes コレクションによって返される列名

列名説明

7-8


ReservedWords コレクション

このスキーマコレクションは、データプロバイダーが接続するデータベー

スで予約されている語句についての情報を公開します。表 7-5 では、デー

タプロバイダーがサポートする列について説明します。

Restrictions コレクション

Restrictions スキーマコレクションは、現在データベースに接続している

データプロバイダーでサポートされる制限に関する情報を公開します。表

7-6 では、データプロバイダーから返される列について説明します。列は

任意の順序で取得できます。

Pervasive PSQL データプロバイダーは標準化された名前を制限に使用しま

す。データプロバイダーが Schema メソッドの制限をサポートしている場

合は、制限に対して常に同じ名前を使用します。

制限値の大文字小文字の区別は基になるデータベースによって決定されま

すが、 DataSourceInformation コレクションの IdentifierCase 値および

QuotedIdentifierCase 値によっても決定することができます

（「DataSourceInformation スキーマコレクション」（7-6 ページ）を参照して

ください）。

サポートされる追加のスキーマコレクションそれぞれに適用する制限に

ついては、「追加のスキーマコレクション」（7-10 ページ）を参照してくだ

さい。

表 7-5 ReservedWords スキーマコレクション

列名説明

Reserved Word プロバイダー固有の予約語。

表 7-6 Restrictions コレクションによって返される列名

列名説明

CollectionName 指定した制限を適用するコレクションの名前。

RestrictionName コレクション内の制限の名前。

RestrictionDefault 無視されます。

RestrictionNumber この制限の、コレクション Restrictions 内における実際の場所。

IsRequired 制限が必要かどうかを指定します。

7-9


追加のスキーマコレクション Pervasive PSQL データプロバイダーは、以下に示す追加のスキーマコレク

ションをサポートしています。

「Columns スキーマコレクション」（7-10 ページ）

「ForeignKeys スキーマコレクション」（7-12 ページ）

「Indexes スキーマコレクション」（7-13 ページ）

「PrimaryKeys スキーマコレクション」（7-14 ページ）

「ProcedureParameters スキーマコレクション」（7-15 ページ）

「Procedures スキーマコレクション」（7-17 ページ）

「TablePrivileges スキーマコレクション」（7-18 ページ）

「Tables スキーマコレクション」（7-19 ページ）

「Views スキーマコレクション」（7-20 ページ）

Columns スキーマコレクション

説明： Columns スキーマコレクションは、指定したユーザーがアクセスで

きるカタログに定義されているテーブル（ビューも含む）の列を識別しま

す。表 7-7 では、指定したユーザーがアクセスできるカタログに定義され

ているテーブルの列を示します。

制限の数： 3

使用可能な制限： TABLE_CATALOG、 TABLE_NAME、 COLUMN_NAME

ソート順： TABLE_CATALOG、 TABLE_NAME、 ORDINAL_POSITION

表 7-7 Columns スキーマコレクション

列名 .NET Framework データ型 1

説明

CHARACTER_MAXIMUM_LENGTH Int32 列の値に許容される大長。文字、バイナリ、ま

たはビットの列の場合、これは次のいずれかに

なります。

いずれかの列が定義されている場合は、それ

ぞれ文字単位、バイト単位、ビット単位の列

の大長。

列の長さが定義されていない場合は、それぞ

れ文字単位、バイト単位、ビット単位のデー

タ型の大長。

列にもデータ型にも大長が定義されてい

ない場合、あるいは列が文字、バイナリ、ビッ

トのいずれでもない場合は、ゼロ（0）。

7-10

追加のスキーマコレクション

CHARACTER_OCTET_LENGTH Int32 列の型が文字またはバイナリの場合は、 8 進数

（バイト単位）で表す列の大長。

値ゼロ（0）は、その列が大長を持たないか、

あるいは、文字またはバイナリの列でないこと

を意味します。

COLUMN_DEFAULT String 列のデフォルト値。

COLUMN_HASDEFAULT Boolean TRUE ：列にはデフォルト値があります。

FALSE ：列にデフォルト値がないか、もしくは

デフォルト値があるかどうかが不明です。

COLUMN_NAME String 列の名前。これは一意でない可能性があります。

DATA_TYPE Object 列のデータ型のインジケーター。

この値をヌルにすることはできません。

IS_NULLABLE Boolean TRUE ：列はヌル値を許可する可能性がありま

す。

FALSE ：列がヌル値を許可するかどうかわかり

ません。

NATIVE_DATA_TYPE String 型のデータソース記述。


NUMERIC_PRECISION Int32 列のデータ型が数値データのものである場合、

これは列の大精度（有効桁数）になります。

NUMERIC_PRECISION_RADIX Int32 どの数を基礎として NUMERIC_PRECISION および NUMERIC_SCALE で値を表現するかを示

す基数。2 または 10 を返す場合にのみ有効です。

NUMERIC_SCALE Int32 列の型が小数位を持つ数値型の場合、これは小

数点より右側の桁数です。

ORDINAL_POSITION Int32 列の序数。列には 1 から始まる番号が付けられ

ています。

PROVIDER_DEFINED_TYPE Int32 列のデータソース定義の型は、データプロバイ

ダーの型の列挙（たとえば PsqlDbType 列挙）に

マップされています。


PROVIDER_GENERIC_TYPE Int32 列のプロバイダー定義の型は

System.Data.DbType 列挙にマップされています。




説明

7-11


ForeignKeys スキーマコレクション

説明： ForeignKeys スキーマコレクションは、指定したユーザーによって

カテゴリ内に定義された外部キー列を識別します。

制限の数： 2

使用可能な制限： FK_TABLE_CATALOG、 PK_TABLE_NAME

ソート順： FK_TABLE_CATALOG、 FK_TABLE_NAME

TABLE_CATALOG String データベース名。

TABLE_NAME String テーブル名。

1 クラスはすべて System.XXX です。たとえば、 System.String となります。



説明

表 7-8 ForeignKeys スキーマコレクション


説明

DEFERRABILITY String 外部キーを延期できるか。次のいずれかの値になります。

INITIALLY DEFERRED

INITIALLY IMMEDIATE

NOT DEFERRABLE

DELETE_RULE String 削除規則が指定された場合は、次のいずれかの値になり

ます。

CASCADE ： CASCADE の参照操作が指定されました。

SET NULL ： SET NULL の参照操作が指定されました。

SET DEFAULT ： SET DEFAULT の参照操作が指定されま

した。

NO ACTION ：NO ACTION の参照操作が指定されました。

FK_COLUMN_NAME String 外部キー列の名前。

FK_NAME String 外部キー名。この制限は必須です。

FK_TABLE_CATALOG String 外部キーテーブルが定義されているカタログ名。

FK_TABLE_NAME String 外部キーテーブル名。この制限は必須です。

7-12


Indexes スキーマコレクション

説明： Indexes スキーマコレクションは、指定したユーザーが所有してい

るカテゴリ内に定義されたインデックスを識別します。

制限の数： 2

使用可能な制限： TABLE_CATALOG、 TABLE_NAME

ソート順： UNIQUE、 TYPE、 INDEX、 CATALOG、 INDEX_NAME、ORDINAL_POSITION

ORDINAL Int32 キーにおける列名の順序。たとえば、あるテーブルに別

のテーブルへの外部キー参照がいくつか含まれていると

します。序数は参照ごとに初から始まります。 3 列の

キーへの 2 つの参照ならば、 1, 2, 3, 1, 2, 3 を返します。

PK_COLUMN_NAME String 主キー列の名前。

PK_NAME String 主キー名。

PK_TABLE_CATALOG String 主キーテーブルが定義されているカタログ名。

PK_TABLE_NAME String 主キーテーブル名。

UPDATE_RULE String 更新規則が指定された場合は、次のいずれかの値になり

ます。

CASCADE ： CASCADE の参照操作が指定されました。

SET NULL ： SET NULL の参照操作が指定されました。

SET DEFAULT ： SET DEFAULT の参照操作が指定されま

した。

NO ACTION ：NO ACTION の参照操作が指定されました。


表 7-8 ForeignKeys スキーマコレクション


説明

表 7-9 Indexes スキーマコレクション


説明

CARDINALITY Int32 インデックスに含まれる一意な値の数。

COLLATION String 次のいずれかの値になります。

ASC ：列の並べ替え順は昇順です。

DESC ：列の並べ替え順は降順です。

7-13


PrimaryKeys スキーマコレクション

説明： PrimaryKeys スキーマコレクションは、指定したユーザーによって

カテゴリ内に定義された主キー列を識別します。

制限の数： 2


ソート順： TABLE_CATALOG、 TABLE_NAME

COLUMN_NAME String 列名。

FILTER_CONDITION String フィルター制限を識別する WHERE 句。

INDEX_CATALOG String カタログ名。

INDEX_NAME String インデックス名。

ORDINAL_POSITION Int32 インデックスにおける列の位置を表す、1 から始まる序数。

PAGES Int32 インデックスの格納に使用されるページ数。

TABLE_CATALOG String カタログ名。


TYPE String インデックスの種類。次のいずれかの値になります。

BTREE ：インデックスは B+- ツリーです。

HASH ：インデックスは、直線的なハッシュや伸縮可能な

ハッシュを用いたハッシュファイルです。

CONTENT：インデックスはコンテンツインデックスです。

OTHER：インデックスは上記の種類以外のインデックスで

す。

UNIQUE Boolean インデックスキーは一意である必要があるかどうかを決

定します。次のいずれかの値になります。

TRUE ：インデックスキーは一意でなければなりません。

FALSE ：重複キーが許されます。


表 7-9 Indexes スキーマコレクション


説明

7-14


ProcedureParameters スキーマコレクション

説明：ProcedureParameters スキーマコレクションは、Procedures コレクショ

ンの一部であるプロシージャのパラメーターおよびリターンコードに関

する情報を返します。

制限の数： 3

使用可能な制限： PROCEDURE_CATALOG、 PROCEDURE_NAME、PARAMETER_NAME

ソート順： PROCEDURE_CATALOG、 PROCEDURE_NAME、ORDINAL_POSITION

表 7-10 PrimaryKeys スキーマコレクション


説明

COLUMN_NAME String 主キー列の名前。

ORDINAL Int32 キーにおける列名の順序。

PK_NAME String 主キー名。

TABLE_CATALOG String テーブルが定義されているデータベース名。



表 7-11 ProcedureParameters スキーマコレクション


説明

CHARACTER_OCTET_LENGTH Int32 パラメーターの型が文字またはバイナリの場合は、 8 進数

（バイト単位）で表すパラメーターの大長。

パラメーターが大長を持たない場合、値はゼロ（0）に

なります。

上記の型以外のパラメーターでは、値は -1 になります。

DATA_TYPE Object 列のデータ型のインジケーター。


DESCRIPTION String パラメーターの記述。たとえば、新しい従業員を追加する

プロシージャの Name パラメーターの記述を Employeename としてもかまいません。

7-15


IS_NULLABLE Boolean TRUE ：パラメーターはヌル値を許可する可能性がありま

す。

FALSE ：パラメーターはヌル値を許可しません。

NATIVE_DATA_TYPE String 型のデータソース記述。


NUMERIC_PRECISION Int32 列のデータ型が数値である場合、これは列の大精度（有

効桁数）になります。

列のデータ型が数値でない場合、これは DbNull になり

ます。

NUMERIC_SCALE Int32 列の型が小数位を持つ数値型の場合、これは小数点より右

側の桁数です。

それ以外の場合、これは DbNull になります。

ORDINAL_POSITION Int32 パラメーターが入力、入出力、または出力パラメーターで

ある場合、これはプロシージャ呼び出しにおけるパラメー

ターの位置を表す、 1 から始まる序数です。

パラメーターが戻り値の場合、これは DbNull になりま

す。

PARAMETER_DEFAULT String パラメーターのデフォルト値。

デフォルト値が NULL の場合、

PARAMETER_HASDEFAULT 列は TRUE を返し、

PARAMETER_DEFAULT 列は存在しなくなります。

PARAMETER_HASDEFAULT に FALSE を設定すると、

PARAMETER_DEFAULT 列が存在しなくなります。

PARAMETER_HASDEFAULT Boolean TRUE ：パラメーターにはデフォルト値があります。

FALSE ：パラメーターにデフォルト値がないか、もしくは

デフォルト値があるかどうかが不明です。

PARAMETER_NAME String パラメーター名。パラメーターに名前が付いていない場

合、これは DbNull になります。



説明

7-16


Procedures スキーマコレクション

説明： Procedures スキーマコレクションは、カタログに定義されているプ

ロシージャを識別します。可能であれば、接続ユーザーが EXECUTE 権限

を持っているプロシージャのみを返すようにしてください。

制限の数： 2

使用可能な制限： PROCEDURE_CATALOG、 PROCEDURE_NAME、PROCEDURE_TYPE

ソート順： PROCEDURE_CATALOG、 PROCEDURE_NAME

PARAMETER_TYPE String 次のいずれかの値になります。

INPUT ：パラメーターは入力パラメーターです。

INPUTOUTPUT：パラメーターは入出力パラメーターです。

OUTPUT ：パラメーターは出力パラメーターです。

RETURNVALUE：パラメーターはプロシージャの戻り値で

す。

UNKNOWN ：データプロバイダーには不明なパラメー

ターの種類です。

PROCEDURE_CATALOG String カタログ名。

PROCEDURE_NAME String プロシージャ名。

PROVIDER_DEFINED_TYPE Int32 列のデータソース定義の型は、データプロバイダーの型の

列挙（たとえば PSQLDbType 列挙）にマップされています。


PROVIDER_GENERIC_TYPE Int32 列のデータソース定義の型は System.Data.DbType 列挙に

マップされています。





説明

7-17


TablePrivileges スキーマコレクション

説明： TablePrivileges スキーマコレクションは、カタログに定義されてい

るテーブルについて、指定したユーザーが利用できる、つまり許可されて

いる権限を識別します。

制限の数： 3

使用可能な制限： TABLE_CATALOG、 TABLE_NAME、 GRANTEE

ソート順： TABLE_CATALOG、 TABLE_NAME、 PRIVILEGE_TYPE

表 7-12 Procedures スキーマコレクション


説明

PROCEDURE_CATALOG String データベース名。

PROCEDURE_NAME String プロシージャ名。

PROCEDURE_TYPE String 次のいずれかの値になります。

UNKNOWN ：値が返されるかどうかわかりません。

PROCEDURE ：プロシージャ。値は返されません。

FUNCTION ：関数。値が返されます。


表 7-13 TablePrivileges スキーマコレクション

列名型インジケーター1 説明

GRANTEE String 権限が付与されているユーザー名（または PUBLIC）。

PRIVILEGE_TYPE String 権限のタイプ。次のいずれかのタイプになります。

DELETE

INSERT

REFERENCES

SELECT

UPDATE

TABLE_CATALOG String テーブルが定義されているデータベースの名前。



7-18


Tables スキーマコレクション

説明： Tables スキーマコレクションは、指定したユーザーがアクセスでき

るカタログに定義されているテーブル（ビューも含む）を識別します。

制限の数： 3

使用可能な制限： TABLE_CATALOG、 TABLE_NAME、 TABLE_TYPE

ソート順： TABLE_TYPE、 TABLE_CATALOG、 TABLE_NAME

表 7-14 Tables スキーマコレクション


説明

DESCRIPTION String テーブルの記述。

列に関連付けられている記述がない場合、データプロバイ

ダーは DbNull を返します。



TABLE_TYPE String テーブルの種類。次のいずれかです。

ALIAS

GLOBAL TEMPORARY

LOCAL TEMPORARY

SYNONYM

SYSTEM TABLE

SYSTEM VIEW

TABLE

VIEW

この列に空文字列を含めることはできません。


7-19


Views スキーマコレクション

説明： Views スキーマコレクションは、指定したユーザーがアクセスでき

るカタログに定義されているビューを識別します。

制限の数： 2


ソート順： TABLE_CATALOG、 TABLE_NAME

表 7-15 Views スキーマコレクション

列名型インジケーター1 説明



VIEW _DEFINITION String ビュー定義。これはクエリ式です。


7-20

8
.NET の SQL エスケープシーケンス
エスケープシーケンスの使用

通常、外部結合やスカラー関数の呼び出しなどの言語機能の多くは、デー

タベース管理システム（DBMS）によって実装されます。これらの機能の

標準的な構文が定義されていても、 DBMS 特有の構文が使われる場合がよ

くあります。 .NET では、次の言語機能の標準的な構文を含む、エスケープ

シーケンスをサポートします。

日付、時刻およびタイムスタンプのリテラル

数値、文字列およびデータ型変換関数などのスカラー関数

外部結合

.NET で使用するエスケープシーケンスは次のとおりです。

{extension}

このエスケープシーケンスは Pervasive PSQL データプロバイダーによっ

て認識および解析されます。このデータプロバイダーはこのエスケープ

シーケンスをデータストア固有の文法で置き換えます。

8-1


日付、時刻、タイムスタンプのエスケープシーケンス

日付、時刻、およびタイムスタンプリテラルのエスケープシーケンスは次

のとおりです。

{literal-type '値 '}

literal-type は以下に示すタイプのうちの 1 つです。

例： UPDATE Orders SET OpenDate={d '1997-01-29'} WHERE OrderID=1023

リテラルの型説明値の形式

d 日付 yyyy-mm-dd

t 時刻 hh:mm:ss [1]

ts タイムスタンプ yyyy-mm-dd hh:mm:ss[.f...]

8-2

スカラー関数

スカラー関数

SQL 文で使用できるスカラー関数の構文は、次のとおりです。

{fn scalar-function}

scalar-function は、表 8-1 に列挙されている Pervasive PSQL データプロ

バイダーでサポートされるスカラー関数です。

例：

SELECT {fn UCASE(NAME)} FROM EMP

表 8-1 サポートされるスカラー関数

文字列関数数値関数日付時刻関数システム関数

ASCIIBIT_LENGTHCHARCHAR_LENGTHCHARACTER_LENGTHCONCATLCASE または LOWERLEFTLENGTHLOCATELTRIMOCTET_LENGTHPOSITIONREPLACEREPLICATERIGHTRTRIMSPACESTUFFSUBSTRINGUCASE または UPPER

ABSACOSASINATANATAN2CEILINGCOSCOTDEGREESEXPFLOORLOGLOG10MODPIPOWERRADIANSRANDROUNDSIGNSINSQRTTANTRUNCATE

CURDATECURRENT_DATECURTIMECURRENT_TIMECURRENT_TIMESTAMPDAYNAMEDAYOFMONTHDAYOFYEAREXTRACTHOURMINUTEMONTHMONTHNAMENOWQUARTERSECONDTIMESTAMPADDTIMESTAMPDIFFWEEKYEAR

DATABASEUSER

8-3


外部結合のエスケープシーケンス

.NET では SQL92 の左外部結合、右外部結合、および完全外部結合の構文

をサポートしています。外部結合用のエスケープシーケンスは次のとおり

です。

{oj outer-join}

この outer-join には次のような構文が入ります。

table-reference {LEFT | RIGHT | FULL} OUTER JOIN {table-reference | outer-join} ON search-condition

この場合、

table-reference はテーブル名で search-condition はテーブルを結合す

るのに使用する条件です。

例：

SELECT Customers.CustID, Customers.Name, Orders.OrderID, Orders.Status FROM {oj Customers LEFT OUTER JOIN Orders ON Customers.CustID=Orders.CustID} WHERE Orders.Status='OPEN'

Pervasive PSQL データプロバイダーは、以下の外部結合エスケープシーケ

ンスを Pervasive PSQL 9.x 以上と同様にサポートします。

左外部結合

右外部結合

完全外部結合

8-4

9
ロックレベルと分離レベル
ロックレベルと分離レベルの使用

ここでは、ロックレベルおよび分離レベルについて、またこれらの設定が、

取得するデータにどのように影響するかについて説明します。データベー

スシステムによって、サポートするロックレベルおよび分離レベルは異な

ります。 Pervasive PSQL では ReadCommitted と Serializable の分離レベルを

サポートします。 Pervasive PSQL はレコードレベルのロックもサポートし

ます。

詳細については、「分離レベル」（2-28 ページ）を参照してください。

9-1


ロック

ロックとは、ユーザーがデータベースのテーブルやレコードにアクセスす

るのを制限する処理です。複数のユーザーが同じテーブルやレコードに同

時にアクセスする可能性がある場合に、ロックをかけます。テーブルやレ

コードをロックすると、一度に 1 人のユーザーだけがデータに影響する処

理を行えるようになります。

ロック制御は、複数のユーザーが、データベースの同じレコードに同時に

アクセスしたり変更する場合に特に重要です。複数のユーザーが同時に使

えるデータベースは便利ですが、問題が発生することもあります。たとえ

ば、ロックしていない場合、 2 人のユーザーが同時に同じレコードを変更

しようとすると、正確なデータが取得できなかったり、一方のユーザーが

必要とするデータをもう一方のユーザーが削除してしまう可能性がありま

す。しかし、いったん 1 人のユーザーがアクセスしたレコードを、他のユー

ザーが一時的に変更できないようにロックできるようにしておくと、この

ような問題は発生しません。ロックすることによって、データベースへの

同時アクセスによる問題の発生を小限に抑えることができます。

9-2

分離レベル

分離レベル

分離レベルとは、データの一貫性を高めるためにデータベースシステムで

採用される特別なロック方法です。分離レベルが高いほど、そのロック方

法も複雑になります。データベースで使用される分離レベルによって、デー

タの一貫性に関連する次の事象がトランザクションで発生するかどうかが

決まります。

分離レベルとは、データベースシステムで、上記の事象が発生するのを防

げるかどうかを示すレベルです。ANSI（American National Standards Institute：米国規格協会）によって、次の 4 つの分離レベルが定められています

Read uncommitted (0) （コミットされていない読み取り）

Read committed (1) （コミットされた読み取り）

Repeatable read (2) （反復可能な読み取り）

Serializable (3) （直列化可能）

メモ Read committed (1) （コミットされた読み取り）および Serializable(3) （直列化可能）分離レベルは Pervasive PSQL v10 SP3 でのみサポー

トされます。

0 から 3 へとレベルが高くなるほど、トランザクションのデータの一貫性

も高くなります。一番低いレベルでは、上の 3 つの事象がすべて発生する

可能性があります。一番高いレベルでは、どの事象も発生しません。この

ような事象が発生するのを防げるかどうかは、各レベルで使う、次のよう

なロック方法によって決まります。

Dirty reads（ダーティーリード）

ユーザー 1 が行を変更します。ユーザー 1 がコミット

する前に、ユーザー 2 が同じ行を読み取ります。ユー

ザー 1 がロールバックします。ユーザー 2 は、実際に

はデータベースに存在しない行を読み取ったことにな

ります。これによって、ユーザー 2 は誤ったデータに

対して判断を下すことになるかもしれません。

Non-repeatable reads（反復不可能な読み取

り）

ユーザー 1 が行を読み取りましたがコミットしません。

ユーザー 2 がその同じ行を修正または削除し、それを

コミットします。ユーザー 1 がもう一度同じ行を読み

取ったときは、その行が変更または削除されています。

Phantom reads（ファントムリード）

ユーザー 1 は、検索条件を使用して複数行のセットを

読み取りましたがコミットはしません。ユーザー 2 がこの検索条件を満たす行を挿入し、コミットします。

ユーザー 1 が検索条件を使ってもう一度読み取ったと

きには、前になかった行が存在することになります。

9-3


表 9-1 では各分離レベルにおいて発生するデータ一貫性の事象を示しま

す。

分離レベルが高いほどデータの一貫性は高くなりますが、逆に、個々のユー

ザーの同時処理性は低くなります。同時処理とは、複数のユーザーが同時

にデータにアクセスして変更することです。分離レベルが上がるに従って、

使用されるロック制御が原因で、同時処理上の問題が発生する確率が高く

なります。

Read uncommitted (0)（コミットされていな

い読み取り）

データベースを変更するときにロックがかかり、トラ

ンザクションの終わり（EOT）まで維持されます。デー

タベースの読み取りには、ロックがかかりません。

Read committed (1) （コミットされた読み

取り） 1

データベースの読み取りと変更時にロックがかかりま

す。読み取り後にロックは解除されますが、変更され

たオブジェクトのロックは EOT まで維持されます。


データベースの読み取りと変更時にロックがかかりま

す。変更されたすべてのオブジェクトのロックは EOTまで維持されます。データの読み取りロックは、 EOTまで維持されます。変更不可能なアクセス構造（イン

デックスおよびハッシュ構造など）のロックは読み取

り後に解除されます。

Serializable (3) （直列化可能） 1

DataSet の影響を受ける行に、 EOT までロックがかかり

ます。変更されたアクセス構造、およびクエリで使わ

れた構造がすべて EOT までロックされます。

1Pervasive PSQL v10 SP3 でサポートされます。

表 9-1 分離レベルとデータの一貫性

レベル Dirty Read（ダーティーリード）

Nonrepeatable Read（反復不可能な

読み取り）

Phantom Read（ファントムリード）

0, Read uncommitted（コミットされていない読

み取り）

可可可

1, Read committed（コミットされた読み取り）

不可可可

2, Repeatable read（反復可能な読み取り）

不可不可可

3, Serializable（直列化可能）

不可不可不可

9-4

分離レベル

検討事項：分離レベルが高くなるほどロック制御が厳しくなり、ユーザー

が、別のユーザーによってかけられたロックが解除されるのを待つ時間が長

くなります。分離レベルと同時処理性には、このような逆比例的な関係が

あるので、分離レベルを選択する前にユーザーがデータベースをどのよう

に使用するか検討しておく必要があります。データの一貫性と同時処理性

のどちらがより重要かを考慮して、使用する分離レベルを決めてください。

9-5


ロックモードとレベル

データベースシステムによって使用するロックモードは異なりますが、通

常、「共有ロック」と「排他ロック」という 2 種類の基本モードがあります。

共有ロックでは、複数のユーザーが単一オブジェクトを参照することが可

能です。1 人のユーザーがレコードに共有ロックをかけると、2 番目に同じ

レコードにアクセスしたユーザーも共有ロックをかけることができます。

ただし、 2 番目のユーザーは、そのレコードに排他ロックをかけることは

できません。排他ロックとは、そのロックを取得したユーザーへの独占的

な権利です。1 人のユーザーがレコードに排他ロックをかけると、2 番目の

ユーザーは、同じレコードにどの種類のロックもかけられなくなります。

データベースシステムで使用するロックレベルは、パフォーマンスと同時

処理性にも影響します。ロックレベルによって、データベース内でロック

されるオブジェクトのサイズが決まります。たとえば、データベースシス

テムの多くで、テーブル全体、および個々のレコードをロックすることが

できます。また、ページレベルのロック（ロックレベルは中程度）もよく

使われます。1 ページには 1 つまたは複数のレコードが入っていますが、こ

れは通常、 1 回のディスクアクセスでディスクから読み取られるデータの

量です。ページレベルのロックの大きな欠点は、 1 人のユーザーがレコー

ドをロックすると、同じページに保存されているほかのレコードを 2 番目

のユーザーがロックできないことです。

9-6

10
パフォーマンスの最適化を図る.NET アプリケーションの設計
.NET アプリケーションの適化

パフォーマンス重視の .NET アプリケーションを開発することは容易では

ありません。 ADO.NET データプロバイダーは、コードの実行速度が非常

に遅くても、それを伝える例外をスローしません。

10-1

パフォーマンスの最適化を図る .NET アプリケーションの設計

データの取得

データを効率よく取得するには、必要なデータのみを返すも効率のよい

方法を選択します。ここでは、 .NET アプリケーションでデータを取得する

ときに、システムのパフォーマンスを適化する方法を説明します。

アーキテクチャについての理解 ADO.NET は ADO.NET データプロバイダーを使用してデータにアクセス

します。 .NET の実行時のデータアクセスは、すべて ADO.NET データプロバイダーを介して行われます。

ADO.NET の開発ウィザードでは、OLE DB を使用してウィザードのグリッ

ドを埋めていきます。設計時にこれらのウィザードがアクセスするのは

OLE DB ですが、生成されたランタイムコンポーネントがデータのアクセ

スに使用するのは ADO.NET データプロバイダーです。 .NET アプリケー

ションで OLEDB を介したデータアクセスを適化するのは実用的ではあ

りません。代わりに ADO.NET データプロバイダーを、実行時のすべての

作業を行うコンポーネントとして適化します。

長いデータの取得

ネットワーク経由で長いデータを取得するのには時間がかかり、リソース

も消費するので、特に必要な場合以外は、アプリケーションから長いデー

タを要求しないようにします。

ユーザーが長いデータを必要とすることはほとんどありません。ユーザー

がこのような結果項目の確認を要求する場合は、選択リストに長いデータ

の列だけを指定して、アプリケーションからもう一度データベースを照会

します。このようにすると、平均的なユーザーは、ネットワークトラフィッ

クのパフォーマンスにさほど影響を与えずに結果セットを取得することが

できます。

アプリケーションによっては、 ADO.NET データプロバイダーにクエリを

送信する前に選択リストを編成しないものもあります（一部のアプリケー

ションでは、select * from <table name> ... などの構文を使用し

ます）。長いデータが選択リストに入っていると、アプリケーションが長い

データを結果セットにバインドしていなくても、フェッチ時に長いデータ

を取得する必要があるデータプロバイダーもあります。できれば、テーブ

ルの一部の列のみを取得する方法を試してください。

場合によっては長いデータを取得しなければならないことがあります。こ

のような場合でも、一般に 100 KB を超えるような大量のテキストを画面

に表示させるのは望ましくありません。

10-2

データの取得

取得するデータのサイズの縮小

ネットワークトラフィックを減らしてパフォーマンスを向上させるため

に、大行数や大フィールドサイズの設定を呼び出したり、行サイズや

フィールドサイズを制限するほかのデータベース固有のコマンドを呼び

出したりして、取得するデータのサイズを扱いやすいサイズまで下げるこ

とができます。取得するデータのサイズを下げるもう 1 つの方法は、列の

サイズを小さくすることです。データプロバイダーでパケットサイズを定

義できる場合は、必要な小パケットサイズを指定します。

また、必要な行のみが返されるようにしてください。たとえば、 2 列しか

必要でないのに 5 列を返すようにしていた場合、不要な列に長いデータが

入っていると、パフォーマンスが低下します。

CommandBuilder オブジェクトの使用

CommandBuilder オブジェクトは SQL ステートメントを生成するには便利

だと思われがちです。しかし、これを使用するとパフォーマンスに悪影響

を及ぼす恐れがあります。同時処理の制限が原因で、CommandBuilder オブ

ジェクトは効率のよい SQL ステートメントを生成することができません。

たとえば、次の SQL ステートメントは Command Builder で作成されたもの

です。

CommandText:UPDATE TEST01.EMP SET EMPNO = ?, ENAME = ?, JOB = ?, MGR = ?, HIREDATE = ?, SAL = ?, COMM = ?, DEPT = ? WHERE

( (EMPNO = ?)AND ((ENAME IS NULL AND ?IS NULL) OR (ENAME = ?))AND ((JOB IS NULL AND ?IS NULL) OR (JOB = ?))AND ((MGR IS NULL AND ?IS NULL) OR (MGR = ?))AND ((HIREDATE IS NULL AND ?IS NULL) OR (HIREDATE = ?))AND ((SAL IS NULL AND ?IS NULL) OR (SAL = ?))AND ((COMM IS NULL AND ?IS NULL) OR (COMM = ?))AND ((DEPT IS NULL AND ?IS NULL) OR (DEPT = ?)) )

ほとんどの場合、 Command Builder で生成される Update ステートメントや

Delete ステートメントよりも、エンドユーザーの方が効率のよいステート

メントを記述できます。

もう 1 つの問題は、 CommandBuilder オブジェクトの設計にあります。

CommandBuilder オブジェクトは常に DataAdapter オブジェクトと関連付け

られ、 DataAdapter オブジェクトが生成する RowUpdating イベントと

RowUpdated イベントのリスナーとして CommandBuilder オブジェクト自身

を登録します。したがって、行を更新するたびに、この 2 つのイベントが

処理されなければなりません。

10-3


正しいデータ型の選択

データ型によっては、取得や送信に時間がかかるものがあります。スキー

マを設計するときには、も効率よく処理できるデータ型を選択してくだ

さい。たとえば、整数データは浮動小数点データより速く処理できます。

浮動小数点データは、内部データベース固有の形式に基づいて定義され、

通常、圧縮形式になっています。このようなデータは、ワイヤプロトコル

で処理できるように、解凍して別の形式に変換する必要があります。

処理時間がも短いデータ型は文字列で、その次が整数です。整数の場合

は、通常、何らかの変換またはバイトの並べ替えが必要です。浮動小数点

データとタイムスタンプの処理には、整数の少なくとも 2 倍の時間が必要

です。

10-4

.NET オブジェクトとメソッドの選択

.NET オブジェクトとメソッドの選択

ここでは、 .NET オブジェクトとメソッドを選択して使用するときに、シス

テムのパフォーマンスを適化する方法を説明します。

ストアドプロシージャの引数としてのパラメーターマーカーの使用

ストアドプロシージャを呼び出す場合は、リテラル引数ではなく、常に、

引数マーカーのパラメーターマーカーを使用します。

Command オブジェクトの CommandText プロパティにストアドプロシー

ジャ名を設定する場合、そのリテラル引数を CommandText へ物理的にコー

ディングしないでください。たとえば、次のようなリテラル引数は使いま

せん。

{call expense (3567, 'John', 987.32)}

ADO.NET データプロバイダーでは、データベースサーバーのストアドプロシージャを呼び出すことができますが、その際プロシージャをその他の

SQL クエリとして実行します。ストアドプロシージャを SQL クエリとし

て実行すると、データベースサーバーがステートメントを解析し、引数の

型を検証し、引数を正しいデータ型に変換します。

次の例で、アプリケーションプログラマは getCustName の引数を整数

12345 であると見なすでしょう。

{call getCustName (12345)}

しかし、 SQL は常に文字列としてデータベースサーバーに送信されます。

データベースサーバーが SQL クエリを解析し、引数値を分離しても結果

はまだ文字列です。データベースサーバーで文字列 "12345" を整数値

12345 に変換する必要があります。パラメーターマーカーを使用すること

で文字列変換の必要がなくなるので、データベースサーバーでの処理量を

減らすことができます。

{call getCustName (?)}

10-5


.NET アプリケーションの設計

ここでは、 .NET アプリケーションを設計するときに、システムパフォー

マンスを適化する方法を説明します。

接続の管理

アプリケーションのパフォーマンスを向上させるには、接続を適切に管理

することが重要です。接続を複数回行う代わりに、 1 回の接続で複数のス

テートメントオブジェクトを使用することで、アプリケーションのパ

フォーマンスを適化します。初期接続の確立後は、データソースへの接

続は行わないようにします。

接続プールを使用すると、特に、ネットワークまたは World Wide Web を介して接続するアプリケーションのパフォーマンスを大幅に向上させるこ

とができます。また、接続プールによって接続の再利用が可能になります。

接続を閉じても、データベースとの物理的接続を閉じるわけではありませ

ん。アプリケーションが接続を要求すると、アクティブな接続が再利用され

るので、新しい接続の作成に必要なネットワークへの I/O は発生しません。

接続は、あらかじめ割り当てておきます。まず、どの接続文字列が必要か

を確認します。 1 つの固有な接続文字列で、新しい接続プールが 1 つ作成

されます。

一度作成された接続プールは、アクティブなプロセスが終了するか、

Connection Lifetime に指定された時間が過ぎるまで破棄されません。アク

ティブでないプールや空のプールを維持するのに必要なシステムオー

バーヘッドは、ごくわずかです。

接続とステートメントの処理は、実装前に決めておく必要があります。接

続方法を慎重に管理することで、アプリケーションのパフォーマンスが向

上し、メンテナンスも簡単になります。

ネイティブの管理プロバイダーの使用

アンマネージコード、つまり .NET 環境外のコードへのブリッジは、パ

フォーマンスを低下させます。マネージコードからアンマネージコードを

呼び出すと、データプロバイダーの実行速度はマネージコードのみのデー

タプロバイダーよりも著しく遅くなります。このようなパフォーマンスが

大きく落ちる方法は、極力避けます。

ブリッジを使用する場合は、そのブリッジのためのコードを書くことにな

ります。後でデータベース固有の ADO.NET データプロバイダーが使用可

能になったとき、このコードを書き直す必要があります。つまり、オブジェ

クト名、スキーマ情報、エラー処理、およびパラメーターを書き直さなけ

ればなりません。ブリッジ用ではなく管理データプロバイダー用にコード

化することによって、貴重な時間とリソースを節約できます。

10-6

データの更新

データの更新

ここでは、データベースのデータを更新するときのシステムパフォーマン

スを適化する方法を説明します。

切断された DataSet の使用

結果セットのサイズが、なるべく小さくなるようにします。サーバーから

結果セットをすべて取得してから、DataSet を埋める必要があります。結果

セット全体をクライアントのメモリに保存します。

データソースへの変更の同期

データソースへの変更の同期を取るには、次の例で示すように主キーを使

用して、 PsqlDataAdapter にロジックを作成する必要があります。

string updateSQL As String = "UPDATE emp SET sal = ?, job = ?" + " = WHERE empno = ?";

10-7


10-8

11
この付録は、 DataDirect によるバルクロードで使用される構成ファイルに

ついて説明します。この機能の詳細については、「Pervasive Bulk Load の使

用」（3-15 ページ）を参照してください。

11-1


バルクデータ構成ファイルのサンプル

バルク形式の構成ファイルは、テーブルまたは DataReader がバルクコピー

操作およびバルクロード操作を使ってエクスポート（アンロード）された

場合に作成されます。

<?xml version="1.0"?>

<table codepage="UTF-16" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="file:///c:/Documents%20and%20Settings/jbruce/My%20Documents/Current%20Specs/BulkData.xsd">

<row> <column codepage="UTF-16" datatype="CHAR"

length="10" nullable="true">CHARCOL</column> <column codepage="UTF-16" datatype="LONGVARCHAR"

length="10">VCHARCOL</column> <column codepage="UTF-16" datatype="DECIMAL"

precision="15" scale="5">DECIMALCOL</column> <column codepage="UTF-16" datatype="DECIMAL"

precision="15" scale="5">NUMERICOL</column> <column codepage="UTF-16" datatype="DECIMAL"

precision="38">SMALLCOL</column> <column codepage="UTF-16"

datatype="INTEGER">INTEGERCOL</column> <column codepage="UTF-16"

datatype="SINGLEPRECISION"">REALCOL</column>

<!- ここに、さらに定義を続けることができます --> </row></table>

11-2

バルクデータ構成ファイル用の XML スキーマ定義

バルクデータ構成ファイル用の XML スキーマ定義

バルク構成 XML スキーマは、バルク構成ファイルを管理します。バルク

構成ファイルは、 DataDirect によるバルクロードで処理されるバルクロー

ドデータファイルを管理します。

DataDirect Technologies はこのスキーマを http://www.datadirect.com/ns/bulk/BulkData.xsd で公開し、この DataDirect 標準を使用して作成されるサード

パーティ機能の土台を提供しています。今後、大量のデータを管理するカ

スタムアプリケーションまたはツールが、 ODBC、 JDBC および ADO.NETAPI 間や複数のプラットフォーム間で、疎結合型の DataDirect によるバル

クロードとしてこのスキーマを採用することが予測されます。

DataDirect によるバルクロードで消費される CSV データを生成する場合、

XML 構成ファイル用の XML スキーマを提供する必要があります。

各バルク操作では、作成されるバルクデータファイルを記述する XML 構成ファイルを UTF-8 形式で生成します。バルクデータファイルが作成で

きなかったり XML 構成ファイルに記述されているスキーマに準拠してい

ない場合は、例外がスローされます。

11-3




11-4

12
IANA コードマッピング
この付録では、も広範に使用されている IBM コードページの IANA コー

ドページ名へのマップを示します。

表 12-1 IANA コードページマッピング

IBM 番号 IANA コードページ名

37 IBM037

38 IBM038

290 IBM290

300 IBM300

301 IBM301

500 IBM500

813 ISO_8859-7:1987

819 ISO_8859-1:1987

857 IBM857

860 IBM860

861 IBM861

897 IBM897

932 IBM-942_P120-2000

939 IBM-939

943 Windows-932-2000 （Windows クライアント用）

943 IBM-943_P14A-2000 （UNIX クライアント用）

950 Big5

1200 UTF-16

1208 UTF-8

12-1

IANA コードマッピング

1251 Windows -1251

1252 Windows -1252

4396 IBM-930

5025 IBM5025

5035 IBM5035

5297 UTF-16

5304 UTF-8

13488 UTF-16BE

表 12-1 IANA コードページマッピング

IBM 番号 IANA コードページ名

12-2

13
用語集
共通の用語の定義

.NET アーキテクチャ

Microsoft では Microsoft .NET を、情報、人々、システム、およびデバイス

を繋ぐ一連の Microsoft ソフトウェアテクノロジであると定義していま

す。ソフトウェアの統合を適化するために、 .NET Framework では Webサービスと呼ばれる小規模で独立したビルドブロックのアプリケーショ

ンを使用します。この Web サービスは相互に接続するほかに、インター

ネット上の別の Web サービス、多数のアプリケーションに接続します。

.NET Framework には 2 つの重要な役割があります。

ASP.NET は、洗練されたクライアントアプリケーション（Windowsフォーム）を構築するための環境であり、疎結合型データアクセスサブシステム（ADO.NET）です。

共通言語ランタイムは、.NET Framework でアプリケーションを実行す

るための中核的なランタイムエンジンです。共通言語ランタイムは、

作成した .NET コードが実行される安全な領域 " サンドボックス " と考えることができます。共通言語ランタイムで実行するコードは「マ

ネージコード」と呼ばれます。

ADO.NET.NET Framework 用のデータアクセスコンポーネント。ADO.NET はデータ

ベースへの接続に使用するクラスのセットで構成されており、リレーショ

ナルデータ、 XML およびアプリケーションデータにアクセスして結果を

取得することができます。

アセンブリ

1 つ以上のクラスがまとまったもの。それぞれのアセンブリは自己完結型

です。つまり、個々のアセンブリにはアセンブリ全体のメタデータが含ま

れています。アセンブリには、プライベートと共有の 2 種類があります。

13-1

用語集

プライベートアセンブリとは、限られた数のアプリケーションで使わ

れるアセンブリで、アプリケーションフォルダーまたはそのサブフォ

ルダーの 1 つに配置されます。たとえば、クライアントに「formulas」というプライベートアセンブリを呼び出すアプリケーションが 2 つあっても、それぞれのクライアントアプリケーションで、正しいアセ

ンブリを読み込むことができます。

共有アセンブリは、複数のクライアントアプリケーションで使用で

き、グローバルアセンブリキャッシュ（Global Assembly Cache：GAC）に配置されます。名前やバージョンが重複しないように、各共有アセ

ンブリには、厳密な名前が付けられます。

アンマネージコード

共通言語ランタイム環境外で、オペレーティングシステムによって直接実

行されるコード。アンマネージコードは .NET Framework が導入される以

前に作成されたすべてのコードを指します。アンマネージコードは .NET環境外なので、 .NET の管理機能を利用することはできません。

共通言語ランタイム（CLR ： Common Language Rruntime）共通言語ランタイム（CLR）は Microsoft .NET Framework の中核的なラン

タイムエンジンです。共通言語ランタイムでは、クロス言語の統合、コー

ドアクセスセキュリティ、オブジェクトの有効期間の管理およびデバッグ

のサポートなどのサービスを提供します。共通言語ランタイムで実行する

アプリケーションは " サンドボックス " で実行されていると言われること

があります。

クライアントロードバランス

コンピューター環境で接続要求に対応できないサーバーがないよう、新し

い接続を分散するメカニズム。

グローバルアセンブリキャッシュ（GAC）

コンピューター上の多数のアプリケーションで共有するためにインストー

ルされる各種アセンブリを格納するアセンブリキャッシュの部分。グロー

バルアセンブリキャッシュに配置されたアプリケーションは、名前やバー

ジョンの競合に対処するために厳密な名前を持つ必要があります。

厳密な名前

アセンブリのテキスト名、バージョン番号およびカルチャ情報（設定され

ている場合）と、そのアセンブリについて生成される公開キーとデジタル

署名で構成される名前です。同じ厳密な名前を持つ複数のアセンブリは同

一であるとみなされます。

13-2

コードアクセスセキュリティ（CAS）マネージコードがセキュリティポリシーで権限を与えられる共通言語ラ

ンタイムによって提供されるメカニズム。権限が行使され、コードが実行

できる操作を制限します。

スキーマコレクション

一緒にグループ化するとさらに効率よく処理できる、密接に関連するス

キーマ。テーブルや列などのデータベーススキーマ要素は、スキーマコレ

クションを介して公開されます。

ストリーム

バイナリデータやテキストデータの流れの抽象化。 Stream クラスとその

派生クラスは、これらのさまざまな種類の入出力のジェネリックビューを

提供します。

接続の再試行

接続の再試行では、データプロバイダーが初の接続の試行に失敗した後

に、プライマリサーバーおよび（設定している場合）代替サーバーへ接続

を試行する回数を定義します。接続の再試行は、システム復旧の有力な方

策となります。

接続プール

データプロバイダーが、基本的なデータベースへの接続を確立する必要が

あるたびに新しい接続を作成するのではなく、接続が再利用できるように

する処理。

接続フェイルオーバー

ハードウェア障害やトラフィックの過負荷などによってプライマリデー

タベースサーバーが利用できなくなった場合でも、アプリケーションが代

替またはバックアップデータベースサーバーに接続することができるメ

カニズム。

名前空間

関連する型をグループ化するための論理的な名前付けスキーム。 Microsoft.NET Framework では、階層型の名前付けスキームを使用して型を論理的な

カテゴリ（ASP.NET 技術やリモート処理機能のように関連する機能ごとの

カテゴリ）にグループ化しています。設計ツールで名前空間を使用すれば、

開発者はコード内の型を簡単に見つけたり参照することができます。つま

り、 1 つのアセンブリには名前空間ルートが異なる階層名の型を複数含め

ることが可能であり、また、 1 つの論理的な名前空間ルートは複数のアセ

13-3

用語集

ンブリ間にまたがることができます。 .NET Framework では、論理設計時の

名前付けには名前空間が便利ですが、アセンブリは実行時に型の名前ス

コープを確立します。

パフォーマンスモニター

Windows SDK のツールで、パフォーマンスの問題が存在する領域を特定し

ます。パフォーマンスモニターではアプリケーションの CLR （共通言語ラ

ンタイム）例外の回数や頻度を確認することができます。パフォーマンス

モニター（PerfMon）や VS パフォーマンスモニター（VSPerfMon）ユー

ティリティを使用すると、アプリケーションのパラメーターを記録し、そ

の結果をレポートやグラフにして見ることができます。

バルクロード

データベースクライアントからデータベースサーバーへ行を送るときに、

小さく分割した多くのデータパケットとしてではなく、連続したストリー

ムで送ること。ネットワーク上での往復が大幅に減らせるため、パフォー

マンスが向上します。

分離レベル

データの整合性を向上させるためにデータベースシステムで採用される

特別なロック方法。分離レベルが高いほど、そのロック方法も複雑になり

ます。データベースで使用される分離レベルによって、トランザクション

におけるデータの一貫性の処理方法が決まります。

ANSI （American National Standards Institute ：米国規格協会）によって、次

の 4 つの分離レベルが定められています

Read uncommitted (0) （コミットされていない読み取り）

Read committed (1) （コミットされた読み取り）


Serializable (3) （直列化可能）

マネージコード

.NET Framework、特に共通言語ランタイムによって実行および管理される

コード。マネージコードは共通言語ランタイムに必要な情報を与えること

で、メモリ管理やコードアクセスセキュリティなどのサービスを利用する

ことができます。

ロードバランス

「クライアントロードバランス」（13-2 ページ）を参照してください。

13-4

ロックレベル

テーブルやレコードへアクセスするユーザーを 1 人に制限するデータベー

ス操作。ロックは 2 人以上のユーザーが同時に同じテーブルやレコードを

使用する可能性がある状況で使用します。テーブルやレコードをロックす

ると、システムでは一度に 1 人のユーザーのみがデータを操作できるよう

にします。

13-5

用語集

13-6

索引

記号?

パラメーターマーカー用 .................... 2-22

AADO.NET

GetSchemaTable メソッドによって返される

列 ........................................................... 7-2OLE DB の使用...................................... 10-2PsqlCommandBuilder オブジェクト ...... 6-7PsqlConnectionStringBuilder オブジェクト 6-

11PsqlConnection オブジェクト ................. 6-9PsqlDataReader オブジェクト .............. 6-12PsqlErrorCollection オブジェクト ........ 6-13PsqlError オブジェクト ......................... 6-13PsqlException オブジェクト ................. 6-14PsqlFactory オブジェクト ..................... 6-15PsqlInfoMessageEventArgs オブジェクト 6-15PsqlParameterCollection オブジェクト 6-17PsqlParameter オブジェクト ................. 6-16PsqlTrace オブジェクト ........................ 6-18PsqlTransaction オブジェクト .............. 6-19SQL エスケープシーケンス ................. 8-1パフォーマンスの適化 ..................... 10-1分離レベル ............................................... 9-1ロックレベル .......................................... 9-1

AllowPartiallyTrustedCallers ....................... 3-14Alternate Servers 接続文字列オプション ... 2-4

BBulkConfigFile ............................................. 6-20BulkCopyColumnMappingCollection クラス 6-4BulkCopyColumnMapping クラス ............... 6-4BulkCopy クラス ........................................... 6-3BulkFile ........................................................ 6-21

CColumns スキーマコレクション .............. 7-10CommandBuilder オブジェクト

パフォーマンスへの影響 ..................... 10-3プロパティ ............................................... 6-7

CommandTimeout プロパティ ..................... 6-6Command オブジェクト

ストアドプロシージャの有効化 ........ 2-24スレッドのサポート ............................. 2-26

Common Assembly ...................................... 3-16Connection Lifetime 接続文字列オプション

「Load Balance Timeout」を参照

Connection Retry Count 接続文字列オプション 2-5

Connection Retry Delay 接続文字列オプション 2-5

ConnectionStringBuilder オブジェクト ..... 6-11ConnectionTimeout ........................................ 6-9Connection オブジェクト

スレッドのサポート ............................. 2-26プロパティ ............................................... 6-9

CSV「カンマ区切り値（CSV）ファイル」を参照

CsvDataReader ............................................. 6-20CsvDataWriter .............................................. 6-22

コード例 ................................................. 3-17CSV ファイル

バルクロードデータファイル .......... 3-17文字セット変換 ..................................... 3-19例 ............................................................. 3-18

DDataAdapter オブジェクト

CommandBuilder オブジェクトとの関連 10-3プロパティ ............................................. 6-11

DataReader オブジェクト

サポートされるプロパティ ................. 6-12サポートされるメソッド ..................... 6-12

DataSourceInformation スキーマコレクション

サポートされる列名 ............................... 7-6DbBulkCopy ................................................. 6-23DbBulkCopyColumnMapping...................... 6-23DbBulkCopyColumnMappingCollection ..... 6-23DeriveParameters............................................ 6-7

索引 1

EEncoding 接続文字列オプション ................ 2-6Encryption 接続文字列オプション .............. 2-6Encrypt 接続文字列オプション ................... 2-6ErrorCollection オブジェクト

サポートされるプロパティ ................. 6-13複数エラーのチェック ......................... 6-14

Error オブジェクト , サポートされるプロパティ 6-13

externalfilecodepage 属性 ................... 3-18, 3-19

FForeignKeys スキーマコレクション ........ 7-12Framework 型 ............................................... 2-15FullTrust........................................................ 3-14

GGetSchemaTable メソッド .......................... 6-12

IIANA コードマッピング........................... 12-1Indexes スキーマコレクション ................ 7-13InfoMessageEventArgs オブジェクト ........ 6-15Initialization 接続文字列オプション ........... 2-7

LLoad Balance Timeout 接続文字列オプション 2-7Load Balancing 接続文字列オプション ...... 2-8

MMetaDataCollections スキーマコレクション 7-5Microsoft Enterprise Library アプリケーションブ

ロック .................................................. 5-1

N.NET

セキュリティ ................................ 2-33, 3-14フレームワーク

サポートされるバージョン .............. 1-2データ型 ................................... 2-15, 2-19

プログラミングリソース .................... 2-33

PParameterCollection オブジェクト

パラメーターマーカー ........................ 2-22プロパティ ............................................. 6-17

Parameter オブジェクト

コレクションへの追加 ......................... 2-22プロパティ ............................................. 6-16

Password 接続文字列オプション ................ 2-9PerfMon のサポート ................................... 3-23Performance Tuning Wizard

［Result］ダイアログ ............................. 4-16Visual Studio からの起動 ...................... 4-14

Persist Security Info 接続文字列オプション 2-9Pervasive Bulk Load

CSV 形式データを含むバルクファイルの指

定 ......................................................... 6-21CSV ファイル形式用の DataReader 構文の提

供 ......................................................... 6-20外部オーバーフローファイル ............ 3-20使用シナリオ ......................................... 3-15説明 ......................................................... 3-15データソーステーブルから宛先テーブルへ

の列のマップ ..................................... 6-23データを説明する CSV バルク構成ファイル

の指定 ................................................. 6-20トランザクションの使用 ..................... 3-21パフォーマンスを改善するためのシーケン

シャルアクセスの使用 .................... 6-21バルクロードプロトコルの決定 ....... 3-19文字セット変換 ..................................... 3-19

Pervasive Common Assembly説明 ......................................................... 3-16例 ............................................................... 1-6

Pervasive PSQL データプロバイダー

DeriveParameters メソッド ..................... 6-7Unicode のサポート .............................. 2-27アセンブリ名 ........................................... 2-2イベント処理 ................................ 2-30, 6-10エラー処理 ............................................. 2-31オブジェクト ........................................... 6-3外部結合のエスケープ構文 ................... 8-4スレッドのサポート ............................. 2-26接続の再試行 ........................................... 2-5接続プールの作成 ................................... 3-2接続プールの有効化 ............................... 2-9データ型 ................................................. 2-15トランザクションのサポート ............. 2-25

2 索引

長いデータパラメーターに対する入力とし

てのストリーム ........................ 2-20, 2-21名前空間 ................................................... 2-2パラメーターデータ型のマッピング 2-17パラメーター配列 ................................. 2-23パラメーターマーカー ........................ 2-22バルクロード操作

トランザクションでの使用............ 3-21プロパティ ............................................... 6-3分離レベル ............................................. 2-28方法 ........................................................... 6-3メソッド呼び出しのトレース ............. 3-22ロードバランス ...................................... 2-8

PrimaryKeys スキーマコレクション ....... 7-14ProcedureParameters スキーマコレクション 7-

15Procedures スキーマコレクション .......... 7-17PsqlBulkCopy................................................. 6-3PsqlBulkCopyColumnMapping...................... 6-4PsqlBulkCopyColumnMappingCollection ..... 6-4PsqlCommandBuilder オブジェクト

パフォーマンスへの影響 ..................... 10-3プロパティ ............................................... 6-7

PsqlCommand オブジェクト

ストアドプロシージャの有効化 ........ 2-24プロパティ ............................................... 6-4

PsqlConnectionStringBuilder オブジェクト 6-11PsqlConnection オブジェクト ...................... 6-9PsqlDataAdapter オブジェクト .................. 6-11

UpdateBatchSize プロパティ ................ 6-11PsqlDataReader オブジェクト ................... 6-12PsqlDbType ......................................... 2-15, 2-18PsqlDbTypes のマッピング ........................ 2-19PsqlErrorCollection オブジェクト ............. 6-13PsqlError オブジェクト .............................. 6-13PsqlException オブジェクト ...................... 6-14PsqlFactory オブジェクト .......................... 6-15PsqlInfoMessageEventArgs オブジェクト . 6-15PsqlParameterCollection オブジェクト ..... 6-17PsqlParameter オブジェクト ...................... 6-16PsqlTrace オブジェクト ............................. 6-18PsqlTransaction オブジェクト .......... 2-25, 6-19

RReadCommitted 分離レベル ....................... 2-28ReservedWords スキーマコレクション ..... 7-9

SSequentialAccess .......................................... 6-21Server DSN 接続文字列オプション .......... 2-10SQL エスケープシーケンス

ADO.NET.................................................. 8-1外部結合 ................................................... 8-4スカラー関数 ........................................... 8-3全般 ........................................................... 8-1日付、時刻、タイムスタンプ ............... 8-2

Statement Cache Mode 接続文字列オプション 2-11, 3-6

StatementCacheBehavior プロパティ .... 3-6, 6-6System.Data.DbTypes .................................. 2-18

TTablePrivileges スキーマコレクション ... 7-18Tables スキーマコレクション .................. 7-19Timestamp 接続文字列オプション ........... 2-11Trace File 接続文字列オプション ............. 2-11Trace オブジェクト

サポートされるプロパティ ................. 6-18使用 ......................................................... 3-22

Transaction オブジェクトプロパティ ..... 6-19

UUnicode

サポート ................................................. 2-27バルクロードデータファイルの文字変換

3-19User ID 接続文字列オプション................. 2-11

VViews スキーマコレクション .................. 7-20Visual Studio

Add Table Wizard ................................... 4-21Add View ウィザード ........................... 4-26Performance Tuning Wizard ................... 4-14使用シナリオ

単純なクエリにクエリビルダーを使用す

る ..................................................... 4-31新規プロジェクトの作成 ..................... 4-18ツールボックスからの DataDirect コンポー

ネントの追加 ..................................... 4-29Visual Studio 2005

索引 3

Pervasive PSQL データプロバイダーの使用 4-1

WWindows オペレーティングシステムのサポー

ト .......................................................... xiv

XXML 構成ファイル

バルクロードデータファイル形式の記述 3-18

例 ............................................................. 11-3

あアセンブリ

概要 ........................................................... 2-2名前 ........................................................... 2-2

宛先テーブル , 列のマップ........................ 6-23アプリケーション

ドットネット（.NET）アプリケーションの

設計「パフォーマンスの適化」を参照

暗号化されたネットワーク通信 , 有効化 2-6, 4-9

いイベント , ストアドプロシージャと関数との使

用 ........................................................ 2-30イベント処理............................................... 2-30引用符で囲まれた識別子............................. 6-8

うウィザード

Add Table ウィザード Add Table うぃざーど 4-21

Add View wizard..................................... 4-26Performance Tuning Wizard ................... 4-14

ウィジェット , DataDirect の追加 ............. 4-29

えエスケープシーケンス

ADO.NET.................................................. 8-1外部結合 ................................................... 8-4日付と時刻 ............................................... 8-2

エラー処理................................................... 2-31

おオブジェクト

PsqlCommand ........................................... 6-4PsqlCommandBuilder ............................... 6-7PsqlConnection.......................................... 6-9PsqlConnectionStringBuilder.................. 6-11PsqlDataAdapter...................................... 6-11PsqlDataReader ....................................... 6-12PsqlError.................................................. 6-13PsqlErrorCollection ................................. 6-13PsqlException.......................................... 6-14PsqlInfoMessageEventArgs .................... 6-15PsqlParameter .......................................... 6-16PsqlTrace ................................................. 6-18PsqlTransaction .............................. 2-25, 6-19概要 .................................................. 7-1, 11-1公開 ......................................................... 2-32サポートされるパブリック .NET オブジェク

ト ........................................................... 6-3プロバイダー固有のプレフィックス ... 6-3

オペレーティングシステムのサポート 0-xiv

かカーソル , 前方のみ ................................... 6-12外部オーバーフローファイル ................. 3-20外部結合のエスケープシーケンス ........... 8-4カウンター , PerfMon ................................. 3-23カンマ区切り値（CSV）ファイル

バルクロードデータファイル .......... 3-17バルクロードでの使用 ........................ 3-18

きキーワード値のペア

パフォーマンスの適化 ..................... 4-14共通プログラミングモデル

バルクロードクラス ........................... 3-16共有アセンブリ ............................................ 2-2

くクイックスタート ....................................... 1-1クエリビルダー , 単純なクエリの実行 .. 4-31クライアントロードバランス

説明 ......................................................... 3-10有効化 ....................................................... 2-8

グローバルアセンブリキャッシュ .......... 2-2

4 索引

け厳密な名前のアセンブリ ............................ 2-2

こ構成ファイル

サンプルバルクデータ構成ファイル 11-2バルクデータ構成ファイル ................ 3-18

コードページ

サポートされるマッピング ................. 12-1ソース文字データの文字変換 ............. 3-19

コード例

接続情報の追加 ....................................... 1-4接続プールの作成 ................................... 3-2データベースに接続する ....................... 1-3統計情報項目の取得 ............................. 3-25名前空間の追加 ....................................... 1-4バルクロードデータファイルの作成 3-17

コミットされた読み取り

分離レベルと ADO.NET ........................ 9-4コミットされていない読み取り

分離レベルと ADO.NET ........................ 9-4コレクション , スキーマ

Columns................................................... 7-10ForeignKeys ............................................ 7-12PrimaryKeys............................................ 7-14ProcedureParameters ............................... 7-15TablePrivileges........................................ 7-18インデックス ......................................... 7-13テーブル ................................................. 7-19ビュー ..................................................... 7-20プロシージャ ......................................... 7-17

さノード , 定義 ............................................... 4-12ノードの定義 .............................................. 4-12...................................................................... 4-12サービスコンポーネント ......................... 2-33サポートされている関数 ............................ 8-3サポートされるプラットフォーム ............. xiv

し識別子 , 引用符で囲む ................................. 6-8時刻リテラルエスケープシーケンス ...... 8-2実行時の統計情報 ...................................... 3-24使用

アプリケーションコード内の DAAB.. 5-6ステートメントキャッシング .............. 3-6単純なクエリのためのクエリビルダー 4-31

シリアライズ可能な分離レベル .............. 2-28新規プロジェクトの作成 .......................... 4-18診断のサポート

実行時の統計情報 ................................. 3-24メソッド呼び出しのトレース ............. 3-22

すスカラー関数 ................................................ 8-3スキーマコレクション

Columns................................................... 7-10DataSourceInformation ............................. 7-6ForeignKeys ............................................ 7-12MetaDataCollections ................................. 7-5PrimaryKeys............................................ 7-14ProcedureParameters ............................... 7-15ReservedWords ......................................... 7-9TablePrivileges........................................ 7-18TablesSchemas ........................................ 7-19インデックス ......................................... 7-13ビュー ..................................................... 7-20プロシージャ ......................................... 7-17

ステートメントキャッシング

概要 ........................................................... 3-6パフォーマンスへの影響の分析 ......... 3-25有効化 ................................................ 2-8, 3-6

ストアドプロシージャ

SQL ステートメントで ? 記号を使用. 2-22キャッシング ........................................... 3-6サポート ................................................. 2-24出力配列のサポート ............................. 2-23パラメーターマーカーを引数として使用 .

10-5ストリームオブジェクト

サポートされるデータ型 ..................... 2-20長いデータパラメーターへの入力として使

用 ......................................................... 2-21スレッドのサポート .................................. 2-26

せセキュリティ

暗号化 ..................................................... 3-14さらに詳しい情報 ................................. 2-33属性 ......................................................... 3-14

索引 5

トレースの有効化 ................................. 3-22必要な権限 ............................................. 3-14

接続

概要 ........................................................... 2-4サーバーエクスプローラーで追加 ...... 4-2ステートメントキャッシング .............. 3-6接続の状態をリセット ........................... 2-4データソース構成ウィザードによる追加 4-

11パフォーマンスの向上 ......................... 10-6

接続状態のリセット ..................................... 2-4接続の再試行

概要 ......................................................... 3-11接続文字列オプション ........................... 2-5説明 ........................................................... 3-9

接続プール

概要 ........................................................... 3-2小接続数 ............................................... 2-8

作成 ........................................................... 3-2接続の削除 ............................................... 3-3接続の追加 ............................................... 3-3デフォルトの動作 ................................... 3-2パフォーマンスに関する考慮点 ......... 2-13有効化 ....................................................... 2-9

接続プールから接続を削除......................... 3-3接続フェイルオーバー

接続の再試行 ........................................... 3-9ロードバランス .................................... 3-10

切断された DataSet ..................................... 10-7専用のバルクプロトコル.......................... 3-19

そ相互運用性................................................... 3-15

た代替データベースサーバー , 指定............. 3-8タイムアウト

コマンド実行の試行を終了する前 ....... 6-6接続の試行を終了する前 ....................... 6-9接続プールから接続を削除する前 ....... 2-7

タイムスタンプリテラルエスケープシーケン

ス .......................................................... 8-2タイムスタンプを文字列として格納する 2-11

ち直列化可能

分離レベルと ADO.NET......................... 9-4

つ追加

アプリケーションに DAAB を .............. 5-5接続

接続プールへの.................................. 3-3データソース構成ウィザードによる 4-11

ソリューションエクスプローラーの参照設

定 ........................................................... 1-3ツールボックス , DataDirect コンポーネントの

追加.................................................... 4-29

てデータアクセスアプリケーションブロック

新しい DAAB エントリの追加.............. 5-4アプリケーションコードでの使用 ...... 5-6アプリケーションへの追加 ................... 5-5概要 ........................................................... 5-2構成 ........................................................... 5-4コード移植性増大のために使用 ........... 5-1使用に適した状況 ................................... 5-2追加のリソース ....................................... 5-7

データ暗号化 ................................................ 2-6データ型

Pervasive ................................................. 2-15パフォーマンスを改善するための選択 10-4

データソース構成ウィザード , 接続の追加 4-11データソースへの変更の同期 ................. 10-7テーブル , Add Table ウィザードで追加 . 4-21デバッグ

Trace オブジェクトを使用してセキュリティ

を維持 ........................................ 3-22, 3-23概要 ......................................................... 6-18

テンプレート , Visual Studio概要 ......................................................... 4-18既存のプロジェクトに追加 ................. 4-20新規プロジェクトの作成 ..................... 4-18

と統計情報

概要 ......................................................... 3-25収集の有効化 .................................. 3-25, 6-9

6 索引

パフォーマンスの分析 ......................... 3-24統計情報の収集 .......................................... 3-24統計情報の取得

概要 ......................................................... 3-25ドットネット（.NET）

OLE DB の使用...................................... 10-2サポートされるパブリックオブジェクト 6-

3ソリューションエクスプローラーを使用す

る例 ....................................................... 1-3トラブルシューティング機能

実行時の統計情報 ................................. 3-24トランザクション

バルクロード操作 ................................ 3-21ローカルのサポート ............................. 2-25

トレース

概要 ......................................................... 3-22トレースファイルの再作成 ................ 3-22トレースファイルのパスの設定 ........ 3-22メソッドの呼び出し ............................. 6-18有効化

概要.................................................... 3-22環境変数の使用................................ 3-22静的メソッドの使用........................ 3-23

トレースで環境変数を使用 ...................... 3-22トレースの有効化 ...................................... 3-22

な長いデータの取得 ...................................... 10-2名前空間 ........................................................ 2-2

ねネイティブ管理プロバイダー , パフォーマンス

の利点................................................ 10-6

は配列 , パラメーター ................................... 2-23配列バインド .............................................. 6-17

パラメーターの行数の設定 ................... 6-4バルクロード操作での使用 ................ 3-19

パスワード , トレースログで隠す . 3-22, 3-23バッチ処理のサポート , 有効化 ............... 6-11パフォーマンスの適化

ADO.NET................................................ 10-1

CommandBuilder オブジェクトを使用しない 10-3

PsqlCommandBuilder オブジェクトの使用 6-7

暗号化 ..................................................... 2-13取得するデータのサイズ ..................... 10-3接続の管理 ............................................. 10-6接続の状態をリセット ........................... 2-4接続文字列の設定 ................................. 2-13切断された DataSet の使用 .................. 10-7正しいデータ型の選択 ......................... 10-4ネイティブ管理プロバイダーの使用 . 10-6バルクロード操作でのシーケンシャルアク

セスの使用 ......................................... 6-21ローカルトランザクションの使用 .... 2-25

パブリックオブジェクトのプレフィックス 6-3パラメーター

ADO.NET でのストアドプロシージャ内の

マーカー ............................................. 10-5ストアドプロシージャ内 .................... 2-24配列のサポート ..................................... 2-23マーカー

? 記号の使用 ..................................... 2-22パラメーターデータ型 ............................. 2-17パラメーター配列バインド ............... 6-4, 6-17バルクデータ構成ファイル用の XML スキーマ

定義........................................... 11-3, 12-1バルクロード

XML 構成ファイル

externalfilecodepage 属性 ................. 3-19例........................................................ 3-18

XML スキーマ定義 ...................... 11-3, 12-1概要 ......................................................... 3-15データファイル .................................... 3-17トランザクションで ............................. 3-21バルクデータ構成ファイル ....... 3-18, 11-2バルクロードデータファイルの作成 3-17プロトコルの決定 ................................. 3-19

バルクロード操作での文字変換 ............. 3-19バルクロード操作のオーバーフローファイル

3-20反復可能な読み取り

分離レベルと ADO.NET......................... 9-4

索引 7

ひ日付 , 時刻 , タイムスタンプリテラルのエス

ケープシーケンス ............................. 8-2ビュー , Add View ウィザードで追加 ...... 4-26

ふプロパティ ..................................................... 6-3分離

ADO.NET のレベル ................................. 9-1分離レベル

ADO.NET との比較................................. 9-4コミットされた読み取りと ADO.NET. 9-4コミットされていない読み取りと ADO.NET

9-4サポート ................................................. 2-28ダーティーリードと ADO.NET............ 9-3直列化可能と ADO.NET......................... 9-4データの同時処理性 ............................... 9-5反復可能な読み取りと ADO.NET......... 9-4反復不可能な読み取りと ADO.NET..... 9-3ファントムリードと ADO.NET............ 9-3

へページレベルのロック ................................ 9-6変更 , データソースへの同期................... 10-7

ほ方法

呼び出しのトレース ............................. 3-22

まマネージコード ............................................ xiv

めメソッド

データプロバイダー固有 .................... 6-10パブリックのサポート ........................... 6-3

も文字セット変換........................................... 3-19

ゆ有効化

ステートメントキャッシング , 概要 ... 3-6

統計情報収集 , 概要 .............................. 3-25

よ用語集 .......................................................... 13-1

りリテラル , エスケープシーケンス ............ 8-2リテラルパラメーター値 ......................... 2-22

れ例

CSV バルクロードデータファイル . 3-17単純なクエリの作成 ............................. 4-31

例外処理のコード例 .................................... 1-4

ろローカルトランザクション , 使用 .......... 2-25ロードバランス

「クライアントロードバランス」を参照

ロック

ADO.NET のレベル................................. 9-1概要 ........................................................... 9-2モードとレベル ....................................... 9-6

わワイヤ暗号化 ......................................... 2-6, 4-9

8 索引

Documents

Pervasive Data Provider for .NET Guide and ……責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用 者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記

Pervasive Data Provider for .NET Guide and ……責事項 Pervasive Software Inc. は、本ソフトウェアおよびドキュメントの使用を、利用者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記