删除表

使用 influxdb3 delete table 命令或 HTTP API 删除 InfluxDB 3 Core 中指定数据库里的表。

在 InfluxDB 3 Core 中，表和度量是同义词。默认情况下，InfluxDB 3 Core 执行软删除，它会计划表删除并在之后使其无法查询。您也可以安排硬删除，以永久移除表及其数据。

• 使用 influxdb3 CLI 删除表
• 使用 HTTP API 删除表

使用 influxdb3 CLI 删除表

使用 influxdb3 delete table 命令删除表

influxdb3 delete table \
  --database 
DATABASE_NAME
 \
  --token 
AUTH_TOKEN
 \
  
TABLE_NAME

替换以下内容：

• DATABASE_NAME：包含表的数据库名称
• TABLE_NAME：要删除的表的名称
• AUTH_TOKEN：您的 管理员令牌

立即硬删除表

要立即永久删除表及其数据，请使用 --hard-delete now 标志

influxdb3 delete table \
  --database 
DATABASE_NAME
 \
  --token 
AUTH_TOKEN
 \
  --hard-delete now \
  
TABLE_NAME

安排硬删除

要安排在特定时间对表进行硬删除，请使用带有时间戳的 --hard-delete 标志

influxdb3 delete table \
  --database 
DATABASE_NAME
 \
  --token 
AUTH_TOKEN
 \
  --hard-delete "2025-12-31T23:59:59Z" \
  
TABLE_NAME

使用 HTTP API 删除表

要使用 HTTP API 删除表，请向 /api/v3/configure/table 端点发送 DELETE 请求

DELETE localhost:8181/api/v3/configure/table

在您的请求中包含以下内容

• 查询参数:
  • db：数据库名称
  • table：要删除的表名称
  • hard_delete_at：(可选) 硬删除的时间戳
• Headers:
  • Authorization: Bearer 加上您的身份验证令牌

软删除表

curl -X DELETE "localhost:8181/api/v3/configure/table?db=
DATABASE_NAME
&table=
TABLE_NAME
" \
  --header "Authorization: Bearer 
AUTH_TOKEN
"

替换以下内容：

• DATABASE_NAME：包含表的数据库名称
• TABLE_NAME：要删除的表的名称
• AUTH_TOKEN：您的 管理员令牌

安排硬删除

要安排在特定时间进行硬删除，请包含 hard_delete_at 参数，并提供 ISO 8601 格式的时间戳

curl -X DELETE "localhost:8181/api/v3/configure/table?db=
DATABASE_NAME
&table=
TABLE_NAME
&hard_delete_at=2025-12-31T23:59:59Z" \
  --header "Authorization: Bearer 
AUTH_TOKEN
"

响应

成功的删除将返回 HTTP 状态码 200，且响应体为空。

示例错误响应

如果表不存在，API 将返回 HTTP 状态码 404

{
  "error": "Table not found"
}