Edit

sys.dm_exec_distributed_sql_requests (Transact-SQL)

  • Article

Applies to: SQL Server 2016 (13.x) and later Azure SQL Managed Instance

Holds information about all SQL query distributions as part of a SQL step in the query. This view shows the data for the last 1000 requests; active requests always have the data present in this view.

Column Name Data Type Description Range
execution_id nvarchar(32) execution_id and step_index make up the key for this view. Unique numeric id associated with the request. See ID in sys.dm_exec_requests (Transact-SQL)
step_index int Index of the query step this distribution is part of. See step_index in sys.dm_exec_distributed_request_steps (Transact-SQL).
compute_node_id int Type of the operation represented by this step. See compute_node_id in sys.dm_exec_compute_nodes (Transact-SQL).
distribution_id int Where the step is executing. Set to -1 for requests that run at the node scope not the distribution scope.
status nvarchar(32) Status of this step Active, Cancelled, Completed, Failed, Queued
error_id nvarchar(36) Unique id of the error associated with this step, if any See id of sys.dm_exec_compute_node_errors (Transact-SQL), NULL if no error occurred.
start_time datetime Time at which the step started execution Smaller or equal to current time and larger or equal to end_compile_time of the query to which this step belongs.
end_time datetime Time at which this step completed execution, was cancelled, or failed. Smaller or equal to current time and larger or equal to start_time, set to NULL for steps currently in execution or queued.
total_elapsed_time int Total amount of time the query step has been executing, in milliseconds Between 0 and the difference between end_time and start_time. 0 for queued steps.
row_count bigint Total number of rows changed or returned by this request 0 for steps that did not change or return data, number of rows affected otherwise. Set to -1 for DMS steps.
spid int Session id on the SQL Server instance executing the query distribution
command nvarchar(4000) Holds the full text of the command of this step. Any valid request string for a step. Truncated if longer than 4000 characters.

See Also

PolyBase troubleshooting with dynamic management views
Dynamic Management Views and Functions (Transact-SQL)
Database Related Dynamic Management Views (Transact-SQL)