Istilah
Term | Deskripsi |
Project |
|
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.
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 9223372036854775807DOUBLE
Bilangan titik mengambang presisi ganda 8 byte
-1.0 × 10^308 to 1.0 × 10^308BOOLEAN
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 127SMALLINT
Bilangan bulat dua byte
-32768 ~ 32767INTEGER
Bilangan bulat 4 byte
-2147483648 to 2147483647FLOAT
Bilangan titik mengambang presisi tunggal 4 byte
-3.40292347 × 10^38 to 3.40292347 × 10^38DECIMAL
Tipe numerik
-10^38 + 1 to 10^38 - 1Dalam 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. |