All Products
Search
Document Center

Data Transmission Service:Connect an on-premises database or a third-party cloud database to Alibaba Cloud using Database Gateway

Last Updated:Dec 23, 2025

Database Gateway (DG) lets you connect an on-premises or third-party cloud database to Alibaba Cloud quickly and cost-effectively. After the connection is established, you can use the database as the source or destination database when you configure a data migration, data synchronization, change tracking, or data validation task in Data Transmission Service (DTS).

Background information

You can use Database Gateway (DG) to connect an on-premises or third-party cloud database to Alibaba Cloud for data synchronization with Data Transmission Service (DTS). DG is a feature of Data Management (DMS) that helps you quickly verify DTS functionality during the proof of concept (POC) phase by establishing a cross-network connection. For more information, see What is Database Gateway?.

Procedure

  1. Log on to the Database Gateway console.

    Note

    If you are using Database Gateway for the first time, you are navigated to the Cloud Service Activation page. On this page, read and agree to the terms of service, and then click Activate Now.

  2. Click Create Gateway. In the dialog box that appears, enter a gateway name and description, and then click Next step.

  3. Install the gateway.

    1. Select and install the appropriate installation package for your operating system.

      • For Windows: Click Download gateway to download the package and follow the prompts to install it.

      • For other operating systems: Copy the command to the machine on which you want to install the gateway, and press Enter.

      Important

      When you deploy DG for a POC, configure the network topology to minimize latency between the database and DG, and between DG and DTS. For example, if you use DG to connect a database in Germany to a service in Singapore, you must deploy the DG gateway in Germany. The DG gateway must resolve to the Endpoint of the DG service in Germany. Do not connect the DG gateway to the DG service Endpoint in Singapore. A cross-border connection increases latency and degrades the network quality of the DTS link.image

    2. Wait for the local gateway to start.

      Note

      The startup time varies based on your service, network, and operating system.

    3. Go to the add database page.

      • The local gateway started successfully and will redirect automatically.

      • Or, click Next step.

  4. Click Add database address to add a database to the gateway. For more information, see Create a database gateway.

  5. Click Complete. After you add the database to the gateway, you can modify or delete it as needed.

What to do next

  • When you configure a data migration, data synchronization, change tracking, or data validation task, set Access Method to Database Gateway. Then, from the Database Endpoint drop-down list, select the database that you connected through the gateway. You can use this database as the source or destination database.

    Important
    • If you set Access Method to Database Gateway when you configure a data migration task, make sure that the source and destination databases reside in the same region. In this case, cross-region data migration is not supported.

    • DG is intended for quickly verifying DTS capabilities during the POC phase and is not a dedicated network product. After the POC phase, delete the DTS task and use a standard network product to establish a network channel. Then, reconfigure the DTS task. DTS does not provide troubleshooting support for task delays that are caused by poor network quality.

  • (Recommended) After you complete the POC, configure a production-ready link. Use a dedicated network product, such as a VPN Gateway or an Express Connect circuit, to connect your on-premises or third-party cloud network to Alibaba Cloud. For example, if your third-party cloud is AWS, you can use a VPN Gateway to connect Alibaba Cloud and AWS. For more information, see Connect a database on AWS to Alibaba Cloud. Then, reconfigure the DTS task and set the connection type to Express Connect, VPN Gateway, or Smart Access Gateway.

FAQ

Why does the connection test for DG fail in the DTS console?

Log on to the machine on which the DG gateway is deployed. Run the telnet command to test the database address and verify the network connectivity. Then, run the connection test in the DTS console again.