Viewing the Dynamic Table Refresh Mode with the SHOW Command

Use SHOW DYNAMIC TABLE REFRESH HISTORY to check the refresh mode. In the output, the refresh_mode field indicates whether incremental refresh was used, and the stats field records the row counts for incremental refreshes.

Syntax

SHOW DYNAMIC TABLE REFRESH HISTORY [where <expr>] [LIMIT num];

Parameters

  • WHERE <expr>: (Optional) Filters results based on the fields displayed by the SHOW JOBS command. You can use an expression to narrow down the results and find the data you need more precisely.
  • LIMIT num: (Optional) Limits the number of job records returned. Valid range: 1–10000.

Return Fields

FieldDescription
workspace_nameWorkspace name
schema_nameSchema name
nameDynamic table name
virtual_clusterCompute cluster used
start_timeRefresh start time, timestamp type
end_timeRefresh end time, timestamp type
durationRefresh duration, interval type
stateJob status
refresh_triggerMANUAL (triggered manually by the user via a refresh call, including Studio scheduled refreshes) or SYSTEM_SCHEDULED (scheduled by Lakehouse)
suspended_resonReserved field, no special meaning
refresh_modeNO_DATA, FULL, INCREMENTAL
error_messageError message if the refresh failed
source_tablesNames of the base tables used by the dynamic table
statsIncremental refresh row counts and related information
completion_targetReserved field, no special meaning
job_idJob ID; click the job ID to view the job profile