Skip to main content

system.views

Provides metadata information for all views.

See also:

Examples:
SELECT * FROM system.views LIMIT 3;

╭────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ catalog │ database │ database_id │ name │ table_id │ engine │ engine_full │ created_on │ dropped_on │ updated_on │ owner │ comment │ view_query │
│ String │ String │ UInt64 │ String │ UInt64 │ String │ String │ Timestamp │ Nullable(Timestamp)Timestamp │ Nullable(String) │ String │ String │
├─────────┼──────────┼─────────────┼────────┼──────────┼────────┼─────────────┼────────────────────────────┼─────────────────────┼────────────────────────────┼──────────────────┼─────────┼─────────────────────────────────┤
defaultdefault1 │ b │ 133095VIEWVIEW2025-06-30 04:59:27.844141NULL2025-06-30 04:59:27.844142NULL │ │ SELECT * FROM hits.hits LIMIT 1
defaultdefault1 │ c │ 119483VIEWVIEW2025-06-30 02:51:52.319229NULL2025-06-30 02:51:52.319229NULL │ │ SELECT * FROM default.a │
defaultdefault1 │ v │ 133330VIEWVIEW2025-06-30 05:24:42.054795NULL2025-06-30 05:24:42.054796NULL │ │ SELECT * FROM default.t │
defaultdefault1 │ xvl │ 119736VIEWVIEW2025-06-30 03:55:24.335369NULL2025-06-30 03:55:24.335370NULL │ │ SELECT * FROM hits.hits LIMIT 1
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

To show the schema of system.views, use DESCRIBE system.views:

DESCRIBE system.views;

╭────────────────────────────────────────────────────────────────────────────────╮
│ Field │ TypeNullDefault │ Extra │
│ String │ String │ String │ String │ String │
├─────────────┼─────────────────┼────────┼──────────────────────────────┼────────┤
│ catalog │ VARCHARNO'' │ │
databaseVARCHARNO'' │ │
│ database_id │ BIGINT UNSIGNEDNO0 │ │
│ name │ VARCHARNO'' │ │
│ table_id │ BIGINT UNSIGNEDNO0 │ │
engineVARCHARNO'' │ │
│ engine_full │ VARCHARNO'' │ │
│ created_on │ TIMESTAMPNO'1970-01-01 00:00:00.000000' │ │
│ dropped_on │ TIMESTAMP │ YES │ NULL │ │
│ updated_on │ TIMESTAMPNO'1970-01-01 00:00:00.000000' │ │
│ owner │ VARCHAR │ YES │ NULL │ │
commentVARCHARNO'' │ │
│ view_query │ VARCHARNO'' │ │
╰────────────────────────────────────────────────────────────────────────────────╯