Help Center/ DataArts Studio/ User Guide/ Management Center/ Configuring DataArts Studio Data Connection Parameters/ MRS Iceberg Connection Parameters
Updated on 2026-08-13 GMT+08:00
View PDF
Share

MRS Iceberg Connection Parameters

Table 1 MRS Iceberg connection

Parameter

Mandatory

Description

Data Connection Type

Yes

MRS Iceberg is selected by default and cannot be changed.

Name

Yes

Name of the data connection to create. Data connection names can contain a maximum of 100 characters. They can contain only letters, digits, underscores (_), and hyphens (-).

Description

No

A description which can help identify the data connection more easily. It can contain a maximum of 100 characters.

Tag

No
Attribute of the data connection to create. Tags make management easier.
NOTE:

The tag name can contain only letters, digits, and underscores (_) and cannot start with an underscore (_) or contain more than 100 characters.

Applicable Modules

Yes

Select the modules for which this connection is available.

NOTE:
  • When offline or real-time data migration jobs are enabled, you can select the DataArts Migration module. Then you can select this data connection when creating a data migration job in DataArts Factory.
  • You can use offline or real-time data migration jobs only after you apply for the whitelist membership. To use this feature, contact customer service or technical support.

Network Connectivity Configuration

Connection Mode

No
Select the connection mode. If you do not need to access MRS clusters in other projects or enterprise projects, select Cluster Name Mode.
  • Cluster Name Mode: Select an existing cluster. You can only connect to an MRS cluster in the same project and enterprise project.
  • If you select Connection String Mode, you can set Manager IP and enable communication between this connection's agent (CDM cluster) and an MRS cluster in another project or enterprise project so that you can access the MRS cluster.

MRS Cluster Name

Yes

This parameter is mandatory when MRS API connection is selected for Connection Type or Cluster Name Mode is selected for Connection Mode.

The name of the MRS cluster. Select an MRS cluster that Hive belongs to. Only MRS clusters are supported. A Hadoop cluster can be selected only after it is managed by MRS. All the MRS clusters with the same project ID and enterprise project are displayed.
NOTE:
  • When connecting to a component of the MRS cluster, you need to enable the port of the component in the outbound rule of the security group of the MRS cluster. For details about the port of each component, see Common Ports for MRS Cluster Services.

  • DataArts Studio does not support MRS clusters whose Kerberos encryption type is aes256-sha2,aes128-sha2, and only supports MRS clusters whose Kerberos encryption type is aes256-sha1,aes128-sha1.

If the connection fails after you select a cluster, check whether the MRS cluster can communicate with the CDM instance which functions as the agent. They can communicate with each other in the following scenarios:
  • If the CDM cluster in the DataArts Studio instance and the MRS cluster are in different regions, a public network or a dedicated connection is required. If the Internet is used for communication, ensure that an EIP has been bound to the CDM cluster, and the MRS cluster can access the Internet and the port has been enabled in the firewall rule.
  • If the CDM cluster in the DataArts Studio instance and the MRS cluster are in the same region, VPC, subnet, and security group, they can communicate with each other by default. If they are in the same VPC but in different subnets or security groups, you must configure routing rules and security group rules. For details about how to configure routing rules, see Configuring Routing Rules. For details about how to configure security group rules, see Configuring Security Group Rules.
  • The MRS cluster and the DataArts Studio workspace belong to the same enterprise project. If they do not, you can modify the enterprise project of the workspace.
NOTE:

If an agent is connected to multiple MRS clusters and one of the MRS clusters is deleted or abnormal, connections to the other MRS clusters will be affected. Therefore, you are advised to connect an agent to only one MRS cluster.

Manager IP

No

This parameter is mandatory when Connection String Mode is selected for Connection Mode.

Set this parameter to the floating IP address of MRS Manager. Only MRS clusters are supported. A Hadoop cluster can be connected only after it is managed by MRS.
NOTE:

DataArts Studio does not support MRS clusters whose Kerberos encryption type is aes256-sha2,aes128-sha2, and only supports MRS clusters whose Kerberos encryption type is aes256-sha1,aes128-sha1.

You can click Select next to the text box and select an MRS cluster in the same project and enterprise project. If you want to access an MRS cluster in another project or enterprise project, obtain and enter the floating IP address of MRS Manager and ensure that the connection's agent (CDM cluster) can communicate with the tenant-plane MRS cluster. To obtain the floating IP address of MRS Manager, log in to the active master node of the MRS cluster and run the ifconfig command. In the command output, the IP address of eth0:wsom is the floating IP address of MRS Manager. For details about how to log in to the master node of the MRS cluster, see Logging In to an ECS.

Enter multiple IP addresses based on the scenario in sequence and separate them with commas (,), for example, 127.0.0.1 or 127.0.0.1,127.0.0.2,127.0.0.3.
  • If you enter one IP address, enter the management-plane floating IP address of the MRS cluster.
  • If you enter three IP addresses, enter the IP address of the active node on the MRS cluster service plane, IP address of the standby node on the MRS cluster service plane, and the floating IP address of the MRS cluster management plane.

jobGateway IP

Yes

This parameter is mandatory when MRS tenant plane connection is selected for Connection Type or DataArts Migration is selected for Applicable Modules and API is selected for SQL Execution Mode.

It indicates the JobGateway IP address, which can be obtained from the MRS JobGateway module.

  • The management plane contains two nodes. Therefore, enter two IP addresses and separate them with commas (,). To obtain the IP addresses, perform the following steps:

    Log in to the MRS Manager management plane and choose Cluster > JobGateway. On the Instances tab page, obtain the management IP address of the JobBalancer role.

  • For a managed cluster, enter the service IP address.

Agent

Yes

MRS is not a fully managed service and cannot be directly connected to DataArts Studio. A CDM cluster can provide an agent for DataArts Studio to communicate with non-fully-managed services. Therefore, you need to select a CDM cluster when creating an MRS data connection. If no CDM cluster is available, create one first by referring to Creating a CDM Cluster.

As a network proxy, the CDM cluster must be able to communicate with the MRS cluster. To ensure network connectivity, the CDM cluster must be in the same region and AZ and use the same VPC and subnet as the MRS cluster. The security group rule must also allow the CDM cluster to communicate with the MRS cluster.

NOTE:

If a CDM cluster functions as the agent for a data connection in Management Center, the cluster supports a maximum of 200 concurrent active threads. If multiple data connections share an agent, a maximum of 200 SQL, Shell, and Python scripts submitted through the connections can run concurrently. Excess tasks will be queued. You are advised to plan multiple agents based on the workload.

Data Migration Configuration

Properties

No
Configure other client attributes. Examples:
  1. socketTimeout: Hive JDBC connection timeout duration in seconds
  2. fs.defaultFS: NameNode URI for the HDFS metadata
  3. hadoop.user.name: username for accessing HDFS

Data Source Authentication and Other Function Configuration

Authentication Method

Yes

This parameter is mandatory when Connection String Mode is selected for Manual.

Authentication method used for accessing MRS
  • SIMPLE: for non-security mode
  • KERBEROS: for security mode

Username

Yes

Human-machine user of the MRS cluster. This parameter is mandatory when Connection Type is set to Proxy connection. If a new MRS user is used for connection, you need to log in to Manager and change the initial password.

To create a data connection for an MRS security cluster, do not use user admin. The admin user is the default management page user and cannot be used as the authentication user of the security cluster. You can create an MRS user by referring to Creating a Kerberos Authentication User for an MRS Security Cluster. When creating an MRS data connection, set Username and Password to the new MRS username and password.
NOTE:
  • For clusters of MRS 3.1.0 or later, the user must at least have permissions of the Manager_viewer role to create data connections in Management Center. To perform database, table, and data operations on components, the user must also have user group permissions of the components.
  • For clusters earlier than MRS 3.1.0, the user must have permissions of the Manager_administrator or System_administrator role to create data connections in Management Center.
  • A user with only the Manager_tenant or Manager_auditor permission cannot create connections.
  • You are advised to set a user password that never expires to prevent connection failures and service loss caused by password expiration.

Password

Yes

The password for accessing the MRS cluster. This parameter is mandatory when Connection Type is set to Proxy connection.

OBS storage support

No

This parameter is displayed when DataArts Migration is selected for Applicable Modules.

The server must support OBS storage. When creating a Hive table, you can store the table in OBS.

Use Agency

No

This parameter is displayed when DataArts Migration is selected for Applicable Modules and OBS storage support is enabled.

If you enable the agency function, you can create a data connection without having a permanent AK/SK and execute CDM jobs using the scheduling identity configured in DataArts Factory.

Public agency

Yes

This parameter is displayed when DataArts Migration is selected for Applicable Modules, and OBS storage support and Use Agency are enabled.

The agency is only used to check whether the connection agency function is normal. CDM jobs will be executed using the scheduling identity configured in DataArts Factory.

AK

-

This parameter is displayed when DataArts Migration is selected for Applicable Modules, OBS storage support is enabled, and Use Agency is disabled.

AK and SK are used to log in to the OBS server.

You need to create an access key for the current account and obtain an AK/SK pair.

To obtain an access key, perform the following steps:
  1. Log in to the management console, move the cursor to the username in the upper right corner, and select My Credentials from the drop-down list.
  2. On the My Credentials page, choose Access Keys, and click Create Access Key.
    Figure 1 Clicking Create Access Key

  3. Click OK and save the access key file as prompted. The access key file will be saved to your browser's configured download location. Open the credentials.csv file to view Access Key Id and Secret Access Key.
    NOTE:
    • You can create up to two access keys.
    • For security purposes, access keys are automatically downloaded only when they are generated for the first time and cannot be obtained from the console later. Keep them secure.

SK

-

OBS Test Path

No

This parameter is available when OBS storage support is set to Yes.

Enter a complete file path. The permission to access the path will be verified through the metadata query API.

NOTE:
  • For object storage, the path must be accurate to object, for example, obs://bucket/dir/test.txt. Otherwise, a 404 error occurs.
  • For a parallel file system, the path must be accurate to directory, for example, obs://bucket/dir.