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)
Feedback
Submit and view feedback for