All Products
Search
Document Center

Quick BI:CreateDataset

Last Updated:Nov 14, 2025

Creates a dataset from a physical table.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

DsId

string

Yes

The ID of the data source.

7AAB95D-*****-****-*4FC0C976

TableName

string

Yes

The name of the table.

st_trd_user_purchase_day_inc

UserDefineCubeName

string

Yes

The name of the dataset.

test

WorkspaceId

string

Yes

The ID of the workspace.

726bee5a-****-43e1-9a8e-b550f0120f35

UserId

string

Yes

The user ID of a Quick BI user who has permissions to create datasets. This is not your Alibaba Cloud account ID. To obtain the user ID, call the QueryUserInfoByAccount operation.

726bee5a-****-43e1-9a8e-b550f0120f35

TargetDirectoryId

string

No

The ID of the destination folder.

asah-fsdfsf*****92342

Response elements

Element

Type

Description

Example

object

The schema of the response.

RequestId

string

The ID of the request.

F68B***********A3DF743

Result

string

The result of the operation. Valid values:

  • true: The request is successful.

  • false: The request fails.

true

Success

boolean

Indicates whether the request is successful. Valid values:

  • true: The request is successful.

  • false: The request fails.

true

Examples

Success response

JSON format

{
  "RequestId": "F68B***********A3DF743",
  "Result": "true",
  "Success": true
}

Error codes

HTTP status code

Error code

Error message

Description

400 Internal.System.Error An internal system error occurred. An internal system error occurred.
400 Invalid.Parameter.Error The parameter is invalid:%s. invalid parameter: ${0}.
400 Cube.Not.Exist The Cube does not exist. The Cube does not exist.
400 Invalid.User.Organization The user is not in your organization. The user is not in your organization.
400 Workspace.NotIn.Organization The workspace is not owned by the organization. The workspace is not owned by the organization.
400 Datasource.NotFound.Error The specified data source does not exist: %s. The specified data source does not exist: %s.
400 DatasourceId.IsNull.Error You must select a data source before selecting the table. You must select a data source before selecting the table.
400 Name.RegularExpression.Error Name format validation failed.
400 NameExceeded.MaxLength.Error The name cannot exceed %s characters in length. The name cannot be longer than% s characters.
400 User.NotIn.Workspace The user is not a member of the group workspace. The user is not a member of the group workspace.
400 Cube.DuplicatedName.Error The dataset name already exists. Modify the name before saving. The dataset name already exists. Modify the name before saving.
400 Directory.NotExist.Error The directory does not exist. The directory does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.