SET OFFSETS (Transact-SQL)

Transact-SQL ステートメント内の指定したキーワードのオフセット (ステートメントの先頭からの相対的な位置) を、DB-Library アプリケーションに返します。

重要
この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。

Transact-SQL 構文表記規則

構文

SET OFFSETS keyword_list { ON | OFF }

引数

• keyword_list
  SELECT、FROM、ORDER、COMPUTE、TABLE、PROCEDURE、STATEMENT、PARAM、EXECUTE などの Transact-SQL 構成要素をコンマで区切って指定します。

説明

SET OFFSETS は DB-Library アプリケーションだけで使用されます。

SET OFFSETS は、実行時ではなく、解析時に設定されます。解析時に設定されるということは、SET ステートメントがバッチまたはストアド プロシージャ内に指定されている場合、コードが実際にその場所まで実行されるかどうかに関係なく、設定が有効になることを意味します。つまり他のどのステートメントが実行されるよりも前に、SET ステートメントが効力を発するということになります。たとえば、絶対に実行されることのない IF...ELSE ステートメント ブロックに SET ステートメントが指定されていたとしても、IF...ELSE ステートメント ブロックは解析されるので、SET ステートメントは有効になります。

SET OFFSETS がストアド プロシージャで設定された場合、SET OFFSETS の値は、制御がストアド プロシージャから返された後、元に戻されます。したがって、動的 SQL に指定されている SET OFFSETS ステートメントは、動的 SQL ステートメントの後にあるステートメントにまったく影響しません。

OFFSETS オプションが ON でエラーがない場合は、SET PARSEONLY はオフセットを返します。

権限

public ロールのメンバシップが必要です。

関連項目

参照

SET (Transact-SQL)

SET PARSEONLY (Transact-SQL)