All Products
Search

This Product

    Object Storage Service:Atur konfigurasi maintenance tabel

    Document Center

    Object Storage Service:Atur konfigurasi maintenance tabel

    Last Updated:May 09, 2026

    Perintah ini mengatur konfigurasi maintenance otomatis untuk sebuah tabel dan mendukung kompaksi otomatis serta manajemen snapshot pada tabel Iceberg.

    Catatan penggunaan

    • Parameter --type mendukung dua jenis maintenance:

      • icebergCompaction: Melakukan kompaksi file data pada tabel Iceberg dengan secara otomatis menggabungkan file kecil menjadi file yang lebih besar guna meningkatkan performa kueri.

      • icebergSnapshotManagement: Mengelola snapshot pada tabel Iceberg dengan secara otomatis menghapus snapshot kedaluwarsa untuk membebaskan ruang penyimpanan.

    • Parameter --value mengatur konfigurasi dalam format JSON. Setiap jenis maintenance memerlukan struktur JSON yang berbeda. Anda dapat memberikan string JSON secara langsung atau memuatnya dari file lokal menggunakan awalan file://.

    • Jalankan perintah ini secara terpisah untuk setiap jenis maintenance. Untuk mengonfigurasi kompaksi dan manajemen snapshot sekaligus, Anda harus menjalankan perintah ini dua kali.

    Sintaks perintah

    ossutil tables-api put-table-maintenance-configuration --table-bucket-arn value --namespace value --name value --type value --value value [flags]

    Parameter

    Tipe

    Deskripsi

    --name

    string

    Nama tabel. Wajib diisi.

    --namespace

    string

    Namespace tabel. Wajib diisi.

    --table-bucket-arn

    string

    ARN Table Bucket, dalam format acs:osstables:{region}:{uid}:bucket/{bucket-name}. Wajib diisi.

    --type

    string

    Jenis konfigurasi maintenance. Nilai yang valid adalah icebergCompaction (untuk kompaksi tabel Iceberg) dan icebergSnapshotManagement (untuk manajemen snapshot tabel Iceberg). Wajib diisi.

    --value

    string

    Konfigurasi maintenance dalam format JSON. Anda dapat memberikan string JSON secara langsung atau menentukan path file lokal menggunakan awalan file://. Wajib diisi.
    Catatan

    Contoh

    • Aktifkan kompaksi otomatis untuk tabel Iceberg dengan ukuran file target 512 MB.

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergCompaction --value '{"status":"enabled","settings":{"targetFileSizeMB":512}}'

    • Aktifkan pembersihan snapshot otomatis yang menyimpan 5 snapshot terbaru dan menghapus snapshot yang lebih lama dari 168 jam (7 hari).

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergSnapshotManagement --value '{"status":"enabled","settings":{"minSnapshotsToKeep":5,"maxSnapshotAgeHours":168}}'

    • Muat konfigurasi maintenance dari file JSON lokal menggunakan awalan file://.

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergCompaction --value file://compaction-config.json

    • Nonaktifkan konfigurasi maintenance kompaksi untuk tabel Iceberg.

      ossutil tables-api put-table-maintenance-configuration --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --type icebergCompaction --value '{"status":"disabled"}'