Dataphin:Create and manage StarRocks clusters

Prerequisites

In single-engine mode, the computing engine for Dataphin is set to StarRocks.

Permissions

• All system roles except label specialists and business members, and custom global roles with the Cluster-View permission, can view cluster details.

• A super administrator, system administrator, or a custom global role with the Cluster-Manage permission can create and manage StarRocks clusters. These users can also specify who can reference the cluster when creating a StarRocks compute source and assign cluster administrators.

• A cluster administrator can manage the clusters for which they are responsible.

Create a StarRocks cluster

1. In the top navigation bar of Dataphin, choose Plan > Cluster management.

2. On the Cluster management page, click Create Cluster. On the Create Cluster page, configure the following parameters.

   • Basic information

     Parameter	Description
     Cluster name	The cluster name. It can be up to 128 characters long and can contain only Chinese characters, English letters, digits, underscores (_), and hyphens (-).
     Cluster administrator	Select one or more members from the current tenant as cluster administrators. A cluster administrator can manage the cluster, including downloading files, editing, viewing historical versions, and deleting it.
     Description (Optional)	A brief description of the cluster, up to 128 characters long.

   • Cluster security control

     Accessible Members: Specify which users can reference this cluster's configuration when creating a compute source. You can select either Roles with 'Create Compute Source' permission or Specified Users.

     • Roles with 'Create Compute Source' permission: Selected by default.

     • Specified users: Select one or more individual accounts and user groups.

   • Cluster configuration

     Parameter	Description
     Version	Select a StarRocks version: v3.0.6, v3.1, v3.2, v3.3, or v3.4. Note For StarRocks clusters created before Dataphin V6.1, the version defaults to v3.0.6.
     JDBC URL	Enter the JDBC URL. The following formats are supported: jdbc:mysql:loadbalance://{fe1-host}:{port},{fe2-host}:{port},{fe3-host}:{port}/. Do not include a database name. jdbc:mysql://{host1}:{port1},{host2}:{post2}/. Do not include a database name.
     Username, Password	The username and password for authentication. Ensure the user has the required data permissions so that tasks run correctly.
     FE node URL	Connection addresses of the FE nodes. Separate multiple addresses with commas (,), for example, fe_host1:http_port01,fe_host02:http_port02.

3. Click Test Connection. After the connection test passes, click Save to create the StarRocks cluster.

Manage StarRocks clusters

1. In the top navigation bar of Dataphin, choose Plan > Cluster management.

2. On the Cluster management page, view the list of StarRocks clusters. The list displays the cluster name, administrators, associated compute sources, creation information, and modification information.

   • Associated compute sources: Shows the total number of associated compute sources. Click the icon to view the list. Clicking a compute source name redirects you to its page.

   • Creation information: Shows the user who created the cluster and when it was created.

   • Modification information: Shows the user who last edited the cluster and the time of the last modification.

   Note

   A compute task can only run on one cluster. Data from different StarRocks clusters cannot be joined.

3. (Optional) You can enter a cluster name in the search box to perform a fuzzy search.

4. In the Actions column of the cluster list, you can perform the following operations on a cluster.

   Actions	Description
   View	Click the icon in a cluster's Actions column to view the details of its current version.
   Edit	Click the icon in the Actions column to open the Edit StarRocks Cluster page. Modify the configuration as needed, then click Save. In the dialog box that appears, enter a change description and click OK.
   Clone	Click the icon in the Actions column. The system clones the current cluster's configuration and opens the Create StarRocks Cluster page for you to modify.
   Historical versions	Click the icon in the Actions column and select Historical versions. A dialog box appears, showing information for each version, including the version name, the last editor, and the change description. You can View and Compare historical versions. View: Click the icon in a version's Actions column to view the details of that version. Compare: Click the icon in a version's Actions column to open the comparison page. Select different versions from the dropdown list. By default, the current version is compared with the selected historical version.
   Delete	Note You can delete a StarRocks cluster only if it has no associated compute sources. Deleting a cluster is an irreversible action. Click the icon in the Actions column and select Delete. In the confirmation dialog box that appears, click OK.