What you need to know
Will a hidden workbook merge step run when another merge step depends on it?
Potentially affected
Azure Workbooks using a merge data source that references another hidden merge step.
DSE recommendation
Flatten a chained merge where practical and test visibility-dependent execution before publishing the workbook.
Source facts
Workbooks can run hidden query and metric steps when a merge references them, but hidden steps that themselves use the merge data source do not run. A downstream merge referencing such a hidden merge waits until that step becomes visible. Microsoft notes that one merge can combine several sources, so chaining merge steps is rarely necessary. Microsoft Learn.
Applicability
Use this execution check when a workbook result disappears after an author hides an intermediate step. Distinguish an ordinary hidden source query from a hidden merge; their treatment is not interchangeable.
DSE recommendation
Flatten a chained merge where practical and test visibility-dependent execution before publishing the workbook. Sketch which source steps feed the final result and identify any intermediate merge that is hidden by default or by a parameter choice. Keep presentation cleanup separate from changes to the data dependency structure. Preserve the original workbook while revising the chain so expected results can be compared.
Verification
Run the workbook with the intermediate merge visible and record the downstream result. Repeat with the intended hidden state and check whether the dependency still executes. After restructuring, compare the final rows and values with the known visible-step result across relevant parameter choices. Do not treat a newly empty final grid as evidence that the monitored environment has no matching data until this execution dependency has been excluded.
Official references
Microsoft Learn: Workbook data sources and merge behavior. Source reviewed September 9, 2026.
Review the official source
Azure Workbooks data sources - Azure Monitor | Microsoft Learn · Verified September 9, 2026
Need help applying this guidance safely?
DSE can help confirm applicability, protect service continuity, and validate the result across physical security and IT systems.
Talk with DSE