- 追加された行はこの色です。
- 削除された行はこの色です。
「[[Open棟梁 wiki>https://opentouryo.osscons.jp]]」は、「[[Open棟梁Project>https://github.com/OpenTouryoProject/]]」,「[[OSSコンソーシアム .NET開発基盤部会>https://www.osscons.jp/dotNetDevelopmentInfrastructure/]]」によって運営されています。
-戻る
--[[リリース情報]]
--[[D層自動生成ツール]]
--[[バッチ処理方式>バッチ処理方式#u9c20643]]
*目次 [#j12868f0]
#contents
*概要 [#xc7b824c]
-自動生成Daoにクエリを再利用機能を追加された(v02-50から利用可能)。
-自動生成Daoにクエリを再利用する~
クエリ・キャッシュ機能が追加された(v02-50から利用可能)。
-本対策を行う事によって、
-本機能を利用する事によって、
>「列数が多過ぎるテーブルに対して、D層自動生成機能に拠るDao生成を行って、それを利用すると、~
内部で使用される"動的パラメタライズド・クエリ"の実行エンジン内部で"性能問題が発生する"」
>と言う問題が解決される。
※ 本修正は、v02-50に含まれる予定ですが、~
テンプレート修正だけなので旧バージョンと互換性があり、~
&color(red){v02-50以前の旧バージョンにも適用可能};となっている。
*詳細 [#h6fa24fc]
**利用方法 [#u3ba88d1]
***自動生成ツールの設定変更 [#c6649c34]
DaoGen_Toolのapp.configを以下の様に変更し、使用するテンプレートを変更する。
-app.config
--
<add key="DaoTemplateFileName" value="DaoTemplate"/>
>↓ ↓ ↓
--
<add key="DaoTemplateFileName" value="DaoTemplate2"/>
-DaoTemplate2
--https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/files/tools/DGenTemplates/DaoTemplate2.cs
--https://github.com/OpenTouryoProject/OpenTouryo/blob/develop/root/files/tools/DGenTemplates/DaoTemplate2.vb
***キャッシュIDを指定 [#qc412f52]
キャッシュを行う箇所で、自動生成DaoのコンストラクタにキャッシュIDを指定する。
***クエリ・キャッシュIDを指定 [#qc412f52]
クエリ・キャッシュを行う箇所で、自動生成Daoのコンストラクタにクエリ・キャッシュIDを指定する。
-
// 自動生成Daoを生成
DaoShippers genDao = new DaoShippers(this.GetDam());
>↓ ↓ ↓
-
// 自動生成Daoを生成
// https://www.guidgenerator.com/online-guid-generator.aspx
DaoShippers genDao = new DaoShippers(this.GetDam(),
"f54d4d7bd5c8441187ec6939c4da7303");
コレにより、
-2回目以降は[[動的パラメタライズド・クエリ]]を、
-処理済みの[[静的パラメタライズド・クエリ]]として、
扱う事が出来る。
**仕様詳細 [#z0f1f563]
-キャッシュは各自動生成Daoに、staticメンバのConcurrentDictionaryとして仕込まれている。
-クエリ・キャッシュは各自動生成Daoに、staticメンバのConcurrentDictionaryとして仕込まれている。
-ConcurrentDictionaryのキーは、「キャッシュID + 読込ファイル名」となっている。
-ConcurrentDictionaryのキーは、「クエリ・キャッシュID + 読込ファイル名」となっている。
-キャッシュを行う箇所で、一意のキャッシュIDを指定する。
--通常は、一意の異なるキャッシュIDを指定する。~
--同じキャッシュIDを使用して異なる箇所で同じキャッシュを利用することもできる。
-クエリ・キャッシュを行う箇所で、一意のクエリ・キャッシュIDを指定する。
--通常は、一意の異なるクエリ・キャッシュIDを指定する。~
--同じクエリ・キャッシュIDを使用して異なる箇所で同じクエリ・キャッシュを利用することもできる。
---ただし、双方の個所で、当該自動生成Daoに指定するパラメタ・セットが同じになる必要がある。
---また、異なる自動生成Daoに同じキャッシュIDを指定しても同じキャッシュを使用することはできない。
---また、異なる自動生成Daoに同じクエリ・キャッシュIDを指定しても同じクエリ・キャッシュを使用することはできない。
-キャッシュIDには、以下の様な、~
-クエリ・キャッシュIDには、以下の様な、~
当該個所の当該自動生成Daoに一意性を与え得る値を使用できる。
--GUID(ハード・コーディング)
--呼出し元のクラス.メソッドの完全修飾名
**注意点 [#c7e9af0d]
本機能は、
本機能は、[[動的パラメタライズド・クエリ]]の、
-パラメタ・セットが同じになる地点でのクエリ・キャッシュを可能にする。
-パラメタ・セットが異なる地点で、~
同じキャッシュIDを使用してクエリ・キャッシュを行うと、~
パラメタライズド・クエリのパラメタ・エラーが発生することになる。
-パラメタ・セットが異なる地点で、
--同じクエリ・キャッシュIDを使用してクエリ・キャッシュを行うと、~
--パラメタライズド・クエリのパラメタ・エラーが発生する。
>ことになる。
-Guid.NewGuid() メソッドはランダム値になり、箇所を特定できないので使用不可。
*参考 [#s8c64910]
-Issue #332 · OpenTouryoProject/OpenTouryo~
Performance improvement of automatically generated Dao.~
https://github.com/OpenTouryoProject/OpenTouryo/issues/332
-Open棟梁:Dao自動生成機能の潜在的な性能問題が完全に解決される。 - OSSコンソーシアム~
https://www.osscons.jp/jo1qzb1y1-537/