Table - Таблица

class axipy.da.Table

Базовые классы: DataObject

Таблица.

Менеджер контекста сохраняет изменения и закрывает таблицу.

Пример:

with provider_manager.openfile('path/to/file.tab') as table:
    ...
    # При выходе из блока таблица будет сохранена и закрыта

См.также

commit(), DataObject.close().

Свойства:

can_redo

Возможен ли откат на один шаг вперед.

can_undo

Возможен ли откат на один шаг назад.

coordsystem

Система координат таблицы.

is_editable

Признак того, что таблица является редактируемой.

is_modified

Таблица содержит несохраненные изменения.

is_spatial

Признак того, что объект данных является пространственным.

is_temporary

Признак того, что таблица является временной.

name

Название объекта данных.

properties

Дополнительные свойства объекта данных.

provider

Провайдер изначального источника данных.

schema

Схема таблицы.

supported_operations

Доступные операции.

Методы:

close()

Пытается закрыть таблицу.

commit()

Сохраняет изменения в таблице.

count([bbox])

Возвращает количество записей, удовлетворяющих параметрам.

get_bounds()

Возвращает область, в которую попадают все данные таблицы.

insert(features)

Вставляет записи в таблицу.

items([bbox, ids])

Запрашивает записи, удовлетворяющие параметрам.

itemsByIds(ids)

Запрашивает записи по списку list с идентификаторами записей, либо перечень идентификаторов в виде списка.

itemsInObject(obj)

Запрашивает записи с фильтром по геометрическому объекту.

itemsInRect(bbox)

Запрашивает записи с фильтром по ограничивающему прямоугольнику.

redo()

Производит откат на один шаг вперед.

remove(ids)

Удаляет записи из таблицы.

rollback()

Отменяет несохраненные изменения в таблице.

undo()

Производит откат на один шаг назад.

update(features)

Обновляет записи в таблице.

Сигналы:

data_changed

Сигнал об изменении данных таблицы.

destroyed

Сигнал оповещения об удалении объекта.

schema_changed

Сигнал об изменении схемы таблицы.

property can_redo: bool

Возможен ли откат на один шаг вперед.

property can_undo: bool

Возможен ли откат на один шаг назад.

close()

Пытается закрыть таблицу.

Исключение:

RuntimeError – Ошибка закрытия таблицы.

Примечание

Объект данных не всегда может быть сразу закрыт. Например, для таблиц используется транзакционная модель редактирования и перед закрытием необходимо сохранить или отменить изменения, если они есть. См. Table.is_modified.

commit()

Сохраняет изменения в таблице.

Если таблица не содержит несохраненные изменения, то команда игнорируется.

Исключение:

RuntimeError – Невозможно сохранить изменения.

property coordsystem: Optional[CoordSystem]

Система координат таблицы.

count(bbox: Optional[Union[Rect, QRectF, tuple]] = None) int

Возвращает количество записей, удовлетворяющих параметрам.

Данный метод является наиболее предпочтительным для оценки количества записей. При этом используется наиболее оптимальный вариант выполнения запроса для каждого конкретного провайдера данных.

Параметры:

bbox – Ограничивающий прямоугольник.

Результат:

Количество записей.

property data_changed: Signal

Сигнал об изменении данных таблицы. Испускается когда были изменены данные таблицы.

Пример подписки на изменение таблицы.
table = provider_manager.openfile(filepath)
table.data_changed.connect(lambda: print('Таблица была изменена.'))
property destroyed: Signal

Сигнал оповещения об удалении объекта.

get_bounds() Rect

Возвращает область, в которую попадают все данные таблицы.

insert(features: Union[Feature, Iterable[Feature]])

Вставляет записи в таблицу.

Параметры:

features – Записи для вставки.

property is_editable: bool

Признак того, что таблица является редактируемой.

property is_modified: bool

Таблица содержит несохраненные изменения.

property is_spatial: bool

Признак того, что объект данных является пространственным.

property is_temporary: bool

Признак того, что таблица является временной. Это в первую очередь касается таблиц, созданных в памяти. А также таблица косметического слоя.

items(bbox: Optional[Union[Rect, QRectF, tuple]] = None, ids: Optional[List[int]] = None) Iterator[Feature]

Запрашивает записи, удовлетворяющие параметрам. В качестве фильтра может быть указан либо ограничивающий прямоугольник, либо перечень идентификаторов в виде списка.

Параметры:
  • bbox – Ограничивающий прямоугольник.

  • ids – Список идентификаторов.

Результат:

Итератор по записям.

itemsByIds(ids: List[int]) Iterator[Feature]

Запрашивает записи по списку list с идентификаторами записей, либо перечень идентификаторов в виде списка. Идентификаторы несохраненных записей имеют отрицательные значения.

Параметры:

ids – Список идентификаторов.

Результат:

Итератор по записям.

Пример
table_world = provider_manager.openfile(filepath)
# Пример запроса по списку идентификаторов.
items = table_world.itemsByIds([11, 27, 41, 163, 203])
for f in items:
    print('Feature id={}. Страна={}'.format(f.id, f['Страна']))
# Просмотр идентификаторов всех записей, включая несохраненные
for f in table_world.items():
    print(f.id, f['Страна'])
# Получение несохраненных записей совместно с сохраненными
items_new = table_world.itemsByIds([-1, -12, 27])
for f in items_new:
    print('Feature id={}. Страна={}'.format(f.id, f['Страна']))
itemsInObject(obj: Geometry) Iterator[Feature]

Запрашивает записи с фильтром по геометрическому объекту.

Параметры:

obj – Геометрия. Если для нее не задана СК, используется СК таблицы.

Результат:

Итератор по записям.

Пример запроса по полигону
table_world = provider_manager.openfile(filepath)
v = 2000000
polygon = Polygon((-v, -v), (-v, v), (v, v), (v, -v))
items = table_world.itemsInObject(polygon)
for f in items:
    print('Feature id={}. Страна={}'.format(f.id, f['Страна']))
itemsInRect(bbox: Union[Rect, QRectF, tuple]) Iterator[Feature]

Запрашивает записи с фильтром по ограничивающему прямоугольнику.

Параметры:

bbox – Ограничивающий прямоугольник.

Результат:

Итератор по записям.

Пример запроса (таблица в проекции Робинсона)
table_world = provider_manager.openfile(filepath)
v = 2000000
items = table_world.itemsInRect(Rect(-v, -v, v, v))
for f in items:
    print('Feature id={}. Страна={}'.format(f.id, f['Страна']))
property name: str

Название объекта данных.

property properties: dict

Дополнительные свойства объекта данных.

property provider: str

Провайдер изначального источника данных.

redo()

Производит откат на один шаг вперед. При этом возвращается состояние до последней отмены.

remove(ids: Union[int, Iterator[int]])

Удаляет записи из таблицы.

Параметры:

ids – Идентификаторы записей для удаления.

rollback()

Отменяет несохраненные изменения в таблице.

Если таблица не содержит несохраненные изменения, то команда игнорируется.

property schema: Schema

Схема таблицы.

property schema_changed: Signal

Сигнал об изменении схемы таблицы. Испускается когда была изменена структура таблицы.

property supported_operations: SupportedOperations

Доступные операции.

Пример использования
flags = table.supported_operations
assert flags == SupportedOperations.ReadWrite
assert flags & SupportedOperations.Insert
assert SupportedOperations.Write in flags
undo()

Производит откат на один шаг назад.

update(features: Union[Feature, Iterable[Feature]])

Обновляет записи в таблице.

Параметры:

features – Записи для обновления.

При обновлении проверяется Feature.id. Если запись с таким идентификатором не найдена, то она пропускается.

Пример использования
modified_feature = Feature({'attr_name': 'new_value'}, id=1)
table.update(modified_feature)
table.commit()

См.также

Feature.id, commit(), is_modified.