適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL データベース
Transact-SQL ステートメント内の指定されたキーワードのオフセット (ステートメントの先頭からの相対的な位置) を、DB-Library アプリケーションに返します。
重要
この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。
構文
SET OFFSETS keyword_list { ON | OFF }
引数
keyword_list
はSELECT、FROM、ORDER、 TABLE、 PROCEDURE、STATEMENT、PARAM、EXECUTEなどの Transact-SQL 構成文をカンマ区切ってリストしています。
解説
SET OFFSETS DB-Library 用途でのみ使用されています。
SET OFFSETSの設定は実行時や実行時ではなく、構文解析時に設定されます。 構文解析時に設定する場合、 SET 文がバッチやストアドプロシージャに存在すれば、コード実行が実際にその時点に達したかどうかに関わらず設定が有効となります。また、 SET 文は文が実行される前に有効となります。 例えば、集合文がIFに入っていても...実行中に一度も到達しないELSE文ブロックは、 SET 文は依然として有効となります。なぜなら、IF...ELSE文ブロックは解析されます。
SET SET OFFSETSがストアドプロシージャに設定されている場合、制御がストアドプロシージャから返されるとSETSET OFFSETSの値は復元されます。 したがって、動的 SQL に指定されている SET OFFSETS ステートメントは、動的 SQL ステートメントの後にあるステートメントにまったく影響しません。
SET SET PARSEONLY OFFSETSオプションがONでエラーが起きない場合、オフセットを返します。
アクセス許可
ロール public のメンバーシップが必要です。