Zen v15 ADO.NET データ プロバイダー 4.4 および 4.5（.NET Framework 用）リリース ノート
一般リリース – 2021 年 10 月
目次
以下のトピックでは、ADO.NET データ プロバイダー 4.4 および 4.5 の両方の Zen v15 サポートに関する情報を提供します。
•
Zen ADO.NET データ プロバイダー 4.4 および 4.5（.NET Framework 用）について
•
本リリースで使用が推奨されなくなった機能
•
Zen Data Tools と Visual Studio との統合
•
はじめに
•
既知の問題と使用に関する注意
Zen ADO.NET データ プロバイダー 4.4 および 4.5（.NET Framework 用）について
Zen v15 は、ADO.NET データ プロバイダー 4.4 および 4.5 の 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 2017 より前のバージョンとの統合はサポートされなくなりました。
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.4/4.5 プロバイダー SDK
4.4 または 4.5 データ プロバイダー（.NET 用）SDK のダウンロードは、zip 形式のアーカイブ ファイルです。ターゲット システム上でパッケージを手動で展開すると、次の項目が配置されます。
•
ドキュメント
•
コード サンプル
•
テンプレートおよび Data Tools を統合するための PowerShell スクリプト
これらの項目を Visual Studio と統合する手順は、次のセクションで説明します。
Visual Studio との統合
Zen ADO.NET データ プロバイダー 4.4 および 4.5 SDK は、Zen ADO.NET データ プロバイダーのテンプレートおよび Data Tools と Microsoft Visual Studio 2017 および 2019 との統合を提供します。
テンプレートと 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 スクリプトを実行するには
1
アーカイブの .zip パッケージの内容をターゲット システム上の特定の場所に展開します。
2
［管理者として実行］オプションを使用して、PowerShell セッションを開始します。
3
PowerShell プロンプトで、以下を実行します。
PS> <スクリプトのパス>\Load-PSQL-DataTools.ps1 install
►
PowerShell を使用した後で VS との統合を解除するには
1
直前の作業の手順 1 ～ 2 を繰り返します。
2
PowerShell プロンプトで、以下を実行します。
PS> <スクリプトのパス>\Load-PSQL-DataTools.ps1 remove
VSIX パッケージを使用した統合（Model-First テンプレートを使用しない）
Entity Framework 開発で Zen Model First テンプレートが不要な場合には、Visual Studio ユーティリティ VSIXInstaller.exe を使用して VSIX パッケージを直接インストールすることもできます。
►
VSIX パッケージを直接インストールするには
1
アーカイブの .zip パッケージの内容をターゲット システム上の特定の場所に展開します。
2
Windows エクスプローラーで、ターゲット システムの場所の VisualStudioDataTools フォルダーを参照します。
3
VSIX インストーラーを起動するには、次の VSIX パッケージをダブルクリックします。
Zen.VisualStudio.DataTools_2017_2019.vsix：VS 2017 ～ 2019 の場合
4
VSIX インストール ウィザードの指示に従います。
►
直接のインストールを行った後で VS との統合を解除するには
1
VS を起動し、［ツール］>［拡張機能と更新プログラム］を選択します。
2
インストールしたパッケージ、Actian Zen DataTools を見つけます。
3
［アンインストール］オプションをクリックし、VSIXInstaller ユーティリティ アンインストール ウィザードの指示に従います。
はじめに
Zen ADO.NET データ プロバイダーで必要とされるファイルは、異なる方法で提供されます。
•
ほとんどのプロバイダー アセンブリは、Zen データベース エンジン（全エディション）をインストールするとデフォルトで含まれます。
•
設計時ファイル、サンプル ソース コード、テンプレート、ライブラリ、および Zen Membership Provider for ASP.NET 2.0 は SDK に含まれています。
プロバイダー アセンブリ
データベース エンジンのインストールは、Zen のインストール先の Zen\bin フォルダー下のバージョンに応じたフォルダーに、すべてのプロバイダー アセンブリをコピーします。4.4 と 4.5 で個別のフォルダーが使用され、それぞれの個別のサブフォルダーに 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.4.0.0 と 4.5.0.0 としてインストールされます。
•
.NET Framework DbProviderFactories 名前空間は次のプロバイダー インスタンスで更新されます。
•
Pervasive.Data.SqlClient.4.5
•
Pervasive.Data.SqlClient.4.4
•
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.4 および 4.5 のプロバイダーを Visual Studio 2017 および 2019 と統合します。
•
プロバイダーを 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.4 などのバージョンに応じたプロバイダーのインスタンスを参照します。
•
アプリケーションは GAC にインストールされたプロバイダーの特定のバージョンの最新のパッチを使用します。
•
アプリケーションは Zen によってインストールされたプロバイダーの最新のリリースを使用することがありません。
アプリケーションはプロバイダーの厳密な名前を参照します。厳密な名前は、公開キーとアセンブリを生成したデジタル署名と、アセンブリのテキスト名、バージョン番号、およびカルチャ情報（提供されている場合）で構成されます。
•
アプリケーションはプロバイダーのこの特定バージョンを配布します。
•
アプリケーションはこのプロバイダーをサイド バイ サイド アセンブリとしてアプリケーション インストール フォルダーにインストールします。
Membership Provider for ASP.NET 2.0
ASP.NET ログイン コントロールは、カスタムの Zen メンバーシップ プロバイダーを使用して、ユーザー情報を格納するための個々のデータベースを指定します。
カスタム メンバーシップ プロバイダーの記述については、Microsoft MSDN ライブラリで追加情報が提供されています。メンバーシップ プロバイダーの場所については、アセンブリを参照してください。
ライブラリとサンプルに含まれるサンプルの ASP.NET アプリケーションは、ユーザーの作成、パスワードの変更、パスワードの回復、およびユーザーの検証を行う方法を示しています。
アセンブリ
PSQL.Membership.Provider.dll という名前の Zen メンバーシップ プロバイダー アセンブリは、デフォルトでは Zen データベースと一緒にインストールされません。このプロバイダー アセンブリは、Zen ADO.NET SDK に含まれています。Zen ADO.NET SDK の場合、メンバーシップ プロバイダーは同じフォルダーの場所（samples\MembershipProvider\bin）の .zip アーカイブに格納されます。
メンバーシップ プロバイダー要件
•
PSQL.Membership.Provider.dll
•
V2 メタデータとユーザー情報のテーブルを使用しているデータベース。同様に、テーブルも V2 メタデータで定義されている必要があります。
►
メンバーシップ プロバイダーを使用するには
1
V2 メタデータを使用して Zen データベースを作成します。
2
Users テーブルの SQL スクリプトを使用してテーブルを作成します。
3
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 ファイルの修正例
<connectionStrings>
<add name="PsqlServices" connectionString="ServerDSN=ASPNETPSQL;" /> </connectionStrings> <system.web>
<membership defaultProvider="PsqlMembershipProvider" userIsOnlineTimeWindow="120">
    <providers>
    <clear />
    <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 2017 エラー メッセージ "The <DataPackage> package did not load correctly.（<DataPackage> パッケージが正しくロードされませんでした。）"
Visual Studio 2017 に .NET デスクトップ開発ワークロードがインストールされていない場合に、Zen ADO.NET Provider Data Tools を統合すると、［ツール］>［Actian Zen］メニューから［Run Zen Performance Tuning Wizard］オプションを選択したときに、このエラー メッセージが表示されます。この問題を解決するには、Visual Studio 2017 のインストールを再実行し、インストール対象として .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 – セット初期化子
2 つ以上の Entity Framework アプリケーションが、少なくとも 1 つのコンテキストに "Create Database If Not Exist" 以外のセット初期化子が含まれる同じデータベースに接続しようとすると、データが失われる可能性があります。この問題を解決するには、カスタマイズ可能なマイグレーション履歴機能を使用し、新しいマイグレーション履歴テーブルにバックエンドの既存テーブルと異なる名前を付けます。
•
マイグレーション履歴テーブルのカスタマイズ – __MigrationHistory テーブルの名前変更
__MigrationHistory テーブルの名前を変更する際は、主キー HistroyContext の長さを Zen で許容される最大長 254 バイト以内に必ず収めてください。
•
マイグレーション履歴テーブルのカスタマイズ – キー列長のサイズ変更
Code First Migrations（Code First マイグレーション）では、カスタマイズ可能なマイグレーション履歴テーブルのデフォルトの主キー列のサイズを変更する際、Zen サーバーで設定されている最大許容主キー長を超えてはなりません。超えると、デフォルト長の値が以下のように設定されます。
Unicode が有効になっている場合、各長さは次のようになります。
•
MigrationId：42
•
ContextKey：83
Unicode が無効なっている場合、各長さは次のようになります。
•
MigrationId：85
•
ContextKey：169
•
マイグレーション履歴のカスタマイズ – マイグレーション履歴テーブルの名前変更
Code First モデルでは、マイグレーション履歴テーブルの名前を変更すると、DropCreateDatabaseIfModelChanges または DropCreateDatabaseAlways セット初期化子を使用する際に、問題が発生する可能性があります。
Progress では、マイグレーション履歴テーブルの名前を変更することをお勧めします。
•
マイグレーション履歴テーブルのカスタマイズ – 新しい列の追加
カスタマイズ可能なマイグレーション履歴テーブルに新しい列を追加した後では、サード パーティ制限のため、どの列のサイズも変更することはできません。
•
Code First Migrations（Code First マイグレーション） – 複数の列の追加/削除、または関係のあるコンテキストの列の変更
複数の列を追加/削除したり、関係のあるコンテキストを持つ 1 つまたは複数の列を 1 回のマイグレーションで変更したりすると、Btrieve エラー 88 が発生します。これは Zen にとって既知の問題です。
•
Lightswitch 2011/2012 のサポート
Lightswitch により、Zen の DATE 型の列に対して DateTime コントロールがロードされます。つまり、Lightswitch アプリケーションで使用する DATE 型の列をテーブルにロードすると、Lightswitch により、そのような列に対して DateTime コントロールがロードされます。TIME 型の値は格納できないため、DATE 型フィールドに入力された時刻は保存されず、Lightswitch アプリケーションにより時刻部分が 00:00 にリセットされます。これを回避するには、Lightswitch Designer における DATE 型の列の Lightswitch マッピングを DateTime から Date に変更します。
•
Entity Framework のサポート
Entity Framework プロバイダーでは、UniqueIdentifier 型のマッピングはサポートされていません。エンティティ データ モデルを生成する際、UniqueIdentifier 型の列が含まれるテーブルを選択すると、"UniqueIdentifier data type is not supported（UniqueIdentifier データ型はサポートされていません）" というエラーが返されます。このようなテーブルは、エンティティ モデルにインポートすることはできるものの、UniqueIdentifier 型の列なしでインポートされます。UniqueIdentifier 型の列でヌル値が許可される場合には、このようなテーブルを Entity Framework アプリケーションで使用し続けることができます。
•
旧バージョンの PSQL データ プロバイダーがインストールされているコンピューターにインストールする場合
Zen ADO.NET データ プロバイダー 4.4 および 4.5（.NET Framework 用）は、GA バージョンや、任意のパッチまたはサービス パックを適用したバージョンなど、以前にリリースされたバージョンのデータ プロバイダーと同じマシン上に共存することができます。ただし、同じディレクトリにインストールすることはできません。
•
Perfmon リストに Zen ADO.NET データ プロバイダー（.NET Framework 用）がない場合
インストールした ADO.NET データ プロバイダーが perfmon の［パフォーマンス オブジェクト］リストに表示されない場合は、次の操作を行います。
•
ADO.NET データ プロバイダーをインストールする際に管理者権限を使用したかどうかを確認します。
•
ADO.NET データ プロバイダーを参照する .NET アプリケーションを実行してみます。
これで、当該リストに ADO.NET データ プロバイダーが表示されるようになります。
•
Logging Application Block の構成
Logging Application Block を正しく機能させるにはアプリケーションに次の行を含める必要があります。
ConfigurationManager.GetSection("Pervasive.Data.SqlClient.Entity");
•
Zen ADO.NET データ プロバイダー（.NET Framework 用）をインストール後に Visual Studio をインストールする場合
Zen ADO.NET データ プロバイダー（.NET Framework 用）がインストールされているコンピューターに Visual Studio を初めてインストールする場合は、Visual Studio Integration Tool（Visual Studio 統合ツール）を使用する必要があります。
•
Visual Studio Integration Tool をインストールするには
コマンド プロンプトで、Tools フォルダーにある InstallProviderIntegration.cmd スクリプトを実行します。Pervasive.Data.SqlClient.dll のインストール ディレクトリを指定します。
•
Visual Studio Integration Tool をアンインストールするには
コマンド プロンプトで、Tools フォルダーにある UninstallProviderIntegration.cmd スクリプトを実行します。
免責事項
ACTIAN CORPORATION は、本ソフトウェアおよびドキュメントの使用を、利用者またはその会社に対して「現状のまま」で、かつ同梱の使用許諾契約書に記載の契約条件によってのみ許諾するものです。
Copyright © 2021 Actian Corporation. All Rights Reserved.