All Products
Search

This Product

    Object Storage Service:Mengganti nama tabel

    Document Center

    Object Storage Service:Mengganti nama tabel

    Last Updated:May 09, 2026

    Mengganti nama tabel dalam bucket tabel tertentu atau memindahkan tabel ke namespace lain.

    Catatan

    • Anda harus menentukan setidaknya salah satu parameter --new-name atau --new-namespace. Jika hanya menentukan --new-name, nama tabel akan diubah dalam namespace-nya saat ini. Jika hanya menentukan --new-namespace, tabel akan dipindahkan ke namespace baru dengan nama aslinya tetap dipertahankan. Jika kedua parameter tersebut ditentukan, tabel akan diganti namanya sekaligus dipindahkan ke namespace baru.

    • Parameter --version-token mengaktifkan kunci optimis. Anda dapat memperoleh versionToken terkini dari suatu tabel menggunakan perintah get-table. Parameter ini mencegah konflik pembaruan selama operasi konkuren. Jika parameter ini tidak ditentukan, tidak ada pemeriksaan versi yang dilakukan.

    Sintaks

    ossutil tables-api rename-table --table-bucket-arn value --namespace value --name value [--new-name value] [--new-namespace value] [--version-token value] [flags]

    Parameter

    Tipe

    Deskripsi

    --name

    string

    Nama tabel saat ini. Parameter ini wajib ditentukan.

    --namespace

    string

    Namespace saat ini dari tabel. Parameter ini wajib ditentukan.

    --new-name

    string

    Nama baru untuk tabel. Anda harus menentukan setidaknya salah satu dari --new-name atau --new-namespace.

    --new-namespace

    string

    Namespace target untuk tabel. Anda harus menentukan setidaknya salah satu dari --new-name atau --new-namespace.

    --table-bucket-arn

    string

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

    --version-token

    string

    Token versi untuk kunci optimis. Anda dapat memperoleh versionToken terkini dari tabel dengan menggunakan perintah get-table. Parameter ini mencegah konflik pembaruan selama operasi konkuren.
    Catatan

    • Perintah rename-table berkorespondensi dengan API RenameTable. Untuk informasi lebih lanjut mengenai parameter API, lihat RenameTable.

    • Untuk informasi mengenai opsi baris perintah global yang didukung, lihat ossutil global options.

    Contoh

    • Mengganti nama tabel dari old_table menjadi new_table dalam namespace-nya saat ini.

      ossutil tables-api rename-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name old_table --new-name new_table

    • Memindahkan tabel my_table dari namespace my_namespace ke target_namespace.

      ossutil tables-api rename-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --new-namespace target_namespace

    • Mengganti nama tabel dan memindahkannya ke namespace berbeda, menggunakan token versi untuk kunci optimis.

      ossutil tables-api rename-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name old_table --new-name new_table --new-namespace target_namespace --version-token abc123def456