sys.dm_exec_sql_text (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Geeft de tekst terug van de SQL-batch die is geïdentificeerd door de gespecificeerde sql_handle. Deze tabelwaardige functie vervangt de systeemfunctie fn_get_sql.

Syntax

sys.dm_exec_sql_text(sql_handle | plan_handle)  

Argumenten

sql_handle
Is een token dat uniek een batch identificeert die heeft uitgevoerd of momenteel uitvoert. sql_handle is varbinair(64).

De sql_handle kan worden verkregen uit de volgende dynamische beheerobjecten:

• sys.dm_exec_query_stats

• sys.dm_exec_requests

• sys.dm_exec_cursors

• sys.dm_exec_xml_handles

• sys.dm_exec_query_memory_grants

• sys.dm_exec_connections

plan_handle
Is een token dat uniek een query-uitvoeringsplan identificeert voor een batch die is uitgevoerd en waarvan het plan zich in de plancache bevindt, of momenteel uitvoert. plan_handle is varbinair(64).

De plan_handle kan worden verkregen uit de volgende dynamische beheerobjecten:

• sys.dm_exec_cached_plans (Transact-SQL)

• sys.dm_exec_query_stats (Transact-SQL)

• sys.dm_exec_requests (Transact-SQL)

• sys.dm_exec_procedure_stats (Transact-SQL)

• sys.dm_exec_trigger_stats (Transact-SQL)

Tabel geretourneerd

Permissions

Vereist VIEW SERVER STATE machtiging op de server.

Machtigingen voor SQL Server 2022 en hoger

Vereist VIEW SERVER PERFORMANCE STATE toestemming op de server.

Opmerkingen

Voor ad hoc-queries zijn de SQL-handles hashwaarden gebaseerd op de SQL-tekst die aan de server wordt gestuurd, en kunnen ze afkomstig zijn van elke database.

Voor databaseobjecten zoals opgeslagen procedures, triggers of functies worden de SQL-handles afgeleid van de database-ID, object-ID en objectnummer.

Plan handle is een hashwaarde die wordt afgeleid van het gecompileerde plan van de hele batch.

Examples

A. Conceptueel voorbeeld

Het volgende is een basisvoorbeeld om te illustreren hoe je een sql_handle direct of met CROSS APPLY kunt halen.

1. Creëer activiteit.
   Voer de volgende T-SQL uit in een nieuw queryvenster in SQL Server Management Studio.

   -- Identify current spid (session_id)
   SELECT @@SPID;
   GO
   
   -- Create activity
     WAITFOR DELAY '00:02:00';
   

2. Gebruik CROSS APPLY.
   De sql_handle van sys.dm_exec_requests worden doorgegeven aan sys.dm_exec_sql_text via CROSS APPLY. Open een nieuw queryvenster en geef de spid door die in stap 1 is geïdentificeerd. In dit voorbeeld is 59de spid toevallig .

   SELECT t.*
   FROM sys.dm_exec_requests AS r
   CROSS APPLY sys.dm_exec_sql_text(r.sql_handle) AS t
   WHERE session_id = 59 -- modify this value with your actual spid
   

3. Geef sql_handle direct door.
   Haal de sql_handle van sys.dm_exec_requests. Geef vervolgens de sql_handle direct aan sys.dm_exec_sql_text. Open een nieuw queryvenster en geef de spid die in stap 1 is geïdentificeerd door aan sys.dm_exec_requests. In dit voorbeeld is 59de spid toevallig . Geef dan de teruggegeven sql_handle als argument aan sys.dm_exec_sql_text.

   -- acquire sql_handle
   SELECT sql_handle FROM sys.dm_exec_requests WHERE session_id = 59  -- modify this value with your actual spid
   
   -- pass sql_handle to sys.dm_exec_sql_text
   SELECT * FROM sys.dm_exec_sql_text(0x01000600B74C2A1300D2582A2100000000000000000000000000000000000000000000000000000000000000) -- modify this value with your actual sql_handle
   

B. Verkrijg informatie over de vijf belangrijkste zoekopdrachten op basis van gemiddelde CPU-tijd

Het volgende voorbeeld geeft de tekst van de SQL-instructie en de gemiddelde CPU-tijd voor de top vijf queries terug.

SELECT TOP 5 total_worker_time/execution_count AS [Avg CPU Time],  
    SUBSTRING(st.text, (qs.statement_start_offset/2)+1,   
        ((CASE qs.statement_end_offset  
          WHEN -1 THEN DATALENGTH(st.text)  
         ELSE qs.statement_end_offset  
         END - qs.statement_start_offset)/2) + 1) AS statement_text  
FROM sys.dm_exec_query_stats AS qs  
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) AS st  
ORDER BY total_worker_time/execution_count DESC;  

C. Verskaf batch-uitvoeringsstatistieken

Het volgende voorbeeld geeft de tekst van SQL-query's die in batches worden uitgevoerd terug en geeft statistische informatie hierover.

SELECT s2.dbid,   
    s1.sql_handle,    
    (SELECT TOP 1 SUBSTRING(s2.text,statement_start_offset / 2+1 ,   
      ( (CASE WHEN statement_end_offset = -1   
         THEN (LEN(CONVERT(nvarchar(max),s2.text)) * 2)   
         ELSE statement_end_offset END)  - statement_start_offset) / 2+1))  AS sql_statement,  
    execution_count,   
    plan_generation_num,   
    last_execution_time,     
    total_worker_time,   
    last_worker_time,   
    min_worker_time,   
    max_worker_time,  
    total_physical_reads,   
    last_physical_reads,   
    min_physical_reads,    
    max_physical_reads,    
    total_logical_writes,   
    last_logical_writes,   
    min_logical_writes,   
    max_logical_writes    
FROM sys.dm_exec_query_stats AS s1   
CROSS APPLY sys.dm_exec_sql_text(sql_handle) AS s2    
WHERE s2.objectid is null   
ORDER BY s1.sql_handle, s1.statement_start_offset, s1.statement_end_offset;  

Zie ook

Dynamische beheerweergaven en -functies (Transact-SQL)
uitvoeringsgerelateerde dynamische beheerweergaven en -functies (Transact-SQL)
sys.dm_exec_query_stats (Transact-SQL)
sys.dm_exec_requests (Transact-SQL)
sys.dm_exec_cursors (Transact-SQL)
sys.dm_exec_xml_handles (Transact-SQL)
sys.dm_exec_query_memory_grants (Transact-SQL)
APPLY gebruiken
sys.dm_exec_text_query_plan (Transact-SQL)