Skip to main content

Описание

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

Столбцы

  • database (String) — Имя базы данных, в которой находится таблица.
  • name (String) — Имя таблицы.
  • uuid (UUID) — UUID таблицы (база данных Atomic).
  • engine (String) — Имя движка таблицы (без параметров).
  • is_temporary (UInt8) — Флаг, указывающий, является ли таблица временной.
  • data_paths (Array(String)) — Пути к данным таблицы в файловых системах.
  • metadata_path (String) — Путь к метаданным таблицы в файловой системе.
  • metadata_modification_time (DateTime) — Время последнего изменения метаданных таблицы.
  • metadata_version (Int32) — Версия метаданных для таблицы ReplicatedMergeTree; для таблиц, не использующих ReplicatedMergeTree, — 0.
  • dependencies_database (Array(String)) — Зависимости базы данных.
  • dependencies_table (Array(String)) — Зависимости таблицы (materialized view, зависящие от текущей таблицы).
  • create_table_query (String) — Запрос, использованный для создания таблицы.
  • engine_full (String) — Параметры движка таблицы.
  • as_select (String) — SELECT-запрос для представления.
  • parameterized_view_parameters (Array(Tuple(name String, type String))) — Параметры parameterized view.
  • partition_key (String) — Выражение ключа партиционирования, указанное в таблице.
  • sorting_key (String) — Выражение ключа сортировки, указанное в таблице.
  • primary_key (String) — Выражение первичного ключа, указанное в таблице.
  • sampling_key (String) — Выражение ключа выборки, указанное в таблице.
  • unique_key (String) — Выражение уникального ключа, указанное в таблице (предложение UNIQUE KEY).
  • skipping_indices_types (Array(String)) — Массив уникальных типов индексов пропуска данных, определённых для таблицы (например, minmax, set, bloom_filter, ngrambf_v1, tokenbf_v1, text, vector_similarity). Пуст для таблиц без индексов пропуска данных.
  • storage_policy (String) — Политика хранения. Применимо к таблицам, использующим движки MergeTree и Distributed.
  • total_rows (Nullable(UInt64)) — Общее количество строк, если точное число строк в таблице можно быстро определить; иначе NULL (включая нижележащую Buffer table).
  • total_bytes (Nullable(UInt64)) — Общее количество байтов, если точное число байтов таблицы в хранилище можно быстро определить; иначе NULL (без учёта нижележащего хранилища). Если таблица хранит данные на диске, возвращается объём занятого дискового пространства (то есть сжатые данные). Если таблица хранит данные в памяти, возвращается приблизительное количество используемых байтов в памяти.
  • total_bytes_uncompressed (Nullable(UInt64)) — Общее количество несжатых байтов, если точное количество байтов таблицы в хранилище можно быстро определить по контрольным суммам частей; иначе NULL (без учёта нижележащего хранилища, если оно есть).
  • parts (Nullable(UInt64)) — Общее количество частей в этой таблице.
  • active_parts (Nullable(UInt64)) — Количество активных частей в этой таблице.
  • total_marks (Nullable(UInt64)) — Общее количество меток во всех частях этой таблицы.
  • active_on_fly_data_mutations (UInt64) — Общее количество активных мутаций данных (UPDATE и DELETE), которые можно применить на лету.
  • active_on_fly_alter_mutations (UInt64) — Общее количество активных ALTER-мутаций (MODIFY COLUMN), которые можно применить на лету.
  • active_on_fly_metadata_mutations (UInt64) — Общее количество активных мутаций метаданных (RENAME), которые можно применить на лету.
  • columns_descriptions_cache_size (UInt64) — Размер кеша описаний столбцов для таблиц семейства *MergeTree
  • 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)) — Зависимая таблица при загрузке.
  • target_database (String) — Для materialized view — база данных целевой таблицы, в которую записывает представление (цель TO или неявная таблица .inner.*). Для других движков значение пустое.
  • target_table (String) — Для materialized view — имя целевой таблицы, в которую записывает представление (цель TO или неявная таблица .inner.*). Для других движков значение пустое.
  • definer (String) — Имя определяющего пользователя безопасности SQL, используемого для таблицы.
Псевдонимы:
  • table — псевдоним name.

Пример

Последнее изменение 14 августа 2026 г.