All Products
Search
Document Center

Dataphin:Create and manage StarRocks clusters

Last Updated:Nov 18, 2025

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

  1. In the top menu bar of the Dataphin home page, choose Planning > Compute Source.

  2. On the Compute Source page, click Manage StarRocks Clusters.

  3. In the Manage StarRocks Clusters dialog box, click + New StarRocks Cluster.

  4. 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.

  5. Click Test Connection. If the test is successful, click Save to create the StarRocks cluster.

Manage StarRocks clusters

  1. In the top menu bar of the Dataphin home page, choose Planning > Compute Source.

  2. On the Compute Source page, click Manage StarRocks Clusters.

  3. 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 image 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.

    Note

    Compute nodes can run in only one cluster. Data cannot be joined across different StarRocks clusters.

  4. (Optional) Enter a cluster name in the search box to perform a fuzzy search.

  5. 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 image icon in the Actions column of the target cluster to view detailed information about the cluster's current version.

    Edit

    Click the image 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 image 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 image 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 image 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 image 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

    Note
    • You can delete a StarRocks cluster only if it has no associated compute sources.

    • A deleted cluster cannot be restored.

    Click the image icon in the Actions column of the target cluster, select Delete, and in the dialog box that appears, click OK.