Todos os produtos
Search

Este produto

    Object Storage Service:Renomear uma tabela

    Central de documentação

    Object Storage Service:Renomear uma tabela

    Última atualização: Jul 03, 2026

    Renomeie uma tabela em um table bucket ou mova-a para outro namespace.

    Observações

    • Especifique pelo menos um dos parâmetros --new-name ou --new-namespace. Se especificar apenas --new-name, a tabela será renomeada no namespace atual. Caso especifique somente --new-namespace, a tabela será movida para o novo namespace, mas manterá o nome original. Ao fornecer ambos os parâmetros, a tabela é renomeada e transferida para o novo namespace.

    • O parâmetro --version-token ativa o bloqueio otimista. Obtenha o versionToken atual da tabela com o comando get-table para evitar conflitos de atualização durante operações simultâneas. Sem esse parâmetro, o sistema não executa verificação de versão.

    Sintaxe

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

    Parâmetro

    Tipo

    Descrição

    --name

    string

    Nome atual da tabela. Obrigatório.

    --namespace

    string

    Namespace atual da tabela. Obrigatório.

    --new-name

    string

    Novo nome da tabela. Especifique pelo menos --new-name ou --new-namespace.

    --new-namespace

    string

    Namespace de destino da tabela. Especifique pelo menos --new-name ou --new-namespace.

    --table-bucket-arn

    string

    Alibaba Cloud Resource Name (ARN) do table bucket, no formato acs:osstables:{region}:{uid}:bucket/{bucket-name}. Obrigatório.

    --version-token

    string

    Token de versão para bloqueio otimista. Use o comando get-table para obter o versionToken atual e evitar conflitos em operações simultâneas.
    Nota

    • O comando rename-table corresponde à API RenameTable. Para mais detalhes sobre os parâmetros da API, consulte RenameTable.

    • Para informações sobre as opções globais de linha de comando compatíveis, consulte Opções globais do ossutil.

    Exemplos

    • Renomeie uma tabela de old_table para new_table no namespace atual.

      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

    • Mova a tabela my_table do namespace my_namespace para 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

    • Renomeie uma tabela e transfira-a para outro namespace com um token de versão para bloqueio otimista.

      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