数据表管理接口说明
所有文档

          云数据库 GaiaDB-X

          数据表管理接口说明

          创建数据表

          接口描述

          本接口用于在云数据库 GaiaDB-X 实例的某个数据库中创建一个数据表

          请求结构

          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

          删除数据表

          接口描述

          本接口用于在云数据库 GaiaDB-X 实例的某个数据库中删除一个数据表

          • 数据表状态必须为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

          查询数据表列表

          接口描述

          本接口用于查询云数据库 GaiaDB-X 实例的某个数据库的数据表列表

          请求结构

          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"
                  }
              ]
          }
          上一篇
          数据库管理接口说明
          下一篇
          账号管理接口说明