云数据库DRDS

    数据表管理接口说明

    创建数据表

    接口描述

    本接口用于在DRDS实例的某个数据库中创建一个数据表

    请求结构

    POST /v{version}/instance/{instanceId}/database/{dbName}/table?clientToken={clientToken} HTTP/1.1
    HOST: drds.bj.baidubce.com
    Authorization: authorization string
    {
        "tableDefineList": tableDefineList
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URI参数 API版本号
    instanceId String URI参数 实例ID
    clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串
    tableDefineList List<TableDefine> RequestBody参数 创建数据表请求列表

    TableDefine

    参数名称 类型 描述
    rawsql String 创建数据库sql语句,只能有一个sql语句,并且以英文分号结束
    isDistributed String 单表:"0",分布式表:"1"
    partitionKey String 分表字段,只支持varchar和int类型的字段
    tabletCount int 分表个数,取值64/128/256/512/1024/2048

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    无特殊响应参数

    请求示例

    GET https://drds.bj.baidubce.com/v1/instance/drdsuc6qx3cpnh3/database/dbtest/table
    Host: drds.bj.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    {
        "tableDefineList": [
            {
                "rawsql": "create table test(id int);",
                "isDistributed": "1",
                "partitionKey": "id",
                "tabletCount": 128
            }
        ]
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
    Content-Type: application/json

    删除数据表

    接口描述

    本接口用于在DRDS实例的某个数据库中删除一个数据表

    • 数据表状态必须为Available

    请求结构

    DELETE /v{version}/instance/{instanceId}/database/{dbName}/table/{tableName} HTTP/1.1
    HOST: drds.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URI参数 API版本号
    instanceId String URI参数 实例ID
    dbName String URI参数 数据库名称
    tableName String URI参数 数据表名称

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    无特殊响应参数

    请求示例

    DELETE https://drds.bj.baidubce.com/v1/instance/drdsuc6qx3cpnh3/database/dbtest/table/test_t
    Host: drds.bj.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
    Content-Type: application/json

    查询数据表列表

    接口描述

    本接口用于查询DRDS实例的某个数据库的数据表列表

    请求结构

    GET /v{version}/instance/{instanceId}/database/{dbName}/table HTTP/1.1
    HOST: drds.bj.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URI参数 API版本号
    instanceId String URI参数 实例ID
    dbName String URI参数 数据库名称

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名称 类型 描述
    tables List<Table> 数据表列表

    Table

    参数名称 类型 描述
    tableName String 数据表名称
    status String 数据表状态
    partitionMethod String 分表规则,hash
    partitionKey String 分表字段
    partitionKeyType String 分表字段类型
    isDistributed String 单表:0, 分布式表:1

    请求示例

    GET https://drds.bj.baidubce.com/v1/instance/drdsuc6qx3cpnh3/database/dbtest/table
    Host: drds.bj.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
    Content-Type: application/json
    {
        "tables": [
            {
                "tableName": "test_t",
                "status": "Available",
                "isDistributed": "1",
                "partitionKey": "id",
                "partitionMethod": "hash",
                "partitionKeyType": "INT"
            }
        ]
    }
    上一篇
    数据库管理接口说明
    下一篇
    账号管理接口说明