sys.dm_exec_describe_first_result_set (Transact-SQL)

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz

Diese dynamische Verwaltungsfunktion verwendet eine Transact-SQL-Anweisung als Parameter und beschreibt die Metadaten des ersten Resultsets für die Anweisung.

sys.dm_exec_describe_first_result_set hat dieselbe Resultsetdefinition wie sys.dm_exec_describe_first_result_set_for_object (Transact-SQL) und ist mit sp_describe_first_result_set (Transact-SQL) vergleichbar.

Transact-SQL-Syntaxkonventionen

Syntax

  
sys.dm_exec_describe_first_result_set(@tsql, @params, @include_browse_information)  

Argumente

@tsql
Mindestens eine Transact-SQL-Anweisung. Transact-SQL_batch kann nvarchar(n) oder nvarchar(max) sein.

@params
@params stellt eine Deklarationszeichenfolge für Parameter für den Transact-SQL-Batch bereit, ähnlich wie sp_executesql. Parameter können nvarchar(n) oder nvarchar(max) sein.

Eine Zeichenfolge, die die Definitionen aller in Transact-SQL_batch eingebetteten Parameter enthält. Die Zeichenfolge muss eine Unicode-Konstante oder eine Unicode-Variable sein. Jede Parameterdefinition besteht aus einem Parameternamen und einem Datentyp. n ist ein Platzhalter für zusätzlicher Parameterdefinitionen. Jeder in stmt angegebene Parameter muss in @params definiert werden. Wenn die Transact-SQL-Anweisung oder der Batch in der Anweisung keine Parameter enthält, ist @params nicht erforderlich. Der Standardwert für diesen Parameter ist NULL.

@include_browse_information
Bei 1 werden alle Abfragen so analysiert, als ob die FOR BROWSE-Option in der Abfrage enthalten wäre. Zusätzliche Schlüsselspalten und Quelltabelleninformationen werden zurückgegeben.

Zurückgegebene Tabelle

Diese gemeinsamen Metadaten werden als Resultset zurückgegeben. In den Ergebnismetadaten sind in einer Zeile pro Spalte der Typ und die NULL-Zulässigkeit der Spalte in dem in der folgenden Tabelle dargestellten Format beschrieben. Wenn die erste Anweisung nicht für alle Steuerelementpfade vorhanden ist, wird ein Resultset mit 0 Zeilen zurückgegeben.

Hinweise

Diese Funktion verwendet den gleichen Algorithmus wie sp_describe_first_result_set. Weitere Informationen finden Sie unter sp_describe_first_result_set (Transact-SQL).

In der folgenden Tabelle werden die Fehlertypen und deren Beschreibungen aufgeführt.

Berechtigungen

Erfordert die Berechtigung zur Ausführung des @tsql-Arguments.

Beispiele

Weitere Beispiele im Thema sp_describe_first_result_set (Transact-SQL) können an die Verwendung von sys.dm_exec_describe_first_result_set angepasst werden.

A. Zurückgeben von Informationen zu einer einzelnen Transact-SQL-Anweisung

Der folgende Code gibt Informationen zu den Ergebnissen einer Transact-SQL-Anweisung zurück.

USE AdventureWorks2022;  
GO  
SELECT * FROM sys.dm_exec_describe_first_result_set  
(N'SELECT object_id, name, type_desc FROM sys.indexes', null, 0) ;  

B. Zurückgeben von Informationen zu einer Prozedur

Im folgenden Beispiel wird eine gespeicherte Prozedur namens pr_TestProc erstellt, die zwei Resultsets zurückgibt. Anschließend wird veranschaulicht, dass sys.dm_exec_describe_first_result_set Informationen zum ersten Resultset in der Prozedur zurückgibt.

USE AdventureWorks2022;  
GO  
  
CREATE PROC Production.TestProc  
AS  
SELECT Name, ProductID, Color FROM Production.Product ;  
SELECT Name, SafetyStockLevel, SellStartDate FROM Production.Product ;  
GO  
  
SELECT * FROM sys.dm_exec_describe_first_result_set  
('Production.TestProc', NULL, 0) ;  

C. Zurückgeben von Metadaten von einem Batch mit mehreren Anweisungen

Im folgenden Beispiel wird ein Batch ausgewertet, der zwei Transact-SQL-Anweisungen enthält. Das Resultset beschreibt das erste zurückgegebene Resultset.

USE AdventureWorks2022;  
GO  
  
SELECT * FROM sys.dm_exec_describe_first_result_set(  
N'SELECT CustomerID, TerritoryID, AccountNumber FROM Sales.Customer WHERE CustomerID = @CustomerID;  
SELECT * FROM Sales.SalesOrderHeader;',  
N'@CustomerID int', 0) AS a;  
GO  

Weitere Informationen

sp_describe_first_result_set (Transact-SQL)
sp_describe_undeclared_parameters (Transact-SQL)
sys.dm_exec_describe_first_result_set_for_object (Transact-SQL)