华为云用户手册

概述 本节主要介绍编排任务连接后的连接配置。提供了编排任务源端信息的配置说明。源端信息用于告诉ROMA Connect如何从源端获取待集成的数据，包括数据源、数据格式、数据范围等。对于不同的数据源类型，其源端信息配置有所差异。 支持“定时”模式的源端数据类型 支持“实时”模式的源端数据类型 API DB2 DWS MySQL MongoDB OBS Oracle PostgreSQL SQL Server ActiveMQ ArtemisMQ Kafka RabbitMQ

ArtemisMQ 返回页首 任务的“集成模式”为“实时”时，可以选择ArtemisMQ作为源端数据源。 在创建任务页面中配置源端信息。 表3 源端ArtemisMQ信息 参数 配置说明 目标端类型 选择ArtemisMQ数据源的消息传递模型，可选择“Topic”和“Queue”。 目标端名称 填写要获取数据的Topic或Queue名称，请确保该Topic或Queue已存在。 数据根字段 指从源端获取到的JSON格式数据中，元数据集上层公共字段的路径。“数据根字段”与元数据的“解析路径”组合，即为元数据的完整路径，具体请参见元数据解析路径配置说明。 元数据 指从源端获取到的JSON格式数据中，要集成到目标端的每一个底层key-value型数据元素。 别名：对元数据的自定义名称。 类型：元数据的数据类型，需要与源端数据中对应字段的数据类型一致。 解析路径：元数据的完整路径中，不包含数据根字段的路径部分，具体请参见元数据解析路径配置说明。 元数据解析路径配置说明： JSON格式数据中不含数组 如以下JSON格式数据，元素a的完整路径定义为a，元素b的完整路径为a.b，元素c的完整路径为a.b.c，元素d的完整路径为a.b.d。元素c和d为底层数据元素，即需要通过ROMA Connect集成到目标端的数据。 { "a": { "b": { "c": "xx", "d": "xx" } } } 此场景下，对于数据根字段和解析路径有三种配置方案： 数据根字段不设置 元素c的解析路径需要设置为a.b.c，元素d的解析路径需设置为a.b.d。 数据根字段设置为a 元数据的解析路径从元素a的下层路径开始。元素c的解析路径需要设置为b.c，元素d的解析路径需设置为b.d。 数据根字段设置为a.b 元数据的解析路径从元素b的下层路径开始。元素c的解析路径需要设置为c，元素d的解析路径需设置为d。 JSON格式数据中含数组 如以下JSON格式数据，元素a的完整路径定义为a，元素b的完整路径为a.b，元素c的完整路径为a.b[i].c，元素d的完整路径为a.b[i].d。元素c和d为底层数据元素，即需要通过ROMA Connect集成到目标端的数据。 { "a": { "b": [{ "c": "xx", "d": "xx" }, { "c": "yy", "d": "yy" } ] } } 此场景下，对于数据根字段和解析路径有三种配置方案： 数据根字段不设置 元素c的解析路径需要设置为a.b[i].c，元素d的解析路径需设置为a.b[i].d。 数据根字段设置为a 元数据的解析路径从元素a的下层路径开始。元素c的解析路径需要设置为b[i].c，元素d的解析路径需设置为b[i].d。 数据根字段设置为a.b 元数据的解析路径从元素b的下层路径开始。元素c的解析路径需要设置为[i].c，元素d的解析路径需设置为[i].d。 源端为ArtemisMQ的配置与ActiveMQ的类似，配置示例可参考ActiveMQ配置示例。

前提条件 已完成源端数据源和目标端数据源的接入，具体操作请参考接入数据源。 在源端数据源接入配置中，“数据库名”的大小写应与实际数据库名保持一致，否则会导致数据同步失败。 源端数据源已开启CDC功能，根据不同的数据源类型和CDC实现模式，具体操作请参考： 配置Oracle CDC（LogMiner）（推荐使用） 配置Oracle CDC（XStream） 配置MySQL CDC（Binlog） 配置SQL Server CDC 源端数据源中CDC归档日志的保留时间需要大于集成任务解析的日志时间，否则会造成集成任务找不到归档日志而导致增量同步失败。因此，数据集成任务停止运行的时间不宜过长。建议最少保留2天以上的归档日志。 在首次执行数据同步期间，建议不要对源端数据库做DDL操作。 如果创建组合任务个数过多，对数据库服务器、FDI插件进程均会产生资源消耗，所以建议对一个数据库，不要创建过多组合任务。 FDI支持单个CDC任务中配置多个Schema下的多个数据库表，实现统一的全量或增量采集能力。 组合任务在运行过程中支持添加表，选择重启后可对新表执行全量采集或者增量采集。 源端Oracle数据源： 大文本类型和二进制类型的字段不支持同步。 表名为小写的数据表不支持同步。 无主键的数据表不支持同步。 如果表中数据较少，建议通过每天采集一次全量数据的方式进行采集，目前PostgreSQL类型表支持写入前清空数据。对于从Oracle数据库采集数据，但表中没有主键的情况，可以利用Oracle内部的RowId作为主键，RowId一般是使用数字、字母生成18位长度的字符串。 名称为数据库自身保留字的数据表或数据字段不支持同步。 truncate方式删除的数据不支持同步，整表方式删除的数据不支持同步。 源端MySQL数据源： 如果MySQL数据库使用的是MGR集群模式，在接入源端数据源时，必须直接连接主节点，不能连节route节点。 如果MySQL数据库中数据量特别巨大，在首次执行数据同步时可能会连接数据库超时，可以通过修改MySQL数据库的超时参数interactive_timeout和wait_timeout来规避。

前提条件 在接入数据源前，请确保ROMA Connect实例与您的数据源所在网络互通。 若ROMA Connect实例与数据源在相同VPC内时，可直接访问数据源。 若ROMA Connect实例与数据源在同一区域的不同VPC内时，可通过创建VPC对等连接，将两个VPC的网络打通，实现同一区域跨VPC访问数据源。具体步骤请参考VPC对等连接说明。 若ROMA Connect实例与数据源在不同区域的不同VPC内时，可通过创建云连接实例并加载需要互通的VPC，将两个VPC的网络打通，实现跨区域跨VPC访问数据源。具体步骤请参考跨区域VPC互通。 若ROMA Connect实例与数据源通过公网互通，请确保ROMA Connect实例已绑定弹性IP。 若ROMA Connect实例跨VPC内网访问数据源时，需要完成实例到数据源所在子网的路由配置。

数据API支持的数据源 表2 数据API支持的数据源 数据源类型 支持的版本 Gauss100 FusionInsight_LibrA_V100R003C20、FusionInsight_LibrA_V300R001C00 MySQL 5.6，5.7，8.0 MRS HBase MRS 3.*.* MRS Hive MRS 3.*.* Oracle 11g PostgreSQL 11.0 SQL Server 2012、2014、2016、2017 DWS 1.3.4 HIVE 2.3.2 HANA 1.0 MongoDB 3.4 Redis 2.8.x，3.x.x

数据集成任务支持的数据源 表1中为数据集成所支持的全量数据源类型，具体每种数据源所支持的任务模式和集成模式请参见接入数据源。 连接数据源的用户需要有创建连接数据库会话的权限。 表1 数据集成支持的数据源 数据源类型 支持的版本 API 无版本号 ActiveMQ 5.15.9 ArtemisMQ 2.9.0 DB2 9.7 DIS 无版本号 DWS 1.3.4 DM 无版本号 FTP 无版本号 Gauss100 FusionInsight_LibrA_V100R003C20、FusionInsight_LibrA_V300R001C00 HL7 2.1、2.2、2.3、2.3.1、2.4、2.5、2.6、2.7、2.8、2.8.1 HANA 1.0 IBM MQ 9.1 Kafka 1.1.0、2.3.0 LDAP 无版本号 MongoDB 3.4 MQS 无版本号 MRS Hbase MRS 3.*.* MRS HDFS MRS 3.*.* MRS Hive MRS 3.*.* MRS Kafka MRS 3.*.* MySQL 5.7、8.0 OBS 3 Oracle 11.2g(不推荐)、12.1g(不推荐)、12.2g、19c PostgreSQL 11 RabbitMQ 3.6.10 RocketMQ 4.7.0 Redis 3.0.7、4.0.11 SAP SAP Java Connector 3.0.19 SNMP v1、v2、v3 SQL Server 2014、2019、2022 GaussDB(for MySQL) 2.0.15.6 WebSocket 无版本号 自定义数据源 无版本号

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“SAP”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表2 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 主机IP地址 填写SAP系统的应用服务器地址。 实例编号 填写SAP系统的应用服务器实例号，实例号由2位字母或数字组成。 客户编号 填写SAP系统中要连接的客户端号，客户端号由3位数字组成。 用户名 填写连接SAP客户端的用户名。 密码 填写连接SAP客户端的用户密码。 SAP数据源的接入配置示例如下图所示。 图1 SAP数据源配置示例 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

概述 ROMA Connect支持把SAP系统作为一个数据源，通过RFC的方式与SAP对接，并用于数据集成任务。在使用SAP数据源前，需要先接入数据源。接入的SAP数据源需要为数据集成任务开启SAP相关权限，具体见表1。 表1 SAP权限 对象类文本 授权对象 授权对象文本 授权 文本 值 跨应用授权对象 S_RFC 跨应用授权对象 RFC_TYPE 允许访问的 RFC 对象类型 FUNC 跨应用授权对象 S_RFC 跨应用授权对象 RFC_NAME 允许访问的 RFC 对象名称 DDIF_FIELDINFO_GET RFCPING RFC_GET_FUNCTION_INTERFACE /SAPDS/RFC_READ_TABLE2 SAPTUNE_GET_SUMMARY_STATISTIC TH_WPINFO RFC_FUNCTION_SEARCH_WITHGROUP 跨应用授权对象 S_RFC 跨应用授权对象 ACTVT 活动 16 跨应用授权对象 S_TCODE 事务开始时检查事务代码 TCD 事务代码 SM50 基础：管理 S_TABU_NAM 按通用标准工具访问表 ACTVT 活动 3 基础：管理 S_TABU_NAM 按通用标准工具访问表 表格 表名称 * 基础：管理 S_ADMI_FCD 系统授权 S_ADMI_FCD 系统管理功能 ST0R

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“Redis”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 连接地址 填写Redis的连接地址和端口号。如果有多个连接地址，可单击“添加地址”添加。 说明： 如果Redis数据源为集群版Redis，需要把全部节点地址都写上。如果只写一个节点地址，ROMA Connect会认为是单机版Redis，会导致访问集群版Redis失败。 密码 填写Redis的连接密码。 数据库编号 填写Redis的数据库编号，不填写则默认连接编号0的数据库。 Redis数据源的接入配置示例如下图所示。 图1 Redis数据源配置示例 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“DB2”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 连接模式 选择数据库的连接方式。 默认：使用系统默认方式连接数据库。 专业：使用JDBC连接字符串方式连接数据库。 连接地址 仅当“连接模式”选择“默认”时需要配置。 填写数据库的连接IP地址和端口号。 数据库名 仅当“连接模式”选择“默认”时需要配置。 填写要接入的数据库名。 连接字符串 仅当“连接模式”选择“专业”时需要配置。 填写DB2数据库的JDBC格式连接串，例如：jdbc:db2://{hostname}:{port}/{dbname}。 {hostname}为数据库的连接地址。 {port}为数据库的连接端口号。 {dbname}为要接入的数据库名。 用户名 填写连接数据库的用户名。 密码 填写连接数据库的用户密码。 数据源的接入配置示例如下所示。 默认方式的数据库连接配置示例： 图1 默认方式配置示例 专业方式的数据库连接配置示例： 图2 专业方式配置示例 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

操作步骤 建议由数据库管理员进行CDC功能的配置操作，以下配置以Linux环境为例进行说明。 开启Binlog。 使用命令行工具连接到MySQL数据库所在服务器，执行以下命令以root用户登录数据库。 mysql -uroot -ppassword 其中，password为数据库root用户的密码，可向数据库管理员获取。 执行以下命令，查询MySQL数据库是否开启了Binlog。 show variables like 'log_bin'; 若变量log_bin的值为“OFF”，则说明Binlog未开启，继续执行下一步。 若变量log_bin的值为“ON”，则说明Binlog已开启，继续执行以下SQL命令，检查相关参数的配置是否符合要求。 show variables like '%binlog_format%'; show variables like '%binlog_row_image%'; 变量binlog_format的值应该为“ROW”，变量binlog_row_image的值应该为“FULL”。如果满足要求，直接跳到2，否则继续执行下一步。 执行以下命令退出数据库。 exit; 执行以下命令编辑MySQL配置文件，然后按“i”进入输入模式。 vi /etc/my.cnf 在配置文件中增加如下配置，开启Binlog。 server-id = 123 log_bin = mysql-bin binlog_format = row binlog_row_image = full expire_logs_days = 10 gtid_mode = on enforce_gtid_consistency = on 其中： server-id的值应为大于1的整数，请根据实际规划设置，并且在创建数据集成任务时设置的“Server Id”值需要此处设置的值不同。 expire_logs_days为Binlog日志文件保留时间，超过保留时间的Binlog日志会被自动删除，应保留至少2天的日志文件。 “gtid_mode = on”和“enforce_gtid_consistency = on”仅当MySQL的版本大于等于5.6.5时才需要添加，否则删除这两行内容。 按“Esc”退出输入模式，然后输入“:wq”并回车，保存退出。 执行以下命令重启MySQL数据库。 service mysqld restart 以root用户登录数据库，执行以下命令，查询变量log_bin的值是否为“ON”，即是否已开启Binlog。 show variables like 'log_bin'; （可选）：当创建MySQL CDC任务Schema映射时，MySQL数据库需要先开启配置项：binlog_rows_query_log_events =1；可在如上第 e 步骤中配置。 在数据库中执行以下命令创建ROMA Connect连接数据库的用户并配置权限。 CREATE USER 'roma'@'%' IDENTIFIED BY 'password'; GRANT SELECT, RELOAD, SHOW DATABASES, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'roma'@'%'; 其中： roma为ROMA Connect连接用户名，请根据实际规划设置。 password为ROMA Connect连接用户密码，请根据实际规划设置。 （可选）如果MySQL数据库版本为8.0，则需要执行以下命令，修改数据库连接用户的密码认证方式。 ALTER USER roma IDENTIFIED WITH mysql_native_password BY 'password'; 其中： roma为2中创建的数据库连接用户名。 password为数据库连接用户的密码。 执行以下命令退出数据库连接。 exit;

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“PostgreSQL”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 连接模式 选择连接数据库模式。 默认：由系统根据用户配置自动拼接数据源连接字符串。 专业：由用户自己输入数据源连接字符串。 连接地址 仅当“连接模式”选择“默认”时需要配置。 填写数据库的连接IP地址和端口号。 数据库名 仅当“连接模式”选择“默认”时需要配置。 填写要接入的数据库名。 连接字符串 仅当“连接模式”选择“专业”时需要配置。 填写PostgreSQL数据库的JDBC格式连接串，例如：jdbc:postgresql://{hostname}:{port}/{dbname}。 {hostname}为数据库的连接地址。 {port}为数据库的连接端口号。 {dbname}为要接入的数据库名。 用户名 填写连接数据库的用户名。 密码 填写连接数据库的用户密码。 PostgreSQL数据源的接入配置与DB2类似，配置示例可参考DB2数据源接入配置示例。 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“FTP”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 协议 选择接入FTP数据源使用的协议，可选择“FTP”和“SFTP”。 连接地址 填写FTP数据源的连接地址和端口号。 用户名 FTP数据源的登录用户名。 密码 FTP数据源的登录密码。 连接模式 仅当“协议”选择“FTP”时需要配置。 选择FTP数据源的连接模式。 主动模式：FTP服务器主动连接客户端的数据端口。 被动模式：FTP服务器被动等待客户端连接自己的数据端口。 数据源的接入配置示例如下图所示。 图1 FTP数据源配置示例 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“Oracle”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 是否开启实时 选择是否开启数据库的实时模式。若该数据源用于数据集成组合任务的源端数据源时，需要选择“是”。 CDC模式 仅当“是否开启实时”选择“是”时需要配置。 选择数据库的CDC模式。 XStream：表示使用Oracle数据库XStream模式的CDC功能。 LogMiner：表示使用Oracle数据库LogMiner模式的CDC功能。 出站服务器 仅当“CDC模式”选择“XStream”时需要配置。 填写的出站服务器名称，需要与在配置Oracle CDC（XStream）中设置的出站服务器一致。 数据库模式 仅当“CDC模式”选择“LogMiner”时需要配置。 填写要同步数据表所在的schemas名称。若不填写，则默认使用数据库的用户名。 可插拔数据库 仅当“是否开启实时”选择“是”时需要配置。 填写要同步数据表所在的PDB名称。 连接模式 选择连接数据库模式。 默认：由系统根据用户配置自动拼接数据源连接字符串。 多地址：用户可以输入多个数据库的IP、Port，由系统根据用户配置自动拼接数据源连接字符串。 专业：由用户自己输入数据源连接字符串。 连接地址 仅当“连接模式”选择“默认”时需要配置。 填写数据库的连接IP地址和端口号。 数据库名 仅当“连接模式”选择“默认”时需要配置。 填写要接入的数据库名。 数据库地址列表 仅当“连接模式”选择“多地址”时需要配置。 填写分布式数据库系统的连接地址和端口号，单击“添加地址”添加多个地址和端口号。 服务名 仅当“连接模式”选择“多地址”时需要配置。 填写分布式数据库系统的服务名。 连接字符串 仅当“连接模式”选择“专业”时需要配置。 填写Oracle数据库的JDBC格式连接串，例如：jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST={hostname})(PORT={port}))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME={servicename})))。 {hostname}为数据库的连接地址。 {port}为数据库的连接端口号。 {servicename}为要接入的Oracle数据库服务名。 用户名 填写连接数据库的用户名。 密码 填写连接数据库的用户密码。 对于普通数据集成任务，Oracle数据源的接入配置与DB2类似，配置示例可参考DB2数据源接入配置示例。 对于组合任务，以接入Oracle的非CDB数据库为例，CDC模式为LogMiner，该Oracle数据源的接入配置示例如下图所示。 图1 Oracle数据源配置示例 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“Gauss100”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 连接模式 选择连接数据库模式。 默认：由系统根据用户配置自动拼接数据源连接字符串。 专业：由用户自己输入数据源连接字符串。 版本号 选择连接的版本号，支持V100R003C20和V300R001C00。 连接地址 仅当“连接模式”选择“默认”时需要配置。 填写数据库的连接IP地址和端口号。 数据库名 仅当“连接模式”选择“默认”时需要配置。 填写要接入的数据库名。 连接字符串 仅当“连接模式”选择“专业”时需要配置。 填写Gauss100数据库的JDBC格式连接串，格式：jdbc:postgresql://host:port/dbname。 host为数据库的连接地址。 port为数据库的连接端口号。 dbname为要接入的Gauss100数据库名。 用户名 数据库的登录用户名。 密码 数据库的登录密码。 Gauss100数据源的接入配置与DB2类似，配置示例可参考DB2数据源接入配置示例。 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“API”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 地址 填写API的请求URL地址，例如“https://example.com/test”。 Site实例中，地址需要填写为APIC连接地址的IP，例如“192.100.0.10”。 说明： 如果接入的API为服务集成中创建的API时，因为API的默认子域名每天最多只能访问1000次，建议不要使用API的默认子域名接入API，避免因超过访问次数限制后导致接入数据源失败。建议使用API的独立域名接入。 请求方式 选择API的请求方式。 认证方式 选择API的请求认证方式。 None：无需认证，任何人都可以调用API。 Basic Auth：使用用户名和密码进行认证，认证通过后才允许调用API。 用户名：输入Basic Auth认证所需的用户名。 密码：输入Basic Auth认证所需的密码。 AppKey Auth：使用AppKey和AppSecret对请求进行签名，签名校验通过后才允许调用API。 APP认证方式：选择如下三种APP认证方式。 Default：使用AppKey和AppSecret对请求进行签名，签名校验通过后才允许调用API。APIC的API默认使用此方式。 Secret：使用AppKey和AppSecret直接进行认证。 Jwt：使用AppKey、AppSecret以及调用时的时间戳生成签名信息，通过AppKey、签名以及时间戳进行认证。 AppKey：输入AppKey Auth认证所需的AppKey。 AppSecret：输入AppKey Auth认证所需的AppSecret。 OAuth2.0：调用接口时提供请求的header中需携带Authorization信息，接口获取header中的secret信息，校验成功后才允许调用。 授权类型：Authorization中的Token信息需要通过Access Token Url获取，所以需要选择授权类型。 Access Token Url：输入OAuth2.0认证的Access Token Url。 客户端标识：输入OAuth2.0认证所需的客户端标识。 客户端密匙：输入OAuth2.0认证所需的客户端密匙。 Scope：输入访问 API 的 Scope（作用域），Scope 用于限制应用程序访问 API 的权限。 Secret：使用密码进行认证，请求的header中携带secret信息，接口获取header中的secret信息，校验成功后才允许调用。 Secret：输入Secret认证所需的Secret。 MD5：使用MD5对body体参数加密后得到验证信息sign，请求的body体中携带sign相关信息，接口获取后，校验成功后才允许调用。 Secret：输入MD5认证所需的Secret。 HMAC：使用HMAC对body体参数加密后得到验证信息sign，请求的body体中携带sign相关信息，接口获取后，校验成功后才允许调用。 Secret：输入HMAC认证所需的Secret。 定制化认证方式：Key Top Auth、Hik Vision Auth、li He Auth等其他认证方式是商业伙伴定制的认证方式，仅定制此类认证方式的商业伙伴使用。需要根据选择的定制认证方式，填写具体的认证参数。 以接入ROMA Connect发布的一个API为例，API的认证方式为“APP认证”，该API数据源的接入配置示例如下图所示。 其中，认证方式选择“APPKey Auth”，APP认证方式保持默认“Default”即可，AppKey和AppSecret为API所授权集成应用的Key和Secret。 图1 API数据源配置示例 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查地址，请求方式，认证方式，AppKey、AppSecret是否填写正确，以及API是否可以正常访问，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

操作步骤 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“数据源管理”，单击页面右上角的“接入数据源”。 在接入数据源页面的“默认数据源”页签下，选择“DM”类型的数据源，然后单击“下一步”。 在页面中配置数据源的连接信息。 表1 数据源连接信息 参数 配置说明 数据源名称 填写数据源的名称，根据规划自定义。建议您按照一定的命名规则填写数据源名称，方便您快速识别和查找。 编码格式 默认“utf-8”格式。 集成应用 选择数据源所归属的集成应用。 描述 填写数据源的描述信息。 连接模式 选择数据库的连接方式。 默认：使用系统默认方式连接数据库。 专业：使用JDBC连接字符串方式连接数据库。 连接地址 仅当“连接模式”选择“默认”时需要配置。 填写数据库的连接IP地址和端口号。 连接字符串 仅当“连接模式”选择“专业”时需要配置。 填写DM数据库的JDBC格式连接串，例如：jdbc:dm://{hostname}:{port}。 {hostname}为数据库的连接地址。 {port}为数据库的连接端口号。 用户名 填写连接数据库的用户名。 密码 填写连接数据库的用户密码。 完成数据源接入配置后，单击“开始检测”，检测ROMA Connect与数据源之间是否能够连通。 若测试结果为“数据源连接成功！”，则继续下一步。 若测试结果为“数据源连接失败！”，则检查数据源状态和数据源连接参数配置，然后单击“重新检测”，直到连接成功为止。 单击“创建”，完成数据源的接入。

使用流程 ROMA Connect是一个全栈式的应用与数据集成平台，聚焦应用和数据连接，提供数据、API、消息和设备的集成能力，适用于多种常见的企业系统集成场景。 使用ROMA Connect进行系统集成的流程如下图所示。 图1 ROMA Connect使用流程 创建实例。 在ROMA Connect服务控制台创建一个ROMA Connect实例，实例规格配置根据实际业务情况选择。 创建集成应用。 在实例控制台创建一个集成应用，实例中的所有资源都要有归属的集成应用。 根据不同的业务场景，选择使用不同ROMA Connect功能。 数据集成：接入源端和目标端数据源，然后通过集成任务进行源端到目标端的数据集成。 服务集成：把已有后端服务、数据源和自定义函数封装成标准的RESTful API，并对外开放。 消息集成：创建消息Topic，不同系统通过Topic进行对接，发送和接收消息。 设备集成：在云端定义设备模型和注册设备，设备通过集成SDK接入云端，发送和接收消息。

日志字段说明 序号 字段 说明 1 remote_addr 客户端地址。 2 request_id 请求ID。 3 api_id API ID。 4 user_id 当使用IAM认证访问时，请求方提供的项目ID。 5 app_id 当使用APP认证访问时，请求方提供的APP ID。 6 time_local 请求时间。 7 request_time 请求时延（单位：s）。 8 request_method HTTP请求方法。 9 host 请求域名。 10 router_uri 请求URI。 11 server_protocol 请求协议。 12 status 响应状态码。 13 bytes_sent 响应大小（包含状态行、响应头、响应体），单位：字节。 14 request_length 请求长度（包含起始行、请求头、请求体），单位：字节。 15 http_user_agent 用户代理标识。 16 http_x_forwarded_for X-Forwarded-For头。 17 upstream_addr 后端地址。 18 upstream_uri 后端URI。 19 upstream_status 后端响应状态码。 20 upstream_connect_time 与后端建立连接所用时间。 21 upstream_header_time 从开始与后端建立连接到从后端获取到首字节所用时间，单位秒。 22 upstream_response_time 从开始与后端建立连接到从后端获取到最后一个字节所用时间，单位秒。 23 region_id 可用区ID。 24 all_upstream_response_time 从开始与后端建立连接到从后端获取到最后一个字节所用时间，单位秒。发生重试时，为所用时间总和。 25 errorType API请求的错误类型。 0：非流控错误。 1：流控错误。 26 auth_type API认证类型。 27 access_model1 认证模式1。 28 access_model2 认证模式2，开启双重认证时，为自定义认证编号。 29 inner_time APIC的内部处理时长，单位秒。 30 proxy_protocol_vni VPC终端节点的虚拟网络标识。 31 proxy_protocol_vpce_id VPC终端节点的ID。 32 proxy_protocol_addr 客户端源IP地址。 33 body_bytes_sent API请求的Body体大小，单位字节。 34 api_name API名称。 35 app_name 当使用APP认证访问时，请求方使用的APP名称。 36 provider_app_id API所属的APP ID。 37 provider_app_name API所属的APP名称。 38 custom_data_log1 用户自定义日志字段值1。 39 custom_data_log2 用户自定义日志字段值2。 40 custom_data_log3 用户自定义日志字段值3。 41 custom_data_log4 用户自定义日志字段值4。 42 custom_data_log5 用户自定义日志字段值5。 43 custom_data_log6 用户自定义日志字段值6。 44 custom_data_log7 用户自定义日志字段值7。 45 custom_data_log8 用户自定义日志字段值8。 46 custom_data_log9 用户自定义日志字段值9。 47 custom_data_log10 用户自定义日志字段值10。 48 response_source 请求响应来源。 local：APIG。 remote：后端服务。

功能介绍 数据库管理 WiseDBA为用户提供统一的数据库管理平台，支持用户级的管理、监控、可视化的数据库交互等功能，为用户节省50%以上的管理成本，提高数据库运维效率。 数据查询 数据查询工具可以帮助业务简化现网的SQL查询流程，避免SRE直接操作数据库。 SQL变更 SQL自动化变更工具可以帮助业务简化现网的SQL变更流程。 实时诊断 WiseDBA为数据库实例提供运维全生命的智能分析服务，让用户既可以直观地感知数据库实例的实时运行状况，也可以定位实时异常，并根据WiseDBA建议进行系统优化。

验证码异常 可能原因： 验证码输入错误。 输入验证码为非本账号的虚拟MFA验证码。 MFA验证码的生成机制和时间相关，如果手机时间和虚拟MFA设备后台服务的系统时间相差30秒以上，生成的MFA验证码将不能通过校验。 解决方法： 确保输入正确的验证码。 联系管理员在管理控制台上删除该用户的MFA设备，终端用户重新通过云桌面客户端登录，重新绑定虚拟MFA设备获取验证码。 请设置手机时间为自动更新后重新验证。（注意手机时间和时区无关，后台会自动转化为世界协调时间，即UTC时间戳。）

登录时提示受策略限制无法登录该如何处理？ 在账号密码输入页面，单击右上角服务器地址，展开服务器列表。 选择修改当前登录服务器地址或者添加新的服务器地址。 修改当前登录服务器地址： 在当前登录地址所在行，单击，修改接入地址为云专线接入地址。 云专线接入地址可联系管理员在云桌面管理控制台的“租户配置”页面获取。 单击“确认修改”。 添加新的服务器地址： 单击“添加新服务器”，输入云专线接入地址和企业ID。 云专线接入地址和企业ID可联系管理员在云桌面管理控制台的“租户配置”页面获取。 单击“确认新增”。 尝试重新登录。 成功登录，则结束操作。 依然无法登录，请联系管理员处理。 父主题： 登录问题

Windows云桌面如何开启RDP？ 开启桌面远程 使用客户端登录云桌面。 在云桌面中按“Win + r”，输入“sysdm.cpl”，弹出系统属性窗口。 在系统属性窗口页面选择“远程”页签，选择“允许远程连接到此计算机”，如图1所示。 图1 系统属性 单击“确定”。 开通桌面上网 参考开通小规模经济型开通云桌面上网功能。 给云桌面绑定3389端口 登录管理控制台。 在待开启RDP云桌面单击安全组，进入安全组基本信息页面，如图2所示。 图2 安全组 在安全组入方向规则下添加3389规则，如图3所示。 图3 添加3389规则 父主题： 管理员常见问题

云桌面的用户认证方式是否可修改？ 已购买的桌面，不支持修改用户认证方式。 如果已购桌面的认证方式选择错误，需在未购买过桌面的其他项目中重新购买桌面，并为新桌面配置需要的用户认证方式。为防止资源浪费，请在购买桌面时参考如下说明谨慎选择对接AD或者不对接AD。 企业未部署用于用户认证的Windows AD，则购买桌面时选择“不对接AD”，即云桌面使用华为自有的账号认证系统进行用户认证。 企业已有的统一AD进行用户认证，且需要云桌面也使用此认证方式，则购买桌面时选择“对接AD”，即云桌面使用企业Windows AD进行用户认证。 购买云桌面的具体操作请参见购买桌面。 项目相关操作请参见IAM项目。 父主题： 管理员常见问题

忘记帐户密码怎么办？ 当您遗失或忘记登录密码时，可联系管理员处理。 对于对接AD的桌面用户，管理员在AD服务器上处理后，将重置的密码告知用户。 对于未对接AD的桌面用户，管理员在云桌面管理控制台上处理后系统会将重置密码的地址发送预留邮箱，用户单击邮件中的地址即可重置密码。 邮件中重置密码的地址链接有效时间为24小时，请及时进行密码重置。 当您遗失或忘记登录密码时，还可以参考如下操作自主重置密码： 在登录界面单击“忘记密码”，进入“重置密码申请”页面。 在“重置密码申请”页面输入用户名、用户邮箱、企业ID，单击“确定”。 如果提示账号为AD域账号，请联系管理员处理。 收到重置邮件后，在邮件中单击重新设置密码的链接，进入重置密码页面，根据页面提示重新设置密码，单击“确定”。 邮件中重置密码的地址链接有效时间为24小时，请及时进行密码重置。 父主题： 登录问题

操作步骤 方式一：联系主账号进行委托授权。委托授权仅需操作一次，因此若主账号授权了，则IAM用户不再需要进行委托开通。 方式二：请联系主账号给该IAM用户添加Security Administrator权限，添加后该子用户方可进行委托开通操作。 进入统一身份认证服务，如图1所示。 图1 统一身份认证服务入口 进入用户组，选择该用户所在的一个用户组，单击【授权】，如图2所示。 图2 用户组列表 选择权限授权，在右侧搜索框中输入“Security Administrator”搜索并勾选，单击“下一步”，如图3所示。 图3 授权 选择区域。 使用默认的“所有资源”，单击“确定”，如图4所示。 图4 授权

前提条件 已获得需要访问互联网的桌面所在区域、项目、使用的VPC和子网信息。 管理员已具有NAT服务和EIP服务的操作权限。 自主注册的华为账号默认拥有华为云所有服务的操作权限，如果您使用的是此类账号，无需再进行确认。 华为账号下新建的IAM账号，需要加入“admin”内置用户组，或者拥有NAT服务和EIP服务操作权限的用户组，才可使用NAT服务和EIP服务。可进入“统一身份认证服务”中查看是否属于“admin”内置用户组。如果非“admin”内置用户组，请参见NAT服务授权、EIP服务授权赋予IAM账号使用NAT服务和EIP服务的权限。

操作场景 管理员购买云桌面后，云桌面默认在VPC子网内，此时云桌面无法访问互联网。管理员需要通过配置NAT网关共享弹性公网IP的方式，使云桌面能够访问互联网。可通过云桌面中的快捷入口开通互联网，也可以自行进入NAT、EIP控制台中购买对应服务。 此章节介绍如何进入NAT、EIP页面购买对应服务，使云桌面能够访问互联网。管理员也可以参考配置云桌面可访问互联网节通过云桌面提供的购买NAT和EIP快捷入口的方式开通互联网。

操作步骤 登录管理控制台。 在左侧导航中单击“上网管理”。 进入“互联网访问”页面。 单击互联网页面右上角“开通互联网”。 弹出“开通互联网”界面。 配置开通互联网信息。 开通类型。 小规模经济型（弹性公网IP）：小规模经济型通过弹性公网Ip访问互联网，每个桌面绑定一个EIP，适用于桌面数量少的场景。 开通小规模经济型互联网会为您创建以下网络资源： 弹性公网IP（Elastic IP）提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。 计费模式，用户可根据需求自行选择。 包年/包月，如表1所示。 按需计费，如表2所示。 表1 包年/包月 参数类型 说明 样例 计费方式 选择“包年/包月”计费方式。 包年/包月 带宽大小 宽带大小范围为1~200Mbit/s，用户可自定义，用户可根据界面提示的范围自定义。 - 企业项目 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。用户根据需求自行选择。 - 购买时长 根据需要选择购买时长。 说明： 用户可自行选择是否勾选“自动续费”。 - 选择桌面 根据桌面名称搜索需要开通互联网的云桌面。 - 表2 按需计费 参数类型 说明 样例 计费方式 选择“按需计费”。 按需计费。 公网宽带 按业务场景选择带宽计费类型。 按带宽计费：指定带宽上限，按使用时间计费，与使用的流量无关。适用于流量较大或较稳定场景使用。带宽范围：1~1780Mbit/s。 按流量计费：指定带宽上限，按实际使用的出公网流量计费，与使用时间无关。适用于流量小或流量波动较大的场景。带宽范围：1~180Mbit/s - 选择桌面 根据桌面名称搜索需要开通互联网的云桌面。 - 计费方式选择“包年/包月”执行5~9，完成操作。 计费方式选择“按需”执行10~11，完成操作。 单击“确认配置”，进入“开通互联网”配置信息界面。 单击“确认”，进入“购买云桌面”界面。 检查“云服务订单”和所需支付费用。 选择以下支付方式： 余额支付。 在线支付，支持多种平台在线支付方式。 选定支付方式并成功付款后，购买完成。 单击“确认配置”，进入“开通互联网”配置信息界面。 单击“确认”，购买完成。

前提条件 如果需要配置AD域，请先参考配置云桌面和Windows AD网络互通（多个子项目对接同一个AD服务器时，需要先参考配置云桌面和Windows AD网络互通使待对接的所有子项目网络与Windows AD网络互通），在AD服务器上开启相关端口，并准备以下数据： 域名 域管理员账号 域管理员密码 主域控制器名称 主域控制器IP地址 主DNS服务器IP地址 备域控制器名称（可选） 备域控制器IP地址（可选） 备DNS服务器IP地址（可选）