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

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.

Пример