5.2.8. xgt.RowID

class xgt.RowID(container_map: _ContainerMap, row_id_list: list[int])

RowID represents a row ID returned from a server. The user shouldn’t manually construct these.

Parameters:

  • container_map (_ContainerMap) – Map of container ids to frames.

  • row_id_list (list[int]) – List in the form: [X, Y] where X is the row id and Y is the commit id when this value was valid.

Methods

get_data([include_row_labels])

Returns row data.

Attributes

frame

The frame the RowID points into.

position

The row position the RowID points to.
property frame: TableFrame | VertexFrame | EdgeFrame

The frame the RowID points into.

get_data(include_row_labels: bool = False) → list[Any]

Returns row data. If the frame this row points to has had deletions since the RowID was created, this row is considered invalid and will raise an exception.

Parameters:

include_row_labels (bool) – Indicates whether the security labels for each row should be egested along with the row.

Returns:

The properties of the row.

Return type:

list[Any]

Raises:

  • XgtNameError – If the frame does not exist on the server.

  • XgtSecurityError – If the user does not have required permissions for this action.

  • XgtTransactionError – If a conflict with another transaction occurs.

  • XgtValueError – If parameter is out of bounds or the row is no longer valid due to a transactional update.

property position: int

The row position the RowID points to.