A MaxCompute connection allows you to read data from and write data to MaxCompute by using MaxCompute Reader and Writer.

Background information

Workspaces in the standard mode support the connection isolation feature. You can add connections for the development and production environments separately and isolate the connections to protect your data security.

MaxCompute offers a comprehensive data import scheme to support fast computing for large amounts of data. DataWorks generates the default connection odps_first for a workspace after you bind a MaxCompute computing engine to the workspace for the first time. From then on, DataWorks generates a computing engine connection named in the format of 0_Region ID_Engine name each time you bind a new MaxCompute computing engine to the workspace.

The MaxCompute project names of the default connection and the default computing engine connections are the same as the names of the MaxCompute projects that serve as computing engines. You can change the AccessKey of the default connection. To change the AccessKey, follow these steps: In the DataWorks console, move the pointer over your username in the top navigation bar and select User Info. On the Personal Account page that appears, click Save AccessKey. In the dialog box that appears, enter the new AccessKey ID and AccessKey secret, and then click Save AccessKey. Note the following rules when you change the AccessKey:
  • You can only switch from the AccessKey of one Alibaba Cloud account to that of another Alibaba Cloud account.
  • Before changing the AccessKey, make sure that no data integration or data analytics nodes are running in DataWorks. A custom MaxCompute connection can use the AccessKey of a Resource Access Management (RAM) user.


  1. Go to the Data Source page.
    1. Log on to the DataWorks console.
    2. In the left-side navigation pane, click Workspaces.
    3. In the top navigation bar, select the region where the target workspace resides. Find the target workspace and click Data Integration in the Actions column.
    4. On the page that appears, click Connection in the left-side navigation pane. The Data Source page appears.
  2. On the Data Source page, click Add a Connection in the upper-right corner.
  3. In the Add Connection dialog box that appears, select ODPS.
  4. In the Add ODPS Connection dialog box that appears, set relevant parameters.
    MaxCompute connection
    Parameter Description
    Connection Name The name of the connection. The name can contain letters, digits, and underscores (_) and must start with a letter.
    Description The description of the connection. The description can be up to 80 characters in length.
    Environment The environment in which the connection is used. Valid values: Development and Production.
    Note This parameter is available only when the workspace is in the standard mode.
    ODPS Endpoint The endpoint of the MaxCompute project. This parameter is read-only, which is automatically obtained from system configurations.
    Tunnel Endpoint The endpoint of the MaxCompute Tunnel service. For more information, see Configure endpoints.
    MaxCompute Project Name The name of the MaxCompute project.
    AccessKey ID The AccessKey ID used as the logon credential. You can view the AccessKey ID on the User Info page.
    AccessKey Secret The AccessKey secret used as the logon credential.
  5. Click Test Connection in the Actions column of each resource group.
    A sync node only uses one resource group. Therefore, you must test the connectivity of all the resource groups for Data Integration that your sync nodes use to connect to the data store so that sync nodes can run properly. For more information, see Test data store connectivity.
  6. After the connection passes the connectivity test, click Complete.

What to do next

Now you have learned how to configure a MaxCompute connection. You can proceed with the next tutorial. In the next tutorial, you will learn how to configure MaxCompute Reader and Writer. For more information, see Configure MaxCompute Reader and Configure MaxCompute Writer.