All Products
Search
Document Center

DataWorks:Add a data source

Last Updated:Aug 30, 2025

Before you use DataService Studio to create an API, you must add your database or data warehouse to DataWorks as a data source. Then, you can use the data source to create an API. During API development, DataService Studio accesses the data source to obtain the schema of a data table based on which you want to create an API to help you configure the request parameters and response parameters of the API. This topic describes how to add a data source.

Prerequisites

You must configure network connectivity and whitelists to ensure that data can be accessed between data sources and service resource groups. If you do not complete these configurations, DataService Studio tasks cannot run as expected. For more information, see Network connectivity solutions.

Procedure

  1. Go to the Data Sources page.

    1. Log on to the DataWorks console. In the top navigation bar, select the desired region. In the left-side navigation pane, choose More > Management Center. On the page that appears, select the desired workspace from the drop-down list and click Go to Management Center.

    2. In the left-side navigation pane of the SettingCenter page, click Data Sources.

  2. On the Data Source page, add a data source as needed. The following table describes the supported types of data sources and the configuration methods.

    Data source type

    Create an API using the codeless UI

    Data Generation API for the Code Editor

    Configuration Method

    Description

    Hologres

    Supported

    Supported

    Attach a Hologres computing resource

    Hologres is compatible with PostgreSQL. PostgreSQL does not support the DATETIME data type. If your Hologres instance contains data of the DATETIME type, Hologres converts the data from the DATETIME type to the TIMESTAMP type of PostgreSQL. This way, DataService Studio can query the data.

    ClickHouse

    Supported

    Supported

    Attach a ClickHouse computing resource

    This data source supports only serverless resource groups (recommended) or exclusive resource groups for DataService Studio.

    RDS

    Supported

    Supported

    RDS includes RDS for MySQL, RDS for PostgreSQL, and RDS for SQL Server. When you configure these data sources, set Configuration Mode to Alibaba Cloud Instance Mode.

    PolarDB-X (formerly DRDS)

    Supported

    Supported

    DRDS (PolarDB-X 1.0) data source

    You can add this type of data source only in connection string mode.

    MySQL

    Supported

    Supported

    MySQL data source

    None.

    PostgreSQL

    Supported

    Supported

    PostgreSQL data source

    None.

    SQL Server

    Supported

    Supported

    SQL Server data source

    None.

    Oracle

    Supported

    Supported

    Oracle data source

    You can add this type of data source only in connection string mode.

    AnalyticDB for MySQL 2.0

    Supported

    Supported

    AnalyticDB for MySQL 2.0 data source

    None.

    AnalyticDB for MySQL 3.0

    Supported

    Supported

    Attach an AnalyticDB for MySQL 3.0 computing resource

    None.

    AnalyticDB for PostgreSQL

    Supported

    Supported

    Attach an AnalyticDB for PostgreSQL computing resource

    None.

    Tablestore

    Supported

    Supported

    Tablestore Stream data source

    MongoDB

    Supported

    Not supported

    MongoDB data source

    None.

    MaxCompute

    • Acceleration solution 1: Acceleration service

    • Acceleration solution 2: MCQA

    • Acceleration solution 1: Acceleration service

    • Acceleration solution 2: MCQA

    StarRocks

    Supported

    Supported

    StarRocks data source

    None.

    Doris

    Supported

    Supported

    Doris data source

    None.

    PolarDB

    Supported

    Supported

    PolarDB data source

    ApsaraDB for Oceanbase

    Supported

    Supported

    ApsaraDB for OceanBase data source

    Sap Hana

    Supported

    Supported

    SAP HANA data source

    Db2

    Supported

    Supported

    Db2 data source

    DM

    Supported

    Supported

    DM data source

    Amazon Redshift

    Supported

    Supported

    Amazon Redshift data source

  3. On the data source configuration page, test the connectivity of the resource group.

    Important

    If the network connectivity test fails, check your configurations. For more information, see Configure network connectivity.

  4. After the connectivity test is successful, return to the DataService Studio interface to create an API.