Searching for Derivative Indicators
Function
Search for derivative metrics by name, creator, reviewer, status, modification time, and l3Id.
Calling Method
For details, see Calling APIs.
URI
GET /v2/{project_id}/design/derivative-indexs
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
project_id |
Yes |
String |
Project ID. For details about how to obtain the project ID, see Project ID and Account ID. |
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
name |
No |
String |
Fuzzy query by name or code. |
|
create_by |
No |
String |
Query by creator. |
|
approver |
No |
String |
Query by reviewer. |
|
status |
No |
String |
Specifies the service status. Options:
|
|
dimension_id |
No |
String |
ID of the dimension based on which dimension attributes are queried. The ID is a string. |
|
dimension_group |
No |
String |
Query dimension attributes based on the dimension granularity. |
|
atomic_index_id |
No |
String |
ID of the atomic metric based on which dimension attributes are queried. The ID is a string. |
|
all_metrics |
No |
Boolean |
Indicates whether to query compound metrics. |
|
dw_type |
No |
String |
Data Connection Type |
|
l3_id |
No |
String |
ID of business object l3, which is a string |
|
begin_time |
No |
String |
Left boundary of time filtering. This parameter is used together with end_time. Only time range filtering is supported. Unilateral filtering is invalid. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
end_time |
No |
String |
Right boundary for time filtering. This parameter is used together with begin_time to support only time range filtering. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
limit |
No |
Integer |
Number of records to be queried on each page, that is, Y records to be queried. The default value is 50, and the value range is [1,100]. |
|
offset |
No |
Integer |
Start coordinate of the query, that is, the number of skipped data records. The value can only be 0 or an integer multiple of limit. If the value does not meet the requirement, the value is rounded down. The default value is 0. |
Request Parameters
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
X-Auth-Token |
Yes |
String |
IAM token, which is obtained by calling the IAM API for obtaining a user token (value of X-Subject-Token in the response header). This field is mandatory for authentication using tokens. |
|
workspace |
Yes |
String |
Workspace ID. For details about how to obtain the workspace ID, see Instance ID and Workspace ID. |
|
X-Project-Id |
No |
String |
Project ID. For details about how to obtain the project ID, see Project ID and Account ID. This parameter is mandatory for API requests that use AK/SK authentication in multi-project scenarios. |
|
Content-Type |
No |
String |
Default value: application/json;charset=UTF-8 This parameter is optional. If the body is available, this parameter is mandatory. If the body is unavailable, you do not need to set this parameter or verify it. |
Response Parameters
Status code: 200
|
Parameter |
Type |
Description |
|---|---|---|
|
data |
data object |
Returned data. |
|
Parameter |
Type |
Description |
|---|---|---|
|
records |
Array of DerivativeIndexVO objects |
DerivativeIndexVO array. |
|
total |
Integer |
Total number. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
Derivative metric ID, which is a string. This parameter is mandatory for update. |
|
name_en |
String |
Derivative metric name in English |
|
name_ch |
String |
Derivative metric name |
|
description |
String |
Description, which is read-only. |
|
create_by |
String |
Creator. |
|
data_type |
String |
Field type |
|
l1_id |
String |
Subject area group ID, which is a read-only string |
|
l2_id |
String |
Subject area ID. This parameter is read-only and does not need to be set during creation and update. |
|
l3_id |
String |
Business object GUID, which is a string |
|
status |
String |
Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
|
atomic_index_id |
String |
Atomic metric ID, which is a string |
|
time_condition_id |
String |
Time filter ID, which is a string |
|
time_field_id |
String |
ID of the field associated with the time filter, which is a string |
|
time_field_name |
String |
Name of the field associated with the time filter. This parameter is read-only. |
|
common_conditions |
Array of CommonConditionVO objects |
General filter information. |
|
dimension_groups |
Array of DerivativeIndexDimensionVO objects |
Statistical dimension, which cannot be changed during update |
|
monitor |
MetricMonitorVO object |
Monitor metrics. |
|
atomic_index |
AtomicIndexVO object |
Atomic metric information, including the name and unit. This parameter is read-only. |
|
time_condition_name |
String |
Time filter name. This parameter is read-only. |
|
create_time |
String |
Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
update_time |
String |
Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
l1 |
String |
Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
|
l2 |
String |
Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
|
l3 |
String |
Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
|
summary_table_id |
String |
Summary table ID, which is a read-only string |
|
approval_info |
ApprovalVO object |
Approval information. This parameter is read-only. Latest review information about a business object, including the business details, reviewer information, and review time. |
|
new_biz |
BizVersionManageVO object |
Service version management. This parameter is read-only. |
|
Parameter |
Type |
Description |
|---|---|---|
|
name |
String |
Name. |
|
field_ids |
Array of strings |
Field ID, in the format table_id.field_id. |
|
field_names |
Array of strings |
Field name information. Format: Table name.Field name. |
|
cal_exp |
String |
Calculation expression, for example, '${table_id.column_id} > 1', where table_id indicates the ID of the table to which the referenced field belongs and column_id indicates the ID of the referenced field. |
|
cal_fn_ids |
Array of strings |
Reference function ID, which is a string |
|
front_configs |
String |
Frontend expression configuration, which is used for front-end data restoration. |
|
id |
String |
General filter ID, which is a read-only string |
|
Parameter |
Type |
Description |
|---|---|---|
|
group_id |
String |
Dimension group ID. |
|
role |
String |
Dimension role. |
|
dimension_id |
String |
Dimension ID, which is a string |
|
hierarchies_id |
String |
Dimension level ID, which is a string |
|
ordinal |
Integer |
Sequence number, which is read-only. |
|
group_name |
String |
Name of a dimension group. |
|
group_code |
String |
Dimension group code. |
|
biz_type |
String |
Business entity type. Options:
|
|
hierarchies |
Array of DimensionHierarchiesVO objects |
Level attribute, which is read-only. |
|
l1 |
String |
Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
|
l2 |
String |
Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
|
l3 |
String |
Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
|
l1_id |
String |
Subject area group ID, which is a read-only string |
|
l2_id |
String |
Subject area ID. This parameter is read-only and does not need to be set during creation and update. |
|
l3_id |
String |
Business object ID, which is a read-only string |
|
dw_type |
String |
Data connection type. |
|
id |
String |
Level ID, which is a read-only string |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
ID, which is a string |
|
name |
String |
Level name. |
|
attrs |
Array of HierarchiesAttrVO objects |
Attributes contained in a hierarchy. |
|
create_time |
String |
Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
update_time |
String |
Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
create_by |
String |
Creator. |
|
update_by |
String |
Person who updates the information. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
ID, which is a string |
|
hierarchies_id |
String |
Level ID, which is a string |
|
attr_id |
String |
Attribute ID, which is a string |
|
level |
Integer |
Indicates the layer. |
|
attr_name_en |
String |
Referenced attribute code. |
|
attr_name_ch |
String |
Referenced attribute name, which is read-only. |
|
detail_attr_ids |
Array of strings |
Details attribute ID, which is a string |
|
detail_attr_name_ens |
Array of strings |
Details attribute in English. |
|
detail_attr_name_chs |
Array of strings |
Details attribute in Chinese, which is read-only. |
|
attr |
DimensionAttributeVO object |
Referenced attribute field, which is read-only. |
|
detail_attrs |
Array of DimensionAttributeVO objects |
Details field, which is read-only. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
ID, which is a string |
|
dimension_id |
String |
Dimension ID, which is a read-only string |
|
code_table_field_id |
String |
Lookup table attribute ID, which is a string |
|
name_en |
String |
Field name. |
|
name_ch |
String |
Service attribute. |
|
description |
String |
Description. |
|
create_by |
String |
Creator. |
|
data_type |
String |
Field type |
|
domain_type |
String |
Domain to which a field type belongs. Options:
|
|
data_type_extend |
String |
Extended field of the data type. |
|
is_primary_key |
Boolean |
Indicates whether a key is a primary key. |
|
is_biz_primary |
Boolean |
Indicates whether it is a service primary key. |
|
is_partition_key |
Boolean |
Indicates whether to partition. |
|
ordinal |
Integer |
Sequence number. |
|
not_null |
Boolean |
Indicates whether the value is empty. |
|
stand_row_id |
String |
ID of the associated data standard, which is a string |
|
stand_row_name |
String |
Name of the associated data standard. This parameter is read-only. |
|
quality_infos |
Array of QualityInfoVO objects |
Quality information, which is read-only. |
|
secrecy_levels |
Array of SecrecyLevelVO objects |
Confidentiality |
|
status |
String |
Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
|
create_time |
String |
Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
update_time |
String |
Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
alias |
String |
Alias |
|
self_defined_fields |
Array of SelfDefinedFieldVO objects |
User-defined item. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
ID, which is a string |
|
table_id |
String |
Table ID, which is a read-only string |
|
attr_id |
String |
Attribute ID, which is a read-only string |
|
biz_type |
String |
Business entity type. Options:
|
|
data_quality_id |
String |
Quality ID, which is a string |
|
show_control |
Integer |
Indicates whether to display the regular expression. |
|
data_quality_name |
String |
Quality name. |
|
alert_conf |
String |
Configure alarms. |
|
expression |
String |
Regular expression configuration in regular expression-related validation rules. |
|
extend_info |
String |
Indicates the extension information. |
|
from_standard |
Boolean |
Indicates whether the data comes from the data standard quality configuration. This parameter is read-only. |
|
result_description |
String |
Result description. |
|
create_by |
String |
Creator, which is read-only. |
|
update_by |
String |
Updater, which is read-only. |
|
create_time |
String |
Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
update_time |
String |
Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
Security level ID, which is a string |
|
uuid |
String |
Data security primary key. |
|
name |
String |
Confidentiality name. |
|
slevel |
Integer |
Confidentiality level. |
|
description |
String |
Confidentiality description. |
|
create_by |
String |
Creator. |
|
update_by |
String |
Person who updates the information. |
|
create_time |
String |
Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
update_time |
String |
Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
new_biz |
BizVersionManageVO object |
Service version management. This parameter is read-only. |
|
Parameter |
Type |
Description |
|---|---|---|
|
fd_name_ch |
String |
Chinese name of a user-defined item. |
|
fd_name_en |
String |
English name of a customized item. |
|
not_null |
Boolean |
Whether a parameter is mandatory. |
|
fd_value |
String |
Attribute value |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
ID, which is a string |
|
other_metric_ids |
Array of strings |
ID of another metric, which is a string |
|
other_metric_names |
Array of strings |
Name of another indicator. This parameter is read-only. |
|
other_compound_metric_ids |
Array of strings |
ID of another composite index. |
|
other_compound_metric_names |
Array of strings |
Name of another compound metric. |
|
expression |
String |
Alarm expression. |
|
metric_id |
String |
Mount pointer ID, which is a string |
|
front_configs |
String |
Frontend expression configuration, which is used for front-end data restoration. |
|
metric_type |
String |
Business entity type. Options:
|
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
ID, which is a string |
|
name_en |
String |
Indicates the English name of an atomic metric. |
|
name_ch |
String |
Indicates the English name of an atomic metric. |
|
description |
String |
Description. |
|
create_by |
String |
Creator. |
|
cal_exp |
String |
Calculation expression, for example, 'sum(${fact_column_id})', where fact_column_id indicates the ID of the referenced field in the fact table |
|
cal_fn_ids |
Array of strings |
Reference function ID, which is a string |
|
l1_id |
String |
Subject area group ID, which is a read-only string |
|
l2_id |
String |
Subject area ID. This parameter is read-only and does not need to be set during creation and update. |
|
l3_id |
String |
Business object GUID, which is a string |
|
table_id |
String |
Fact table ID, which is a string |
|
tb_name |
String |
Name of a fact table. |
|
dw_type |
String |
Data connection type, which corresponds to the type of the data warehouse where the table is located. The value can be DWS, MRS_HIVE, POSTGRESQL, MRS_SPARK, CLICKHOUSE, MYSQL, ORACLE, or DORIS. |
|
field_ids |
Array of strings |
Field ID, which is a string |
|
field_names |
Array of strings |
Field name. |
|
status |
String |
Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
|
biz_type |
String |
Business entity type. Options:
|
|
create_time |
String |
Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
update_time |
String |
Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
l1 |
String |
Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
|
l2 |
String |
Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
|
l3 |
String |
Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
|
approval_info |
ApprovalVO object |
Approval information. This parameter is read-only. Latest review information about a business object, including the business details, reviewer information, and review time. |
|
new_biz |
BizVersionManageVO object |
Service version management. This parameter is read-only. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
Application ID, which is a string |
|
tenant_id |
String |
Project ID. For details about how to obtain the project ID, see the API path parameter project_id. |
|
name_ch |
String |
Chinese name of a service. |
|
name_en |
String |
English name of a service. |
|
biz_id |
String |
Business ID, which is a string |
|
biz_type |
String |
Business entity type. Options:
|
|
biz_info |
String |
Serialized service details. The type is string. |
|
biz_info_obj |
Object |
Service details. The type is object. |
|
biz_version |
Integer |
Service version. |
|
biz_status |
String |
Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
|
approval_status |
String |
Service approval status. This parameter is read-only. Options:
|
|
approval_type |
String |
Service review type. Options:
|
|
submit_time |
String |
Submitted At |
|
create_by |
String |
Creator. |
|
l1 |
String |
Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
|
l2 |
String |
Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
|
l3 |
String |
Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
|
approval_time |
String |
Review time. |
|
approver |
String |
Reviewer. |
|
|
String |
Email address of the reviewer. |
|
msg |
String |
Review information. |
|
directory_path |
String |
Directory tree. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
Field ID, which is a string |
|
biz_type |
String |
Business entity type. Options:
|
|
biz_id |
String |
Business ID, which is a string |
|
biz_info |
String |
Business object information. |
|
status |
String |
Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
|
biz_version |
Integer |
Service version, which is read-only. |
|
create_time |
String |
Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
|
update_time |
String |
Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
Status code: 400
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code, for example, DS.6000, indicating that the request fails to be processed. |
|
error_msg |
String |
Error message |
|
data |
Object |
Returned data information. |
Status code: 401
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code, for example, DS.6000, indicating that the request fails to be processed. |
|
error_msg |
String |
Error message |
|
data |
Object |
Returned data information. |
Status code: 403
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code, for example, DS.6000, indicating that the request fails to be processed. |
|
error_msg |
String |
Error message |
|
data |
Object |
Returned data information. |
Example Requests
This API is used to query derivative metrics in pagination mode based on request parameters.
GET https://{endpoint}/v2/{project_id}/design/derivative-indexs?offset=1&limit=10
Example Responses
Status code: 200
This operation succeeds, and the returned data is a DerivativeIndexVO array and the total number of records.
{
"data" : {
"value" : {
"total" : 1,
"records" : [ {
"id" : "1181167466668310528",
"name_en" : "sum_total_amount",
"name_ch" : "Creating a derivative metric named total_amount_(vendor,stroke_order.dim_dropoff_date_key)",
"description" : "",
"create_by" : "test_uesr",
"data_type" : "STRING",
"l1_id" : "1170066794946420736",
"l2_id" : null,
"l3_id" : null,
"status" : "PUBLISHED",
"atomic_index_id" : "1170005876631875584",
"time_condition_id" : null,
"time_field_id" : null,
"time_field_name" : null,
"common_conditions" : [ ],
"dimension_groups" : [ {
"group_id" : "1169322847009742848",
"role" : null,
"dimension_id" : "1169322847009742848",
"hierarchies_id" : null,
"ordinal" : 1,
"group_name" : "Suppliers",
"group_code" : "dim_vendor",
"biz_type" : "DIMENSION",
"hierarchies" : null,
"l1" : null,
"l2" : null,
"l3" : null,
"l1_id" : null,
"l2_id" : null,
"l3_id" : null,
"dw_type" : null,
"id" : "1181167466768973824"
} ],
"monitor" : null,
"atomic_index" : {
"id" : "1170005876631875584",
"name_en" : "sum_total_amount",
"name_ch" : "total_amount",
"description" : "",
"create_by" : null,
"cal_exp" : "sum (total fare)",
"cal_fn_ids" : null,
"l1_id" : null,
"l2_id" : null,
"l3_id" : null,
"table_id" : "1169329693619625984",
"tb_name" : null,
"dw_type" : null,
"field_ids" : [ ],
"field_names" : null,
"status" : "DRAFT",
"biz_type" : "FACT_LOGIC_TABLE",
"create_time" : "2024-04-20T16:12:42.274+08:00",
"update_time" : "2024-04-20T16:12:42.274+08:00",
"l1" : null,
"l2" : null,
"l3" : null,
"approval_info" : null,
"new_biz" : null
},
"time_condition_name" : null,
"create_time" : "2023-12-04T09:37:49+08:00",
"update_time" : "2023-12-04T09:37:49+08:00",
"l1" : "test_001",
"l2" : null,
"l3" : null,
"summary_table_id" : "1181167468975177728",
"approval_info" : {
"id" : "1181167467817549824",
"tenant_id" : null,
"name_ch" : null,
"name_en" : null,
"biz_id" : "1181167466668310528",
"biz_type" : null,
"biz_info" : null,
"biz_info_obj" : null,
"biz_version" : 0,
"biz_status" : "PUBLISHED",
"approval_status" : "APPROVED",
"approval_type" : null,
"submit_time" : "2023-12-04T09:37:49+08:00",
"create_by" : null,
"l1" : null,
"l2" : null,
"l3" : null,
"approval_time" : "2023-12-04T09:37:49+08:00",
"approver" : "test_uesr",
"email" : null,
"msg" : "Fast Approval OK.",
"directory_path" : null
},
"new_biz" : null
} ]
}
}
}
Status code: 400
BadRequest
{
"error_code" : "DS.60xx",
"error_msg" : "The user request is illegal."
}
Status code: 401
Unauthorized
{
"error_code" : "DS.60xx",
"error_msg" : "User authentication failed."
}
Status code: 403
Forbidden
{
"error_code" : "DS.60xx",
"error_msg" : "The user does not have permission to call this API."
}
Status Codes
|
Status Code |
Description |
|---|---|
|
200 |
This operation succeeds, and the returned data is a DerivativeIndexVO array and the total number of records. |
|
400 |
BadRequest |
|
401 |
Unauthorized |
|
403 |
Forbidden |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.