Skip to main content
Version: 24.3.x

SYS.REFLECTIONS

The sys.reflections table contains metadata for reflections in the Dremio instance.

Syntax
SELECT * 
FROM sys.reflections

Example Output

reflection_idreflection_nametypestatusdataset_iddataset_namedataset_typesort_columnspartition_columnsdistribution_columnsdimensionsmeasuresdisplay_columnsexternal_reflectionnum_failuresarrow_cache
4c78569a-158b-413d-afa9-4424b0e51a72ref_unionAGGREGATIONCAN_ACCELERATEc50508c3-b82d-48a9-b5d0-d0ce5cb37da9sam.unionviewVIRTUAL_DATASETAB0false
74de4114-27e0-4db9-ab88-60cf9a689dd0taxi_reflectionAGGREGATIONCANNOT_ACCELERATE_MANUAL9ad9e8be-b584-468a-97ff-34e58e8c1ba8Samples."samples.dremio.com"."NYC-taxi-trips-iceberg"PHYSICAL_DATASET_SOURCE_FOLDERMONTH(pickup_datetime)pickup_datetime"passenger_counttrip_distance_mifare_amounttip_amounttotal_amount
f79d8196-2f60-4aa7-beb1-eb69466cf0c8Raw ReflectionRAWFAILED65541138-07ec-496c-ba5e-318fee7d225ds3."samples.dremio.com"."NYC-taxi-trips-iceberg"PHYSICAL_DATASET_SOURCE_FOLDERpassenger_count"pickup_datetimepassenger_counttrip_distance_mifare_amount
438bfbaa-2bf1-4ba9-9759-bd16399a3869Aggregation ReflectionAGGREGATIONCAN_ACCELERATE4da4eb8d-be0a-487b-99d6-68827f806c9amy_space.weatherVIRTUAL_DATASET"DayOfWeekDescript"DayOfWeek0

Fields

FieldData TypeDescription
reflection_idvarcharThe UUID to identify the reflection.
reflection_namevarcharThe user-defined name of the reflection.
typevarcharThe type of reflection.
Enum: AGGREGATION, RAW
statusvarcharThe status of the reflection based on the last time the reflection was used.
Enum: CAN_ACCELERATE, CAN_ACCELERATE_WITH_FAILURES, REFRESHING, FAILED, EXIPRED, DISABLED, INVALID, INCOMPLETE, CANNOT_ACCELERATE_SCHEDULED, CANNOT_ACCELERATE_MANUAL
dataset_idvarcharThe UUID to identify the dataset that the reflection is on.
dataset_namevarcharThe path and name of the dataset that the reflection is on.
dataset_typevarcharThe type of dataset that the reflection has been created on.
Enum: PHYSICAL_DATASET_HOME_FILE, PHYSICAL_DATASET_SOURCE_FILE, PHYSICAL_DATASET_SOURCE_FOLDER, VIRTUAL_DATASET
sort_columnsvarcharThe list of columns that will be sorted on.
partition_columnsvarcharThe list of columns that the dataset is partitioned on. Shows partition transforms, if any are set, on the columns.
distribution_columnsvarcharThe list of distributed columns.
dimensionsvarcharThe list of dimension columns or expressions.
measuresvarcharThe list of measures.
display_columnsvarcharThe list of displayed columns.
external_reflectionvarcharThe field will be populated if the reflection is an external reflection.
num_failuresintegerThe number of recent failures.
arrow_cachebooleanThis value will be true if Arrow caching is enabled for the reflection; false otherwise.