# 删除视图

删除指定视图。执行前请确认该视图不再需要。

```text
POST https://api.moi.matrixorigin.cn/v5/meta/view/drop
```

## 调用前准备

1. 准备有目标工作区访问权限且具有删除视图权限的[个人访问令牌](../../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)和[目标工作区 ID](../../../../../guides/ai-studio/resource-center/workspace.md#复制工作区-id)。
2. [查看数据库](list-databases.md#成功响应)，选择数据库名称。
3. [查看数据库中的表和视图列表](list-database-tables.md#成功响应)，选择要删除的视图名称。
4. 确认该视图不再需要。


## 请求体

将示例中的调用者专属值替换为实际值。

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X POST "https://api.moi.matrixorigin.cn/v5/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\"
  }"

```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `db_name` | string | 是 | 视图所在的数据库名称。 |
| `table_name` | string | 是 | 要删除的视图名称。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code | integer | 成功时为 200。 |
| data | null | 此操作不返回结果对象。 |

:::::
::::::
:::::::

成功响应不返回对象。随后[查看数据库中的表和视图列表](list-database-tables.md#调用前准备)，确认该视图已不再出现。

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | integer 或 string | 错误代码或状态码。 |
| `message` | string | 错误信息。 |

:::::
::::::
:::::::

## 后续操作

[查看数据库中的表和视图列表](list-database-tables.md#调用前准备)，确认目标已不再出现。