の APPLCOMPAT レベルの互換性のない変更。 Db2 12

IFCID 0376トレースとAPPLCOMPATレベルの互換性のない潜在的な変更の特定

IFCID 0239でパッケージ・レベルのアカウンティングまたはモニタ・トレースを実行し、SQLと互換性のない変更を示すQPACFLGSフィールドを確認できます。 IFCID 0376 に対してトレースが開始され、アプリケーションがより低い APPLCOMPAT レベルで実行される場合、より高い APPLCOMPAT レベルで動作が変化する機能や関数に関する詳細は、フィールド QW0376FN に記述される。

より高い APPLCOMPAT レベルで実行を開始する SQL ステートメントで起こりうる互換性のない変更の説明は、DSNWMSGS フラットファイルの IFCID 0376 セクションにもあります。 DSNWMSGSの最新バージョンは、 Db2 12 for z/OS® ライセンスをお持ちのお客様のみご利用いただけます。 情報は PDF ファイルにあります。 この情報を検索するには、 Db2 12 for z/OS IFCIDフラットファイル（DSNWMSGS ）を参照してください。

APPLCOMPAT レベルの互換性のない変更の概要

次の表は、 Db2 12 の高い APPLCOMPAT レベルでアプリケーションを初めて実行したときに発生する可能性のある、互換性のない変更をまとめたものです。 APPLCOMPATレベル列は、アプリケーションが APPLCOMPATレベル新ビヘイビア列に記述された新ビヘイビアに遭遇する可能性のある、最も低いアプリケーション互換レベルを示す。

V10R1 そのため、この値を持つ行の Previous deprecated behavior 列には、サブシステム・パラメータなど、アプリケーションが適切な調整を行うまで非推奨の動作を継続できるようにする他の設定がリストされます。 QW0376FN トレース・コードの列には、アプリケーションが低い APPLCOMPAT レベルで実行されているときに IFCID 0376 が有効になっている場合に返されるファンクション・コードが含まれています。

の APPLCOMPAT レベルの互換性のない変更内容 Db2 12

以下のエントリでは、 Db2 13 の APPLCOMPAT レベルを高くしてアプリケーションを初めて実行したときに発生する可能性のある、互換性のない変更について詳しく説明しています。

へのパススルーでサポートされる新しい組み込み関数名 IBM® Db2 Analytics Accelerator

APPPLCOMPAT レベル V12R1M507 以降では、以下の組み込み関数がサポートされています。 パススルー専用の組み込み関数は、 IBM Db2 Analytics Accelerator を通してサポートされています。 Db2 アプリケーションが、これらの名前を持つ既存のユーザー定義関数への修飾されていない参照を持つ場合、特定の状況下では、名前とシグネチャが一致すれば、代わりに新しい組み込み関数を呼び出すようになるかもしれません。

• ADD_DAYS スカラー関数
• BTRIM スカラー関数
• DAYS_BETWEEN スカラー関数
• NEXT_MONTH スカラー関数
• 回帰関数 (REGR_AVGX、REGR_AVGY、REGR_COUNT ...)
• ROUND_TIMESTAMPスカラー関数 （日付式で呼び出された場合

取るべき行動 ： Db2、意図したユーザー定義機能を確実に実行するを参照。

明示的に作成されたテーブル・スペースの変更

APPLCOMPAT レベル V12R1M506 以上から、以下の変更が有効になる：

• 明示的に作成されたユニバーサル表スペース内にある表をドロップすると、エラーは返されなくなりました。 代わりに、表スペースは暗黙的にドロップされます。
• 明示的に作成された LOB 表スペースにある補助表をドロップすると、その LOB 表スペースがデータベース内で維持されなくなりました。 代わりに、表スペースは暗黙的にドロップされます。

取るべき行動:

• DROP TABLESPACE ステートメントを使用してユニバーサル表スペースと表をドロップする既存のアプリケーションは、DROP TABLE ステートメントを代わりに使用するように変更できるようになりました。
• 補助表がドロップされた場合、LOB 表スペースが再使用のために保持されることが想定されているアプリケーションまたはツールは、それに応じて変更する必要があります。

へのパススルーでサポートされる新しい組み込み関数名 IBM Db2 Analytics Accelerator

APPPLCOMPAT レベル V12R1M504 以降では、以下の組み込み関数がサポートされています。 パススルー専用の組み込み関数は、 IBM Db2 Analytics Accelerator を通してサポートされています。 Db2 アプリケーションが、これらの名前を持つ既存のユーザー定義関数への修飾されていない参照を持つ場合、特定の状況下では、名前とシグネチャが一致すれば、代わりに新しい組み込み関数を呼び出すようになるかもしれません。

• CUME_DIST
• CUME_DIST 集約関数
• FIRST_VALUE
• LAG
• LAST_VALUE
• LEAD
• NTH_VALUE
• NTILE
• PERCENT_RANK
• PERCENT_RANK 集約関数
• RATIO_TO_REPORT
• REGEXP_COUNT スカラー関数
• REGEXP_INSTR スカラー関数
• REGEXP_LIKE スカラー関数
• REGEXP_REPLACE スカラー関数
• REGEXP_SUBSTR スカラー関数

取るべき行動: Db2 が意図したユーザー定義関数を確実に実行する.

カラム名に CURRENT_TIMEZONE と CURRENT_SERVER を指定する

APPLCOMPATレベル V12R1M504、またはそれ以降で、 Db2 環境に CURRENT_TIMEZONE や CURRENT_SERVER などの名前を持つ既存の列や変数がある場合は、これらの列名を区切るようにアプリケーションを変更する必要があります。

取るべき行動 ： 以下のクエリーを使用して、その名前を持つカラムと変数を特定することができます。

オブジェクト・タイプ	照会の例
Columns	SELECT * FROM SYSIBM.SYSCOLUMNS WHERE NAME IN('CURRENT_SERVER','CURRENT_TIMEZONE');
変数	SELECT * FROM SYSIBM.SYSVARIABLES WHERE NAME IN('CURRENT_SERVER','CURRENT_TIMEZONE');

結果に基づいて、例えば SYSIBM.SYSPACKDEP カタログ表を照会することにより、依存関係をチェックして、これらの名前の区切り文字で区切られていない形式に依存する静的アプリケーションを識別することができます。

非推奨オブジェクトの作成防止

APPPLCOMPAT レベル V12R1M504 以降では、明示的または暗黙的にベース・テーブルのテーブル・スペースを作成する SQL 文は常に、パーティション・バイ・グロース（PBG）またはパーティション・バイ・レンジ（PBR）テーブル・スペースであるユニバーサル・テーブル・スペース（UTS）を作成します。 また、ベース・テーブルが常にUTS内に作成されることの副作用として、以前は成功した特定のSQL文に対してエラーが返されることがある。

• LOB 列の CREATE AUX TABLE 文は、ベース・テーブルが PBG テーブル・スペースにある場合に PART 節が必要なため、SQLCODE -769 エラーで失敗することがあります。
• DROP TABLE 文は PBG テーブル・スペース内のテーブルではサポートされていないため、SQLCODE -669 エラーで失敗することがあります。 代わりにDROP TABLESPACE文を使用しなければならない。 (APPLCOMPATレベル V12R1M506、この状況は解決される）。詳細については、 「機能レベル 506 ( PH16829 - 2019 年 10 月) 」を参照してください。
• CREATE TABLE ステートメントが同じテーブル・スペースに複数のテーブルを作成しようとすると、SQLCODE -646 エラーで失敗することがあります。 各UTSには1つのテーブルしかない。

APPLCOMPAT レベル 504 以降では、以下の SQL 文は非推奨オブジェクトを作成する代わりにエラーを返します：

• CREATE SYNONYM ステートメント
• 既存の非 UTS 表スペースを指定する CREATE TABLE ステートメント
• ORGANIZE BY HASH を指定する CREATE TABLE ステートメントおよび ALTER TABLE ステートメント

取るべき行動: 非推奨のオブジェクト・タイプを使用するようにアプリケーションを更新してください。

ヒントすべての新しいデータベース・オブジェクトには非推奨の型を使用するのがベストですが、リカバリの状況など、必要に応じてより低いAPPLCOMPATレベルを使用して非推奨のテーブル・スペースを作成することができます。 詳しくは、 非UTSテーブル・スペースの作成（非推奨 ）を参照のこと。

ON DELETE ADD EXTRA ROW を使用して定義されたシステム期間テンポラル表の結果変更

アプリケーション互換性レベル V12R1M503 以降では、システム期間一時テーブルの DATA CHANGE OPERATION 列に対応する履歴テーブル列に NULL 値が含まれる行は、システム期間一時テーブルが ON DELETE ADD EXTRA ROW 属性で定義されている場合でも、期間指定を含むクエリの中間結果の一部と見なされます。 低いアプリケーション互換性レベルで実行されるクエリは、中間結果セットからNULL値を含む行を引き続き省略し、不完全な結果を返す可能性があります。

この動作変更は、アプリケーション互換性レベル V12R1M503 またはそれ以上で実行されるクエリで、以下の条件がすべて満たされている場合に発生します：

• このクエリは、システム期間テンポラル・テーブル（STT）を FOR SYSTEM_TIME FROM value1 から value2 (または value1 および value2 )期間指定。 STT は、直接的に参照することも、間接的に参照することもできます。
• STT は、ON DELETE ADD EXTRA ROW 節を使用して定義されます。
• STT は、DATA CHANGE OPERATION 列を使用して定義されます。
• 一時的な監査機能を使用するためのマイグレーションの間に、変更された表に既存の行が含まれます。
• DATA CHANGE OPERATION 列には、既存の行のデフォルトの NULL 値が入力されます。
• クエリが実行されると、履歴テーブルには、STTのDATA CHANGE OPERATION列に関連付けられた列にNULL値を持つレコードが含まれます。

取るべき行動: IFCID 0376のトレースを開始します。 トレース出力では、機能コード 1215031 または 1202 が、影響を受けた照会を識別します。

APPLCOMPAT が V12R1M503 以上の場合、SET_MAINT_MODE_RECORD_NO_TEMPORALHISTORY ストアード・プロシージャーはサポートされません。

アプリケーション互換性レベル V12R1M503 以降では、 SYSPROC.SET_MAINT_MODE_RECORD_NO_TEMPORALHISTORY ストアドプロシージャを呼び出したユーザーまたはアプリケーションに対して、 Db2 はエラーを返します。

取るべき行動: IFCID 0376のトレースを開始します。 トレース出力では、機能コード 1215032 または 1203 は、SYSPROC.SET_MAINT_MODE_RECORD_NO_TEMPORALHISTORY ストアード・プロシージャーを使用するアプリケーションを識別します。 このようなアプリケーションを変更して、SYSIBMADM.REPLICATION_OVERRIDE 組み込みグローバル変数の値を代わりに「Y」に設定します。 詳細は SYSIBMADM.REPLICATION_OVERRIDE 組み込みグローバル変数を参照。

GRAPHICおよびVARGRAPHICを組み込み関数としてサポート

APPLCOMPATレベル V12R1M502、またはそれ以上のレベルで、環境にGRAPHICまたはVARGRAPHICという名前の既存のユーザー定義関数が含まれている場合、既存のユーザー定義関数への修飾されていない参照を持つアプリケーションは、特定の状況でユーザー定義関数の代わりに組み込み関数を起動し始めることがあります。

取るべき行動 ： Db2、意図したユーザー定義機能を確実に実行するを参照。

無効な入力と SQLCODE -138 エラーに対する SUBSTR 組み込み関数の変更

関数レベル V12R1M500 以降では (APPLCOMPAT レベルでは制御されません)、SUBSTR_COMPATIBILITY サブシステム・パラメータは、SUBSTR スカラ関数に記述されている要件を満たさない無効な引数に対して、SUBSTR 組み込み関数の呼び出しが一貫して SQLCODE -138 エラーを返すかどうかを指定します。 つまり、SUBSTR_COMPATIBILITYがCURRENTに設定されている場合、 Db2 、SUBSTR組み込み関数に関する文書化された規則が常に適用され、無効な入力に対してはSQLエラー・コードが返されます。 SUBSTR 組み込み関数の有効な入力規則の詳細については、. CURRENT設定での動作は、他のプラットフォームの Db2 との互換性を向上させる。

デフォルトのSUBSTR_COMPATIBILITYがPREVIOUSに設定されている場合、 Db2 、無効な入力に対して適切なエラー・メッセージを発行する代わりに、誤って結果を返すことがありました。 デフォルト値は「PREVIOUS」。 詳細については、 SUBSTR COMPATIBILITY フィールド（SUBSTR_COMPATIBILITY サブシステム・パラメータ ）を参照してください。

Db2 12 におけるこの変更の導入に関する詳細については、以下の APAR クロージングテキストを参照のこと。 PH36071.

取るべき行動: SUBSTR_COMPATIBILITY サブシステム・パラメータを CURRENT に設定する前に、この変更を処理するためにアプリケーションの一部を変更する必要があるかもしれません。 IFCID 0376 のトレースを有効にした場合、トレース出力の QW0376FN フィールドにあるファンクション識別子 '14' の値は、この変更によって影響を受ける可能性のあるアプリケーションを特定します。

ROLLBACK に対する KEEPDYNAMIC(YES) バインド・オプションのサポート

APPLCOMPAT レベル V12R1M500 以降では、KEEPDYNAMIC(YES) バインド・オプションは COMMIT 文と ROLLBACK 文の両方に影響します。 KEEPDYNAMIC(YES) では、パッケージ内の動的 SQL ステートメントは COMMIT または ROLLBACK の後に保持され、それらのステートメントは、別の PREPARE なしで再度実行可能です。 この変更により、以下のような違いが生じる：

• PREPARE 文が先行しない OPEN 文では、SQLCODE -514 エラーは発生しません。
• PREPARE 文が先行しない EXECUTE 文では、SQLCODE -518 エラーは発生しません。

より低い APPLCOMPAT レベルでは、KEEPDYNAMIC(YES) バインド・オプションは COMMIT 文にのみ適用されます。 ROLLBACK文の後、動的SQL文が実行できるように、別のPREPAREが必要です。 つまり、KEEPDYNAMIC(YES)でバインドされたパッケージは、ROLLBACKが発行された後、再び動的SQL文を準備する必要がありました。

取るべき行動: KEEPDYNAMIC(YES)バインドオプションを使用しているパッケージを見直す。 ROLLBACK文の実行後にSQL文を再度準備するPREPARE文を削除することで、KEEPDYNAMIC(YES)でバインドされた動的SQLプログラムをより効率的に実行することができます。 APPLCOMPATレベル V11R1 またはそれ以前のプログラムを実行する必要がなくなったと確信できるまでは、この処置をとらないでください。 詳細はプリペアド・ステートメントをコミットやロールバックの時点以降も保持する方法と KEEPDYNAMICバインド・オプションを参照してください。

POWER 組み込み関数は、範囲外の DOUBLE 結果に対して警告 SQLCODE を返します

APPLCOMPAT レベル V12R1M500 以降で、DOUBLE 引数を持つ POWER® 組み込み関数を範囲外の結果で呼び出すと、SQLCODE +802 警告が返される場合があります。 例えば、以下のクエリはSQLCODE +802の警告を返します：

SELECT POWER(DOUBLE(2.0E38), DOUBLE(2.0))
 FROM SYSIBM.SYSDUMMY1;

より低いAPPLCOMPATレベルでは、 Db2 、このような状況で-802を発行する。

取るべきアクション ： 返されたSQLCODEがエラーから警告に変更されたことを考慮して、エラー処理を調整してください。 IFCID 0376 のトレースを有効にした場合、トレース出力の QW0376FN フィールドにあるファンクション識別子 '1201' の値は、この変更によって影響を受ける可能性のあるアプリケーションを特定します。

CAST (string AS TIMESTAMP) 結果が変わる

APPLCOMPAT レベル V11R1 以降では、CAST (string AS TIMESTAMP) の結果が変更される場合があります。 つまり、8バイト文字列または13バイト文字列がCAST (string AS TIMESTAMP)に入力されると、 Db2 、入力文字列はTIMESTAMP値の文字列表現として解釈される。 CAST (string AS TIMESTAMP) の 8 バイトまたは 13 バイト文字列の表現が無効な場合、SQLCODE -180 エラーが発生します。 例えば、次の最初のSELECT文の結果は 2013-01-01-00.00.00.000000、これは正しい結果である。 2番目のSELECT文の結果はSQLCODE -180エラーです。これは、Store Clock値がCAST (string AS TIMESTAMP)の有効な入力ではないためです。

-- SET APPLICATION COMPATIBILITY TO V11R1
SET CURRENT APPLICATION COMPATIBILITY='V11R1';
-- CAST AN 8-BYTE STRING REPRESENTATION OF A DATETIME VALUE
-- TO TIMESTAMP
SELECT CAST('1/1/2013' AS TIMESTAMP) FROM SYSIBM.SYSDUMMY1;
-- CAST AN 8-BYTE STRING REPRESENTATION OF A STORE CLOCK VALUE
-- TO TIMESTAMP
SELECT CAST(X'CAB5060708090100' AS TIMESTAMP) FROM SYSIBM.SYSDUMMY1;

より低いAPPLCOMPATレベルでは、 Db2 、CAST (string AS TIMESTAMP)を実行すると、 Db2 、8バイト文字列をStore Clock値として、13バイト文字列をGENERATE_UNIQUE値として解釈する。 この解釈では、CAST 指定による結果が正しくないものになる可能性があります。 例えば、最初のSELECT文の結果は 2034-07-25-16.43.41.599503、これは正しくない結果である。 2 つ目の SELECT ステートメントの結果は 2013-01-01-20.37.04.246928 で、入力ストリングがストア・クロック値として解釈される場合はこれは正しい結果です。

-- SET APPLICATION COMPATIBILITY TO V10R1
SET CURRENT APPLICATION COMPATIBILITY='V10R1';
-- CAST AN 8-BYTE STRING REPRESENTATION OF A DATETIME VALUE
-- TO TIMESTAMP
SELECT CAST('1/1/2013' AS TIMESTAMP) FROM SYSIBM.SYSDUMMY1;
-- CAST AN 8-BYTE STRING REPRESENTATION OF A STORE CLOCK VALUE
-- TO TIMESTAMP
SELECT CAST(X'CAB5060708090100' AS TIMESTAMP) FROM SYSIBM.SYSDUMMY1;

対処法 ： IFCID 0376 のトレースを有効にした場合、トレース出力の QW0376FN フィールドにあるファンクション識別子「1109」値は、この変更によって影響を受ける可能性のあるアプリケーションを特定します。

ストア・クロック値を TIMESTAMP データ・タイプに変換する必要がある場合は、CAST(string AS TIMESTAMP) の代わりに TIMESTAMP 組み込み関数を使用してください。 例えば、以下の文は正しい結果、 2013-01-01-20.37.04.246928 を返す。

-- SET APPLICATION COMPATIBILITY TO V11R1
SET CURRENT APPLICATION COMPATIBILITY='V11R1';
-- CONVERT AN 8-BYTE STRING REPRESENTATION OF A STORE CLOCK VALUE
-- TO TIMESTAMP
SELECT TIMESTAMP(X'CAB5060708090100') FROM SYSIBM.SYSDUMMY1;

CURRENT CLIENTの特殊レジスタ長が増加

APPLCOMPATレベル V11R1 またはそれ以上から、以下の特殊レジスタ値はより大きな長さの値を返す可能性があり、値はサポートされる最大長にパディングされず、末尾の空白は取り除かれる。

特殊レジスター	新しい最大長	以前の最大長	QW0376FN 関数コード
CURRENT CLIENT_ACCTNG	255 バイト	200 バイト	'1104'
現在のクライアントアプリ名	255 バイト	32 バイト	'1105'
CURRENT CLIENT_USERID	128 バイト	16 バイト	'1106'
現在のクライアント名	255 バイト	18 バイト	'1107'

対処法 ： IFCID 0376 のトレースを有効にした場合、トレース出力の QW0376FN フィールドにある以下のファンクションレベル識別 子の値によって、この変更によって影響を受ける可能性のあるアプリケーションが特定されます（前掲の表 に示すとおり）：'1104'、'1105'、'1106'、または '1107'。

ダイナミックSQLのRLF実施に伴うASUTIME制限の変更

APPLCOMPAT レベル V11R1 以降では、同じスレッドで複数のパッケージが呼び出される場合、リソース制限機能（RLF）は各パッケージに指定された ASUTIME 制限を実施し、トップレベルの呼び出しパッケージに指定された ASUTIME 制限は考慮されません。 パッケージ内の動的 SQL 文がそのパッケージで指定された制限を超える ASUTIME を使用すると、 Db2 は SQLCODE -905 エラーを返します。 各パッケージに対して制限が適用されるため、アプリケーションはより頻繁にSQLCODE -905エラーを返す可能性があります。

また、各パッケージのAPPLCOMPATレベルは、呼び出すパッケージのAPPLCOMPATレベルに関係なく、新しい動作を制御する。 つまり、RLFは、それ自体がAPPLCOMPATレベル V11R1 またはそれ以上にバインドされているパッケージ内の動的SQL文に指定されたASUTIME制限を、たとえそれが V10R1 でバインドされているパッケージによって呼び出されたとしても強制します。

より低いAPPLCOMPATレベル V10R、 Db2 は、スレッド全体に対するトップレベルの呼び出しパッケージの制限に遭遇した場合にのみ、SQLCODE -905エラーを発行する。

取るべき行動: 動的SQLを使用するルーチンとパッケージのASUTIME制限を見直し、必要に応じて調整する。 IFCID 0376 のトレースを有効にした場合、トレース出力の QW0376FN フィールドにあるファンクション識別子 '1103' の値は、この変更によって影響を受ける可能性のあるアプリケーションを特定します。

XPath処理は、フィルタリングされた結果でエラーが発生したまま続行される

APPLCOMPATレベル V11R1 以降では、XPath処理は、明示的なキャストを含む述語式や、無効な値を含む演算で、より少ないエラーを返すかもしれません。 より少ないエラーを返す可能性が高いXPath式の例には、次のような状況があります：

• ゼロ除算などの無効な演算の前に、述部によってデータが結果からフィルタリングされる
• データが非互換データ・タイプに明示的にキャストされる

XPath式の使用については、 XPath式による出力のフィルタリングと XMLデータの選択を参照してください。

取るべき行動: XPath処理を使用するアプリケーションのエラー処理を見直す。 IFCID 0376 のトレースを有効にした場合、トレース出力の QW0376FN フィールドにあるファンクション識別子 '1102' の値は、この変更によって影響を受ける可能性のあるアプリケーションを特定します。

XMLカラムの挿入と更新のために暗黙的に追加されるXMLドキュメント・ノード

APPLCOMPAT V11R1 以降では、アプリケーションがXML列を挿入または更新すると、 Db2 、XMLドキュメントにまだノードが含まれていなければ、暗黙的にXMLドキュメント・ノードが追加されます。

より低い関数レベルでは、アプリケーションが挿入または更新の前にXMLDOCUMENT関数も呼び出さない限り、 Db2 、この状況でSQLCODE -20345エラーが発生します。

取るべき行動: XMLDOCUMENT関数を使用するアプリケーションを見直してください。 IFCID 0376 のトレースを有効にした場合、トレース出力の QW0376FN フィールドにあるファンクション識別子 '1101' の値は、この変更によって影響を受ける可能性のあるアプリケーションを特定します。