All Products
Search
Document Center

DataWorks:Create a workspace

Last Updated:Feb 20, 2025

A workspace in DataWorks is the fundamental unit for managing tasks, members, roles, and permissions. All development activities occur within designated workspaces. To begin developing tasks, you must first create a workspace. This topic describes the steps to create a workspace.

Prerequisites

Preparations before creation

Prior to creating a workspace, you should plan its configurations and choose an appropriate workspace mode. The table below provides guidance on these preparations.

Operation item

Description

Reference link

Plan a workspace

A workspace is the largest business unit supported by DataWorks. Before you create a workspace, you must understand how workspaces work and plan a workspace for your business scenarios.

Plan a workspace

Select a workspace mode

DataWorks allows you to create a workspace that is in basic mode or standard mode:

  • Basic Mode: Only a production environment is provided. The workspace corresponds to a single project. Database permission isolation and development-production isolation cannot be achieved.

  • Standard Mode: Both development and production environments are provided. The workspace corresponds to two projects. Development-production isolation and data security can be better ensured.

Note

We recommend that you select a workspace that is in standard mode when you develop a task.

Must-read: Differences between basic mode and standard mode

Step 1: Select a region

  1. Log on to the DataWorks console.

  2. In the console's top navigation bar, select a region.

    Workspaces are region-specific. Choose a region that aligns with where your business data is utilized to create workspaces.

    Note
    • Ensure the selected region is correct. Once a workspace is created, its region cannot be altered.

    • If the chosen region observes daylight saving time, consider reading Scenario: Impact of daylight saving time on task scheduling to mitigate potential confusion due to time changes.

    • The region's time zone is automatically applied to task scheduling times.

    • Some regions support multiple scheduling time zones in DataWorks. Review Scenario: Switch scheduling time zones for details on regions with this support, available time zones, switching precautions, and the switching process.

Step 2: Create a workspace

  1. In the console's left-side navigation pane, click Workspaces to access the workspace list page.

  2. On the Workspace List page, click Create Workspace.

    Workspaces serve as the primary unit for task and member management, role assignment, and permission granting in DataWorks. Before task development, a workspace must be established. Once you navigate to the workspace creation section, follow the instructions to configure the parameters.

    image.png

    The parameters are described in the following table.

    Parameter

    Description

    Workspace Name

    The unique identifier for the workspace, which cannot be modified after creation.

    Important

    A workspace name must be unique within the same region and cannot be reused.

    Display Name

    It is recommended to choose a name reflecting your business or team characteristics for easy identification.

    Production And Development Environment Isolation

    Determines if the production and development environments are separate.

    • Yes: Select Yes to isolate the environments, creating a workspace in standard mode.

    • No: Select No if isolation is not required, creating a workspace in basic mode.

    For more details on workspace modes, refer to Must-read: Differences between basic mode and standard mode. Choose the mode that best fits your business needs.

    Workspace Administrator

    The individual responsible for managing the workspace.

    By default, the account currently logged in is the administrator. You can designate another workspace member as the administrator. For guidance on adding members, see Add members to a workspace.

    Participate In The Public Preview Of New-version Data Studio

    Indicates whether to opt in for the public preview of the new Data Studio version. This option is available in select regions. For more information, see New-version Data Studio.

    Note

    In the following regions, new users automatically have the new version of Data Studio enabled and do not need to adjust this setting:

    China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), Hong Kong (China), Singapore, Indonesia (Jakarta), Germany (Frankfurt)

    Default Resource Group Configuration

    The default resource group for DataWorks within the workspace. You can switch to another group in the workspace settings. For an overview of resource groups, see Overview of DataWorks resource groups.

    Alibaba Cloud Resource Group

    Choose a resource group created in Alibaba Cloud's Resource Management. The Default Resource Group is selected by default.

    If your organization has multiple Alibaba Cloud resources, you can group them using resourcegroups created in Resource Management. Assign an administrator to manage the resources within each group.

    Important

    The resource group selected here is established within the Resource Group service of Resource Management, which helps organize resources under your Alibaba Cloud account for streamlined management of resources and permissions. A resource group in the Resource Management console is distinct from a DataWorks task execution resource group.

    Create A Workspace With The Same Name In AI

    Determines if a workspace with an identical name should be created in AI. This option is enabled by default, allowing you to manage PAI algorithm tasks within the AI workspace. For more details, visit PAI.

    Description

    A brief description of the workspace, which can include its intended use or other identifying details.

What to do next

Once you've configured the workspace creation parameters, click Create Workspace. Your next steps will depend on whether you're participating in the public preview of the new-version Data Studio:

  • If you participate in the public preview of new-version Data Studio, you'll be directed to the page for attaching computing resources. For more information, see Attach computing resources.

  • If you do not participate in the public preview of new-version Data Studio, you'll be taken back to the workspace list page, where you can review workspace details. For more information, see Manage workspaces. After creating the workspace, you should create a data source or register a cluster. Once set up, you can commence data development. For guidance, see Create a data source or register a cluster.