クエリ・パフォーマンスの最適化

クエリのパフォーマンス統計の収集

パフォーマンス統計を収集するには、以下のいずれかを使用して統計 (Stats) コードの生成を有効にする必要があります。

• 管理ポータルの [SQL 実行時統計] タブ (管理ポータルから、[システム・エクスプローラ]、[ツール]、[SQL パフォーマンス・ツール]、[SQL 実行時統計] の順に選択します)。

• SetSQLStats()Opens in a new tab メソッドまたは SetSQLStatsJob()Opens in a new tab メソッド

これらのインタフェースのいずれかの場合は、次のオプションの 1 つを指定します。0 の場合は統計のコード生成が無効になり、1 の場合はすべてのクエリに対して統計のコード生成が有効になりますが統計の収集は行われません (既定)。2 の場合はクエリの外部ループのみの統計を記録し (クエリのオープンおよびクローズ時に統計を収集)、3 の場合はクエリのすべてのモジュール・レベルに対して統計を記録します。モジュールは入れ子にすることができます。その場合、MAIN モジュールの統計が包含的な数となり、全クエリに対する全体的な結果となります。

SetSQLStatsJob() の場合のオプションはわずかに異なります。次のようなオプションがあります。-1 を指定すると、このジョブの統計が無効になり、0 を指定すると、システム設定値が使用されます。1、2、および 3 のオプションは SetSQLStats() と同様であり、システム設定がオーバーライドされます。既定値は 0 です。

SQL 統計データを収集するには、統計コードの生成をオン (オプション 1、既定値) にしてクエリをコンパイルする必要があります。

• 0 から 1 に変更する場合：SQL 統計オプションの変更後、SQL を含んでいる実行時のルーチンとクラスは統計コードの生成を実行するためにコンパイルする必要があります。xDBC およびダイナミック SQL については、コードの生成を強制するために、クエリ・キャッシュを削除する必要があります。

• 1 から 2 に変更する場合：SQL 統計オプションを変更するだけで、統計の収集が開始されます。これにより、最短の中断で稼働中のプロダクション環境に関する SQL パフォーマンスの分析を実行できるようになります。

• 1 から 3 (または 2 から 3) に変更する場合：SQL 統計オプションの変更後、SQL を含んでいる実行時のルーチンとクラスは、すべてのモジュール・レベルの統計を記録するためにコンパイルする必要があります。xDBC およびダイナミック SQL については、コードの生成を強制するために、クエリ・キャッシュを削除する必要があります。一般に、オプション 3 は、非プロダクション環境で特定したパフォーマンスの低いクエリにのみ使用します。

• 1，2，または 3 から 0 に変更する場合：統計コードの生成をオフにするために、クエリ・キャッシュを削除する必要はありません。

この情報は %SYS.PTools.SQLQueryOpens in a new tab および %SYS.PTools.SQLStatsOpens in a new tab に保存されています。

クエリ・キャッシュを削除すると、関連するすべての SQL 統計データが削除されます。テーブルまたはビューを削除すると、関連するすべての SQL 統計データが削除されます。

クエリ・パフォーマンス統計の表示

以下の方法で SQL クエリのパフォーマンス統計を表示できます。

• 管理ポータルから、[システム・エクスプローラ]、[ツール]、[SQL パフォーマンス・ツール]、[SQL 実行時統計] の順に選択し、[統計の表示] タブをクリックします。これにより、このシステムで収集された実行時統計の全体像が得られます。

  [統計の表示] 列をクリックすると、クエリ統計をソートできます。その後で、特定のクエリの [プラン表示] をクリックします。

• 以下の例のように %SYS.PTools.SQLStatsOpens in a new tab クラスの GetLastSQLStats()Opens in a new tab メソッドを使用します。

    ZNSPACE "Samples"
    DO $SYSTEM.SQL.SetSQLStatsJob(2)
    SET myquery = "SELECT TOP 5 Name,DOB FROM Sample.Person"
    SET tStatement = ##class(%SQL.Statement).%New()
    SET qStatus = tStatement.%Prepare(myquery)
      IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
    SET rset = tStatement.%Execute()
    DO rset.%Display()
    WRITE !,"end of query result set",!!
    KILL rset
    DO ##class(%SYS.PTools.SQLStats).GetLastSQLStats()
    DO %sqlcontext.DumpResults()

  

• 以下の例のようにストアド・プロシージャを呼び出します。

    ZNSPACE "Samples"
    DO $SYSTEM.SQL.SetSQLStatsJob(2)
    SET myquery = "SELECT TOP 5 Name,DOB FROM Sample.Person"
    SET tStatement = ##class(%SQL.Statement).%New()
    SET qStatus = tStatement.%Prepare(myquery)
      IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
    SET rset = tStatement.%Execute()
    DO rset.%Display()
    WRITE !,"end of query result set",!!
    KILL rset
    &sql(CALL %SYS_PTools.GetLastSQLStats())
    DO %sqlcontext.DumpResults()

  

以下の例では、INSERT 文から実行時統計を収集します。

CreateATable
  &sql(CREATE TABLE sample.sqltest (FullName VARCHAR(25),MyDate DATE DEFAULT CURRENT_DATE))
    IF SQLCODE=0 { WRITE "sqltest table created",! }
    ELSE {WRITE "table create failed SQLCODE=",SQLCODE,! }

InsertData
  SET oldstat=$SYSTEM.SQL.SetSQLStatsJob(2)
  &sql(INSERT INTO sample.sqltest(FullName) SELECT Name FROM Sample.Person WHERE Name BETWEEN 'A' AND 'J')
  WRITE "Inserted ",%ROWCOUNT," rows in table SQLCODE=",SQLCODE,!
  DO ##class(%SYS.PTools.SQLStats).GetLastSQLStats()
  DO %sqlcontext.DumpResults()
Cleanup
   DO $SYSTEM.SQL.SetSQLStatsJob(oldstat)
   &sql(DROP TABLE sample.sqltest)

以下の例に示すように、SQLStatsView クエリを使用して、これらの統計を表示することができます。

  ZNSPACE "Samples"
  DO ##class(%SYS.PTools.SQLStats).Purge("Samples")
  DO ##class(%SYSTEM.SQL).SetSQLStatsJob(2)
  SET myquery = "SELECT TOP 5 Name,DOB FROM Sample.Person"
  SET tStatement = ##class(%SQL.Statement).%New()
  SET qStatus = tStatement.%Prepare(myquery)
   IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
  SET rset = tStatement.%Execute()
  DO rset.%Display()
  WRITE !,"end of query result set",!!
  KILL rset
  DO ##class(%ResultSet).RunQuery("%SYS.PTools.SQLStats","SQLStatsView")
  WRITE !!,"End of SQL Statistics"

実行時統計とプラン表示

[SQL 実行時統計] ツールは、実行時統計を含むクエリのプラン表示を表示するために使用できます。

[代替表示プラン] ツールは、クエリの実行時統計を表示して、プラン表示を統計と比較するために使用できます。[プラン表示のオプション] の [代替表示プラン] ツールには、クエリの推定統計が表示されます。実行時統計の収集がアクティブにされていると、[プラン表示を統計と比較] オプションにより、実際の実行時統計が表示されます。実行時統計がアクティブでない場合、このオプションにより推定統計が表示されます。

インデックスの対象

インデックスの追加によってクエリのパフォーマンスが向上するかどうかを判断するには、管理ポータルの SQL インタフェースからクエリを実行して、[パフォーマンス] のグローバル参照の数をメモします。インデックスを追加してからクエリを再度実行して、グローバル参照の数をメモします。インデックスが有用な場合は、グローバル参照の数が少なくなります。インデックスの使用を抑止するには、WHERE 節または ON 節の条件の前に %NOINDEX キーワードを使用します。

JOIN で指定されるフィールド (プロパティ) のインデックスを作成します。LEFT OUTER JOIN では、左のテーブルから開始し、その後、右のテーブルを調査します。そのため、右のテーブルのフィールドからインデックスを作成する必要があります。以下の例では、T2.f2 のインデックスを作成します。

   FROM Table1 AS T1 LEFT OUTER JOIN Table2 AS T2 ON T1.f1 = T2.f2

INNER JOIN には、両方の ON 節のフィールドに対するインデックスが必要です。

プラン表示を実行して、最初のマップをたどります。クエリ・プランの最初の箇条項目が "Read master map" の場合や、最初の箇条項目が "Read master map" のモジュールをクエリ・プランが呼び出す場合は、クエリの最初のマップはインデックス・マップではなくマスタ・マップになります。テーブルが比較的小さなものでない限り、このクエリを再実行したときにクエリ・プランの最初のマップに [インデックス・マップの読み取り] と表示されるようにインデックスを作成する必要があります。

WHERE 節の等値条件で指定されるフィールドのインデックスを作成します。

WHERE 節の範囲条件で指定されるフィールドや GROUP BY 節および ORDER BY 節で指定されるフィールドのインデックスを作成することが必要になる場合もあります。

範囲条件に基づくインデックスでは、クエリの速度が遅くなる場合があります。大部分の行が指定された範囲条件を満たす場合にこのようになる可能性があります。例えば、レコードの大部分が前の日付を持つデータベースでクエリ節 WHERE Date < CURRENT_DATE を使用する場合に、Date にインデックスを作成すると、クエリの速度が大幅に低下します。この原因は、クエリ・オプティマイザは、範囲条件で返される行は比較的少ないと仮定し、この状況に合わせて最適化するからです。これが発生しているかどうかは、範囲条件の前に %NOINDEX を配置してクエリを再度実行することで判断できます。

インデックスが作成されているフィールドを使用して比較を実行する場合、その比較に指定するフィールドの照合タイプは、対応するインデックスの照合タイプと同じにする必要があります。例えば、SELECT の WHERE 節または JOIN の ON 節の Name フィールドは、その Name フィールドに定義されたインデックスと同じ照合にする必要があります。フィールドの照合とインデックスの照合に不一致があると、インデックスの効果が低下するか、インデックスがまったく使用されなくなります。詳細は、このドキュメントの “インデックスの定義と構築” の章の "インデックス照合" を参照してください。

インデックスの作成方法と使用可能なインデックスのタイプとオプションの詳細は、"Caché SQL リファレンス" の CREATE INDEX コマンドと、このドキュメントの “インデックスの定義と構築” の章を参照してください。

インデックス構成オプション

以下のシステム全体の構成メソッドは、クエリでインデックスの使用を最適化するために使用できます。

• PRIMARY KEY を IDKey インデックスとして使用する $SYSTEM.SQL.SetDDLPKeyNotIDKey()Opens in a new tab

• SELECT DISTINCT クエリにインデックスを使用する $SYSTEM.SQL.SetFastDistinct()Opens in a new tab

詳細は、"Caché 詳細構成設定リファレンス" で説明されている SQL 構成設定を参照してください。

インデックス使用の分析

以下のいずれかを使用して、SQL クエリ・キャッシュのインデックス使用を分析できます。

• 管理ポータルの [インデックス分析] SQL パフォーマンス・ツール。

• %SYS.PTools.SQLUtilitiesOpens in a new tab のメソッド IndexUsage()Opens in a new tab、TableScans()Opens in a new tab、TempIndices()Opens in a new tab、および JoinIndices()Opens in a new tab。

インデックス分析

管理ポータルの [ツール] インタフェースから、[システム・エクスプローラ]、[ツール]、[SQL パフォーマンス・ツール]、[インデックス分析] の順に選択します。現在のネームスぺースの SQL 文カウントが表示され、4 つのインデックス分析レポート・オプションが提供されます。

IndexUsage() メソッド

以下の例では、IndexUsage()Opens in a new tab メソッドの使用法を示します。

  ZNSPACE "Samples"
  DO ##class(%SYS.PTools.SQLUtilities).IndexUsage(1)
  SET utils = "SELECT %EXACT(Type), Count(*) As QueryCount "_
              "FROM %SYS_PTools.SQLUtilities GROUP BY Type"
  SET utilresults = "SELECT SchemaName, Tablename, IndexName, UsageCount "_
                    "FROM %SYS_PTools.SQLUtilResults ORDER BY UsageCount"
  SET tStatement = ##class(%SQL.Statement).%New()
  SET qStatus = tStatement.%Prepare(utils)
   IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
  SET rset = tStatement.%Execute()
  DO rset.%Display()
  WRITE !,"End of utilities data",!!
  SET qStatus = tStatement.%Prepare(utilresults)
   IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
  SET rset = tStatement.%Execute()
  DO rset.%Display()
  WRITE !,"End of results data"

結果は UsageCount 順になるので、UsageCount > 0 のインデックスは結果セットの最後にリストされます。

インデックスの最適化オプション

既定で、Caché SQL クエリ・オプティマイザは、高度で柔軟性の高いアルゴリズムを使用して複数のインデックスを含む複雑なクエリのパフォーマンスを最適化します。ほとんどの場合、これらの既定によってパフォーマンスが最適化されます。ただし、optimize-option キーワードを指定することで、クエリ・オプティマイザに “ヒント” を与えることもできます。

FROM 節では、%ALLINDEX および %IGNOREINDEX の optimize-option キーワードがサポートされています。これらの optimize-option キーワードは、クエリ内のすべてのインデックスの使用を制御します。これらの詳細は、"Caché SQL リファレンス" の FROM 節のリファレンス・ページを参照してください。

条件レベル・ヒント %NOINDEX を使用すると、特定の条件のインデックスの使用に対する例外を指定できます。%NOINDEX ヒントは、インデックスを使用しない各条件の前に配置します。例えば、WHERE %NOINDEX hiredate < ? のようにします。通常、この方法は条件によって圧倒的多数のデータが選択される (または選択されない) 場合に使用します。「より小さい (<)」または「より大きい (>)」条件では、通常、条件レベル・ヒント %NOINDEX を使用すると効果的です。等価条件では、条件レベル・ヒント %NOINDEX を使用しても効果はありません。結合条件では、%NOINDEX は、WHERE 節の外部結合 =* および *= ではサポートされませんが、ON 節の結合ではサポートされます。

%NOINDEX キーワードを使用すると、FROM 節で確立されたインデックス最適化をオーバーライドできます。以下の例では、%ALLINDEX 最適化のキーワードが E.Age 条件を除くすべての条件テストに適用されます。

  SELECT P.Name,P.Age,E.Name,E.Age
  FROM %ALLINDEX Sample.Person AS P LEFT OUTER JOIN Sample.Employee AS E
       ON P.Name=E.Name
  WHERE P.Age > 21 AND %NOINDEX E.Age < 65

実行プランの表示

[プラン表示] を使用すると、以下のどの方法でもクエリの実行プランを表示できます。

• 管理ポータルの [SQL] インタフェースから。[システム・エクスプローラ]、[SQL] の順に選択します。ページ上部の [切り替え] オプションでネームスペースを選択します (ユーザごとに管理ポータルの既定ネームスペースを設定できます)。クエリを作成します (テキスト・ボックスに入力するか、[クエリ・ビルダ] を使用する)。次に [プラン表示] ボタンを押します (一覧表示されているクエリのプラン・オプションをクリックして、[履歴を表示] から [プラン表示] を呼び出すこともできます)。このドキュメントの“管理ポータルの SQL インタフェースの使用法”　の章の "SQL 文の実行" を参照してください。

• 管理ポータルの [ツール] インタフェースから、[システム・エクスプローラ]、[ツール]、[SQL パフォーマンス・ツール]、[SQL 実行時統計] の順に選択します。

  • [クエリ・テスト] タブから、ページ上部の [切り替え] オプションでネームスペースを選択します。テキスト・ボックスにクエリを入力します。次に、[SQL 統計によるプラン表示] ボタンを押します。これにより、クエリを実行することなく [プラン表示] を生成します。

  • [統計の表示] タブで、リストされているいずれかのクエリの [プラン表示] ボタンを押します。リストされているクエリには、[クエリ実行] (システム, SQL) で記述されたクエリと、[クエリ・テスト] (システム, SQL 実行時統計) で記述されたクエリの両方が含まれます。

• 以下の例のように ShowPlan()Opens in a new tab メソッドを実行します。

    ZNSPACE "Samples"
    SET oldstat=$SYSTEM.SQL.SetSQLStatsJob(3)
    SET mysql=2
    SET mysql(1)="SELECT TOP 10 Name,DOB FROM Sample.Person "
    SET mysql(2)="WHERE Name [ 'A' ORDER BY Age"
    DO $SYSTEM.SQL.ShowPlan(.mysql,0,1)
    DO $SYSTEM.SQL.SetSQLStatsJob(oldstat)

  

• プロパティとして格納されているリテラル置換値の :i%Prop syntax を使用して、キャッシュ・クエリの結果セットに対してプラン表示を実行します。

    ZNSPACE "Samples"
    SET cqsql=2
    SET cqsql(1)="SELECT TOP :i%PropTopNum Name,DOB FROM Sample.Person "
    SET cqsql(2)="WHERE Name [ :i%PropPersonName ORDER BY Age"
    DO ShowPlan^%apiSQL(.cqsql,0,"",0,$LB("Sample"),"",1)

  

既定では、[プラン表示] は論理モードで値を返します。ただし、管理ポータルまたは SQL Shell から [プラン表示] を呼び出すと、[プラン表示] は実行時モードを使用します。

実行プラン：文テキストとクエリ・プラン

[プラン表示] の実行計画は、文テキストとクエリ・プランという 2 つのコンポーネントで構成されます。

[文テキスト] は、以下の変更によって、元のクエリをレプリケートします。管理ポータル の [SQL] インタフェースにある [プラン表示] ボタンにより、DECLARE QRS CURSOR FOR (QRS はクエリ結果セット) を前に付けた SELECT クエリが表示されます。これは、[プラン表示] で凍結プランを使用できるようにすることにより行われます。[プラン表示] ボタンは、各リテラルを ? で置換するリテラル置換の実行も表示します。ただし、二重の括弧でリテラル値を囲むことで、リテラル置換を抑制している場合を除きます。このような変更は、ShowPlan() メソッドを使用してプラン表示を表示したときや、代替表示プランを表示したときには行われません。

[クエリプラン] には、クエリの実行に使用されるプランが示されます。[クエリプラン] は、以下の内容で構成されます。

• [Frozen Plan凍結プラン] は、クエリ・プランが凍結されている場合に、[クエリプラン] の先頭行に表示されます。それ以外の場合、先頭行は空白になります。

• [相対コスト] は、2 つのクエリの効率を比較するための抽象的な数値として、多数の要因から計算される整数値です。この計算では、さまざまな要因の中でも特にクエリの複雑さ、インデックスの有無、およびテーブルのサイズが考慮に入れられます。WHERE 節を指定していない COUNT(*) または MAX(%ID) などの特定の集約クエリによって “Relative cost not available” が返されます。

• [クエリプラン] は、メイン・モジュールと 1 つ以上のサブコンポーネント (必要な場合) で構成されます。1 つ以上のモジュール・サブコンポーネントが表示される場合は、B から始まるアルファベット順の名前が付けられ (Module B、Module C など)、実行順にリストされます (アルファベット順とは限りません)。アルファベットの最後に達すると、それ以降のモジュールには、Z=26 と解析して番号が付けられます。つまり、Module Z の次のモジュールは Module 27 になります。モジュールは、処理を実行して、その結果を内部的な一時ファイル (内部一時テーブル) に入力します。

  1 つ以上のサブクエリのサブコンポーネントが表示されることがあります。各サブクエリは、個別のサブクエリ・モジュールとして、クエリで指定されている順序で表示されます。サブクエリ・モジュールに名前は付けられません。サブクエリがモジュールを呼び出した場合、そのモジュールは、サブクエリの後に配置され、適切な不連続のアルファベット名が付けられます。このため、1 つのクエリ・プランに、Module B を呼び出すメイン・モジュールと Module H を呼び出す Subquery が含まれる場合があります。

• メイン・モジュールの最初の箇条項目が “Read master map” である場合、非効率的なクエリ・プランを示します。クエリ・プランは、Read master map... (使用可能なインデックスがない)、Read index map... (使用可能なインデックスを使用)、または Generate a stream of idkey values using the multi-index combination... (マルチ・インデックス、複数のインデックスを使用) のいずれかのマップ・タイプの文で実行を開始します。マスタ・マップは、データに対するインデックスではなくデータ自体を読み取るため、ほとんどの場合、Read master map... は非効率的なクエリ・プランを示します。テーブルが比較的小さなものでない限り、クエリ・プランを再生成したときに最初のマップに Read index map... と表示されるように、インデックスを定義する必要があります。クエリ・プランの解釈の詳細は、"SQL クエリ・プランの解釈" を参照してください。

一部の操作では、クエリ・プランが生成されない可能性のあることを示す [プラン表示] が作成されます。

• 非クエリの INSERT：INSERT... VALUES() コマンドはクエリを実行しません。そのため、クエリ・プランは生成されません。

• 常に FALSE のクエリ：Caché は、クエリ条件が常に false になるためにデータを返せないクエリを準備している場合を判断できます。この状況は、[プラン表示] の [クエリプラン] コンポーネントで通知されます。例えば、条件 WHERE %ID IS NULL または条件 WHERE Name %STARTSWITH('A') AND Name IS NU L を含むクエリはデータを返せないため、Caché は実行プランを生成しません。実行プランを生成する代わりに、[クエリプラン] は “Output no rows” というメッセージを示します。クエリに、これらの条件のいずれかを指定したサブクエリが含まれている場合、そのサブクエリ・モジュールについての [クエリプラン] には “Subquery result NULL, found no rows” というメッセージが表示されます。この条件チェックは、NULL が関与するいくつかの状況に制限されていて、自己矛盾するクエリ条件のすべてを補足することを意図していません。

• 不正なクエリ：[プラン表示] には、ほとんどの不正なクエリに対して SQLCODE エラー・メッセージを表示します。ただし、[プラン表示] は空として表示することもあります。例えば、WHERE Name = $$$$$ や WHERE Name %STARTSWITH('A") (単一引用符と二重引用符に注目してください) などが挙げられます。このような場合、[プラン表示] には [文テキスト] が表示されません。また、[クエリプラン] には [No plan created for this statement] というメッセージが表示されます。一般に、これはリテラルを区切っている引用符が釣り合っていない場合に発生します。また、ユーザ定義 ("外部") 関数に正しい構文を指定しないで、複数のドル記号を先頭に指定した場合にも発生します。

統計

[プラン表示オプション] リストでは、各代替表示プランに [コスト] 値を割り当てます。この値により、実行プラン間での相対的な比較が可能になります。

[代替表示プラン] の詳細には、[クエリプラン] ごとに [クエリの合計] についての統計 (Stats) のセットが示されます。(該当する場合は) クエリ・プラン・モジュールごとにも、これが示されます。各モジュールの統計には、時間 (ミリ秒単位での全体的なパフォーマンス)、グローバル (グローバル参照の数)、コマンド (実行されたコマンドの数)、およびディスク待機時間 (ミリ秒単位でのディスク読み込みの遅延) が含まれます。[クエリの合計] の統計には、[行] (返される行の数) も含まれます。

無視される %PARALLEL キーワード

%PARALLEL キーワードが FROM 節に指定されているかどうかに関係なく、一部のクエリは並列処理ではなく線形処理を使用する場合があります。Caché は、クエリを最適化して、他のクエリ最適化オプションを適用した後、クエリに並列処理を使用するかどうかを決定します (指定されている場合)。Caché は、ユーザ指定のクエリ形式が並列処理を実行すると利点があるように思える場合でも、最適化された形式のクエリが並列処理に適していないと決定することがあります。Caché が並列処理のためにクエリを分配したか、またはどのようにそうしたかは、プラン表示を使用して確認できます。

以下の状況では、%PARALLEL を指定しても並列処理は実行されません。クエリは正常に実行されてエラーは発行されませんが、並列処理は実行されません。

• FOR SOME 述語を含むクエリ。

• TOP 節と ORDER BY 節の両方を含むクエリ。この節の組み合わせでは、最初の行に移動する時間が最短になるように最適化されており、並列処理は使用されません。FROM 節の %NOTOPOPT optimize-option キーワードを追加することで、完全な結果セットの取得が最速になるように最適化されます。クエリに集約関数が含まれていない場合、この %PARALLEL と %NOTOPOPT の組み合わせにより、クエリの並列処理が実行されます。

• ON 節が等値条件ではない LEFT OUTER JOIN または INNER JOIN を含むクエリ。例えば、FROM %PARALLEL Sample.Person p LEFT OUTER JOIN Sample.Employee e ON p.dob > e.dob などです。これは、SQL 最適化により、このタイプの結合が FULL OUTER JOIN に変換されるために起きます。%PARALLEL は FULL OUTER JOIN の場合は無視されます。

• %PARALLEL の最適化と %INORDER の最適化は同時に使用できません。両方を指定すると、%PARALLEL は無視されます。

• テーブルに BITMAPEXTENT インデックスがある場合、COUNT(*) は並列処理を使用しません。

• %PARALLEL は、標準的なデータ・ストレージ定義を使用するテーブルで使用するためのものです。カスタマイズされたストレージ形式での使用はサポートされない場合があります。%PARALLEL は、GLOBAL TEMPORARY テーブル、または拡張グローバル参照ストレージがあるテーブルではサポートされません。

• %PARALLEL は、テーブルのすべての行にアクセスできるクエリ用であり、行レベル・セキュリティ (ROWLEVELSECURITYOpens in a new tab) が定義されているテーブルは並列処理を実行できません。

• %PARALLEL は、ローカル・データベースに格納されているデータを処理するためのものです。リモート・データベースにマップされているグローバル・ノードはサポートされません。

サブクエリ内の %PARALLEL

%PARALLEL は、SELECT クエリとそのサブクエリで使用するためのものです。INSERT コマンド・サブクエリは %PARALLEL を使用できません。

%PARALLEL は、括弧で囲まれたクエリと相互に関連しているサブクエリに適用された場合は無視されます。以下はその例です。

SELECT name,age FROM Sample.Person AS p 
WHERE 30<(SELECT AVG(age) FROM %PARALLEL Sample.Employee where Name = p.Name)

%PARALLEL は、複合述語を含むサブクエリ、または複合述語へと最適化する述語を含むサブクエリに適用された場合は無視されます。複合と見なされる述語には、%CONTAINS、%CONTAINSTERM、FOR SOME、および FOR SOME %ELEMENT 述語があります。

共有メモリの考慮事項

並列処理では、Caché は複数のプロセス間キュー (IPQ) をサポートしています。各 IPQ が 1 つの並列クエリを処理します。これを使用することで、並列の作業ユニット・サブプロセスは、データの行をメイン・プロセスに送り返し、作業ユニットの完了をメイン・プロセスが待機する必要がなくなるようにすることができます。これにより、並列クエリは、クエリ全体の完了を待機することなく、できる限り迅速にデータの最初の行を返せるようになります。さらに、集約関数のパフォーマンスも向上します。

クエリの並列実行には、一般メモリ・ヒープ (gmheap) の共有メモリを使用します。SQL クエリの並列実行を使用するユーザは、gmheap のサイズを大きくすることが必要になる場合があります。原則として、各 IPQ のメモリ要件は 4 x 64k = 256k です。Caché は、並列 SQL クエリを使用可能な CPU コア数に分割します。そのため、この追加の gmheap をユーザが割り当てる必要があります。

<Number of concurrent parallel SQL requests> x <Number cores> x 256 = <required size increase (in kilobytes) of gmheap>

この式に 100% の正確性はありません。並列クエリは同じく並列のサブ・クエリを生成することがあるためです。そのため、この式で指定された値よりも多くの gmheap を割り当てることが賢明です。

適切な gmheap の割り当てに失敗すると、cconsole.log にエラーが報告されます。SQL クエリは失敗する可能性があります。別のサブシステムが gmheap を割り当てようとすると、その他のエラーも発生する可能性があります。

インスタンスごとの gmheap の使用率を確認するには、管理ポータルのホーム・ページから [システム操作]→[システム使用] の順に選択して、[共有メモリヒープ使用状況] リンクをクリックします。詳細は、"Caché 監視ガイド" の “管理ポータルを使用した Caché の監視” の章の "一般 (共有) メモリ・ヒープ使用状況" を参照してください。

一般メモリ・ヒープまたは gmheap (共有メモリ・ヒープまたは SMH といわれることもある) のサイズを変更するには、管理ポータルのホーム・ページから、[システム管理]→[構成]→[追加設定]→[メモリ詳細] を選択します。詳細は、"Caché 追加構成設定リファレンス" の “Caché 追加構成設定” の章にある "詳細メモリ設定" を参照してください。

クエリ・キャッシュの考慮事項

キャッシュされた SQL クエリが %PARALLEL を使用している場合、このキャッシュされたクエリの実行中にクエリの初期化 (例えば、クエリ・キャッシュの削除) が行われると、このクエリはワーカ・ジョブの 1 つから <NOROUTINE> エラーの報告を受け取る可能性があります。一般に、クエリ・キャッシュの削除は、$SYSTEM.SQL.Purge() を呼び出すか、このクエリが参照するクラスを再コンパイルすることで発生します。クラスを再コンパイルすると、そのクラスに関連するクエリ・キャッシュは自動的に削除されます。

通常、このエラーが発生した場合は、もう一度クエリを実行することで正常に実行されます。クエリから %PARALLEL を削除すると、このエラーは発生しなくなります。

SQL 文とプランの状態

%PARALLEL を使用する SQL クエリは、複数の SQL 文になることがあります。これに該当する SQL 文の [プランの状態] は、[未凍結/並列] になります。プランの状態が [未凍結/並列] のクエリは、ユーザの操作で凍結することはできません。詳細は、“SQL 文” の章を参照してください。