This document describes how to create a Workspace in the DataBuddy console.
Prerequisites
Before creating a workspace, make sure that:
You are a DataBuddy console administrator. Sub-accounts with the AdministratorAccess policy are automatically assigned the console administrator role when they enter the console for the first time. Other sub-accounts must first be introduced and authorized by a console administrator.
The necessary CAM sub-account permissions have been enabled for the selected region. If TCLake has not been enabled in this region, it will be automatically enabled when you create a workspace. Make sure that your account has the required permissions for this operation.
Operation Steps
1. Log in to the DataBuddy console and select Workspace in the left sidebar.
2. Click Create Workspace.
3. In the pop-up window, enter the following information:
|
Workspace name | The display name of the workspace in the console will be used as the name of the Catalog with the same name. | Yes | - | No more than 128 characters. |
Region | The region where the workspace resides determines the physical locations of data storage and compute resources. | Yes | - | Depends on the DataBuddy regions supported by the current account. Once the region is determined, it cannot be modified after creation. |
Description | Description of the workspace purpose, helping team members identify the workspace. | No | Null | No more than 200 characters. |
1. Click OK to submit the creation.
2. After submission, the workspace status will be displayed as Creating.
3. After all resources are ready, the workspace status changes to Running. You can click Enter Workspace in the list to start using it.
Editing a Workspace
If you need to modify the workspace name or description:
1. In the Workspace list, locate the target workspace and click Edit in the operation column.
2. Modify the workspace name or description, and click OK to save the changes.
Note
The region cannot be modified after creation. To use it in a new region, create a workspace.
Deleting a Workspace
Deleting a workspace stops all running tasks in the workspace, releases compute resources, and removes all entity objects in the workspace except Catalog (including tasks, dashboards, model experiments, model services, user and role configurations, and so on). Data assets in Catalog will not be removed when the workspace is deleted.
Operation Steps:
1. In the Workspace list, click Delete in the operation column of the target workspace.
2. In the confirmation window, enter the workspace name and select the confirmation item.
3. Click OK, and DataBuddy will asynchronously perform the cleanup task:
Stop all running and scheduled tasks;
Stop user-side alarms;
Delete all entity objects in the workspace except Catalog;
Release the compute resources associated with the workspace to avoid continued billing.
Warning
Deleting a workspace is an irreversible operation. Before deletion, confirm that critical data in the workspace has been backed up or migrated.
Use Limits
Name Length: The workspace name must not exceed 128 characters, and the description must not exceed 200 characters.
Region cannot be modified: The region field becomes read-only after creation.
Catalog with the Same Name: The workspace name is used as the initial Catalog name. Avoid using a name that duplicates an existing Catalog in the region.
FAQs
Will the corresponding Catalog and data be deleted along with the workspace?
No. The metadata and underlying data in Catalog are independently managed by TCLake. Deleting a workspace only removes workspace-level entities such as tasks and dashboards, and does not delete data assets such as Catalog, Schema, tables, Volume, and models. If you need to completely clean up data, go to Data Catalog to process it separately.
What should I do if a workspace remains in the "Creating" state for a long time?
Check whether TCLake has been successfully activated. If the issue persists, you can view the specific exception reason by clicking the info icon next to the workspace status, or submit a ticket to contact technical support.