Exclui uma tabela e seus dados de um Table Bucket.
Notas de uso
Esta API suporta apenas tabelas Iceberg, não tabelas Lance. Para excluir tabelas Lance, use a Lance REST Namespace API ou o ecossistema Lance (Spark, Trino e outros mecanismos de computação).
-
Esta operação exclui permanentemente uma tabela e todos os seus dados e metadados. A exclusão é irreversível.
-
Use o parâmetro versionToken para bloqueio otimista, a fim de excluir apenas a versão desejada da tabela.
Permissões
|
API |
Ação |
Descrição |
|
DeleteTable |
oss:DeleteTable |
Exclui uma tabela e verifica a Table Policy correspondente. |
Sintaxe da requisição
DELETE /tables/{tableBucketARN}/{namespace}/{name} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueParâmetros da requisição
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
tableBucketARN |
String |
Sim |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
O Alibaba Cloud Resource Name (ARN) do Table Bucket. Formato: acs:osstables:{region}:{uid}:bucket/{bucketName}. Especificado no URI. |
|
namespace |
String |
Sim |
my_namespace |
O namespace que contém a tabela. Especificado no URI. |
|
name |
String |
Sim |
my_table |
A tabela a ser excluída. Especificado no URI. |
|
versionToken |
String |
Não |
aaabbb |
O token de versão para bloqueio otimista. Se o token não corresponder à versão atual da tabela, um erro 409 Conflict será retornado. Especificado na query string. |
Exemplos
Exemplo de requisição
DELETE /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****Exemplo de resposta
HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3SDKs
O DeleteTable está disponível nos seguintes SDKs:
CLI: ossutil
O comando ossutil correspondente é delete-table.
Códigos de erro
|
Código de erro |
Código de status HTTP |
Descrição |
|
ForbiddenException |
403 |
Você não tem as permissões necessárias. |
|
NotFoundException |
404 |
O recurso solicitado não existe. |
|
ConflictException |
409 |
A requisição está em conflito com o estado atual do recurso, como uma incompatibilidade de versionToken com a versão atual da tabela. |