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

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 для представления.

  • 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.

Пример