Перейти к основному содержимому
Перейти к основному содержимому

system.tables

Содержит метаданные каждой таблицы, о которой знает сервер.

Отключенные таблицы не отображаются в system.tables.

Временные таблицы видны в system.tables только в тех сессиях, где они были созданы. Они отображаются с пустым полем database и с включенным флагом is_temporary.

Столбцы:

  • database (String) — Название базы данных, в которой находится таблица.

  • name (String) — Название таблицы.

  • uuid (UUID) — UUID таблицы (атомарная база данных).

  • engine (String) — Название движка таблицы (без параметров).

  • is_temporary (UInt8) - Флаг, указывающий, является ли таблица временной.

  • data_paths (Array(String)) - Пути к данным таблицы в файловых системах.

  • metadata_path (String) - Путь к метаданным таблицы в файловой системе.

  • metadata_modification_time (DateTime) - Время последнего изменения метаданных таблицы.

  • metadata_version (Int32) - Версия метаданных для таблицы ReplicatedMergeTree, 0 для таблицы не ReplicatedMergeTree.

  • dependencies_database (Array(String)) - Зависимости базы данных.

  • dependencies_table (Array(String)) - Зависимости таблицы (материализованные представления текущей таблицы).

  • create_table_query (String) - Запрос, который использовался для создания таблицы.

  • engine_full (String) - Параметры движка таблицы.

  • as_select (String) - Запрос SELECT для представления.

  • parameterized_view_parameters (Array of Tuple) — Параметры параметризованного представления.

  • partition_key (String) - Выражение ключа раздела, указанное в таблице.

  • sorting_key (String) - Выражение ключа сортировки, указанное в таблице.

  • primary_key (String) - Выражение первичного ключа, указанное в таблице.

  • sampling_key (String) - Выражение ключа выборки, указанное в таблице.

  • storage_policy (String) - Политика хранения:

  • total_rows (Nullable(UInt64)) - Общее количество строк, если можно быстро определить точное количество строк в таблице, иначе NULL (включая подлежащую таблицу Buffer).

  • total_bytes (Nullable(UInt64)) - Общее количество байт, если можно быстро определить точное количество байт для таблицы на хранилище, иначе NULL (не включает подлежащее хранилище).

    • Если таблица хранит данные на диске, возвращает использованное пространство на диске (т.е. сжатое).
    • Если таблица хранит данные в памяти, возвращает приблизительное количество использованных байт в памяти.

  • total_bytes_uncompressed (Nullable(UInt64)) - Общее количество несжатых байт, если можно быстро определить точное количество байт из контрольных сумм частей для таблицы на хранилище, иначе NULL (не учитывает подлежащее хранилище (если есть)).

  • lifetime_rows (Nullable(UInt64)) - Общее количество строк, добавленных с момента запуска сервера (только для таблиц Buffer).

  • lifetime_bytes (Nullable(UInt64)) - Общее количество байт, добавленных с момента запуска сервера (только для таблиц Buffer).

  • comment (String) - Комментарий к таблице.

  • has_own_data (UInt8) — Флаг, указывающий, хранит ли таблица собственные данные на диске или только обращается к какому-либо другому источнику.

  • loading_dependencies_database (Array(String)) - Зависимости загрузки базы данных (список объектов, которые должны быть загружены перед текущим объектом).

  • loading_dependencies_table (Array(String)) - Зависимости загрузки таблицы (список объектов, которые должны быть загружены перед текущим объектом).

  • loading_dependent_database (Array(String)) - Зависимая база данных загрузки.

  • loading_dependent_table (Array(String)) - Зависимая таблица загрузки.

Таблица system.tables используется в реализации запроса SHOW TABLES.

Пример