SET FMTONLY (Transact-SQL)SET FMTONLY (Transact-SQL)

ESTE TEMA SE APLICA A: síSQL Server (a partir de 2008)síAzure SQL DatabasesíAzure SQL Data Warehouse síAlmacenamiento de datos paralelos THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Devuelve solo metadatos al cliente.Returns only metadata to the client. Se puede usar para probar el formato de la respuesta sin ejecutar realmente la consulta.Can be used to test the format of the response without actually running the query.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

SET FMTONLY { ON | OFF }   

ComentariosRemarks

Cuando se establece SET FMTONLY en ON, no se procesa ni se envía al cliente ninguna fila como resultado de una solicitud.No rows are processed or sent to the client because of the request when SET FMTONLY is turned ON.

La opción SET FMTONLY se establece en tiempo de ejecución, no en tiempo de análisis.The setting of SET FMTONLY is set at execute or run time and not at parse time.

PermissionsPermissions

Debe pertenecer al rol public.Requires membership in the public role.

EjemplosExamples

R: ver la información de encabezado de columna para una consulta sin ejecutar realmente la consulta.A: View the column header information for a query without actually running the query.

En el ejemplo siguiente se cambia el valor de SET FMTONLY a ON y se ejecuta una instrucción SELECT.The following example changes the SET FMTONLY setting to ON and executes a SELECT statement. La opción hace que la instrucción solo devuelva la información de las columnas, sin ninguna fila de datos.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  

Ejemplos: Almacenamiento de datos SQL de AzureAzure SQL Data Warehouse y Almacenamiento de datos paralelosParallel Data WarehouseExamples: Almacenamiento de datos SQL de AzureAzure SQL Data Warehouse and Almacenamiento de datos paralelosParallel Data Warehouse

B.B. Ver la información de encabezado de columna para una consulta sin ejecutar realmente la consulta.View the column header information for a query without actually running the query.

En el ejemplo siguiente se muestra cómo devolver únicamente la información de encabezado (metadatos) de columna de una consulta.The following example shows how to return only the column header (metadata) information for a query. El lote comienza con FMTONLY establecida en OFF y cambia FMTONLY en ON antes de la instrucción SELECT.The batch begins with FMTONLY set to OFF and changes FMTONLY to ON before the SELECT statement. Esto hace que la instrucción SELECT devolver sólo los encabezados de columna; se devuelve ninguna fila de datos.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  

Vea tambiénSee Also

Instrucciones SET (Transact-SQL)SET Statements (Transact-SQL)