All Products
Search

This Product

    Object Storage Service:Perbarui lokasi metadata tabel

    Document Center

    Object Storage Service:Perbarui lokasi metadata tabel

    Last Updated:May 09, 2026

    Memperbarui lokasi penyimpanan metadata untuk tabel tertentu. Perintah ini biasanya digunakan setelah melakukan commit snapshot metadata baru untuk tabel Iceberg.

    Catatan penggunaan

    • Parameter --version-token mengaktifkan kunci optimis. Anda harus terlebih dahulu memperoleh versionToken saat ini melalui perintah get-table-metadata-location, lalu meneruskannya ke parameter ini. Jika klien lain memperbarui lokasi metadata setelah Anda memperoleh versionToken tetapi sebelum Anda menyelesaikan pembaruan, operasi tersebut akan gagal. Mekanisme ini mencegah pembaruan bersamaan saling menimpa satu sama lain.

    • Parameter --metadata-location menentukan path ke file metadata baru. Path tersebut harus merupakan path file metadata Iceberg yang valid.

    • Kedua parameter --metadata-location dan --version-token wajib digunakan.

    Format perintah

    ossutil tables-api update-table-metadata-location --table-bucket-arn value --namespace value --name value --metadata-location value --version-token value [flags]

    Parameter

    Jenis

    Deskripsi

    --metadata-location

    string

    Path ke file metadata baru. Harus berupa path yang valid untuk file metadata Iceberg. Parameter ini wajib digunakan.

    --name

    string

    Nama tabel. Parameter ini wajib digunakan.

    --namespace

    string

    Nama namespace tabel. Parameter ini wajib digunakan.

    --table-bucket-arn

    string

    Nama Sumber Daya Alibaba Cloud (ARN) dari Table Bucket. Formatnya adalah acs:osstables:{region}:{uid}:bucket/{bucket-name}. Parameter ini wajib digunakan.

    --version-token

    string

    Token versi untuk kunci optimis. Untuk memastikan pembaruan menggunakan versi terbaru, peroleh versionToken saat ini dengan perintah get-table-metadata-location dan teruskan ke parameter ini. Parameter ini wajib digunakan.

    Catatan

    • Perintah update-table-metadata-location sesuai dengan Operasi API UpdateTableMetadataLocation. Untuk informasi lebih lanjut mengenai parameter API, lihat UpdateTableMetadataLocation.

    • Untuk opsi baris perintah global yang didukung, lihat ossutil Global Options.

    Contoh

    Perbarui lokasi file metadata tabel my_table dengan menentukan path metadata baru dan token versi.

    ossutil tables-api update-table-metadata-location --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --metadata-location oss://my-table-bucket/metadata/my_namespace/my_table/metadata/00001-abc123.metadata.json --version-token abc123def456