删除视图

删除指定视图。此操作不可恢复；执行前请确认该视图不再需要。

POST https://moi.matrixorigin.cn/newmoi/meta/view/drop

调用前准备

准备有目标视图删除权限的个人访问令牌、工作区 ID、数据库名称和视图名称。可先查询数据库中的表确认名称。

下方示例使用 $AI_STUDIO_API_KEY、$WORKSPACE_ID、$DATABASE 和 $VIEW。

请求体

字段

类型

是否必填

说明

db_name

string

是

视图所在的数据库名称。

table_name

string

是

要删除的视图名称。

请求示例

curl -X POST "https://moi.matrixorigin.cn/newmoi/meta/view/drop" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d "{\"db_name\":\"$DATABASE\",\"table_name\":\"$VIEW\"}"

成功响应

{"code":200,"data":null}

响应字段如下。

字段

类型

说明

code

integer

成功时为 200。

data

null

此操作不返回结果对象。

成功响应不返回对象。随后查询数据库中的表，确认该视图已不再出现。

错误响应

{
  "code": 400,
  "message": "table_name 不能为空"
}

常见 HTTP 错误

HTTP 状态码

常见原因

建议操作

400

请求体无法解析，或缺少 db_name、table_name。

补齐两个非空字段。

401

凭据缺失或无效。

检查 API Key 和工作区请求头。

403

当前访问凭据没有删除该视图的权限。

使用具有相应数据库权限的凭据重试。

500

视图删除操作失败。

检查对象名称和服务端错误信息后重试。

503

数据库连接暂时不可用。

稍后重试。

后续操作

查看表字段，确认目标已不再出现。

最后更新于