All Products
Search

This Product

    Dataphin:Create a TDengine data source

    Document Center

    Dataphin:Create a TDengine data source

    Last Updated:Jun 04, 2026

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

    Permission requirements

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

    Procedure

    1. On the Dataphin homepage, click Management Hub > Datasource Management in the top navigation bar.

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

    3. On the Create Data Source page, select TDengine in the Big Data section.

      If you have recently used TDengine, you can also find it in the Recently Used section or use the search box.

    4. On the Create TDengine Data Source page, configure the basic information.

      Parameter

      Description

      Datasource Name

      Enter a data source name that meets the following requirements:

      • Can contain Chinese characters, letters, digits, underscores (_), and hyphens (-) only.

      • Maximum length: 64 characters.

      Datasource Code

      After configuration, reference tables in Flink_SQL tasks using the Data source code.Table name or Data source code.schema.Table name format. To access the data source based on the current environment, use the variable format ${Data source code}.table or ${Data source code}.schema.table. Develop Dataphin data source tables.

      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.

      Version

      Select 2.x or 3.x.

      Data Source Description

      Brief description of the data source. Maximum 128 characters.

      Data Source Configuration

      Select a configuration mode:

      • To separate production and development environments, select Production + Development Data Source.

      • To use a single environment, select Production Data Source.

      Tags

      Categorize data sources with tags. Manage data source tags.

    5. Configure the connection parameters.

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

      Note

      Use separate data sources for production and development to isolate environments. You can also use the same data source with identical parameters for both.

      1. Set the Cluster Configuration parameters.

        Parameter

        Description

        JDBC URL

        JDBC connection address of the target database. Format: jdbc:TAOS-RS://host:port/dbname.

        Username, Password

        TDengine login credentials.

        httpConnectTimeout

        HTTP connection timeout. Default: 900,000 ms (15 minutes). Set to -1 for no limit.

        httpSocketTimeout

        HTTP socket timeout. Default: 1,800,000 ms (30 minutes). Set to -1 for no limit.

    6. Select a Default Resource Group to run data source tasks such as database SQL, offline migration, and data preview.

    7. Click Test Connection to verify connectivity, or click OK to save the data source directly.

      Test Connection verifies Dataphin connectivity. If you click OK directly, the system still tests all selected clusters automatically. The data source is created even if connection tests fail.