更新时间:2024-11-06 GMT+08:00

创建连接(待下线)

连接管理能力由管理中心统一提供,相关接口已不再维护,推荐使用管理中心API进行连接管理。

功能介绍

创建一个新连接,当前支持的连接类型有DWS、DLI、SparkSQL、HIVE、RDS、CloudTable。

URI

  • URI格式

    POST /v1/{project_id}/connections

  • 参数说明
    表1 URI参数说明

    参数名

    是否必选

    参数类型

    说明

    project_id

    String

    项目编号,获取方法请参见项目ID和账号ID

请求参数

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

String

工作空间id。

  • 如果不设置该参数,默认查询default工作空间下的数据。
  • 如果需要查询其他工作空间的数据,需要带上该消息头。
表3 Connection参数说明

参数名

是否必选

参数类型

说明

name

String

连接名称,只能包含四种字符:英文字母、数字、中划线和下划线,且长度小于等于100个字符。连接名称不能重复。

type

String

连接类型,包含:

  • DWS
  • DLI
  • SparkSQL
  • HIVE
  • RDS
  • CloudTable
  • HOST

config

Map<String,String>

连接的配置项,不同类型的连接配置项不同。DLI类型的连接不需要配置。config参数,其他类型的连接请参考连接配置项说明。

description

String

描述,长度不能超过255个字符。

表4 DWS类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

String

DWS集群名称。

通过DWS管理控制台获取集群名称:

  1. 登录管理控制台。
  2. 单击“数据仓库服务”,左侧列表选择集群管理。

在集群管理列表中可以获取到集群名称。

默认值为空。

ip

String

DWS集群的访问地址。

通过DWS管理控制台获取访问地址:

  1. 登录管理控制台。
  2. 单击“数据仓库服务”,左侧列表选择集群管理。
  3. 单击集群名称,进入集群基本信息页面。

在数据库属性标签中可以查看到内网IP,如果有多个IP地址,选择第一个IP。

默认值为空。

port

String

DWS集群的访问端口。

通过DWS管理控制台获取访问集群的访问端口:

  1. 登录管理控制台。
  2. 单击“数据仓库服务”,左侧列表选择集群管理。
  3. 单击集群名称,进入集群基本信息页面。

在数据库属性标签中可以获取到端口信息。

例如8000,默认值为空。

userName

String

数据库的用户名,创建DWS集群的时输入的用户名。

password

String

数据库的访问密码,创建DWS集群的时候输入的密码。

sslEnable

boolean

是否使用ssl连接。

kmsKey

String

KMS密钥名称。

通过KMS管理控制台获取密钥名称:

  1. 登录管理控制台。
  2. 单击“密钥管理服务”,左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

agentName

String

连接代理,即CDM集群名称。

通过DataArts Studio管理控制台 > 数据集成,在批量数据迁移集群列表可以获取到集群名称。

表5 Spark SQL类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

String

MRS集群名称。

通过MRS管理控制台获取集群名称:

  1. 登录管理控制台。
  2. 单击“MapReduce服务”,左侧列表选择现有集群。

在现有集群中可以获取到集群名称,例如mrsCluster1。

connectionMethod

String

连接方式:

  • agent :通过代理连接。
  • direct :直接连接。

userName

String

MRS集群的用户名,通过代理连接的时候,是必选项。

password

String

MRS集群的访问密码,通过代理连接的时候,是必选项。

agentName

String

连接代理,即CDM集群名称。通过代理连接的时候,是必选项。

通过DataArts Studio管理控制台 > 数据集成,在批量数据迁移集群列表可以获取到集群名称。

kmsKey

String

KMS密钥名称。通过代理连接的时候,是必选项。

通过KMS管理控制台获取密钥名称:

  1. 登录管理控制台。
  2. 单击“密钥管理服务”,左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

表6 Hive类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

String

MRS集群名称,例如mrsCluster1

connectionMethod

String

连接方式:

  • agent:通过代理连接。
  • direct :直接连接。

userName

String

MRS集群的用户名,通过代理连接的时候,是必选项。

password

String

MRS集群的访问密码,通过代理连接的时候,是必选。

agentName

String

连接代理,即CDM集群名称。通过代理连接的时候,是必选项。

通过DataArts Studio管理控制台 > 数据集成,在批量数据迁移集群列表可以获取到集群名称。

kmsKey

String

KMS密钥名称。通过代理连接的时候,是必选项。

通过KMS管理控制台获取密钥名称:

  1. 登录管理控制台。
  2. 单击“密钥管理服务”,左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

表7 RDS类型的连接配置项说明

参数名

是否必选

参数类型

说明

ip

String

RDS的访问地址。

通过RDS管理控制台获取访问地址:

  1. 登录管理控制台。
  2. 单击“关系型数据库服务”,从左侧列表选择实例管理。
  3. 单击某一个实例名称,进入实例基本信息页面。

在连接信息标签中可以获取到内网地址。

port

String

RDS的访问端口。

通过RDS管理控制台获取访问端口:

  1. 登录管理控制台。
  2. 单击“关系型数据库服务”,左侧列表选择实例管理。
  3. 单击某一个实例名称,进入实例基本信息页面。

在连接信息标签中可以获取到数据库端口。

userName

String

数据库的用户名,创建集群的时候,输入的用户名。

password

String

数据库的访问密码,创建集群的时候,输入的密码。

kmsKey

String

KMS密钥名称。

通过KMS管理控制台获取密钥名称:

  1. 登录管理控制台。
  2. 单击“密钥管理服务”,左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

agentName

String

连接代理,即CDM集群名称。

通过DataArts Studio管理控制台 > 数据集成,在批量数据迁移集群列表可以获取到集群名称。

driverName

String

驱动程序名称:

  • com.mysql.jdbc.Driver
  • org.postgresql.Driver

driverPath

String

驱动在OBS上路径。

表8 CloudTable类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

String

CloudTable集群名称

通过CloudTable管理控制台获取集群名称:

  1. 登录管理控制台。
  2. 单击“表格存储服务”,左侧列表选择集群模式。

在集群模式中可以获取到集群名称。

表9 HOST类型的连接配置项说明

参数名

是否必选

参数类型

说明

ip

String

主机的地址

port

String

主机的SSH端口号

userName

String

主机的登录用户名

password

String

主机的登录方式为密码时,填写主机的登录密码。

agentName

String

连接代理,即CDM集群名称。

通过DataArts Studio管理控制台 > 数据集成,在批量数据迁移集群列表可以获取到集群名称。

kmsKey

String

KMS密钥名称。

通过KMS管理控制台获取密钥名称:

  1. 登录管理控制台。
  2. 单击“密钥管理服务”,左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

响应参数

请求示例

创建一个连接。
POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/connections
{
    "name":"connection1",
    "type":"DWS",
    "config":{
	    "clusterName":"test",
	    "userName":"dbadmin",
            "password":"*********",
	    "kmsKey":"cdm-dlf",		
	    "agentName":"cdm-donotdelete",		
	    "sslEnable":false
    }
}

响应示例

  • 成功响应

    HTTP状态码 204

  • 失败响应

    HTTP状态码 400

    {
        "error_code":"DLF.6309",
        "error_msg":"The name already exists."
    }

状态码

状态码请参见状态码