All Products
Search
Document Center

Dataphin:Create a StarRocks compute source

Last Updated:Sep 16, 2026

Dataphin supports using StarRocks as an offline computing engine to process offline computing tasks. This topic describes how to create a StarRocks compute source.

Background information

StarRocks is a high-performance analytical database that supports real-time, multidimensional, and highly concurrent data analytics. StarRocks is highly scalable, highly available, and easy to maintain. It supports a wide range of OLAP use cases, such as real-time analytics, ad hoc query, and data lake analytics. For more information, see the StarRocks official website.

Permissions

  • All system roles, except for Tag Businessperson and Business Member, and custom global roles with the Cluster-View permission can view cluster details.

  • Super Admin, System Admin, and custom global roles with the Cluster-Manage permission can create and manage StarRocks clusters. They can also specify which users can reference the cluster when creating a StarRocks compute source, and assign a cluster administrator.

  • A Cluster administrator can manage their assigned clusters.

  • Super Admin, System Admin, and users with a custom global role that has the Compute Source Management-Create permission can create a StarRocks compute source. They can also reference any StarRocks cluster they have permission to use.

Procedure

  1. In the top navigation bar of the Dataphin homepage, choose Plan > Compute Source.

  2. On the Compute Source page, click Add Compute Source and select StarRocks Compute Source.

  3. On the Create StarRocks Compute Source page, configure the following parameters.

    Reference a specific cluster

    Parameter

    Description

    Basic information

    Compute type

    Select StarRocks.

    Compute source name

    The compute source name can contain Chinese characters, letters, digits, underscores (_), and hyphens (-).

    Configuration method

    Select Reference a specific cluster. From the drop-down list, select a cluster that you are permitted to use. Click View to go to the View StarRocks page to view cluster details. If the required cluster is not available, click Configure Cluster to go to the Create StarRocks Cluster page and create a new cluster.

    Note

    Changes to the cluster information are automatically synchronized to this compute source.

    Compute source description

    Enter a brief description for the compute source. The description can be up to 128 characters long.

    Configuration

    JDBC URL

    The JDBC URL defaults to the one configured for the selected StarRocks cluster and cannot be modified.

    Catalog

    You can select Default Catalog or External Catalog.

    • Default Catalog: Used to manage internal data in StarRocks.

    • External Catalog: You can select from all external catalogs in the cluster or manually enter a catalog name.

    Database

    You can select an existing database in the selected Catalog or enter a new database name.

    Authentication

    You can select Same as cluster or Custom. The default is Same as cluster. If you select Custom, you must enter a username and password for authentication. To ensure that tasks run properly, ensure the user has the required data permissions.

    Task resource group

    Enable resource isolation

    StarRocks uses resource groups and a classifier to isolate resources by routing tasks to specific groups. Dataphin lets you specify a resource group name for tasks based on priority.

    • Use cluster default settings: Uses the default resource group settings that are configured for the selected cluster.

    • Isolate resources by task priority: Select a Resource isolation method, such as Resource group or Compute group. You must also specify the resource group or compute group name for each priority: highest priority, high priority, medium priority, low priority, and lowest priority.

      Note

      Compute groups are supported only in EMR Serverless StarRocks v3.3 and later versions with storage-compute separation.

    Standalone configuration

    Parameter

    Description

    Basic information

    Compute type

    Select StarRocks.

    Compute source name

    The compute source name can contain Chinese characters, letters, digits, underscores (_), and hyphens (-).

    Configuration method

    Select Standalone configuration.

    Compute source description

    Enter a brief description for the compute source. The description can be up to 128 characters long.

    Configuration

    JDBC URL

    Enter a JDBC URL in one of the following formats:

    • jdbc:mysql:loadbalance://{fe1-host}:{port},{fe2-host}:{port},{fe3-host}:{port}/{database}

    • jdbc:mysql://{host}:{port}/database?key1=value1&key2=value2

    Catalog

    Only Default Catalog is supported. To create a compute source from an External Catalog, use the Reference a specific cluster configuration method.

    FE node URL

    A comma-separated list of the connection addresses for the FE nodes. Example: fe_host1:http_port01,fe_host02:http_port02.

    Username

    Enter the username and password used to log on to the StarRocks database. To ensure tasks run correctly, ensure the user has the required data permissions.

    Password

    Task resource group

    StarRocks uses resource groups and a classifier to isolate resources by routing tasks to specific groups. Dataphin lets you specify a resource group name for tasks based on priority.

    • Use default execution user: Uses the default execution user specified in the configuration above.

    • Custom: You must specify a resource group for each priority: highest priority, high priority, medium priority, low priority, and lowest priority.

  4. Click test connection to verify the compute source connection.

  5. If the connection test is successful, click Submit.

    Once created, the StarRocks compute source can be assigned to a project. For more information, see Manage permissions and compute sources for a project space.

Next steps

Assign the compute source to a project to use it for offline computing tasks. For more information, see Create a general-purpose project.