sys.fn_stmt_sql_handle_from_sql_stmt (Transact-SQL)sys.fn_stmt_sql_handle_from_sql_stmt (Transact-SQL)

Anwendungsbereich:Applies to: JaSQL Server 2016 (13.x)SQL Server 2016 (13.x)yesSQL Server 2016 (13.x)SQL Server 2016 (13.x) und höher JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL Database JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceAnwendungsbereich:Applies to: JaSQL Server 2016 (13.x)SQL Server 2016 (13.x)yesSQL Server 2016 (13.x)SQL Server 2016 (13.x) and later JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL Database JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed Instance

Ruft den stmt_sql_handle für eine Transact-SQLTransact-SQL Anweisung unter dem angegebenen parameterisierungstyp (einfach oder erzwungen) ab.Gets the stmt_sql_handle for a Transact-SQLTransact-SQL statement under given parameterization type (simple or forced). Dies ermöglicht es Ihnen, auf Abfragen zu verweisen, die in der Abfragespeicher gespeichert sind, indem Sie Ihre stmt_sql_handle verwenden, wenn Sie Ihren Text kennen.This allows you to refer to queries stored in the Query Store by using their stmt_sql_handle when you know their text.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

sys.fn_stmt_sql_handle_from_sql_stmt   
(  
    'query_sql_text',   
    [ query_param_type   
) [;]  

ArgumenteArguments

query_sql_textquery_sql_text
Der Text der Abfrage im Abfrage Speicher, für den Sie das Handle benötigen.Is the text of the query in the query store that you want the handle of. query_sql_text ist vom Datentyp nvarchar (max) und hat keinen Standardwert.query_sql_text is a nvarchar(max), with no default.

query_param_typequery_param_type
Der Parametertyp der Abfrage.Is the parameter type of the query. query_param_type ist ein tinyint-Wert.query_param_type is a tinyint. Mögliche Werte:Possible values are:

  • NULL-der Standardwert ist 0.NULL - defaults to 0

  • 0 – Keine0 - None

  • 1-Benutzer1 - User

  • 2: einfach2 - Simple

  • 3-erzwungene3 - Forced

Zurückgegebene SpaltenColumns Returned

In der folgenden Tabelle sind die Spalten aufgelistet, die von sys. fn_stmt_sql_handle_from_sql_stmt zurückgegeben werden.The following table lists the columns that sys.fn_stmt_sql_handle_from_sql_stmt returns.

SpaltennameColumn name typeType BESCHREIBUNGDescription
statement_sql_handlestatement_sql_handle varbinary(64)varbinary(64) Das SQL-handle.The SQL handle.
query_sql_textquery_sql_text nvarchar(max)nvarchar(max) Der Text der Transact-SQLTransact-SQL Anweisung.The text of the Transact-SQLTransact-SQL statement.
query_parameterization_typequery_parameterization_type tinyinttinyint Der parameterisierungstyp der Abfrage.The query parameterization type.

RückgabecodewerteReturn Code Values

„0“ (erfolgreich) oder „1“ (fehlerhaft)0 (success) or 1 (failure)

BemerkungenRemarks

BerechtigungenPermissions

Erfordert die Execute -Berechtigung für die Datenbank und die Delete -Berechtigung für die Katalog Sichten des Abfrage Speicher.Requires the EXECUTE permission on the database, and DELETE permission on the query store catalog views.

BeispieleExamples

Im folgenden Beispiel wird eine-Anweisung ausgeführt, und dann wird verwendet, sys.fn_stmt_sql_handle_from_sql_stmt um das SQL-Handle dieser Anweisung zurückzugeben.The following example executes a statement, and then uses sys.fn_stmt_sql_handle_from_sql_stmt to return the SQL handle of that statement.

SELECT * FROM sys.databases;   
SELECT * FROM sys.fn_stmt_sql_handle_from_sql_stmt('SELECT * FROM sys.databases', NULL);  

Verwenden Sie die-Funktion, um Abfragespeicher Daten mit anderen dynamischen Verwaltungs Sichten zu korrelieren.Use the function to correlate Query Store data with other dynamic management views. Im folgenden Beispiel:The following example:

SELECT qt.query_text_id, q.query_id, qt.query_sql_text, qt.statement_sql_handle,  
q.context_settings_id, qs.statement_context_id   
FROM sys.query_store_query_text AS qt  
JOIN sys.query_store_query AS q   
    ON qt.query_text_id = q.query_id  
CROSS APPLY sys.fn_stmt_sql_handle_from_sql_stmt (qt.query_sql_text, null) AS fn_handle_from_stmt  
JOIN sys.dm_exec_query_stats AS qs   
    ON fn_handle_from_stmt.statement_sql_handle = qs.statement_sql_handle;  

Weitere InformationenSee Also

sp_query_store_force_plan (Transact-SQL-) sp_query_store_force_plan (Transact-SQL)
sp_query_store_remove_plan (TransT-SQL-) sp_query_store_remove_plan (Transct-SQL)
sp_query_store_unforce_plan (Transact-SQL-) sp_query_store_unforce_plan (Transact-SQL)
sp_query_store_reset_exec_stats (Transact-SQL-) sp_query_store_reset_exec_stats (Transact-SQL)
sp_query_store_flush_db (Transact-SQL-) sp_query_store_flush_db (Transact-SQL)
sp_query_store_remove_query (Transact-SQL-) sp_query_store_remove_query (Transact-SQL)
Abfragespeicher Katalog Sichten (Transact-SQL-) Query Store Catalog Views (Transact-SQL)
Überwachen der Leistung mit dem AbfragespeicherMonitoring Performance By Using the Query Store