调用DeleteTable接口删除指定Table Bucket中的表。
注意事项
该接口仅支持 Iceberg 表，不支持 Lance 表。如需删除 Lance 表，请通过 Lance REST Namespace API 或 Lance 生态（Spark、Trino 等计算引擎）完成。
-
删除后，表的数据和元数据将被清除。删除操作不可恢复，请谨慎操作。
-
可通过versionToken参数进行乐观锁控制，确保删除的是预期版本的表。
权限说明
|
API |
Action |
说明 |
|
DeleteTable |
oss:DeleteTable |
删除表（同时检查Table Policy） |
请求语法
DELETE /tables/{tableBucketARN}/{namespace}/{name} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue请求参数
|
名称 |
数据类型 |
是否必选 |
示例值 |
描述 |
|
tableBucketARN |
字符串 |
是 |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
Table Bucket的ARN，格式为acs:osstables:{region}:{uid}:bucket/{bucketName}。位于URI中。 |
|
namespace |
字符串 |
是 |
my_namespace |
表所在的命名空间名称。位于URI中。 |
|
name |
字符串 |
是 |
my_table |
要删除的表名。位于URI中。 |
|
versionToken |
字符串 |
否 |
aaabbb |
版本token（乐观锁），用于确保删除的是预期版本的表。如果传入的versionToken与服务端当前版本不一致，则返回409冲突错误。位于Query参数中。 |
示例
请求示例
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****返回示例
HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3SDK
DeleteTable接口所对应的各语言SDK如下：
命令行工具ossutil
DeleteTable接口所对应的ossutil命令，请参见delete-table。
错误码
|
错误码 |
HTTP状态码 |
描述 |
|
ForbiddenException |
403 |
调用者无权执行此请求。 |
|
NotFoundException |
404 |
请求的资源不存在。 |
|
ConflictException |
409 |
请求与之前的写入操作存在冲突。 |