获取数据源中的表
功能介绍
获取数据源中的表
调用方法
请参见如何调用API。
URI
GET /v2/{project_id}/{connection_id}/datatables
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参见项目ID和账号ID。 最小长度:1 最大长度:128 |
connection_id |
是 |
String |
数据连接id,可通过数据连接列表中获取。 最小长度:1 最大长度:128 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
database_name |
是 |
String |
数据库名称 最小长度:1 最大长度:128 |
table_name |
否 |
String |
指定查询表的名称 最小长度:1 最大长度:128 |
limit |
否 |
String |
数据条数限制 最小长度:1 最大长度:16 |
offset |
否 |
String |
偏移量 最小长度:1 最大长度:16 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token,使用Token认证时必选。通过调用ManageOne平台的IAM服务的“获取用户Token”接口获取响应消息头中X-Subject-Token的值。 最小长度:0 最大长度:4096 |
workspace |
是 |
String |
数据所在空间的id值 最小长度:1 最大长度:128 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
total_count |
Integer |
当前数据库中表的记录数 最小值:0 最大值:100 |
tables |
Array of TablesList objects |
表的列表 数组长度:0 - 100 |
参数 |
参数类型 |
描述 |
---|---|---|
table_name |
String |
表名称 最小长度:1 最大长度:128 |
table_id |
String |
数据表的id信息 最小长度:1 最大长度:128 |
table_name_cn |
String |
表的中文名称 最小长度:1 最大长度:128 |
columns |
String |
表中字段 最小长度:1 最大长度:128 |
dw_id |
String |
数据连接id。 最小长度:1 最大长度:128 |
dw_name |
String |
数据连接名称 最小长度:1 最大长度:128 |
dw_type |
String |
数据连接类型 最小长度:1 最大长度:128 |
database_name |
String |
数据库名称 最小长度:1 最大长度:128 |
schema_name |
String |
schema名称 最小长度:1 最大长度:128 |
life_cycle |
Integer |
表的生命周期 最小值:0 最大值:1 |
description |
String |
表的描述 最小长度:1 最大长度:128 |
user_id |
String |
用户id,可在IAM侧用户信息中查询 最小长度:1 最大长度:128 |
user_name |
String |
用户名称 最小长度:1 最大长度:128 |
project_id |
String |
数据连接id。 最小长度:1 最大长度:128 |
create_time |
String |
表的创建时间 最小长度:1 最大长度:128 |
table_size |
Integer |
表的大小 最小值:0 最大值:4096 |
total_count |
Integer |
当前查询条件下表的总记录数 最小值:0 最大值:100 |
is_valid |
Integer |
表是否合规 最小值:0 最大值:1 |
extra_setting |
String |
表的额外设置 最小长度:1 最大长度:128 |
partitioned |
Boolean |
是否进行数据分区 缺省值:false |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
返回的错误信息。 最小长度:1 最大长度:1024 |
error_code |
String |
返回的错误码。 最小长度:1 最大长度:1024 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
返回的错误信息。 最小长度:1 最大长度:1024 |
error_code |
String |
返回的错误码。 最小长度:1 最大长度:1024 |
请求示例
无
响应示例
状态码: 200
Success,返回查询的表的列表
{ "tables" : [ { "description" : null, "table_id" : "NativeTable-9b18c0ad6ef5404caef4e6cbaccdae6f-postgres-dm_autotest-kuaallfuhe01", "table_name" : "kuaallfuhe01", "table_name_cn" : null, "columns" : null, "dw_id" : "9b18c0ad6ef5404caef4e6cbaccdae6f", "dw_name" : "dws_xiaoyu", "dw_type" : "DWS", "database_name" : "postgres", "schema_name" : "dm_autotest", "life_cycle" : 0, "user_id" : "ei_dayu_y00321344_01", "user_name" : null, "project_id" : null, "create_time" : null, "table_size" : 0, "total_count" : 15, "is_valid" : 1, "extra_setting" : null, "partitioned" : true } ], "total_count" : 15 }
状态码: 400
{ "error_code" : "DAYU.4402", "error_msg" : "The operation failed, detail msg {0}." }
状态码: 500
{ "error_code" : "DAYU.3531", "error_msg" : "Internal server error: {0}" }
状态码
状态码 |
描述 |
---|---|
200 |
Success,返回查询的表的列表 |
400 |
BadRequest |
500 |
Internal Server Error |