All Products
Search
Document Center

Dataphin:Create a Doris data source

Last Updated:Jun 23, 2026

Create a Doris data source to enable Dataphin to read business data from or write data to Doris.

Background information

Apache Doris is a high-performance, real-time analytical database based on MPP architecture. It returns query results on massive datasets with sub-second response time, supporting both high-concurrency point queries and high-throughput complex analytics. Typical use cases include report analysis, ad hoc queries, unified data warehouse construction, and data lake federated query acceleration. For more information, see Doris official website.

Permissions

Only custom global roles with the permission to create data sources and the roles of super administrator, data source administrator, domain architect, and project administrator can create data sources.

Procedure

  1. On the Dataphin homepage, click Management Center > Data Source Management in the top navigation bar.

  2. On the Datasource page, click +Create Data Source.

  3. In the Big Data section of the Create Data Source page, select Doris.

    You can also select Doris from the Recently Used section or search for it by keyword.

  4. On the Create Doris Data Source page, configure the connection parameters.

    1. Configure the basic information of the data source.

      Parameter

      Description

      Datasource Name

      The name must meet the following requirements:

      • It can contain only Chinese characters, uppercase and lowercase letters, digits, underscores (_), and hyphens (-).

      • It cannot exceed 64 characters in length.

      Datasource Code

      After you configure the data source code, reference tables in the data source in Flink_SQL nodes using the format datasource_code.table_name or datasource_code.schema.table_name. To automatically access the data source of the current environment, use the variable format ${datasource_code}.table or ${datasource_code}.schema.table. For more information, see Develop tables for a Dataphin data source and .

      Important
      • The data source code cannot be modified after it is configured.

      • You can preview data on the object details page in the asset directory and asset checklist only after the data source code is configured.

      • In Flink SQL, only MySQL, Hologres, MaxCompute, Oracle, StarRocks, Hive, SelectDB, and GaussDB data warehouse service (DWS) data sources are currently supported.

      Data Source Description

      A brief description of the Doris data source. It cannot exceed 128 characters.

      Data Source Configuration

      Based on whether the business data source distinguishes between production and development data sources:

      • If the business data source distinguishes between production and development data sources, select Production + Development Data Source.

      • If the business data source does not distinguish between production and development data sources, select Production Data Source.

      Tag

      You can categorize and tag data sources based on tags. For information about how to create tags, see Manage data source tags.

    2. Configure the connection parameters between the data source and Dataphin.

      If you select Production + Development Data Source, configure connection information for both environments. If you select Production Data Source, configure connection information for the Production Data Source only.

      Note

      We recommend configuring separate data sources for production and development to achieve environment isolation. However, Dataphin also supports using the same data source with identical parameter values for both environments.

      Parameter

      Description

      JDBC URL

      Enter the endpoint of the data source. The endpoint format is jdbc:mysql://host:port/dbname.

      Username,Password

      The username and password used to log on to the Doris data source.

      FE Node URL

      Enter the endpoint of the FE node to access the FE node through a web server. The endpoint format is {FE IP}:{Http Port}. The default port is 8030. You can configure multiple FE nodes. Separate them with commas (,).

      SSL Encryption

      To establish an encrypted connection through SSL, you need to Enable SSL encryption, Upload The Truststore Certificate, and enter the Truststore Certificate Password.

    3. Configure advanced settings for the data source.

      Parameter

      Description

      connectTimeout

      The connectTimeout duration of the database (in milliseconds). The default is 900,000 milliseconds (15 minutes).

      Note
      • If you include a connectTimeout configuration in the JDBC URL, the connectTimeout will be the timeout period configured in the JDBC URL.

      • For data sources created before Dataphin V3.11, the default connectTimeout is -1, which indicates no timeout limit.

      socketTimeout

      The socketTimeout duration of the database (in milliseconds). The default is 1,800,000 milliseconds (30 minutes).

      Note
      • If you include a socketTimeout configuration in the JDBC URL, the socketTimeout will be the timeout period configured in the JDBC URL.

      • For data sources created before Dataphin V3.11, the default socketTimeout is -1, which indicates no timeout limit.

      Connection Retry Count

      If the database connection times out, the system automatically retries until the specified count is reached. If the connection still fails after all retries, it is considered failed.

      Note
      • The default retry count is 1, and you can configure a value between 0 and 10.

      • The connection retry count will be applied by default to offline integration tasks and global quality (requires the asset quality function module to be enabled). In offline integration tasks, you can configure task-level retry counts separately.

  5. Select a Default Resource Group, which is used to run tasks related to the current data source, including database SQL, offline database migration, data preview, and more.

  6. Perform a Test Connection or directly click OK to save and complete the creation of the Doris data source.

    Click Test Connection to verify connectivity between the data source and Dataphin. If you click OK directly, the system tests the connection for all selected clusters automatically. The data source can still be created even if all clusters fail the connection test.