全部产品
Search
文档中心

DataHub:Istilah

更新时间:Nov 14, 2025

Istilah

Term

Deskripsi

Project

  • Proyek adalah unit organisasi dasar untuk data di DataHub dan berisi beberapa topik.

  • Proyek DataHub bersifat independen dari proyek MaxCompute.

Topic

Topik adalah unit terkecil untuk langganan dan penerbitan data di DataHub. Anda dapat menggunakan topik untuk merepresentasikan kelas atau tipe data streaming tertentu.

Periode waktu hidup (TTL) dari sebuah topik

Periode waktu hidup (TTL) dari sebuah topik menentukan periode retensi maksimum untuk data yang ditulis ke dalam topik tersebut. Satuannya adalah hari. Nilainya berkisar antara 1 hingga 7.

Shard

Shard adalah saluran konkuren untuk transmisi data dalam sebuah topik. Setiap shard memiliki ID unik.

Shard yang diaktifkan mengonsumsi sumber daya server. Buatlah shard sesuai kebutuhan.

Untuk informasi lebih lanjut mengenai berbagai status shard, lihat Status shard.

Rentang Kunci Hash Shard

Properti dari sebuah shard yang menentukan rentang nilai kunci hash. Rentang tersebut bersifat tertutup di kiri dan terbuka di kanan.

Data dengan kunci yang sama ditulis ke shard yang sama.

Penggabungan Shard

Penggabungan shard adalah operasi yang menggabungkan shard-shard dengan rentang kunci bersebelahan menjadi satu shard tunggal.

Untuk informasi lebih lanjut, lihat Operasi shard.

Pemisahan Shard

Pemisahan shard adalah operasi yang membagi sebuah shard menjadi dua shard dengan rentang kunci shard bersebelahan.

Catatan

Unit dasar interaksi data antara data pengguna dan DataHub.

Tipe catatan

Tipe data dari sebuah topik. DataHub mendukung tipe Tuple dan BLOB.

  • Topik bertipe Tuple mendukung catatan data mirip database. Setiap catatan berisi beberapa kolom.

  • Topik bertipe BLOB hanya mendukung penulisan satu blok data biner.

Untuk informasi lebih lanjut mengenai tipe data yang didukung, lihat Tipe data.

Tipe data

  • Tipe Tuple: Mendukung penulisan data dengan tipe data berikut:

    Tipe data TINYINT, SMALLINT, INTEGER, dan FLOAT di DataHub didukung mulai dari Java SDK V2.16.1-public.

    Tipe

    Deskripsi

    Rentang

    BIGINT

    Bilangan bulat bertanda 8 byte

    -9223372036854775807 to 9223372036854775807

    DOUBLE

    Bilangan titik mengambang presisi ganda 8 byte

    -1.0 × 10^308 to 1.0 × 10^308

    BOOLEAN

    Tipe Boolean

    • True/true/1

    • False/false/0

    TIMESTAMP

    Tipe timestamp

    Timestamp yang akurat hingga mikrodetik.

    STRING

    String. Hanya mendukung pengkodean UTF-8.

    Satu kolom STRING dapat mencapai ukuran maksimum 2 MB.

    TINYINT

    Bilangan bulat satu byte

    -128 to 127

    SMALLINT

    Bilangan bulat dua byte

    -32768 ~ 32767

    INTEGER

    Bilangan bulat 4 byte

    -2147483648 to 2147483647

    FLOAT

    Bilangan titik mengambang presisi tunggal 4 byte

    -3.40292347 × 10^38 to 3.40292347 × 10^38

    DECIMAL

    Tipe numerik

    -10^38 + 1 to 10^38 - 1

  • Dalam mode Blob, satu blok data biner dapat ditulis sebagai catatan. Data dikirimkan menggunakan pengkodean Base64.

Status shard

Status

Deskripsi

Dukungan baca/tulis

Opening

Saat topik dibuat, semua shard-nya berada dalam status Opening selama proses inisialisasi.

Operasi baca dan tulis tidak didukung.

Active

Setelah saluran shard dibuka, shard tersebut memasuki status Active.

Operasi baca dan tulis normal didukung.

Closing

Shard berada dalam status Closing saat menjalani operasi pemisahan atau penggabungan.

Operasi baca dan tulis tidak didukung.

Closed

Setelah operasi pemisahan atau penggabungan selesai, shard tersebut memasuki status Closed.

Hanya baca.

Deskripsi kesalahan

ErrorCode

HttpCode

Deskripsi

InvalidUriSpec

400

URI yang diminta tidak valid.

InvalidParameter

400

Parameter tidak valid. Untuk informasi lebih lanjut, lihat pesan kesalahan yang dikembalikan.

Unauthorized

401

Kesalahan tanda tangan.

NoPermission

403

Izin akun tidak mencukupi.

InvalidSchema

400

Format skema tidak valid.

InvalidCursor

400

Kursor tidak valid atau telah kedaluwarsa.

NoSuchProject

404

Proyek yang diminta tidak ada.

NoSuchTopic

404

Topik yang diminta tidak ada.

NoSuchShard

404

ID shard yang diminta tidak ada.

ProjectAlreadyExist

400

Proyek sudah ada.

TopicAlreadyExist

400

Topik sudah ada.

InvalidShardOperation

405

Operasi shard tidak valid. Misalnya, menulis data ke shard setelah shard tersebut ditutup.

LimitExceeded

400

Parameter permintaan melebihi batas. Misalnya, jumlah total shard melebihi 512.

InternalServerError

500

Terjadi kesalahan tak dikenal, pengecualian layanan internal, atau sedang berlangsung peningkatan sistem.