All Products
Search
Document Center

DataWorks:Configure a workspace

Last Updated:Nov 27, 2025

After you create a workspace, daily management is key to ensuring that it runs smoothly and securely. This topic guides workspace administrators through core management operations, such as viewing configuration details, modifying basic information, adding data sources, and disabling or deleting the workspace when it is no longer needed.

Permissions

  • Only an Alibaba Cloud account or a Resource Access Management (RAM) user with the AliyunDataWorksFullAccess permission can delete or disable a workspace.

  • Only a Workspace Administrator can modify workspace information, add data sources, and attach computing resources.

Create a workspace

In DataWorks, a workspace is the basic unit for managing tasks, members, roles, and permissions. All development work is performed within a workspace. Before you can develop tasks, you must first create a workspace.

Configure a workspace

Go to the workspace configuration page

  1. Go to the DataWorks workspace list and switch to the required region in the menu bar at the top of the console.

  2. Find the target workspace and click Details in the Actions column to go to the workspace details page.

    Alternatively, you can click the Manage button to go to the SettingCenter. You can use either method to view and manage the workspace.

    image

Configure basic workspace information

  1. On the General Configurations > Basic Properties tab, you can view and configure the basic information of the workspace.

    Parameter

    Description

    Workspace ID

    The unique identifier of the current workspace. It cannot be modified after creation.

    Workspace Name

    Status

    The status of the workspace. You can manually disable a workspace.

    • Normal: The workspace is running properly.

    • Disabled: The workspace is manually disabled.

    • Overdue: The workspace is frozen due to an overdue payment.

    • Other statuses: If any other unexpected status appears, contact technical support.

      If workspace creation fails, the status is Initialization Failed. In this case, you can recreate the workspace.

    Display Name

    The display name and description of the current workspace are used to identify the workspace. They can be modified by an account that is assigned the Workspace Administrator role.

    Description

    Mode

    When you create a workspace, if you enable Isolate Development and Production Environments, the workspace is in Standard Mode. Otherwise, the workspace is in Basic Mode.

    Important

    You can upgrade a workspace from Basic Mode to Standard Mode if the Data Studio (new version) is not enabled. The upgrade option is visible only to Alibaba Cloud accounts. Workspaces that have the Data Studio (new version) enabled do not currently support upgrades. To upgrade, contact technical support. For more information, see Upgrade workspace mode.

    Owner

    The owner of the current workspace. The owner has the permissions to delete and disable the workspace. This identity cannot be modified.

    Schedule PAI Tasks

    To schedule PAI algorithm tasks in Data Studio, enable this switch. After it is enabled, it cannot be disabled.

    If you select Create AI Workspace with Same Name when you create the workspace, this option is enabled by default.
  2. (Optional) In the General Configuration > Personal Development Environment section, you can configure the automatic shutdown policy for personal development environment instances in the current workspace.

    Important

    Supported in select regions only. Refer to the console for availability.

    This option can be configured only for workspaces that have the Data Studio (new version) enabled. If a running personal development environment instance in the workspace meets the workspace-level automatic shutdown policy, the instance is automatically shut down. For more information, see Set a workspace-level automatic shutdown policy.

    image

  3. In the General Configuration > Security Settings section, you can control basic security operations for the workspace.

    Parameter

    Description

    Download SELECT Result

    Specifies whether to allow downloading data query results during development. If you disable this feature, you cannot download the results of SELECT queries.

    Change Node Owner by RAM User

    Specifies whether to allow RAM users to change the owners of their nodes.

    Sandbox Whitelist (The whitelist contains IP addresses or domain names that can be accessed by Shell tasks.)

    Specifies the IP addresses or domain names that Shell tasks can directly access when they run on the shared resource group.

    Important

    You must enter public IP addresses or accessible domain names. For internal services, we recommend that you use exclusive resource groups to ensure network reachability. For more information, see DataWorks resource groups.

Add a data source or attach a computing resource

DataWorks supports various types of compute engines, such as MaxCompute, E-MapReduce, and real-time computing Flink. It also supports data synchronization between different compute engines. In addition, DataWorks lets you run computing tasks on MaxCompute, Hologres, AnalyticDB for PostgreSQL, AnalyticDB for MySQL, and ClickHouse computing resources in Data Development and manage the data stored in these data sources.

Configure workspace members and roles

On the Workspace Members tab, you can add, modify, and delete workspace members and grant roles to them. On the Workspace Roles tab, you can view and manage the roles in the current workspace.

  1. Add a workspace member: When you add a RAM user to the workspace, you must grant the user a workspace role. After the role is granted, the user has the permissions of that role. For more information, see Add a workspace member and manage member roles and permissions.

    Note

    DataWorks lets you grant workspace-level custom roles and preset roles to RAM users. A workspace administrator must create custom roles on the Workspace Roles tab. Different roles have different permissions for workspace modules. For more information, see Control permissions on workspace-level modules.

  2. Manage member roles: You can view the preset or custom roles in the workspace. If preset roles do not meet your business requirements, you can create custom roles. You can configure the permissions that a role has for DataWorks workspace modules. You can also configure permission mappings with MaxCompute project roles. For more information about permission control for workspace roles, see Control permissions on workspace-level modules.

    Note

    Only an Alibaba Cloud account or a RAM user to which the Admin or Super_Administrator role of a MaxCompute project is assigned can configure permission mappings.

  3. View the permission list: On the Permissions tab, you can view the feature-level permissions of each preset workspace role. For more information, see Appendix: List of permissions for preset roles (workspace level).

Delete or disable a workspace

In the DataWorks Management Console, go to the Workspaces. Find the target workspace, click the 更多 icon in the Actions column, and select to delete or disable the workspace.

  • Delete Workspace: Deleting a workspace also deletes all development assets, such as code, from the DataWorks workspace. This operation is irreversible. Proceed with caution.

    Important

    Before you delete a workspace, go to Operation Center to freeze or delete related auto triggered tasks. Then, go to DataService Studio to unpublish and delete published APIs. This prevents charges from being generated after the workspace is deleted. If charges are still generated after you delete the workspace, submit a ticket to contact technical support.

  • Disable Workspace:

    • After a workspace is disabled, instances are no longer generated for auto triggered tasks in the workspace. Instances that were generated before the workspace was disabled run automatically at their scheduled time. However, you cannot log on to the workspace to view the related information.

    • After a workspace is disabled, the compute engine services used by the workspace continue to exist. This may incur storage-related fees. These fees are charged by the corresponding compute engine, not by DataWorks. If you have questions about storage bills, consult the personnel in charge of the corresponding compute engine.

Next steps

After you activate DataWorks, you must also purchase a resource group for resource usage in data synchronization, data scheduling, or DataService Studio. For more information, see Resource group management.