DataObject - Object Storage Service

本文為您介紹OSS Connector for AI/ML中的資料類型。

資料類型

說明

DataObject僅支援唯寫模式或者唯讀模式，唯讀模式支援順序讀和隨機讀，唯寫模式僅支援順序寫。

DataObject作為OSS Connector for AI/ML中的資料類型，樣本如下：

class DataObject:
    key: str
    size: int
    label: str

    def __enter__(self) -> DataObject: ...   
    def __exit__(self, exc_type, exc_val, exc_tb): ...
    def tell(self) -> int: ...
    def seek(self, offset: int, whence: int) -> int: ...
    def read(self, count: int) -> bytes: ...
    def readinto(self, buf) -> int: ...
    def write(self, data) -> int: ...
    def close(self) -> int: ...
    def copy(self) -> DataObject: ...

屬性方法

DataObject實現了常用的IO介面，具體請參見下表。

屬性/方法	類型/傳回值類型	描述
`key`	`str`	對象的唯一識別碼。
`size`	`int`	對象的實際大小，單位為位元組。
`label`	`str`	對象的標籤，用於分類或標記。
`__enter__`	`DataObject`	進入上下文管理器的方法，返回`DataObject`執行個體本身。
`__exit__`	`None`	退出上下文管理器的方法，用於釋放資源或執行清理操作。
`tell`	`int`	在唯讀模式下擷取當前檔案指標的位置，單位為位元組。
`seek`	`int`	在唯讀模式下設定檔案指標的位置，單位為位元組。
`read`	`bytes`	在唯讀模式下從當前檔案指標位置開始讀取指定數量的位元組，並以`bytes`類型返回。
`readinto`	`int`	在唯讀模式下從當前檔案指標位置開始讀取資料到緩衝區中，返回實際讀取的位元組數。
`write`	`int`	在唯寫模式下將資料寫入當前檔案指標位置，返回寫入的位元組數。
`close`	`int`	關閉檔案，釋放相關資源。
`copy`	`DataObject`	建立一個新的`DataObject`執行個體，包含當前執行個體的所有屬性。