Zen v16 ADO.NET データプロバイダー 4.5 および 4.6（.NET Framework 用）リリースノート一般リリース

Zen v16 ADO.NET データプロバイダー 4.5 および 4.6（.NET Framework 用）リリースノート
一般リリース – 2024 年 8 月

以下のトピックでは、ADO.NET データプロバイダー 4.5 および 4.6 の両方の Zen v16 サポートに関する情報を提供します。

•

Zen ADO.NET データプロバイダー 4.5 および 4.6（.NET Framework 用）について

•

本リリースで使用が推奨されなくなった機能

•

Zen Data Tools と Visual Studio との統合

•

はじめに

•

既知の問題と使用に関する注意

Zen ADO.NET データプロバイダー 4.5 および 4.6（.NET Framework 用）について

Zen v16 は、ADO.NET データプロバイダー 4.5 および 4.6 の 2 つのバージョンを提供します。デフォルトで、すべてのバージョンがデータベースエンジンと一緒にインストールされます。プロバイダーの使用法および互換性の詳細については、Zen の『Data Provider for ADO.NET』を参照してください。このガイドは SDK ダウンロードの \doc ディレクトリにあります。.NET アプリケーションの開発方法の詳細については、Zen 開発者ドキュメントの『Zen Programmer’s Guide』を参照してください。

本リリースで使用が推奨されなくなった機能

このドキュメントで説明されているように、Data Tools、プロジェクトテンプレート、項目テンプレート、および Entity Framework Model First テンプレートと Visual Studio との統合は、Microsoft Visual Studio 2019 より前のバージョンとの統合はサポートされなくなりました。

Zen Data Tools と Visual Studio との統合

Zen ADO.NET データプロバイダー SDK パッケージは、SDK Library for Zen / PSQL からダウンロードできます。これらのパッケージは、設計時ファイル（ドキュメントとコードサンプル）を同梱しているほか、Zen ADO.NET データプロバイダーのテンプレートおよび Data Tools と Visual Studio との統合を提供します。サポートされている Zen ADO.NET データプロバイダーのバージョンごとにダウンロードがあります。

4.5/4.6 プロバイダー SDK

4.5 または 4.6 データプロバイダー（.NET 用）SDK のダウンロードは、zip 形式のアーカイブファイルです。ターゲットシステム上でパッケージを手動で展開すると、次の項目が配置されます。

•

ドキュメント

•

コードサンプル

•

テンプレートおよび Data Tools を統合するための PowerShell スクリプト

これらの項目を Visual Studio と統合する手順は、次のセクションで説明します。

Visual Studio との統合

Zen ADO.NET データプロバイダー 4.5 SDK および 4.6 SDK は、Zen ADO.NET データプロバイダーのテンプレートおよび Data Tools と Microsoft Visual Studio 2019 および 2022 との統合を提供します。

テンプレートと Data Tools を Visual Studio に統合するには、アーカイブファイルの VisualStudioDataTools フォルダーに同梱されている PowerShell インストールスクリプトを使用することをお勧めします。

PowerShell スクリプトでは、アーカイブファイル内の上記フォルダーに同梱されている Visual Studio 拡張機能（VSIX）パッケージのいずれかのインストールが処理されます。このパッケージにより、Zen プロジェクトテンプレートおよび項目テンプレートと Zen Data Tools が Visual Studio に統合されます。VSIX パッケージでは現在、Entity Framework Model First テンプレートの統合がサポートされていないため、VS が Entity Framework 開発用に構成されている場合に限り、Zen Model First テンプレートをパッケージ内の該当する場所から適切な VS フォルダーにコピーする処理も PowerShell スクリプトが行います。

PowerShell を使用した統合

PowerShell インストールスクリプトを使用するには、PowerShell 3.0 以降をインストールしておくと共に、設定する際に、署名付きスクリプトを実行できるようにその実行ポリシーを設定しておく必要があります。また、PowerShell セッションを管理者特権で実行することも必要です。

PowerShell スクリプトを実行するには

アーカイブの .zip パッケージの内容をターゲットシステム上の特定の場所に展開します。

［管理者として実行］オプションを使用して、PowerShell セッションを開始します。

PowerShell プロンプトで、以下を実行します。

PS> <スクリプトのパス>\Load-Zen-DataTools.ps1 install

PowerShell を使用した後で VS との統合を解除するには

直前の作業の手順 1 ～ 2 を繰り返します。

PowerShell プロンプトで、以下を実行します。

PS> <スクリプトのパス>\Load-Zen-DataTools.ps1 remove

VSIX パッケージを使用した統合（Model-First テンプレートを使用しない）

Entity Framework 開発で Zen Model First テンプレートが不要な場合には、Visual Studio ユーティリティ VSIXInstaller.exe を使用して VSIX パッケージを直接インストールすることもできます。

VSIX パッケージを直接インストールするには

アーカイブの .zip パッケージの内容をターゲットシステム上の特定の場所に展開します。

Windows エクスプローラーで、ターゲットシステムの場所の VisualStudioDataTools フォルダーを参照します。

VSIX インストーラーを起動するには、次の VSIX パッケージのいずれかをダブルクリックします。これらは、使用する ADO.NET データプロバイダーのバージョンに対応する SDK のバージョンに付属しています。

•

ADO.NET データプロバイダー 4.5 SDK

•

Zen.VisualStudio.DataTools_2017_2019.vsix：VS 2017 ～ 2019 統合の場合

•

Zen.VisualStudio.DataTools_2022.vsix：VS 2022 統合の場合

•

ADO.NET データプロバイダー 4.6 SDK

•

Zen.VisualStudio.DataTools_2019.vsix：VS 2019 統合の場合

•

Zen.VisualStudio.DataTools_2022.vsix：VS 2022 統合の場合

VSIX インストールウィザードの指示に従います。

直接のインストールを行った後で VS との統合を解除するには

VS を起動し、［ツール］>［拡張機能と更新プログラム］を選択します。

インストールしたパッケージ、Actian Zen DataTools を見つけます。

［アンインストール］オプションをクリックし、VSIX インストールウィザードの指示に従います。

はじめに

Zen ADO.NET データプロバイダーで必要とされるファイルは、異なる方法で提供されます。

•

ほとんどのプロバイダーアセンブリは、Zen データベースエンジン（全エディション）をインストールするとデフォルトで含まれます。

•

設計時ファイル、サンプルソースコード、テンプレート、ライブラリ、および Zen Membership Provider for ASP.NET 2.0 は SDK に含まれています。

プロバイダーアセンブリ

データベースエンジンのインストールは、Zen のインストール先の Zen\bin フォルダー下のバージョンに応じたフォルダーに、すべてのプロバイダーアセンブリをコピーします。4.5 と 4.6 で個別のフォルダーが使用され、それぞれの個別のサブフォルダーに Entity Framework プロバイダーアセンブリが格納されます。Membership Provider for ASP.NET 2.0 はこのレイアウトに当てはまらないため、これについては Membership Provider for ASP.NET 2.0 で説明します。

Zen データベースインストールがサポートされているバージョンの .NET Framework を検出した場合は、次の処理も発生します。

•

プロバイダーアセンブリは GAC（Windows Global Assembly Cache）にアセンブリバージョン 4.5.0.0 と 4.6.0.0 としてインストールされます。

•

.NET Framework DbProviderFactories 名前空間は次のプロバイダーインスタンスで更新されます。

•

Pervasive.Data.SqlClient.4.6

•

Pervasive.Data.SqlClient.4.5

•

Pervasive.Data.SqlClient

メモ：インスタンスは、.NET Framework の最終一般提供（GA）リリースに対してのみ、DbProviderFactories 名前空間に追加されます。システム上にインストールされている .NET Framewaork が Alpha、Beta や RC（Release Candidate：リリース候補）版のような、GA より前のリリースである場合、名前空間は更新されません。

汎用プロバイダーのインスタンス（Pervasive.Data.SqlClient）は常に最新のプロバイダーアセンブリを指します。

Zen\bin フォルダーにコピーされたプロバイダーアセンブリは、インストール時にプリコンパイルされません。つまり、それらはローカルコンピューター上の Windows ネイティブイメージサービスに追加されません。プロバイダーアセンブリをプライベートサイドバイサイドアセンブリとしてアプリケーションと一緒にインストールし、ターゲットシステム上の Windows ネイティブイメージサービスに追加したい場合は、インストールにそれらを追加する必要があります。詳細については、Microsoft MSDN ライブラリで「ネイティブイメージジェネレーター」トピックを参照してください。

異なるプロバイダーの参照

SDK のインストーラーはサンプルソースコードファイル、テンプレート、およびライブラリをインストールすることに加え、Zen ADO.NET データプロバイダーのために次の統合を実行します。

•

バージョン 4.5 および 4.6 のプロバイダーを Visual Studio 2019 および 2022 と統合します。

•

プロバイダーを Windows パフォーマンスモニター（perfmon）と統合します。

•

プロバイダーを Visual Studio サーバーエクスプローラーと統合します。

•

Visual Studio の［ツール］メニューオプション、［Actian Zen］>［Run Zen Performance Tuning Wizard］を追加します。

•

Visual C# と Visual Basic 用の項目テンプレートおよびプロジェクトテンプレートを Visual Studio IDE に追加します。Visual Studio が Entity Framework 開発用に構成されている場合は、さらに Model First テンプレートが適切な Visual Studio インストールフォルダーにコピーされます。

Zen ADO.NET データプロバイダーをインストール後に Visual Studio をインストールする場合

Zen ADO.NET SDK をインストール後に Visual Studio をインストールした場合は、前述の統合手順を再実行してください。

Logging Application Block の構成

Logging Application Block を正しく機能させるにはアプリケーションに次の行を含める必要があります。

ConfigurationManager.GetSection("Pervasive.Data.SqlClient.Entity");

設計の考慮点

以下の情報は、Zen ADO.NET データプロバイダー（.NET Framework 用）で機能するアプリケーションの設計方法を決定するのに役立ちます。

設計方法

解説

アプリケーションは Zen プロバイダーの汎用プロバイダーインスタンスを参照します。

•

アプリケーションは再コンパイルすることなくプロバイダーのアップデートを使用できます。

•

アプリケーションはプロバイダーファイルを配布する必要がありません。

•

アプリケーションは Zen のインストールおよび Zen パッチによって GAC にインストールされた最新のアセンブリバージョンを常に使用することができます。

アプリケーションは Zen ADO.NET データプロバイダー 4.5 などのバージョンに応じたプロバイダーのインスタンスを参照します。

•

アプリケーションは GAC にインストールされたプロバイダーの特定のバージョンの最新のパッチを使用します。

•

アプリケーションは Zen によってインストールされたプロバイダーの最新のリリースを使用することがありません。

アプリケーションはプロバイダーの厳密な名前を参照します。厳密な名前は、公開キーとアセンブリを生成したデジタル署名と、アセンブリのテキスト名、バージョン番号、およびカルチャ情報（提供されている場合）で構成されます。

•

アプリケーションはプロバイダーのこの特定バージョンを配布します。

•

アプリケーションはこのプロバイダーをサイドバイサイドアセンブリとしてアプリケーションインストールフォルダーにインストールします。

Membership Provider for ASP.NET 2.0

ASP.NET ログインコントロールは、カスタムの Zen メンバーシッププロバイダーを使用して、ユーザー情報を格納するための個々のデータベースを指定します。

カスタムメンバーシッププロバイダーの記述については、Microsoft のオンラインで追加情報が提供されています。メンバーシッププロバイダーの場所については、アセンブリを参照してください。

ライブラリとサンプルに含まれるサンプルの ASP.NET アプリケーションは、ユーザーの作成、パスワードの変更、パスワードの回復、およびユーザーの検証を行う方法を示しています。

アセンブリ

メンバーシッププロバイダーのアセンブリは、Zen ADO.NET（.NET Framework 用）SDK ダウンロードに含まれています。ダウンロードした SDK からファイルを展開した後、アセンブリは \samples\MembershipProvider\bin\ に存在します。

メンバーシッププロバイダー要件

•

PSQL.Membership.Provider.dll

•

V2 メタデータとユーザー情報のテーブルを使用しているデータベース。同様に、テーブルも V2 メタデータで定義されている必要があります。

メンバーシッププロバイダーを使用するには

V2 メタデータを使用して Zen データベースを作成します。

Users テーブルの SQL スクリプトを使用してテーブルを作成します。

web.config ファイルの membership セクションを修正します。web.config ファイルの修正例を参照してください。

ここまでの手順を完了すると、ASP.NET のログインコントロールは Zen メンバーシッププロバイダーを使用できるようになります。

Users テーブルの SQL スクリプト

CREATE TABLE Users

(

PKID UniqueIdentifier NOT NULL PRIMARY KEY,

Username Char (255) NOT NULL,

ApplicationName char (255) NOT NULL,

Email Char (128) NOT NULL,

Comment Char (255),

"Password" Char (128) NOT NULL,

PasswordQuestion Char (255),

PasswordAnswer Char (255),

IsApproved SmallInt,

LastActivityDate DateTime,

LastLoginDate DateTime,

LastPasswordChangedDate DateTime,

CreationDate DateTime,

IsOnLine SmallInt,

IsLockedOut SmallInt,

LastLockedOutDate DateTime,

FailedPasswordAttemptCount Integer,

FailedPasswordAttemptWindowStart DateTime,

FailedPasswordAnswerAttemptCount Integer,

FailedPasswordAnswerAttemptWindowStart DateTime

)

web.config ファイルの修正例

<add

name="PsqlMembershipProvider"

type="PSQL.Membership.PsqlMembershipProvider"

connectionStringName="PsqlServices"

enablePasswordRetrieval="true"

enablePasswordReset="true"

requiresQuestionAndAnswer="true"

writeExceptionsToEventLog="true"

debug="false"

passwordFormat="Clear"/>

</providers>

</membership>

</system.web>

IPv6 環境

Zen ADO.NET データプロバイダー（.NET Framework 用）は、IPv6 環境（IPv4/IPv6 混在または IPv6 のみ）をサポートしています。

ドキュメント

『Zen Data Providers for ADO.NET Guide to Developing Applications』は、SDK ダウンロードの \doc ディレクトリに含まれています。.NET アプリケーションの開発方法の詳細については、Zen 開発者ドキュメントの『Zen Programmer’s Guide』を参照してください。

サンプル

以下の表は ADO.NET データプロバイダー（.NET Framework 用）で提供されるサンプルの要約です。サンプルファイルは、SDK .zip アーカイブの samples フォルダーにあります。

ディレクトリ	サンプル	サンプルの目的
Provider	CommandBuilder	SQL ステートメントからコマンドを作成します
	CreateDatabaseObjects	テーブルあるいはストアドプロシージャのようなデータベースオブジェクトを作成します
	DataAdapter	データアダプターを使用して、データの読み取りや変更を行います
	DataGridUpdate	グリッドコントロールの中でデータを更新します
	DataReader	データリーダーを使用して、データを取得します
	Escapes	Escape ステートメント中でエスケープシーケンスを処理します
	LimitingRows	結果セットから返される行数を制限します
	LocalTransactions	トランザクションを処理します
	LongDataTypes	LONGVARCHAR のような長いデータ型を使用します
	ScalarValue	値を返すスカラー関数を実行します
	StoredProcedures	ストアドプロシージャを使用します
MembershipProvider	ASP.NET ログインコントロールと共にメンバーシッププロバイダーを使用するための ASPX ファイル	さまざまなログイン活動や、パスワードの変更などを行います
Enterprise Library	Microsoft Enterprise Library を使用したサンプル	Microsoft Enterprise Library の使用法を示します

既知の問題と使用に関する注意

修正履歴および既知の問題については、弊社 Web サイトで参照できます。

ここに挙げた問題に加えて、一般的な既知の問題のリストも参照できます。

•

VSIX パッケージを使用した VS 統合ではインターネット接続が必要

Zen ADO.NET SDK と Visual Studio の統合に VSIX パッケージを使用する場合は、パッケージに署名した認証機関の証明書を検証するために、インターネット接続が必要です。

•

VS エラーメッセージ "The <DataPackage> package did not load correctly.（<DataPackage> パッケージが正しくロードされませんでした。）"

Visual Studio に .NET デスクトップ開発ワークロードがインストールされていない場合に、Zen ADO.NET Provider Data Tools を統合すると、［ツール］>［Actian Zen］メニューから［Run Zen Performance Tuning Wizard］オプションを選択したときに、このエラーメッセージが表示されます。この問題を解決するには、Visual Studio のインストールを再実行し、インストール対象として .NET デスクトップ開発ワークロードを選択したうえで、Zen ADO.NET Provider Data Tools を統合する PowerShell スクリプトを再実行するか、VSIX パッケージを再インストールします。

•

Entity Framework アプリケーションの EF5 から EF6 へのアップグレード – Code First

Entity Framework アプリケーションの使用中に、同じデータベースに対して Microsoft ADO.NET Entity Framework v5.0（EF5）から v6.0（EF6）にアップグレードすると、Code First のワークフローで問題が発生する場合があります。このような場合には、NotSupported 例外が返されます。この例外を解決するには、__MigrationHistory テーブルを削除し、アプリケーションを再実行します。

•

Code First Migrations（Code First マイグレーション） – ストアドプロシージャへのマッピング

Code First Migrations（Code First マイグレーション）のワークフローでは、ストアドプロシージャのマッピングを有効にして Enable-Migration（マイグレーションの有効化）コマンドを実行すると、［設定］フォルダーに <タイムスタンプ>_InitialCreate.cs ファイルが作成されますが、このファイルによってビルドエラーが発生します。

この問題を解決するには、<タイムスタンプ>_InitialCreate.cs ファイルを削除します。このファイルを削除しても、データの損失につながったり、データのマイグレーションに影響したりしません。

•

データが含まれるテーブルに対する Code First Migrations（Code First マイグレーション）

バックエンドのデータが含まれるテーブルに対して Code First Migrations（Code First マイグレーション）を実行すると、"ファイルがロックされています" というエラーが返されます。その理由は、Entity Framework の Code First Migrations（Code First マイグレーション）ではすべてのクエリがローカルトランザクション（通常、Alter コマンド）内で実行されるためです。ところが、この動作は Zen ではサポートされていません。

•

Code First – セット初期化子