All Products
Search
Document Center

Quick BI:QueryDatasetInfo

Last Updated:Nov 04, 2025
This topic is generated by a machine translation engine without any human intervention. ALIBABA CLOUD DOES NOT GUARANTEE THE ACCURACY OF MACHINE TRANSLATED CONTENT. To request a human-translated version of this topic or provide feedback on this translation, please include it in the feedback form.

Indicates whether the table is a custom SQL table. Valid values: \\* true: custom SQL table \\* false: non-custom SQL table

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
quickbi-public:QueryDatasetInfoget
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
DatasetIdstringYes

Queries information about a specified dataset.

a201c85c-******

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

Whether the operation is successfully returned. Valid values:

  • true: The call is successful.
  • false: The call fails.
a4d1a221d-41za1-****
Resultobject

The dataset information.

CubeTableListarray<object>

The unique ID of the dataset.

CubeTableListobject
Captionstring

Indicates whether the data source table is valid. Valid values:

  • true: data source table
  • false: custom table
odps_40
Customsqlboolean

The display name of the table.

false
DatasourceIdstring

The name of the table.

dfefd7f4-fc6e-42c9-b4******
DsTypestring

The ID of the data source.

maxcompute
FactTableboolean

The unique ID of the table.

true
Sqlstring

Indicates whether the table is a custom SQL table. Valid values:

  • true: custom SQL table
  • false: non-custom SQL table
select * from ****
TableNamestring

The list of tables used by the dataset.

viewdasb8494aab2612473cb74992159fe****
UniqueIdstring

The type of the data source. Valid values:

  • mysql
  • odps
  • oracle
  • ... and other data source types supported by Quick BI
7a62530b36
CustimzeSqlboolean

The unique ID of the workspace to which the dataset belongs.

false
DatasetIdstring

The type of the data source. Valid values:

  • mysql
  • odps
  • oracle
  • ... Data source types supported by Quick BI such as
a201c85c-******
DatasetNamestring

The user ID of the dataset owner in the Quick BI.

opds_40
DimensionListarray<object>

A list of all dimensions in the dataset.

DimensionListobject
Captionstring

The unique ID of the field that is referenced by the group measure. Non-NULL if and only if the metric is a grouping metric.

city
DataTypestring

A list of all dimensions in the dataset.

string
DimensionTypestring

The actual physical field.

group_dimension
Expressionstring

Data type; value:

  • string: character
  • number: a number
  • datetime: time
example_expression
FactColumnstring

Expression for a calculated dimension; valid only for calculated dimensions.

city
FieldDescriptionstring

The description of the field.

hhhh
Granularitystring

The type of the dimension. Valid values:

  • standard_dimension: General Dimension
  • calculate_dimension: calculating dimensions
  • group_dimension: grouping dimensions
example_granularity
RefUidstring

The granularity.

308f7****
TableUniqueIdstring

The ARN.

7a62530***
Uidstring

The display name of the dimension.

a69774***
ExpressionV2string

Expression for the flattened calculation dimensions.

example_expression
Directoryobject

The unique ID of the metric.

Idstring

Test directory

a3eecab7-618d-4f9f-*****
Namestring

Test directory

The name of the directory.
PathIdstring

The information about the directory to which the dataset belongs.

88b680****
PathNamestring

The path of the directory ID, for example, aa/bb/cc/dd.

The path name of the directory ID, for example, one-level directory /two-level directory.
DsIdstring

The name of the data source.

a201c85c-******
DsNamestring

The time when the dataset was last modified.

odps
DsTypestring

The point in time when the training dataset was created.

odps
GmtCreatestring

Indicates whether to customize SQL statements. Valid values:

  • true
  • false
1629450382000
GmtModifystring

The information about the dataset.

1629450382000
MeasureListarray<object>

A list of all measures for the dataset.

MeasureListobject
Captionstring

The actual physical field.

profit_amt
DataTypestring

A list of all measures for the dataset.

string
Expressionstring

Data type; value:

  • string: character
  • number: a number
  • datetime: time
example_expression
FactColumnstring

The type of the measure. Valid values:

  • standard_measure: General Metrics
  • calculate_measure: Calculating Measures
profit_amt
FieldDescriptionstring

The description of the field.

asadsda
MeasureTypestring

An expression that calculates a measure; valid only for calculated measures.

calculate_measure
TableUniqueIdstring

The display name of the metric.

7a62530b36
Uidstring

The unique ID of the table to which the table belongs, which corresponds to the UniqueId of the CubeTypeList.

88b680****
ExpressionV2string

Expression for flattened computation metrics.

example_expression
OpenOfflineAccelerationboolean

Whether to enable extraction acceleration. Valid values:

  • true
  • false
false
OwnerIdstring

Test Space

b8494aab26124*****
OwnerNamestring

The unique ID of the data source.

The name of the dataset owner.
RowLevelboolean

The name of the training dataset.

false
WorkspaceIdstring

Whether row-level permissions are enabled. Valid values:

  • true: The VIP Netty channel is enabled.
  • false: The VIP Netty channel is disabled.
420abef4-a79b-4289-b12****
WorkspaceNamestring

Big Baby

The name of the workspace in which the dataset resides.
Successboolean

The unique ID of the dataset.

true

Examples

Sample success responses

JSONformat

{
  "RequestId": "a4d1a221d-41za1-****",
  "Result": {
    "CubeTableList": [
      {
        "Caption": "odps_40",
        "Customsql": false,
        "DatasourceId": "dfefd7f4-fc6e-42c9-b4******",
        "DsType": "maxcompute",
        "FactTable": true,
        "Sql": "select * from ****",
        "TableName": "viewdasb8494aab2612473cb74992159fe****",
        "UniqueId": "7a62530b36"
      }
    ],
    "CustimzeSql": false,
    "DatasetId": "a201c85c-******",
    "DatasetName": "opds_40",
    "DimensionList": [
      {
        "Caption": "city",
        "DataType": "string",
        "DimensionType": "group_dimension",
        "Expression": "example_expression",
        "FactColumn": "city",
        "FieldDescription": "hhhh",
        "Granularity": "example_granularity",
        "RefUid": "308f7****",
        "TableUniqueId": "7a62530***",
        "Uid": "a69774***",
        "ExpressionV2": "example_expression"
      }
    ],
    "Directory": {
      "Id": "a3eecab7-618d-4f9f-*****",
      "Name": "The name of the directory.\n",
      "PathId": "88b680****",
      "PathName": "The path name of the directory ID, for example, one-level directory /two-level directory.\n"
    },
    "DsId": "a201c85c-******",
    "DsName": "odps",
    "DsType": "odps",
    "GmtCreate": 1629450382000,
    "GmtModify": 1629450382000,
    "MeasureList": [
      {
        "Caption": "profit_amt",
        "DataType": "string",
        "Expression": "example_expression",
        "FactColumn": "profit_amt",
        "FieldDescription": "asadsda",
        "MeasureType": "calculate_measure",
        "TableUniqueId": "7a62530b36",
        "Uid": "88b680****",
        "ExpressionV2": "example_expression"
      }
    ],
    "OpenOfflineAcceleration": false,
    "OwnerId": "b8494aab26124*****",
    "OwnerName": "The name of the dataset owner.\n",
    "RowLevel": false,
    "WorkspaceId": "420abef4-a79b-4289-b12****",
    "WorkspaceName": "The name of the workspace in which the dataset resides.\n"
  },
  "Success": true
}

Error codes

HTTP status codeError codeError messageDescription
400Cube.Not.ExistThe Cube does not exist.The Cube does not exist.
400Not.WorkspaceCube.ErrorYou can only use the %s dataset of the current workspace.You can only use the dataset of the current workspace.
400Decryption.ErrorAn error occurred while decoding.An error occurred while decoding.
400Datasource.UserPermission.ErrorYou do not have datasource authorization.You do not have datasource authorization.
400CubeMeta.ToXml.ErrorAn error occurred while converting the data object to the XML format.An error occurred while converting the data object to the XML format.
400Datasource.NotFound.ErrorThe specified data source does not exist: %s.The specified data source does not exist: %s.
400Cube.ParseToXml.ErrorAn error occurred while parsing a dataset object to XML format.An error occurred while parsing a dataset object to XML format.
400DatasourceId.IsNull.ErrorYou must select a data source before selecting the table.You must select a data source before selecting the table.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-05-22The Error code has changed. The response structure of the API has changedView Change Details