CREATE WORKSPACE

Creates a workspace boundary for isolating the pipelines and scripts imported from the workspace's git repository.

Category: securityPrivilege: ManageWorkspacesDeltaForge extension

Syntax

CREATE WORKSPACE [IF NOT EXISTS] <name> [COMMENT '<description>']

Description

## Overview CREATE WORKSPACE registers a workspace in the catalog. Workspaces group together the assets imported by scanning the workspace's linked git repository (pipelines and scripts) and provide a unit of isolation for grants and quotas. Workspace content is managed in git and imported through the repository scan; DeltaForge does not author workspace files. Schedules are independent, shared objects and are not workspace-scoped. ## Behavior - Workspace creation requires ACCOUNTADMIN. The Control Plane enforces the `ManageWorkspaces` privilege, which only ACCOUNTADMIN holds by default. - Storage configuration for the workspace (storage root, default zone) is managed through the Control Plane API; this SQL command captures only the name and comment. - Without IF NOT EXISTS, creating a workspace that already exists raises an error. ## Access Control Requires the `ManageWorkspaces` privilege (ACCOUNTADMIN by default). ## Compatibility DeltaForge extension.

Parameters

Name	Type	Description
`name`		Specifies the workspace name.
`comment`		Optional human-readable description.
`if_not_exists`		When true, succeed silently if a workspace with this name already exists.

Examples

CREATE WORKSPACE analytics_team;

CREATE WORKSPACE IF NOT EXISTS analytics_team COMMENT 'Analytics team sandbox';

Pitfalls

Workspace creation requires ACCOUNTADMIN; standard admin grants are not enough. Plan workspace bootstrap through the account admin path or through the Control Plane provisioning API.