DataObject - Object Storage Service

Topik ini menjelaskan tipe data yang digunakan dalam OSS Connector untuk AI/ML.

Tipe data

Catatan

Tipe data DataObject dalam OSS Connector untuk AI/ML hanya mendukung mode tulis-saja atau baca-saja. Mode baca-saja mendukung pembacaan berurutan dan acak, sedangkan mode tulis-saja hanya mendukung penulisan berurutan.

Contoh:

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: ...

Metode

DataObject mendukung metode I/O umum. Tabel berikut memberikan penjelasan mengenai metode I/O tersebut.

Metode	Tipe/Nilai kembalian	Deskripsi
`key`	`str`	Pengenal unik dari objek.
`size`	`int`	Ukuran sebenarnya dari objek. Satuan: byte.
`label`	`str`	Tag dari objek, yang digunakan untuk klasifikasi atau pelabelan.
`__enter__`	`DataObject`	Metode yang digunakan untuk masuk ke pengelola konteks untuk menginisialisasi instance `DataObject`.
`__exit__`	`None`	Metode yang digunakan untuk keluar dari pengelola konteks untuk melepaskan sumber daya atau melakukan operasi pembersihan.
`tell`	`int`	Mendapatkan posisi pointer file saat ini dalam mode baca-saja. Satuan: byte.
`seek`	`int`	Menentukan posisi pointer file dalam mode baca-saja. Satuan: byte.
`read`	`bytes`	Membaca jumlah byte tertentu mulai dari posisi pointer file saat ini dalam mode baca-saja. Satuan: `bytes`.
`readinto`	`int`	Membaca data mulai dari posisi pointer file saat ini ke buffer dalam mode baca-saja, dan mengembalikan jumlah byte sebenarnya yang dibaca.
`write`	`int`	Menulis data ke posisi pointer file saat ini dalam mode tulis-saja dan mengembalikan jumlah byte yang ditulis.
`close`	`int`	Menutup file dan melepaskan sumber daya terkait.
`copy`	`DataObject`	Membuat instance `DataObject` baru yang berisi semua atribut dari instance saat ini.