Library related objects

arcticdb.version_store.library.NormalizableType module-attribute

NormalizableType = Union[NORMALIZABLE_TYPES]

Types that can be normalised into Arctic's internal storage structure.

See Also

Library.write: for more documentation on normalisation.

arcticdb.version_store.library.ReadInfoRequest

Bases: NamedTuple

ReadInfoRequest is useful for batch methods like read_metadata_batch and get_description_batch, where we only need to specify the symbol and the version information. Therefore, construction of this object is only required for these batch operations.

ATTRIBUTE	DESCRIPTION
symbol	See read_metadata method. TYPE: str
as_of	See read_metadata method. TYPE: Optional[AsOf], default=none

See Also

Library.read: For documentation on the parameters.

arcticdb.version_store.library.ReadRequest

Bases: NamedTuple

ReadRequest is designed to enable batching of read operations with an API that mirrors the singular read API. Therefore, construction of this object is only required for batch read operations.

ATTRIBUTE	DESCRIPTION
as_of	See read method. TYPE: Optional[AsOf], default=none
date_range	See readmethod. TYPE: Optional[Tuple[Optional[Timestamp], Optional[Timestamp]]], default=none
row_range	See read method. TYPE: Optional[Tuple[int, int]], default=none
columns	See read method. TYPE: Optional[List[str]], default=none
query_builder	See read method. TYPE: Optional[Querybuilder], default=none

See Also

Library.read: For documentation on the parameters.

arcticdb.version_store.library.SymbolDescription

Bases: NamedTuple

A named tuple. Descriptive information about the data stored under a particular symbol.

ATTRIBUTE	DESCRIPTION
columns	Columns stored under the symbol. TYPE: Tuple[NameWithDType]
index	Index of the symbol. TYPE: NameWithDType
index_type	Whether the index is a simple index or a multi_index. NA indicates that the stored data does not have an index. TYPE: str {"NA", "index", "multi_index"}
row_count	Number of rows. TYPE: int
last_update_time	The time of the last update to the symbol, in UTC. TYPE: datetime64
date_range	The times in UTC that data for this symbol spans. If the data is not timeseries indexed then this value will be (datetime.datetime(1970, 1, 1), datetime.datetime(1970, 1, 1)). TYPE: Tuple[datetime, datetime]

arcticdb.version_store.library.SymbolVersion

Bases: NamedTuple

A named tuple. A symbol name - version pair.

ATTRIBUTE	DESCRIPTION
symbol	Symbol name. TYPE: str
version	Version of the symbol. TYPE: int

arcticdb.version_store.library.VersionedItem

Return value for many operations that captures the result and associated information.

ATTRIBUTE	DESCRIPTION
library	Library this result relates to. TYPE: str
symbol	Read or modified symbol. TYPE: str
data	For data retrieval (read) operations, contains the data read. For data modification operations, the value might not be populated. TYPE: Any
version	For data retrieval operations, the version the as_of argument resolved to. For data modification operations, the version the data has been written under. TYPE: int
metadata	The metadata saved alongside data. Availability depends on the method used and may be different from that of data. TYPE: Any
host	Informational / for backwards compatibility. TYPE: Optional[str]

arcticdb.version_store.library.VersionInfo

Bases: NamedTuple

A named tuple. Descriptive information about a particular version of a symbol.

ATTRIBUTE	DESCRIPTION
date	Time that the version was written in UTC. TYPE: datetime
deleted	True if the version has been deleted and is only being kept alive via a snapshot. TYPE: bool
snapshots	Snapshots that refer to this version. TYPE: List[str]

arcticdb.version_store.library.WritePayload

WritePayload is designed to enable batching of multiple operations with an API that mirrors the singular write API.

Construction of WritePayload objects is only required for batch write operations.

One instance of WritePayload refers to one unit that can be written through to ArcticDB.

__init__

__init__(
    symbol: str,
    data: Union[Any, NormalizableType],
    metadata: Any = None,
)

Constructor.

PARAMETER	DESCRIPTION
symbol	Symbol name. Limited to 255 characters. The following characters are not supported in symbols: "*", "&", "<", ">" TYPE: str
data	Data to be written. If data is not of NormalizableType then it will be pickled. TYPE: Any
metadata	Optional metadata to persist along with the symbol. TYPE: Any DEFAULT: None

See Also

Library.write_pickle: For information on the implications of providing data that needs to be pickled.