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

SE APLICA A: síSQL Server síAzure SQL Database noAzure Synapse Analytics (SQL DW) noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Obtiene el stmt_sql_handle para un Transact-SQLTransact-SQL instrucción en el tipo de parametrización (simple o forzada) dado.Gets the stmt_sql_handle for a Transact-SQLTransact-SQL statement under given parameterization type (simple or forced). Esto permite hacer referencia a las consultas almacenadas en el Store de la consulta mediante el uso de sus stmt_sql_handle cuando conoce su texto.This allows you to refer to queries stored in the Query Store by using their stmt_sql_handle when you know their text.

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

SintaxisSyntax

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

ArgumentosArguments

query_sql_textquery_sql_text
Es el texto de la consulta en el que desea que el identificador de almacén de consultas.Is the text of the query in the query store that you want the handle of. query_sql_text es un nvarchar (max) , no tiene ningún valor predeterminado.query_sql_text is a nvarchar(max), with no default.

query_param_typequery_param_type
Es el tipo de parámetro de la consulta.Is the parameter type of the query. query_param_type es un tinyint.query_param_type is a tinyint. Los valores posibles son:Possible values are:

  • NULL: el valor predeterminado es 0NULL - defaults to 0

  • 0: ninguno0 - None

  • 1 - usuario1 - User

  • 2 - simple2 - Simple

  • 3 - forzada3 - Forced

Columnas devueltasColumns Returned

La tabla siguiente enumeran las columnas que sys.fn_stmt_sql_handle_from_sql_stmt devuelve.The following table lists the columns that sys.fn_stmt_sql_handle_from_sql_stmt returns.

Nombre de columnaColumn name TypeType DescripciónDescription
statement_sql_handlestatement_sql_handle varbinary(64)varbinary(64) El identificador SQL.The SQL handle.
query_sql_textquery_sql_text nvarchar(max)nvarchar(max) El texto de la Transact-SQLTransact-SQL instrucción.The text of the Transact-SQLTransact-SQL statement.
query_parameterization_typequery_parameterization_type tinyinttinyint El tipo de parametrización de consultas.The query parameterization type.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

ComentariosRemarks

PermisosPermissions

Requiere el EXECUTE permiso en la base de datos y eliminar permiso en las vistas de catálogo del almacén de consultas.Requires the EXECUTE permission on the database, and DELETE permission on the query store catalog views.

EjemplosExamples

El ejemplo siguiente se ejecuta una instrucción y, a continuación, usa sys.fn_stmt_sql_handle_from_sql_stmt para devolver el identificador SQL de esa instrucción.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);  

Use la función para correlacionar datos de la consulta Store con otras vistas de administración dinámica.Use the function to correlate Query Store data with other dynamic management views. El ejemplo siguiente: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;  

Vea tambiénSee Also

sp_query_store_force_plan (Transact-SQL) sp_query_store_force_plan (Transact-SQL)
sp_query_store_remove_plan (Transct-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)
Query Store Catalog Views (Transact-SQL) (Vistas de catálogo del Almacén de consultas (Transact-SQL)) Query Store Catalog Views (Transact-SQL)
Supervisar el rendimiento mediante el Almacén de consultasMonitoring Performance By Using the Query Store