文档首页 > > API参考> SQL作业相关API> 数据库相关API> 删除数据库

删除数据库

分享
更新时间: 2020/03/11 GMT+08:00

功能介绍

该API用于删除数据库,默认方式下,若待删除的数据库中存在表,则需先删除其中的所有表。删除表API请参见删除表

URI

  • URI格式:

    DELETE /v1.0/{project_id}/databases/{database_name}?cascade={is_cascade}&async={is_async}

  • 参数说明
    表1 URI 参数

    名称

    是否必选

    说明

    project_id

    项目编号,用于资源隔离。获取方式请参考获取项目ID

    database_name

    删除的数据库名称。

    cascade

    是否强制删除数据库,范围: [true|false]。默认值为:false。

    async

    是否异步方式删除数据库,范围: [true|false]。默认值为:false。

请求消息

无请求参数。

响应消息

表2 响应参数

参数

是否必选

参数类型

说明

is_success

Boolean

执行请求是否成功。“true”表示请求执行成功。

message

String

系统提示信息,执行成功时,信息为空。

job_id

String

此SQL语句将生成并提交一个新作业,返回此作业的ID,可用于获取作业状态和作业结果。

job_type

String

作业类型。

  • DDL
  • DCL
  • IMPORT
  • EXPORT
  • QUERY
  • INSERT

job_mode

String

作业执行模式:

  • async:异步
  • sync:同步

示例

  • 请求样例:
    None
  • 同步方式请求成功响应样例:
    {
     "is_success": true,
    "message": "",
    "job_mode": "sync"
    }
    • 异步方式请求成功响应样例:
      {
       "is_success": true,
      "message": "",
      "job_id": "208b08d4-0dc2-4dd7-8879-ddd4c020d7aa",
      "job_type": "DDL",
      "job_mode": "async"
      }

    调用API出错后,将不会返回上述结果,而是返回错误码和错误信息,详细介绍请参见错误码

    如果通过异步方式删除数据库,可以通过查询作业状态接口查看当前作业的状态,详细介绍参见5.3.10-查询作业状态。

    如果强制删除数据库cascade=true,则会级联删除该数据库下面的所有表,需要谨慎使用。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问