Permissions
All system roles, except for label specialists and business members, and custom global roles with the Cluster - View permission can view the details of each cluster.
Super administrators, system administrators, and custom global roles with the Cluster - Manage permission can create and manage StarRocks clusters. These users can also specify which users can reference the cluster when creating a StarRocks compute source and assign cluster administrators to the cluster.
Cluster administrators can manage the clusters they are responsible for.
Create a StarRocks cluster
In the top menu bar of the Dataphin home page, choose Planning > Compute Source.
On the Compute Source page, click Manage StarRocks Clusters.
In the Manage StarRocks Clusters dialog box, click + New StarRocks Cluster.
On the New StarRocks Cluster page, configure the following parameters.
Basic information
Parameter
Description
Cluster Name
Enter a name for the cluster. The name can contain only Chinese characters, letters, digits, underscores (_), and hyphens (-). The name can be up to 128 characters long.
Cluster Administrator
Select one or more members from the current tenant to be the cluster administrators. Cluster administrators can manage the cluster, including downloading files, editing, viewing historical versions, and deleting.
Description (Optional)
Enter a brief description of the cluster. The description can be up to 128 characters long.
Cluster security control
Usable by: Specifies the users who can reference the current cluster's configuration when creating a compute source. You can select Roles With "Create Compute Source" Permission or Specified Users.
Roles With "Create Compute Source" Permission : Selected by default.
Specified Users : You can select one or more personal accounts and user groups.
Cluster configuration
Parameter
Description
JDBC URL
Enter the Java Database Connectivity (JDBC) URL. The following two formats are supported:
jdbc:mysql:loadbalance://{fe1-host}:{port},{fe2-host}:{port},{fe3-host}:{port}/. You do not need to enter a database name.jdbc:mysql://{host1}:{port1},{host2}:{post2}/. You do not need to enter a database name.
Username, Password
Enter the username and password for authentication. To ensure that nodes run correctly, make sure the user has the required database permissions.
FE Node URL
The endpoint of the FE node. Separate multiple endpoints with commas (,), for example,
fe_host1:http_port01,fe_host02:http_port02.
Click Test Connection. If the test is successful, click Save to create the StarRocks cluster.
Manage StarRocks clusters
In the top menu bar of the Dataphin home page, choose Planning > Compute Source.
On the Compute Source page, click Manage StarRocks Clusters.
In the Manage StarRocks Clusters dialog box, you can view a list of StarRocks clusters. The list displays information such as the cluster name, cluster administrator, associated compute sources, creation information, and modification information.
Associated Compute Sources: Displays the total number of associated compute sources. Click the
icon to view the list of associated compute sources. Click a compute source name to open the compute source page.Creation Information: Displays the user who created the cluster and the creation time.
Modification Information: Displays the username of the user who last edited the cluster and the modification time.
NoteCompute nodes can run in only one cluster. Data cannot be joined across different StarRocks clusters.
(Optional) Enter a cluster name in the search box to perform a fuzzy search.
In the Actions column of the StarRocks cluster list, you can perform management operations on a cluster. The supported operations are as follows.
Operation
Description
View
Click the
icon in the Actions column of the target cluster to view detailed information about the cluster's current version.Edit
Click the
icon in the Actions column of the target cluster to open the Edit StarRocks Cluster page. On this page, you can modify the existing configurations. After you complete the modifications, click Save. In the dialog box that appears, enter a Change Description and click OK.Clone
Click the
icon in the Actions column of the target cluster. The system automatically clones all data of the current cluster and opens the Create StarRocks Cluster page, where you can modify the existing configuration.History
Click the
icon in the Actions column of the target cluster and select History. A dialog box appears and displays information about each version of the cluster, such as the version name, modifier, and change description. You can perform View and Compare operations on the historical versions.View: Click the
icon in the Actions column for the target version to open the View StarRocks Cluster page, where you can view detailed information about the cluster's current version.Compare: Click the
icon in the Actions column of the target version to go to the Version Comparison page. On the comparison page, you can select different versions from the filter drop-down list. By default, the current version of the StarRocks cluster is compared with the target version.
Delete
NoteYou can delete a StarRocks cluster only if it has no associated compute sources.
A deleted cluster cannot be restored.
Click the
icon in the Actions column of the target cluster, select Delete, and in the dialog box that appears, click OK.