sys.dm_pdw_request_steps (Transact-SQL)

Applies to: Azure Synapse Analytics Analytics Platform System (PDW)

Holds information about all steps that compose a given request or query in Azure Synapse Analytics. It lists one row per query step.

Note

This syntax is not supported by serverless SQL pool in Azure Synapse Analytics.

Column Name	Data Type	Description	Range
request_id	nvarchar(32)	request_id and step_index make up the key for this view. Unique numeric ID associated with the request.	See request_id in sys.dm_pdw_exec_requests (Transact-SQL).
step_index	int	request_id and step_index make up the key for this view. The position of this step in the sequence of steps that make up the request.	0 to (n-1) for a request with n steps.
plan_node_id	int	The node ID corresponding to the operator ID of that step in the execution plan.	None
operation_type	nvarchar(35)	Type of operation represented by this step.	DMS query plan operations: 'ReturnOperation', 'PartitionMoveOperation', 'MoveOperation', 'BroadcastMoveOperation', 'ShuffleMoveOperation', 'TrimMoveOperation', 'CopyOperation', 'DistributeReplicatedTableMoveOperation' SQL query plan operations: 'OnOperation', 'RemoteOperation' Other query plan operations: 'MetaDataCreateOperation', 'RandomIDOperation' External operations for reads: 'HadoopShuffleOperation', 'HadoopRoundRobinOperation', 'HadoopBroadcastOperation' External operations for MapReduce: 'HadoopJobOperation', 'HdfsDeleteOperation' External operations for writes: 'ExternalExportDistributedOperation', 'ExternalExportReplicatedOperation', 'ExternalExportControlOperation' For more information, see "Understanding Query Plans" in the Analytics Platform System (PDW) product documentation. A query plan can also be affected by the database settings. Check ALTER DATABASE SET options for details.
distribution_type	nvarchar(32)	Type of distribution this step will undergo.	'AllNodes', 'AllDistributions', 'AllComputeNodes', 'ComputeNode', 'Distribution', 'SubsetNodes', 'SubsetDistributions', 'Unspecified'
location_type	nvarchar(32)	Where the step is running.	'Compute', 'Control', 'DMS'
status	nvarchar(32)	Status of this step.	Pending, Running, Complete, Failed, UndoFailed, PendingCancel, Canceled, Undone, Aborted
error_id	nvarchar(36)	Unique ID of the error associated with this step, if any.	See error_id of sys.dm_pdw_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. For more information on queries, see sys.dm_pdw_exec_requests (Transact-SQL).
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 running, in milliseconds.	Between 0 and the difference between end_time and start_time. 0 for queued steps. If total_elapsed_time exceeds the maximum value for an integer, total_elapsed_time will continue to be the maximum value. This condition will generate the warning "The maximum value has been exceeded." The maximum value in milliseconds is equivalent to 24.8 days.
row_count	bigint	Total number of rows changed or returned by this request.	The number of rows affected by the step. Greater than or equal to zero for data operation steps. -1 for steps that do not operate on data.
estimated_rows	bigint	Total number of rows of work calculated during query compilation.	The number of rows estimated by the step. Greater than or equal to zero for data operation steps. -1 for steps that do not operate on data.
command	nvarchar(4000)	Holds the full text of the command of this step.	Any valid request string for a step. NULL when the operation is of the type MetaDataCreateOperation. Truncated if longer than 4000 characters.

For information about the maximum rows retained by this view, see the Maximum System View Values section in the "Minimum and Maximum Values" in the Analytics Platform System (PDW) product documentation.

See Also

Azure Synapse Analytics and Parallel Data Warehouse Dynamic Management Views (Transact-SQL)