Todos os produtos
Search
Central de documentação

Object Storage Service:Excluir uma tabela

Última atualização: Jul 03, 2026

Exclui uma tabela no namespace especificado.

Observações de uso

  • Esta operação é irreversível. Confirme que os dados da tabela não são mais necessários antes de prosseguir.

  • Para evitar exclusões acidentais, use o parâmetro --version-token. A tabela será excluída apenas se o token informado corresponder à versão atual.

  • Execute get-table para revisar os detalhes da tabela antes da exclusão.

Sintaxe

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

Parâmetro

Tipo

Descrição

--name

string

Nome da tabela a excluir.

--namespace

string

Nome do namespace que contém a tabela.

--table-bucket-arn

string

ARN do Table Bucket. O formato é acs:osstables:{region}:{uid}:bucket/{bucket-name}.

--version-token

string

Token de versão da tabela. Se especificado, a tabela será excluída somente se o token corresponder à versão atual. Use este parâmetro para impedir exclusões acidentais causadas por operações simultâneas.

Nota
  • O comando delete-table corresponde à operação da API DeleteTable. Para obter mais informações sobre os parâmetros, consulte DeleteTable.

  • Para obter uma lista das opções globais de linha de comando compatíveis, consulte Opções globais do ossutil.

Exemplos

  • Exclua a tabela my_table do namespace my_namespace.

    ossutil tables-api delete-table \
        --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket \
        --namespace my_namespace \
        --name my_table
  • Exclua uma tabela apenas se o token de versão corresponder. A exclusão será ignorada caso o token tenha sido alterado.

    ossutil tables-api delete-table \
        --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket \
        --namespace my_namespace \
        --name my_table \
        --version-token abc123