現象
Transact-SQL で実装され、単一のデータ値を返す User-Defined 関数 (UDF) は、T-SQL スカラー User-Defined 関数 (UDF) と呼ばれます。
スカラー UDF インライン機能は、Microsoft SQL Server 2019 で導入されました。 この機能により、UDF の実行が主なボトルネックである T-SQL スカラー UDF を呼び出すクエリのパフォーマンスを向上させることができます。 T-SQL スカラー UDF インライン処理は、インライン対応 UDF をリレーショナル式に自動的に変換します。
この累積的な更新プログラム (CU) には、スカラー UDF インライン処理を使用するクエリがエラー メッセージや予期しない結果を返す可能性があるシナリオに対して、次の領域にわたるいくつかの 修正 プログラムが含まれています。
- UDF の戻り値の型が
sql_variant(SQL Server 2019 CU2 で追加) の場合、型不一致エラーが発生します。 -
sp_executesqlからの UDF 呼び出しは実行を取り消します (SQL Server 2019 CU2 で追加)。 - 関連付けられた
GOTOコマンドのないラベルを参照する UDF は正しくない結果を返します (SQL Server 2019 CU2 で追加)。 - 非常に大きなスカラー UDF (SQL Server 2019 CU2 で追加) が原因でメモリ不足状態とメモリ リークが発生します。
- 条件 (
IF-ELSE) ステートメントで使用される初期化されていない変数によりエラーが発生する (SQL Server 2019 CU2 で追加)。 - UDF に
sql_variantパラメーター (SQL Server 2019 CU7 で追加) がある場合、明示的な変換エラーが発生します。 - スカラー関数が
CHECKSUM(SQL Server 2019 CU7 で追加) を参照している場合、エラーが発生します。 - 多くのスカラー式の再評価を伴う UDF 呼び出しでは、Non-yielding スケジューラ エラーが発生する可能性があります (SQL Server 2019 CU7 で追加)。
注: この問題の修正プログラムは、パフォーマンスがリグレッションする場合があります。 このパフォーマンス低下を軽減するには、トレース フラグ (TF) 13156 をオンにして、元の修正プログラムを無効にします。
マイクロソフトは、このパフォーマンス回帰の修正に取り組んでいます。この修正プログラムは、将来の CU で利用可能になります。 - UDF 参照クエリで
OPTION (RECOMPILE)(SQL Server 2019 CU7 で追加) が使用されている場合、エラーが発生します。 - ビューがインライン UDF (SQL Server 2019 CU9 で追加) を呼び出すと、アクセス許可エラーが発生する。
-
query_tsql_scalar_udf_inlinedXEvent (SQL Server 2019 CU9 で追加) が使用されている場合、アクセス違反が発生します。 - スカラー UDF インライン処理が
QUERY_OPTIMIZER_COMPATIBILITY_LEVEL_nクエリ ヒント (SQL Server 2019 CU9 で追加) を尊重しないために、矛盾した動作が発生する。 - インライン UDF には、非生成スケジューラ エラーを引き起こす可能性のある集計が含まれています (SQL Server 2019 CU9 で追加)。
- メモリ不足エラーは、条件付きブロック内の同じ変数に対する一連のスカラー操作が原因で発生します (SQL Server 2019 CU9 で追加)。
- CU9 にアップグレードした後、オブジェクトが入力パラメーターとして使用されるスカラーインライン可能 UDF (UDF1) を持つスカラーインライン可能 UDF (UDF2) を呼び出すと、アクセス違反が発生します (SQL Server 2019 CU11 で追加)。
- UDF をインラインするとエラーが発生し、エラー コード 6846、1011、および 107 (SQL Server 2019 CU11 で追加) が生成される場合があります。
- sysadmin 以外のアカウントとして実行される UDF をインライン化すると、"現在のコマンドで重大なエラーが発生しました。 結果があれば破棄する必要があります" (SQL Server 2019 CU16 で追加)。
- 一時テーブルがシノニム (Microsoft SQL Server 2022 CU1 および SQL Server 2019 CU19 で追加) を使用して UDF 内で呼び出されると、アクセス違反が発生します。
- UDF 定義に
GOTOラベルとRETURNステートメント (SQL Server 2022 CU1 および SQL Server 2019 CU19 で追加) のみが含まれている場合、アクセス違反が発生します。 - スカラー UDF は、スカラー UDF インライン機能がオンになっている場合、異なる日付と時刻の形式で結果を返します (SQL Server 2022 CU3 および SQL Server 2019 CU20 で追加)。
-
GROUP BY句を持つクエリが、集計関数 (SQL Server 2022 CU12 および SQL Server 2019 CU26 で追加) を使用せずにSELECTステートメントでインライン UDF を使用すると、ダンプ ファイルが生成されます。 - ネスティング レベルを超えていない場合でも、スカラー UDF インライン機能がオンになっていると、エラー "最大ストアド プロシージャ、関数、トリガー、またはビューの入れ子レベルを超えました (制限 32)"というエラーが発生します (SQL Server 2022 CU12 および SQL Server 2019 CU26 で追加)。
- スカラー UDF インライン機能がオンになっている場合、
sqllang.dll!CProchdr::FDeriveInlineabilityOfScalarUdfでメモリ破損が発生します (SQL Server 2022 CU12 および SQL Server 2019 CU26 で追加)。 - 同じクエリでスカラー UDF インラインと
OPTION (RECOMPILE)の組み合わせが原因で正しくない結果が発生します (SQL Server 2022 CU17 および SQL Server 2019 CU31 で追加)。
この累積的な更新プログラムは、次のシナリオでもインラインを ブロックします 。
- UDF が特定の組み込み関数 (
@@ROWCOUNTなど) を参照している場合、UDF がインライン化されている場合、結果が変更される可能性があります (SQL Server 2019 CU2 で追加)。 - 集計関数がパラメーターとしてスカラー UDF に渡される場合 (SQL Server 2019 CU2 で追加)。
- UDF が組み込みビュー (
OBJECT_IDなど) を参照している場合 (SQL Server 2019 CU2 で追加)。 - UDF で XML メソッドが使用されている場合 (SQL Server 2019 CU4 で追加)。
- UDF に
ORDER BY句が使用されているがTOP 1を使用しないSELECTステートメントが含まれている場合 (SQL Server 2019 CU4 で追加)。 -
SELECTステートメントがORDER BY句 (SELECT @x = @x +1 FROM table ORDER BY column_nameなど) と一緒に代入を実行する場合 (SQL Server 2019 CU4 で追加)。 - UDF に複数の
RETURNステートメント (SQL Server 2019 CU5 で追加) が含まれている場合。 - UDF が
RETURNステートメントから呼び出される場合 (SQL Server 2019 CU5 で追加)。 - UDF が
STRING_AGG関数 (SQL Server 2019 CU5 で追加) を参照している場合。 - UDF 定義がリモート テーブル (SQL Server 2019 CU6 で追加) を参照している場合。
- UDF 呼び出しクエリが
GROUPING SETS、CUBE、またはROLLUP(SQL Server 2019 CU6 で追加) を使用している場合。 - UDF 呼び出しクエリに、割り当ての UDF パラメーターとして使用される変数 (
SELECT @y=2, @x=UDF(@y)など) が含まれている場合 (SQL Server 2019 CU6 で追加)。 - UDF が暗号化された列 (SQL Server 2019 CU11 で追加) を参照している場合。
- UDF に
WITH XMLNAMESPACES(SQL Server 2019 CU11 で追加) への参照が含まれている場合。 - UDF を呼び出すクエリに共通テーブル式 (CTE) (SQL Server 2019 CU11 で追加) がある場合。
- UDF 定義に一時テーブルまたは一時テーブルの類義語が含まれている場合 (SQL Server 2022 CU1 および SQL Server 2019 CU19 で追加)。
- UDF 定義に複数の代入列に
SELECTステートメントと複数の代入列に関するDISTINCT句 (SQL Server 2022 CU4 および SQL Server 2019 CU20 で追加) がある場合)。 - UDF に
TABLESAMPLE PERCENT句と複数の変数割り当てを使用するSELECTステートメントが含まれている場合 (SQL Server 2022 CU7 で追加)。 - UDF を含むインデックス付きビューによって参照されているテーブルに
INSERTクエリが存在する場合 (SQL Server 2022 CU12 および SQL Server 2019 CU26 で追加)。
SQL Server 2019 CU2 にアップグレードした後、SQL Server 2019 CU5 にアップグレードする前に、UDF がインライン化の対象かどうかを再評価する必要があります。 これを行うには、次のいずれかの方法で適格なスカラー UDF を更新します。
- 適用可能なスカラー UDF に対して
sp_refreshsqlmoduleを実行します。 このシステム ストアド プロシージャの詳細については、「 sp_refreshsqlmodule (Transact-SQL)」を参照してください。 - 既存の定義、アクセス許可、およびセット プロパティを使用して、既存のスカラー UDF を変更または再作成します。 詳細については、「 ALTER FUNCTION (Transact-SQL)」を参照してください。
次のコマンドは、既存のインライン スカラー UDF のメタデータを更新するスクリプトを生成します。
/*
Generates a script that can be used to refresh all active inlineable scalar UDFs.
Note The sp_refreshsqlmodule command does not affect any permissions, extended properties, or SET options that are associated with the object.
*/
SELECT 'EXECUTE sys.sp_refreshsqlmodule ''[' + OBJECT_SCHEMA_NAME(object_id) + +'].' + '[' + OBJECT_NAME(object_id)
+ ']'';' AS 'RefreshStatement'
FROM sys.sql_modules
WHERE is_inlineable = 1
AND inline_type = 1;
GO
注: SQL Server 2019 CU5 にアップグレードすると、コンパイル中に UDF インライン可能性の自動派生が再開されます。
解決策
この問題は、次の SQL Server の累積的な更新プログラムで修正されています。
SQL Server 用の累積的な更新プログラムについて
SQL Server 用の新しい累積的な更新プログラムには、以前の累積的な更新プログラムに含まれていたすべての修正プログラムとすべてのセキュリティ修正プログラムが含まれています。 SQL Server の最新の累積的な更新プログラムを確認してください。
状態
マイクロソフトでは、この問題をこの資料の対象製品として記載されているマイクロソフト製品の問題として認識しています。
参考資料
マイクロソフトでソフトウェア更新プログラムの説明に使用する用語集を参照してください。