文档首页> 智能数据洞察 DataArts Insight> API参考> 数据源> 获取数据源列表
更新时间：2024-05-16 GMT+08:00
查看PDF
分享

获取数据源列表

功能介绍

获取数据源列表。

URI

GET /v1/{project_id}/connections

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参考获取项目ID。

最小长度：0

最大长度：128
表2 Query参数

参数

是否必选

参数类型

描述

all

否

Boolean

是否返回全部数据源列表。

limit

否

Integer

返回最大条数。

最小值：0

最大值：2147483647

缺省值：10

offset

否

Integer

偏移量。

最小值：0

最大值：2147483647

缺省值：0

name

否

String

数据源搜索值（按名称模糊匹配）。

最小长度：0

最大长度：512

type

否

String

数据源类型：MySQL、PostgreSQL、DWS、OpenGauss、DLI、ClickHouse、API、Doris。

枚举值：

  • MySQL
  • PostgreSQL
  • DWS
  • OpenGauss
  • DLI
  • ClickHouse
  • API
  • Doris

sort_key

否

String

排序字段：支持name、creation_date、update_date。

最小长度：0

最大长度：32

sort_dir

否

String

排序类型：ASC、DESC。

最小长度：0

最大长度：64

枚举值：

  • ASC
  • DESC

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Workspace-Id

是

String

工作空间ID，即控制台的项目ID。

最小长度：0

最大长度：128

X-Auth-Token

是

String

用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。

最小长度：0

最大长度：8192

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

page_data

Array of DataConnectionVO objects

分页数据。

数组长度：0 - 2147483647

count

Long

数据总数。

最小值：0

最大值：9223372036854775807
表5 DataConnectionVO

参数

参数类型

描述

id

String

数据源ID。

最小长度：1

最大长度：128

name

String

数据源名称。

最小长度：1

最大长度：512

description

String

数据源描述。

最小长度：0

最大长度：128

host

String

数据源ip或域名。

最小长度：1

最大长度：128

port

Integer

端口。

最小值：0

最大值：2147483647

server_list

String

服务列表。

最小长度：1

最大长度：512

database_name

String

数据库名称。

最小长度：1

最大长度：512

user_name

String

用户名。

最小长度：1

最大长度：64

url

String

jdbc连接url。

最小长度：0

最大长度：512

test_url

String

jdbc连接test_url。

最小长度：0

最大长度：512

password

String

连接数据库密码。

最小长度：0

最大长度：512

source_instance_id

String

关联云实例id。

最小长度：0

最大长度：255

vpc_connection_id

String

关联云实例vpc_connection_id。

最小长度：0

最大长度：255

project_id

String

项目ID。

最小长度：0

最大长度：64

domain_id

String

用户domainId。

最小长度：0

最大长度：64

region_id

String

所属regionID。

最小长度：0

最大长度：64

work_space_id

String

所属工作空间ID。

最小长度：0

最大长度：64

extra

String

网络配置信息。

最小长度：0

最大长度：65535

config

DcConfigVO object

配置信息。

type

String

数据源类型：MySQL、PostgreSQL、DWS、OpenGauss、DLI、ClickHouse、API、Doris。

枚举值：

  • MySQL
  • PostgreSQL
  • DWS
  • OpenGauss
  • DLI
  • ClickHouse
  • API
  • Doris

source

String

数据源来源：rds、dws、mrs、gaussdb、public、restapi、dli。

最小长度：1

最大长度：64

mode

String

模式.

最小长度：1

最大长度：64

default_schema

String

默认schema.

最小长度：0

最大长度：255
表6 DcConfigVO

参数

参数类型

描述

ssl

Boolean

ssl参数配置。

region_id

String

归属regionId；当前不支持跨region，值只能是当前regionId。

最小长度：1

最大长度：20

catalog_name

String

数据目录名称；默认值：dli；DLI自有catalog值为dli。

缺省值：dli

最小长度：0

最大长度：100

catalog_type

String

数据目录类型，默认值：dil，枚举值：

  • dli：DLI自有catalog；
  • lakeformation：lakeformation的数据目录。

缺省值：dli

最小长度：0

最大长度：10

ds_project_id

String

DLI队列归属rpojectId。

最小长度：0

最大长度：100

queue_name

String

SQL队列。

最小长度：1

最大长度：200

auth_type

String

验证方式；AKSK。

枚举值：

  • AKSK

ds_ak

String

用户ak（验证方式为AKSK时必填）。

最小长度：0

最大长度：500

ds_sk

String

用户sk（验证方式为AKSK时必填）。

最小长度：0

最大长度：500

time_out

Integer

API数据源时，请求超时时间。

最小值：0

最大值：2147483647

protocol

String

协议：REST。

最小长度：0

最大长度：50

token_key

String

token key。

最小长度：0

最大长度：10000

token_value

String

token value。

最小长度：0

最大长度：2000

resp_param

Array of ResponseParamVO objects

返回参数。

数组长度：0 - 1000

param_example

String

API数据源参数示例。

最小长度：0

最大长度：1000

request_url

String

API数据源时，请求url。

最小长度：0

最大长度：1000

request_method

String

请求方式：GET、POST。

最小长度：0

最大长度：100

枚举值：

  • GET
  • POST

request_params

Array of RequestParamDto objects

请求参数列表。

数组长度：0 - 1000
表7 ResponseParamVO

参数

参数类型

描述

select

Boolean

是否选中当前参数。

json_path

String

json路径。

最小长度：0

最大长度：512

alias_name

String

参数别名。

最小长度：0

最大长度：512

field_type

String

参数类型：String、Long、Decimal、DateTime、Bool。

最小长度：0

最大长度：100

param_name

String

参数名称。

最小长度：0

最大长度：32
表8 RequestParamDto

参数

参数类型

描述

location

String

位置。

最小长度：0

最大长度：100

value

Array of strings

参数值。

最小长度：0

最大长度：1000

数组长度：0 - 100

tag_id

String

标签ID，当param_source为user时必填。

最小长度：0

最大长度：128

param_name

String

参数名称。

最小长度：0

最大长度：500

alias_name

String

参数别名。

最小长度：0

最大长度：128

field_type

String

参数类型：String、Long、Decimal、List<String>、List<Long>、List<Decimal>、DateTime、Bool、PageIndex、PageNum。

最小长度：0

最大长度：50

param_source

String

参数来源：custom、user、userGroup。

最小长度：0

最大长度：50

type

Boolean

是否加密。

请求示例

获取数据源列表。

GET /v1/{project_id}/connections

响应示例

状态码： 200

数据源列表详情。

{
  "count" : 100,
  "page_data" : [ {
    "id" : "xxxxxxx796649a185b012a96xxxxxxx",
    "name" : "test_name",
    "host" : "xxx.xx.x.xx",
    "port" : 80,
    "server_list" : "xxx.xx.x.xx:xxxx",
    "database_name" : "db_name",
    "user_name" : "test_name",
    "test_url" : "jdbc:gaussdb://xxx.xx.x.xx:xxxx/gaussdb?socketTimeout=120&loginTimeout=5&ssl=true",
    "project_id" : "xxxxxxxb4dac4055888643b331axxxxxxx",
    "domain_id" : "xxxxxxxcf3c90428fb22606b64dxxxxxxx",
    "work_space_id" : "xxxxxxxa5ea0764ffa850664804b9xxxxxxx",
    "extra" : "[{\"ip\": \"xxx.xx.x.xx\", \"port\": xxxx, \"channelType\": \"eip\"}]",
    "config" : {
      "ssl" : true
    },
    "type" : "DWS",
    "source" : "public",
    "mode" : "multi-node",
    "default_schema" : "public",
    "creation_user" : "xxxxxxx63a94b0ba2887b8xxxxxxx",
    "creation_date" : 1700114987113,
    "creation_user_name" : "ei_dlv_l00456193_01",
    "update_user" : "xxxxxxxa863a94b0ba2887b80dxxxxxxx",
    "update_user_name" : "name1",
    "update_date" : 1701071948929
  } ]
}

状态码

状态码

描述

200

数据源列表详情。

错误码

请参见错误码。

父主题： 数据源
分享：

    相关文档

    相关产品