Zen ADO.NET データ プロバイダーは、.NET 対応アプリケーションやアプリケーション サーバーにデータ アクセスを提供します。Zen ADO.NET データ プロバイダーにより、インターネットまたはイントラネット経由でデータ ストアにポイント ツー ポイント アクセスおよび n 層アクセスすることが可能になります。Zen ADO.NET データ プロバイダーは .NET 環境向けに最適化されているため、これを使用することにより、.NET 技術が組み込まれ、既存のシステムの機能とパフォーマンスを向上させることができます。

以下のトピックでは、Zen ADO.NET データ プロバイダーに関連する機能について説明します。

メモ：Zen ADO.NET Entity Framework でのデータ プロバイダーの使用法については、Zen ADO.NET Entity Framework データ プロバイダーを参照してください。

Zen ADO.NET データ プロバイダーはマネージ コードのみで構築されています。つまり、完全に共通言語ランタイム（CLR）の内部で、実行およびデータベースへの接続が行えます。

クライアント ライブラリや COM コンポーネントなどネイティブ オペレーティング システムで実行するコードはアンマネージ コードと言います。マネージ コードとアンマネージ コードは 1 つのアプリケーション内に混在させることができます。ただし、アンマネージ コードは共通言語ランタイムの外部にまで影響が及ぶため、現実的には複雑になり、パフォーマンスも低下します。また、セキュリティの危険にさらすことにもなりかねません。

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

次のコードは、Zen ADO.NET データ プロバイダーの名前空間をアプリケーションに組み込む方法を示しています。

Zen ADO.NET データ プロバイダー用の厳密な名前のアセンブリは、インストール時にグローバル アセンブリ キャッシュ（GAC）に配置されます。アセンブリ名は Pervasive.Data.SqlClient.dll です。

Pervasive.Data.Common アセンブリには、バルク ロードのサポートなどの機能が含まれます。

接続の動作は、接続文字列や PsqlConnection オブジェクトのプロパティを使って定義することができます。しかし、接続文字列内の値の設定を接続プロパティによって変更することはできません。

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

接続文字列を指定する際のガイドラインは、接続文字列の使用を参照してください。

サポートされる接続文字列オプションの説明については、表 35 を参照してください。

PsqlConnectionStringBuilder プロパティの名前は、接続文字列オプションの名前と同じです。ただし、接続文字列オプションの名前は、語と語の間に必要なスペースを入れて、複数の語で構成することができます。たとえば、Min Pool Size 接続文字列オプションは MinPoolSize プロパティに相当します。表 35 では、接続文字列オプションを挙げ、各プロパティについて説明します。

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

接続文字列オプション値の各ペアはセミコロンで区切ります。次に、Zen ADO.NET データ プロバイダー用の単純な接続文字列のキーワードと値の例を示します。

アプリケーションのパフォーマンスは、接続文字列オプション、および、いくつかのデータ プロバイダー オブジェクトのプロパティに設定された値の影響を受けます。

Encrypt：データ暗号化は、データの暗号化と復号で必要となる追加オーバーヘッド（主に CPU 使用）のため、パフォーマンスに悪影響を与えることがあります。

Max Statement Cache Size：アプリケーションが使用する全プリペアド ステートメントをキャッシュすれば、最高のパフォーマンスを提供できるように思われます。しかし、この手法では、接続プールを使ってステートメント キャッシングを実装した場合、データベース サーバーのメモリに負担をかける結果になります。この場合、プールされた接続はそれぞれステートメント キャッシュを持ち、アプリケーションが使用する全プリペアド ステートメントを含むことになります。キャッシュされたプリペアド ステートメントは、すべてデータベース サーバーのメモリにも保持されます。

Pooling：データ プロバイダーが接続プールを使用できるようにしている場合、パフォーマンスに影響する以下の追加オプションを定義できます。

Schema Options：ある種のデータベース メタデータを返すことは、パフォーマンスに影響を与えます。アプリケーションのパフォーマンスを最適化するため、データ プロバイダーは、パフォーマンスに悪影響を与えるプロシージャ定義やビュー定義などのデータベース メタデータを返さないようにします。アプリケーションがこれらのデータベース メタデータを必要とする場合は、明確にそれを返すよう要求する必要があります。

複数の種類の除外されたメタデータを返すには、名前をカンマ区切りリストで指定するか、返したい列コレクションの 16 進値の合計を指定します。たとえば、プロシージャ定義とビュー定義を返すには以下のいずれかを指定します。

Statement Cache Mode：ほとんどの場合、ステートメント キャッシングを有効にするとパフォーマンスが向上します。プリペアド ステートメント（コマンド インスタンス）のキャッシングを有効にするには、このオプションを Auto に設定します。アプリケーションが、暗黙的にステートメント キャッシュに含めるとマークされたプリペアド ステートメントを持つ場合は、この設定を使用します。または、暗黙的に含めるステートメントがいくつかあり、その他は明示的に含める場合、この設定を使用します。ステートメント キャッシュに Cache とマークされたプリペアド ステートメントのみを含めたい場合は、1）Command オブジェクトの StatementCacheBehavior プロパティに Cache を設定し、2）このオプションに ExplicitOnly を設定します。

StatementCacheBehavior：アプリケーションがその存続期間中にプリペアド ステートメントを複数回再使用する場合、ステートメント キャッシュを使用することによってパフォーマンスに影響を及ぼすことができます。このプロパティは、プリペアド ステートメント（Command オブジェクトのインスタンス）がステートメント キャッシング中にどのように処理されるかを決定します。

Cache に設定すると、プリペアド ステートメントはステートメント キャッシュに含められます。

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

DoNotCache に設定すると、プリペアド ステートメントはステートメント キャッシュから除外されます。

特定のステートメントをキャッシングすることによるパフォーマンスへの影響を判断するには、接続統計情報を使用できます（接続統計情報によるパフォーマンスの分析を参照してください）。

表 5 から表 8 は、Zen ADO.NET データ プロバイダーでサポートされるデータ型を示しています。

表 5 では、Zen ADO.NET データ プロバイダーでサポートされるデータ型と、対応する .NET Framework 型を示します。この表で、DataAdapter を使って DataSet を埋めるときに使用するデータ型を確認してください。

また、この表では DataReader オブジェクトが直接使用される場合のデータの適切なアクセサーも示します。

パラメーターのデータ型は、データ プロバイダーごとに固有のものを使用します。Zen ADO.NET データ プロバイダーは、サーバーへ送信する前に、パラメーター値をネイティブの形式に変換する必要があります。アプリケーションでパラメーターを記述する最もよい方法は、データ プロバイダー固有の型の列挙を使用することです。

汎用プログラミングでは、データ プロバイダー固有の型を使用できない場合があります。プロバイダー固有の DB 型が指定されていない場合は、パラメーター値の System.Data.DbType または .NET Framework 型からデータ型が推定されます。

Zen ADO.NET データ プロバイダーは、次の順序を用いてパラメーターのデータ型を推定します。

表 6 は、System.Data.DbType のみが指定された場合に、データ プロバイダーがどのようにデータ型を推定するかを示します。

表 7 では、プロバイダー固有のデータ型も System.Data.DbType も指定されない場合に、データ プロバイダーがデータ型を推定するために使用する対応表を示します。

Zen ADO.NET プロバイダーは、表 8 に挙げられているデータ型に対し、長いデータ パラメーターへの入力としてストリームを使用することをサポートしています。

ストリームの説明については、長いデータ パラメーターへの入力としてストリームを使用するを参照してください。

ビデオ クリップや大量のドキュメントなど非常に大きなバイナリ値やテキスト値を表すために、不連続なメモリの使用を許可することによって、パフォーマンス、機能性、スケーラビリティが向上します。

バイナリ データの読み取りに使用されるストリーム オブジェクトは System.IO.Stream オブジェクトから派生し、Framework データ型の byte[] を使用します。

テキスト データを読み込むために使用するストリーム オブジェクトは System.IO.TextReader オブジェクトから派生し、Framework データ型の string を使用します。

ストリームを使用できるようにするには、PsqlParameter オブジェクトの Value プロパティにストリームの特定のインスタンスを設定します（PsqlParameter オブジェクトを参照してください）。コマンドが実行されると、データ プロバイダーはストリームから読み込んで値を抽出します。

データ プロバイダーに付属する用例には、ランダムに生成されるデータを使用して LONGVARCHAR 列と LONGVARBINARY 列にデータを挿入するコード例が含まれています。また、用例では、ストリーム オブジェクトを LONGVARCHAR 列および LONGVARBINARY 列への入力として使用する方法も示しています。

パラメーター マーカー（ストアド プロシージャで使用するものも含む）は、Zen ADO.NET データ プロバイダーでは SQL ステートメントで ? 記号を使用することによって指定されます。

パラメーターには名前が付いていないため、SQL ステートメントにあるパラメーターの順番どおりにバインドされなければなりません。つまり、PsqlParameterCollection オブジェクトの Add() メソッド（Parameter オブジェクトをコレクションに追加する）の呼び出しは、コマンド テキストに現れる "?" の順番どおりに発生する必要があるということです。

パラメーター配列のバインドは通常 INSERT ステートメントで使用され、テーブルを埋めるために必要な時間を短縮します。アプリケーションは 1 回のコマンド実行で複数のパラメーター値の行を指定することができます。それらの値を 1 回の往復（バックエンド データベース本来の能力によって異なる）でデータベース サーバーに送ることができます。

Zen ADO.NET データ プロバイダーでは、INSERT および UPDATE ステートメントに対して入力パラメーター配列をサポートします。