| description | SET OFFSETS (Transact-SQL) | ||||
|---|---|---|---|---|---|
| title | SET OFFSETS (Transact-SQL) | Microsoft Docs | ||||
| ms.custom | |||||
| ms.date | 06/10/2016 | ||||
| ms.prod | sql | ||||
| ms.prod_service | database-engine, sql-database | ||||
| ms.reviewer | |||||
| ms.technology | t-sql | ||||
| ms.topic | reference | ||||
| f1_keywords |
|
||||
| dev_langs |
|
||||
| helpviewer_keywords |
|
||||
| ms.assetid | c7bcc697-0930-4630-acae-d8ccbfa4414c | ||||
| author | WilliamDAssafMSFT | ||||
| ms.author | wiassaf |
[!INCLUDE SQL Server SQL Database]
Returns the offset (position relative to the start of a statement) of specified keywords in [!INCLUDEtsql] statements to DB-Library applications.
Important
[!INCLUDEssNoteDepFutureAvoid]
Transact-SQL Syntax Conventions
SET OFFSETS keyword_list { ON | OFF }
[!INCLUDEsql-server-tsql-previous-offline-documentation]
keyword_list
Is a comma-separated list of [!INCLUDEtsql] constructs including SELECT, FROM, ORDER, TABLE, PROCEDURE, STATEMENT, PARAM, and EXECUTE.
SET OFFSETS is used only in DB-Library applications.
The setting of SET OFFSETS is set at parse time and not at execute time or run time. Setting at parse time means that if the SET statement is present in the batch or stored procedure, the setting takes effect, regardless of whether code execution actually reaches that point; and the SET statement takes effect before any statements are executed. For example, even if the set statement is in an IF...ELSE statement block that is never reached during execution, the SET statement still takes effect because the IF...ELSE statement block is parsed.
If SET OFFSETS is set in a stored procedure, the value of SET OFFSETS is restored after control is returned from the stored procedure. Therefore, a SET OFFSETS statement specified in dynamic SQL does not have any effect on any statements following the dynamic SQL statement.
SET PARSEONLY returns offsets if the OFFSETS option is ON and no errors occur.
Requires membership in the public role.