凍結プランの構成

凍結プランの使用方法

凍結プランの使用方法には、楽観的方法と悲観的方法という 2 つの方法があります。

• 楽観的 ： この方法は、システム・ソフトウェアかクラス定義への変更でパフォーマンスが向上することを想定している場合に使用します。クエリを実行して、プランを凍結します。凍結プランをエクスポート (バックアップ) します。プランの凍結を解除します。ソフトウェアの変更を行います。クエリを再実行します。これにより、新しいプランが生成されます。2 つのクエリのパフォーマンスを比較します。新しいプランではパフォーマンスが向上しない場合は、バックアップ・ファイルから以前の凍結プランをインポートします。

• 悲観的 ： この方法は、システム・ソフトウェアかクラス定義への変更で、特定のクエリのパフォーマンスが向上する可能性がほとんどないことを想定している場合に使用します。クエリを実行して、プランを凍結します。ソフトウェアの変更を行います。%NOFPLAN キーワードを指定してクエリを再実行します (凍結プランは無視されます)。2 つのクエリのパフォーマンスを比較します。凍結プランを無視してもパフォーマンスが向上しない場合は、プランを凍結したままにして、クエリから %NOFPLAN を削除します。

ソフトウェアのバージョンをアップグレードした後の凍結プラン

InterSystems IRIS® のデータ・プラットフォームを新しいメジャー・バージョンにアップグレードすると、既定では既存のクエリ・プランは自動的に凍結されます。つまり、ソフトウェアのメジャー・アップグレードによって既存のクエリのパフォーマンスが低下することがあります。ソフトウェアのバージョンをアップグレードする前に、パフォーマンスが重要なクエリをすべて手動で凍結することを検討します。アップグレード後に、これらのクエリに以下の手順を実行します。

1. プランの状態を [凍結/明示] としてクエリを実行し、パフォーマンスを監視します。これは、プランを明示的に凍結する前に作成した最適化済みクエリ・プランです。

2. %NOFPLAN キーワードをクエリに追加して実行し、パフォーマンスを監視します。これにより、ソフトウェアのアップグレードで提供された SQL オプティマイザを使用して、クエリ・プランが最適化されます。既存のクエリ・プランの凍結は解除されません。

3. パフォーマンス・メトリックを比較します。

   • %NOFPLAN のパフォーマンスが優れている場合、ソフトウェアのアップグレードによってクエリ・プランの効率が向上しています。クエリ・プランの凍結を解除します。%NOFPLAN キーワードを削除します。

   • %NOFPLAN のパフォーマンスが劣る場合、ソフトウェアのアップグレードによってクエリ・プランの効率が低下しています。クエリ・プランを凍結状態のままとして、%NOFPLAN キーワードを削除します。

4. パフォーマンスが重要なクエリのテストが終了すれば、凍結した残りのプランをすべて凍結解除してもかまいません。

自動凍結を有効にしている場合は、プランを作成した InterSystems ソフトウェアよりも新しいバージョンのソフトウェアでクエリを準備またはコンパイルしたときに自動凍結が実行されます。例えば、システム・ソフトウェア・バージョン xxxx.1 で準備またはコンパイルした SQL 文を考えます。その後でバージョン xxxx.2 にアップグレードし、その SQL 文を再び準備/コンパイルします。システムは、これが新しいバージョンで実施されるその SQL 文の最初の準備/コンパイルになることを検出し、そのプランに自動的に [凍結/アップグレード] のマークを付けて、今回の準備/コンパイルに既存のプランを使用します。これにより、前のバージョンのクエリ・プランと同程度のクエリ・プランが使用されるようになります。

メジャー・バージョンの InterSystems システム・ソフトウェアのアップグレードでのみ、既存のクエリ・プランが自動的に凍結されます。メンテナンス・リリース・バージョンのアップグレードでは、既存のクエリ・プランは凍結されません。例えば、2018.1 から 2019.1 などのようなメジャー・バージョンのアップグレードでこの処理が実行されます。2018.1.0 から 2018.1.1 などのようなメンテナンス・リリース・バージョンのアップグレードでは、この処理は実行されません。

INFORMATION.SCHEMA.STATEMENTSOpens in a new tab Frozen=2 プロパティを使用して、現在のネームスペースの凍結/アップグレード・プランをすべてリスト表示できます。

次の $SYSTEM.SQL.Statement メソッドを使用して 1 つのクエリ・プランまたは複数のクエリ・プランを凍結できます ： 1 つのプランの場合は FreezeStatement()Opens in a new tab、関係のすべてのプランの場合は FreezeRelation()Opens in a new tab、スキーマのすべてのプランの場合は FreezeSchema()Opens in a new tab、現在のネームスペースのすべてのプランの場合は FreezeAll()Opens in a new tab。対応する Unfreeze メソッドがあります。

• Freeze メソッドを使用すると、[凍結/アップグレード] としてフラグが設定されたクエリ・プランを [凍結/明示] に昇格 ("凍結") できます。一般に、このメソッドは適切な [凍結/アップグレード] プランを選択的に [凍結/明示的] に昇格してから、それ以外の [凍結/アップグレード] プランの凍結をすべて解除するために使用します。

• Unfreeze メソッドを使用すると、ネームスペース、スキーマ、リレーション (テーブル)、または個々のクエリといった指定した範囲内での [凍結/アップグレード] クエリ・プランを凍結解除できます。

凍結プランのインタフェース

FREEZE PLANS コマンドを使用してクエリを凍結でき、UNFREEZE PLANS コマンドを使用してクエリを凍結解除できます。どちらの操作も、テーブル別、スキーマ別、またはネームスペース別に個別のクエリに対して実行できます。個別のプランを凍結または凍結解除するには、INFORMATION_SCHEMA.STATEMENTS をクエリすることにより、目的の Statement の Hash を探し出します。つづいて、FREEZE PLANS または UNFREEZE PLANS を使用して、特定の文の Hash を指定することで、その文のプランの状態を変更できます。

Frozen プロパティに対して INFORMATION_SCHEMA.STATEMENTS をクエリすることで、現在のネームスペースにあるすべての SQL 文のプランの状態を一覧できます。Frozen 列の値は、凍結解除 (0)、凍結/明示 (1)、凍結/アップグレード (2)、または未凍結/パラレル (3) のいずれかです。特定のクエリに EXPLAIN を使用して、そのクエリが凍結状態であるかどうかを判断することもできます。

1 つ以上のプランの凍結または凍結解除には、$SYSTEM.SQL.Statement Freeze および Unfreeze メソッドを使用することもできます。次の適切なメソッドを指定して、凍結または凍結解除操作の範囲を指定できます ： 1 つのプランの場合は FreezeStatement()Opens in a new tab、関係のすべてのプランの場合は FreezeRelation()Opens in a new tab、スキーマのすべてのプランの場合は FreezeSchema()Opens in a new tab、現在のネームスペースのすべてのプランの場合は FreezeAll()Opens in a new tab。対応する Unfreeze メソッドがあります。

凍結プランの相違

プランが凍結されている場合は、実際にプランの凍結を解除することなく、プランの凍結を解除したときに異なるプランが生成されるかどうかを判断できます。この情報は、プランの凍結を解除した場合にパフォーマンスが向上するかどうかを判断するために、%NOFPLAN を使用してテストする価値がある SQL 文を決定する際に役立ちます。

INFORMATION.SCHEMA.STATEMENTSOpens in a new tab FrozenDifferent プロパティを使用して、現在のネームスペースのこのタイプの凍結プランをすべてリスト表示できます。

凍結プランは、以下のいずれかの操作によって現在のプランとは異なるものになる可能性があります。

• テーブル、またはテーブルが参照するテーブルのリコンパイル。

• SetMapSelectability()Opens in a new tab を使用したインデックスの有効化または無効化。INFORMATION_SCHEMA.INDEXES カタログ・テーブルをクエリして MAP_SELECTABLE 列の値を確認することで、インデックスがアクティブかどうかを確認できます。

• テーブルに対するテーブル・チューニングの実行。

• InterSystems ソフトウェア・バージョンのアップグレード。

リコンパイルによって、既存のクエリ・キャッシュが自動的に削除されます。その他の操作の場合に新規クエリ・プランを適用するには、既存のクエリ・キャッシュを手動で削除する必要があります。

これらの操作によってクエリ・プランが異なるものになるかどうかはわかりません。すべての凍結プランをスキャンして、新しいクエリ・プランが生成されるかどうかを判断できます。

凍結プランの自動日次チェック

InterSystems SQL は、[SQL 文] リストにある凍結されたすべての文を毎晩午前 2:00 時に自動的にスキャンします。このスキャンは最大で 1 時間かかります。スキャンが 1 時間で完了しなかった場合は、中断した場所が記録され、そこから次回の日時スキャンが続行されます。

さらに、管理ポータルを使用してスキャンを強制実行できます。そのためには、[システムオペレーション]→[タスクマネージャ]→[タスクスケジュール] の順に選択し、Scan frozen plans タスクを選択します。

このスキャンの結果は、INFORMATION.SCHEMA.STATEMENTSOpens in a new tab を呼び出すことで確認できます。以下の例では、すべての凍結プランの SQL 文が返され、凍結されない場合になるプランと凍結プランが異なるかどうかが示されます。未凍結プランの場合の文は Frozen=0 または Frozen=3 となる可能性があることに注意してください。

SELECT Frozen,FrozenDifferent,Timestamp,Statement FROM INFORMATION_SCHEMA.STATEMENTS 
WHERE Frozen=1 OR Frozen=2

%NOFPLAN キーワード

%NOFPLAN キーワードを使用すると、凍結プランをオーバーライドできます。%NOFPLAN キーワードを含んでいる SQL 文は、新しいクエリ・プランを生成します。凍結プランは保持されますが、使用されません。これにより、凍結プランを維持しながら、生成されたプランの動作をテストできるようになります。

%NOFPLAN の構文は、以下のとおりです。

DECLARE <cursor name> CURSOR FOR SELECT %NOFPLAN ...   SELECT %NOFPLAN ....   INSERT [OR UPDATE] %NOFPLAN ...   DELETE %NOFPLAN ...   UPDATE %NOFPLAN 

凍結プランのエクスポートとインポート

SQL 文を XML 形式のテキスト・ファイルとしてエクスポートまたはインポートすることができます。これにより、凍結プランを別の場所に移動できます。SQL 文のエクスポートとインポートには、関連付けられたクエリ・プランのエンコード・バージョンと、プランが凍結されているかどうかを示すフラグが含まれます。詳細は、"SQL 文のエクスポートとインポート" を参照してください。