SET FMTONLY (Transact-SQL)

SET FMTONLY (Transact-SQL)

 

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008) yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Returns only metadata to the client. Can be used to test the format of the response without actually running the query.

Topic link icon Transact-SQL Syntax Conventions


SET FMTONLY { ON | OFF } 
-- Azure SQL Data Warehouse and Parallel Data Warehouse
SET FMTONLY { ON | OFF } [;] 

No rows are processed or sent to the client because of the request when SET FMTONLY is turned ON.

The setting of SET FMTONLY is set at execute or run time and not at parse time.

Requires membership in the public role.

The following example changes the SET FMTONLY setting to ON and executes a SELECT statement. The setting causes the statement to return the column information only; no rows of data are returned.

USE AdventureWorks2012;
GO
SET FMTONLY ON;
GO
SELECT * 
FROM HumanResources.Employee;
GO
SET FMTONLY OFF;
GO

The following example shows how to return only the column header (metadata) information for a query. The batch begins with FMTONLY set to OFF and changes FMTONLY to ON before the SELECT statement. This causes the SELECT statement to return only the column headers; no rows of data are returned.

-- Uses AdventureWorks

BEGIN
    SET FMTONLY OFF;
    SET DATEFORMAT mdy;
    SET FMTONLY ON;
    SELECT * FROM dbo.DimCustomer;
    SET FMTONLY OFF;
END

Community Additions

ADD
Show:
© 2016 Microsoft