Column

class Column(column, dtype, fileobj=None, total_rows=0)
Параметры:
  • column (str) – Имя колонки

  • dtype (str) – Строковое описание типа данных

  • fileobj (BufferedReader | None) – Файловый объект (опционально)

  • total_rows (int) – Количество строк

Основной класс для работы с колонками данных в Native формате.

Описание:

Представляет отдельную колонку таблицы ClickHouse с поддержкой чтения, записи, итерации и управления данными. Инкапсулирует логику работы с различными типами данных через соответствующие объекты (DType, Array, LowCardinality).

Атрибуты:

info: ColumnInfo

Метаданные колонки.

dtype: Array | DType | LowCardinality

Объект для работы с конкретным типом данных.

data: list[Any] | None

Прочитанные данные колонки.

iter_data: Iterator[Any] | None

Итератор по данным.

Свойства:

total_rows
Type:

int

Получение общего количества строк в колонке.

Методы:

skip()

Пропуск чтения колонки.

read()
Результат:

Список всех значений колонки

Тип результата:

list[Any]

Чтение всех данных колонки.

write(data)
Параметры:

data (Any) – Значение для записи

Результат:

Количество записанных байт

Тип результата:

int

Запись значения в колонку.

tell()
Результат:

Размер данных колонки

Тип результата:

int

Получение текущего размера.

clear()
Результат:

Собранные данные колонки

Тип результата:

bytes

Извлечение данных и очистка буферов.

Итерация:

Поддерживает протокол итератора для последовательного чтения значений.

Использование:

Основной интерфейс для работы с колонками в NativeReader/NativeWriter.