Skip to content

Latest commit

 

History

History
129 lines (93 loc) · 4.58 KB

dbcc-pdw-showexecutionplan-transact-sql.md

File metadata and controls

129 lines (93 loc) · 4.58 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic dev_langs monikerRange
DBCC PDW_SHOWEXECUTIONPLAN (Transact-SQL)
DBCC PDW_SHOWEXECUTIONPLAN displays the execution plan for a query running on a specific Azure Synapse Analytics or Analytics Platform System (PDW) compute node or control node.
rwestMSFT
randolphwest
12/05/2022
sql
data-warehouse
reference
TSQL
>= aps-pdw-2016 || = azure-sqldw-latest

DBCC PDW_SHOWEXECUTIONPLAN (Transact-SQL)

[!INCLUDEapplies-to-version/asa-pdw]

Displays the [!INCLUDEssNoVersion] execution plan for a query running on a specific [!INCLUDEssazuresynapse-md] or [!INCLUDEssPDW] Compute node or Control node. Use this to troubleshoot query performance problems while queries are running on the Compute nodes and Control node.

Once query performance problems are understood for SMP [!INCLUDEssNoVersion] queries running on the Compute nodes, there are several ways to improve performance. Possible ways to improve query performance on the Compute nodes include creating multi-column statistics, creating nonclustered indexes, or using query hints.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

Syntax for Azure Synapse Analytics:

DBCC PDW_SHOWEXECUTIONPLAN ( distribution_id , spid )
[;]

Syntax for Analytics Platform System (PDW):

DBCC PDW_SHOWEXECUTIONPLAN ( pdw_node_id , spid )
[;]

Note

[!INCLUDEsynapse-analytics-od-unsupported-syntax]

Arguments

distribution_id

Identifier for the distribution that is running the query plan. This is an integer and can't be NULL. Value must be between 1 and 60. Used when targeting [!INCLUDEssazuresynapse-md].

pdw_node_id

Identifier for the node that is running the query plan. This is an integer and can't be NULL. Used when targeting an Appliance.

spid

Identifier for the [!INCLUDEssNoVersion] session that is running the query plan. This is an integer and can't be NULL.

Permissions

Requires CONTROL permission on [!INCLUDEssazuresynapse-md].

Requires VIEW SERVER STATE permission on the Appliance.

Examples: [!INCLUDEssazuresynapse-md]

A. DBCC PDW_SHOWEXECUTIONPLAN basic syntax

The following sample query will return the sql_spid for each actively running distribution.

SELECT [sql_spid]
    , [pdw_node_id]
    , [request_id]
    , [dms_step_index]
    , [type]
    , [start_time]
    , [end_time]
    , [status]
    , [distribution_id]
FROM sys.dm_pdw_dms_workers
WHERE [status] <> 'StepComplete'
    AND [status] <> 'StepError'
ORDER BY request_id
    , [dms_step_index];

If you are curious as to what distribution_id 1 was running in session 375, you would run the following command:

DBCC PDW_SHOWEXECUTIONPLAN (1, 375);

Examples: Analytics Platform System (PDW)

B. DBCC PDW_SHOWEXECUTIONPLAN basic syntax

The query that is running too long is either running a DMS query plan operation or a SQL query plan operation.

If the query is running a DMS query plan operation, you can use the following query to retrieve a list of the node IDs and session IDs for steps that aren't complete.

SELECT [sql_spid]
    , [pdw_node_id]
    , [request_id]
    , [dms_step_index]
    , [type]
    , [start_time]
    , [end_time]
    , [status]
FROM sys.dm_pdw_dms_workers
WHERE [status] <> 'StepComplete'
    AND [status] <> 'StepError'
    AND pdw_node_id = 201001
ORDER BY request_id
    , [dms_step_index]
    , [distribution_id];

Based on the results of the preceding query, use the sql_spid and pdw_node_id as parameters to DBCC PDW_SHOWEXECUTIONPLAN. For example, the following command shows the execution plan for pdw_node_id 201001 and sql_spid 375.

DBCC PDW_SHOWEXECUTIONPLAN (201001, 375);

Next steps