使用FML语句查询数据建模引擎的信息。
接口说明
- 每次调用该接口均需使用 FML 语句请求获取查询信息。
- 除了数仓分层、业务过程和数据域查询外,其他引擎信息查询均可使用分页查询方式。您可以在 FML 语句结尾增加 offset num limit num 语句,表示查询信息时的偏移量及每次返回的页数。目前偏移量取值仅支持为页数的倍数。
- 每次调用该接口时,最多返回 1000 条数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的
Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
-
资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
-
对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
dataworks:* | Read |
|
|
无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Text | string | 是 |
输入查询引擎信息的 FML 语句,详情请参见 使用 FML 语句配置并管理数据表 。 当前仅支持 show 语句。 |
show dim tables |
ProjectId | string | 是 |
DataWorks 工作空间的 ID。您可以登录 DataWorks 控制台 ,进入工作空间管理页面获取 ID。 |
1234 |
返回参数
返回结果说明
查询数仓分层使用的 FML 语句如下。
show layers;
参数名 | 参数类型 | 示例值 | 描述信息 |
---|---|---|---|
code | String | dws | 数仓分层编码 |
englishName | String | dws | 数仓分层英文名 |
name | String | 汇总层 | 数仓分层中文名 |
ownerId | String | 0123456 | 负责人 ID |
ownerName | String | 甲乙丙丁 | 负责人名称 |
description | String | 汇总层描述 | 备注 |
uuid | String | obj-123456 | 对象唯一标识 |
gmtCreate | TimeStamp | 1644397025000 | 创建时间 |
gmtModified | TimeStamp | 1644459965000 | 修改时间 |
creatorId | String | 0123456 | 创建人 BaseId |
creatorName | String | 甲乙丙丁 | 创建人名称 |
modifierId | String | 0123456 | 修改人 BaseId |
modifierName | String | 甲乙丙丁 | 修改人名称 |
查询数据域使用的 FML 语句如下。
show domains;
参数名 | 参数类型 | 示例值 | 描述信息 |
---|---|---|---|
code | String | member | 数据域编码 |
englishName | String | member | 数据域英文名 |
name | String | 会员 | 数据域中文名 |
ownerId | String | 0123456 | 负责人 ID |
ownerName | String | 甲乙丙丁 | 负责人名称 |
businessUnitCode | String | bu-123456 | 业务板块编码 |
description | String | 会员域备注 | 备注 |
uuid | String | obj-123456 | 对象唯一标识 |
gmtCreate | TimeStamp | 1644397025000 | 创建时间 |
gmtModified | TimeStamp | 1644459965000 | 修改时间 |
creatorId | String | 0123456 | 创建人 BaseIdID |
creatorName | String | 甲乙丙丁 | 创建人名称 |
modifierId | String | 0123456 | 修改人 BaseIdID |
modifierName | String | 甲乙丙丁 | 修改人名称 |
查询业务过程使用的 FML 语句如下。
参数名 | 参数类型 | 示例值 | 描述信息 |
---|---|---|---|
code | String | bp-123456 | 业务过程编码 |
englishName | String | pay | 业务过程英文名 |
name | String | 付款 | 业务过程中文名 |
dataDomainCode | String | trade | 所属数据域编码 |
dataDomainName | String | 交易 | 所属数据域中文名 |
dataDomainUuid | String | dm-123456 | 所属数据域 UUID |
ownerId | String | 0123456 | 负责人 BaseId |
ownerName | String | 甲乙丙丁 | 负责人名称 |
description | String | 付款 | 备注 |
source | Integer | 2 |
创建来源。可取值如下:
1:系统创建 2:用户创建 |
uuid | String | obj-123456 | 对象唯一标识 |
gmtCreate | TimeStamp | 1644397025000 | 创建时间 |
gmtModified | TimeStamp | 1644459965000 | 修改时间 |
creatorId | String | creatorId | 创建人 BaseId |
creatorName | String | 甲乙丙丁 | 创建人名称 |
modifierId | String | 0123456 | 修改人 BaseId |
modifierName | String | 甲乙丙丁 | 修改人名称 |
查询业务分类使用的 FML 语句如下。
show business_categories;
show business_categories where code='code';
show business_categories where keyword='keyword';
show business_categories where uuid='uuid';
参数名 参数类型 示例值 描述信息 categoryDetail DirectoryDetailDTO {"uuid": "cate_uuid", "code": "trd", "name": "交易"} 业务分类详细信息 name String 电商 目录名称 detailType String DICT 目录子类型 parentUuid String dy-123456 父级目录 UUID description String 描述信息 目录描述 code String ind 业务分类 code dataDomains List [{"uuid": "domain1", "code": "trd", "name": "交易域"}] 业务分类下挂靠数据域 ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 businessUnitCode String bu-123456 业务板块编码 description String 描述信息 目录描述 categoryPath String tm.ind 业务分类 path
查询数据集市使用的 FML 语句如下。
show markets;
参数名 参数类型 示例值 描述信息 categoryDetail DirectoryDetailDTO {"uuid": "cate_uuid", "code": "trd", "name": "交易"} 数据集市详细信息 name String 电商 目录名称 detailType String DICT 目录子类型 parentUuid String dy-123456 父级目录 UUID description String 描述信息 目录描述 code String ind 业务分类 code subDetailType String common 目录子类型细分类型 auditDTOList List [{"baseId":"123","showName":"test"}] 审核人员列表 code String member 数据域编码 englishName String member 数据域英文名 name String 会员 数据域中文名 ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 businessUnitCode String bu-123456 业务板块编码 description String 会员域备注 备注 auditDTOList List [{"baseId":"123","showName":"test"}] 审核人员列表 categoryPath String tm.ind 业务分类 path
查询主题域使用的 FML 语句如下。
show subjects;
参数名 参数类型 示例值 描述信息 categoryDetail DirectoryDetailDTO {"uuid": "cate_uuid", "code": "trd", "name": "交易"} 主题详细信息 name String 电商 目录名称 detailType String DICT 目录子类型 parentUuid String dy-123456 父级目录 UUID description String 描述信息 目录描述 code String ind 业务分类 code subDetailType String common 目录子类型细分类型 auditDTOList List [{"baseId":"123","showName":"test"}] 审核人员列表 code String member 数据域编码 englishName String member 数据域英文名 name String 会员 数据域中文名 ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 businessUnitCode String bu-123456 业务板块编码 description String 会员域备注 备注 auditDTOList List [{"baseId":"123","showName":"test"}] 审核人员列表 categoryPath String tm.ind 业务分类 path
查询数据标准集使用的 FML 语句如下。
show dict groups;
参数名 参数类型 示例值 描述信息 name String 电商 目录名称 detailType String DICT 目录子类型 parentUuid String dy-123456 父级目录 UUID description String 描述信息 目录描述 code String ind 业务分类 code uuid List obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询数据标准使用的 FML 语句如下。
show dicts;
参数名 参数类型 示例值 描述信息 code String shop_type 英文缩写 englishName String shop type 英文名称 name String 店铺类型 中文名称 no String SN00001 标准编号 dataType String STRING 数据类型 length Integer 10 列长度 numericalPrecision Integer 2 列精度 notNull Boolean false 是否不为空 defaultValue String 旗舰店 默认值 parentNo String SN0001 父级标准编号 parentName String 店铺 父级标准名称 codeTableNo String shop_type 引用码表编号 codeTableName String 店铺类型码表 引用码表名称 codeTableUuid String tb-0001 引用码表 UUID directoryUuid String 所属目录 UUID 所属目录 UUID directoryName String 店铺目录 所属目录名称 description String remark 备注 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询标准代码使用的 FML 语句如下。
show code tables;
参数名 参数类型 示例值 描述信息 code String shop_type 代码编码 name String 店铺类型 代码名称 extendName String shop type 英文名称 description String remark 描述 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询度量单位组使用的 FML 语句如下。
show measure_unit groups;
参数名 参数类型 示例值 描述信息 name String 电商 目录名称 detailType String DICT 目录子类型 parentUuid String dy-123456 父级目录 UUID description String 描述信息 目录描述 code String ind 分类 code uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询度量单位使用的 FML 语句如下。
show measure_units;
参数名 参数类型 示例值 描述信息 code String yuan 英文缩写 englishName String RMB 英文名称 name String 元 列中文名称 directoryUuid String di-0001 单位分组 UUID directoryName String 货币 单位分组名称 description String remark 备注 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询标准代码内容使用的 FML 语句如下。
show codes from code_table;
参数名 参数类型 示例值 描述信息 codeContent String 0 code 内容值 extendNameContent String female 扩展标准代码名称 nameContent String 女性 标准代码名称 description String remark 标准代码描述 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询命名词典使用的 FML 语句如下。
show naming dicts;
参数名 参数类型 示例值 描述信息 code String shop 英文缩写 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 extendName String shop 英文名称 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称 name String 店铺 中文名称 ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 uuid String obj-123456 对象唯一标识
查询表信息使用的 FML 语句如下。
show tables;
参数名 参数类型 示例值 描述信息 code String dim_shop 表编码 name String 店铺维度表 表中文名 type Integer 1 表类型。取值如下:
0:事实表
1:维度表
3:汇总表
4:应用表
5:贴源表
6:维度 detailType String normal 表具体类型。可取值如下:
普通维度
枚举维度
事务事实 businessProcessUuid String bp-123456 业务过程 UUID businessUnitUuid String bu-123456 业务板块 UUID dataWarehouseLayerUuid String ly-123456 数仓层 UUID businessCategoryUuid String bc-123456 业务分类 UUID ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 description String 店铺表备注 备注 config String json 字符串 拓展属性配置 lifeCycle Integer 365 表生命周期 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询维度表使用的 FML 语句如下。
show dim tables;
参数名 参数类型 示例值 描述信息 code String dim_shop 表编码 name String 店铺维度表 表中文名 type Integer 1 表类型。可取值如下:
0:事实表
1:维度表 detailType String normal 表具体类型。可取值如下:
普通维度
枚举维度
事务事实 businessProcessUuid String bp-123456 业务过程 UUID businessUnitUuid String bu-123456 业务板块 UUID dataWarehouseLayerUuid String ly-123456 数仓层 UUID businessCategoryUuid String bc-123456 业务分类 UUID ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 description String 店铺表备注 备注 config String json 字符串 拓展属性配置 lifeCycle Integer 365 表生命周期 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询事实表信息使用的 FML 语句如下。
show fact tables;
参数名 参数类型 示例值 描述信息 code String dim_shop 表编码 name String 店铺维度表 表中文名 type Integer 1 表类型。可取值如下:
0:事实表
1:维度表 detailType String normal 表具体类型。可取值如下:
普通维度
枚举维度
事务事实 businessProcessUuid String bp-123456 业务过程 UUID businessUnitUuid String bu-123456 业务板块 UUID dataWarehouseLayerUuid String ly-123456 数仓层 UUID businessCategoryUuid String bc-123456 业务分类 UUID ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 description String 店铺表备注 备注 config String json 字符串 拓展属性配置 lifeCycle Integer 365 表生命周期 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询汇总表使用的 FML 语句如下。
show dws tables;
参数名 参数类型 示例值 描述信息 dataDomainUuid String dm-12345 数据域 UUID dataDomainCode String member 数据域 Code dataDomainName String 会员 数据域名字 timePeriods List [{"uuid": "uuid", "code": "code", "name": "中文名称"}] 时间周期列表 uuid String obj-123456 对象唯一标识 code String dws_001 表名 name String 支付汇总表 表中文名称 adjuncts List [{"uuid": "uuid", "code": "code", "name": "中文名称"}] 修饰词列表 dimensions List [{"uuid": "uuid", "code": "code", "name": "中文名称"}] 粒度 bizEntityUuid String dim-123456 业务对象 UUID bizEntityCode String dim_shop 业务对象英文缩写 bizEntityName String 店铺表 业务对象中文名称 relUuid String dim_a-123456 关联维度 UUID type Integer 3 表类型。取值为:3(汇总表) detailType String dws_normal 表具体类型。可取值如下:
dws_normal:普通汇总表
dws_advanced:轻度汇总表 businessProcessUuid String bp-123456 业务过程 UUID businessUnitUuid String bu-123456 业务板块 UUID dataWarehouseLayerUuid String ly-123456 数仓层 UUID businessCategoryUuid String bc-123456 业务分类 UUID ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 description String 店铺表备注 备注 config String json 字符串 拓展属性配置 lifeCycle Integer 365 表生命周期 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询应用表使用的 FML 语句如下。
show ads tables;
参数名 参数类型 示例值 描述信息 dataDomainUuid String dm-12345 数据域 UUID dataDomainCode String member 数据域 Code dataDomainName String 会员 数据域名称 timePeriods List [{"uuid": "uuid", "code": "code", "name": "中文名称"}] 时间周期列表 uuid String obj-123456 对象唯一标识 code String dws_001 表名 name String 支付汇总表 表中文名称 adjuncts List [{"uuid": "uuid", "code": "code", "name": "中文名称"}] 修饰词列表 dimensions List [{"uuid": "uuid", "code": "code", "name": "中文名称"}] 粒度 bizEntityUuid String dim-123456 业务对象 UUID bizEntityCode String dim_shop 业务对象英文缩写 bizEntityName String 店铺表 业务对象中文名称 relUuid String dim_a-123456 关联维度 UUID type Integer 1 表类型。可取值如下:
0:事实表
1:维度表 detailType String normal 表具体类型。可取值如下:
普通维度
枚举维度
事务事实 businessProcessUuid String bp-123456 业务过程 UUID businessUnitUuid String bu-123456 业务板块 UUID dataWarehouseLayerUuid String ly-123456 数仓层 UUID businessCategoryUuid String bc-123456 业务分类 UUID ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 description String 店铺表备注 备注 config String json 字符串 拓展属性配置 lifeCycle Integer 365 表生命周期 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询表信息同时返回字段信息使用的 FML 语句如下。
show full tables;
参数名 参数类型 示例值 描述信息 tableUuid String tb-123456 表 UUID tableCode String dim_shop 表编码 tableName String 店铺表 表名称 columnCode String shop_id 列编码 columnName String 店铺 Id 列名称 columnUuid String col-123456 列 UUID columnType String STRING 列数据类型 columnCategory String ATTRIBUTE 列类别
查询列信息使用的 FML 语句如下。
show columns from table_code;
参数名 参数类型 示例值 描述信息 code String seller_id 列编码 name String 卖家 Id 列中文名 dataType String STRING 数据类型 type String ATTRIBUTE 字段类型 isPrimaryKey Boolean false 是否主键 isPartitionKey Boolean false 是否分区键 partitionOrder Integer 1 分区键顺序 notNull Boolean true 是否非空 dataDictionaryUuid String member_id 数据字典编码 dataDictionaryCode String 会员 Id 数据字典名称 codeTableUuid String cd-123456 关联码表 UUID codeTableCode String sex 关联码表编码 codeTableName String 性别 关联码表名称 measureUnitCode String percent 关联单位编码 measureUnitName String 分 关联单位名称 sourceProjectName String autotest 来源项目名称 sourceTableCode String dict 来源表编码 sourceColumnCode String age 来源字段编码 sourceRelationTag String label 冗余关系标签 description String 字段备注 备注 orderId String 1 字段顺序 columnGroupName Integer col_group_1 所属字段组 config String json 字符串 拓展属性配置 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询修饰词使用的 FML 语句如下。
show adjuncts;
参数名 参数类型 示例值 描述信息 businessUnitUuid String bu-123456 业务板块 UUID businessUnitCode String test_bu 业务板块 CODE businessUnitName String 测试板块 业务板块 NAME dataDomainUuid String dt-123456 数据域 UUID dataDomainCode String member 数据域 CODE dataDomainName String 会员域 数据域 NAME categoryUuid String cy-123456 业务分类 UUID categoryCode String trade 业务分类 CODE categoryName String 电商 业务分类 NAME type AdjunctTypeEnum DIM_VAL 修饰词类型 code String beauty 英文缩写 name String 美妆 中文名称 extendName String beauty 英文名称 description String 美妆描述 描述 bizExpression String 用于报表统计口径 业务口径 expression String beauty = 1 修饰词语义表达式 bizEntityUuid String dim-123456 业务对象 UUID bizEntityCode String dim_shop 业务对象英文缩写 bizEntityName String 店铺表 业务对象中文名称 relUuid String dim_a-123456 关联维度 UUID ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 isDeleted DeleteTagEnum NO 是否被删除 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询时间周期使用的 FML 语句如下。
show time_periods;
参数名 参数类型 示例值 描述信息 businessUnitUuid String bu-123456 所属的业务板块 businessUnitCode String test_bu 业务板块 CODE type TimePeriodTypeEnum DAY 时间周期类型 typeName String 天 时间周期类型名称 code String 1d 英文缩写 name String 1 天 中文名称 extendName String 1d 英文名称 description String 时间周期描述 描述 isDeleted DeleteTagEnum NO 是否被删除 timeBegin String start_expression 开始时间表达式 timeEnd String end_expression 结束时间表达式 gmtCreate TimeStamp 1633885261000 创建时间 gmtModified TimeStamp 1633885261000 修改时间 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称 ownerId String 0123456 负责人 BaseId ownerName String 甲乙丙丁 负责人名称 beginOffset Integer 1 开始周期偏移量 endOffset Integer 1 结束周期偏移量 firstDay Integer 1 周期第一天(必填场景:type in[WEEK, MONTH, QUARTER, YEAR]),"+ "取值范围:"+ "WEEK(初始星期,周日:1, 周一:2, 周二:3, 周三:4, 周四:5, 周五:6, 周六:7), "+ "MONTH(初始号,月初:1, 月末:99, 2 号到 27 号:[2~27]), "+ "QUARTER(初始月,1 月到 12 月:[0~11]), "+ "YEAR(初始月,1 月到 12 月:[0~11]) uuid String obj-123456 对象唯一标识 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称
查询原子指标使用的 FML 语句如下。
show atomic indicators;
参数名 参数类型 示例值 描述信息 dataDistinct YesOrNoEnum YES 数据是否需要去重。可取值如下:
YES
NO aggFunctionType AggFunctionEnum SUM 指标聚合函数类型。可取值如下:
SUM
COUNT
AVG
MAX
MIN
RATE
RANK
UNDEFINED calExpression String price 计算口径(code) dataType DataTypeNameEnum TINYINT 数据类型。可取值为:TINYINT、SMALLINT、INT、BIGINT、BINARY、FLOAT、DOUBLE、DECIMAL、VARCHAR、CHAR、STRING、DATE、DATETIME、TIMESTAMP、BOOLEAN、ARRAY、MAP、STRUCT、JSON dataRound String N 数据精度。可取值如下:
N
M dataUnitUuid String du-123456 指标单位 UUID dataUnitCode String percent 指标单位 CODE dataUnitName String 分 指标单位名称 bizExpression String 支付金额汇总 业务口径 dataRollUpType String AGG_FUNCTION 数据上卷方式。可取值如下:
AGG_FUNCTION
SUM_THEN_RATE
RATE_THEN_AVG
NOT_SUPPORT businessUnitUuid String bu-0001 业务板块 UUID businessUnitCode String project_code 业务板块 Code businessProcessUuid String di-0002 业务过程 UUID businessProcessCode String pay 业务过程 Code businessProcessName String 支付 业务过程 Name dataDomainUuid String di-0003 数据域 UUID dataDomainCode String trd 数据域 Code dataDomainName String 交易 数据域 Name categoryUuid String di-0001 业务分类 UUID categoryCode String tb 业务分类 Code categoryName String 淘宝 业务分类 Name type String ATOMIC 指标类型。可取值如下:
ATOMIC
DERIVATIVE
DERIVATIVE_COMPOSITE code String pay_amt 英文缩写 name String 支付金额 中文名称 extendName String pay amount 英文名称 description String remark 描述 status String NORMAL 指标状态。可取值如下:
DRAFT
DEV
NORMAL ownerId String 0001 负责人 BaseId ownerName String 负责人姓名 负责人名称 isDeleted DeleteTagEnum NO 是否被删除。可取值如下:
YES
NO uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询派生指标使用的 FML 语句如下。
show derivative indicators;
参数名 参数类型 示例值 描述信息 timePeriodUuid String tp-0001 时间周期 UUID timePeriodCode String 1d 时间周期英文缩写 timePeriodName String 近 1 天 时间周期中文名称 adjunctUuids List ["adj-001"] 修饰词 UUID 列表 adjunctCodes List ["male"] 修饰词英缩写列表 adjunctNames List 男性 修饰词中文名称列表 atomicIndicatorUuid String ind-a-0001 原子指标 UUID atomicIndicatorCode String pay_amt 原子指标英文缩写 atomicIndicatorName String 支付金额 原子指标中文名称 dataType DataTypeNameEnum BIGINT 数据类型。可取值为:TINYINT、SMALLINT、INT、BIGINT、BINARY、FLOAT、DOUBLE、DECIMAL、VARCHAR、CHAR、STRING、DATE、DATETIME、TIMESTAMP、BOOLEAN、ARRAY、MAP、STRUCT、JSON bizEntityUuid String dim-123456 业务对象 UUID bizEntityCode String dim_shop 业务对象英文缩写 bizEntityName String 店铺表 业务对象中文名称 relUuid String dim_a-123456 关联维度 UUID indHash String hash-0001 指标 hash suggestCode String pay_amt_1d 推荐编码 businessUnitUuid String bu-0001 业务板块 UUID businessUnitCode String project_code 业务板块 Code businessProcessUuid String di-0002 业务过程 UUID businessProcessCode String pay 业务过程 Code businessProcessName String 支付 业务过程 Name dataDomainUuid String di-0003 数据域 UUID dataDomainCode String trd 数据域 Code dataDomainName String 交易 数据域 Name categoryUuid String di-0001 业务分类 UUID categoryCode String tb 业务分类 Code categoryName String 淘宝 业务分类 Name type IndicatorTypeEnum ATOMIC 指标类型。可取值如下:
ATOMIC
DERIVATIVE
DERIVATIVE_COMPOSITE code String pay_amt 英文缩写 name String 支付金额 中文名称 extendName String pay amount 英文名称 description String remark 描述 status IndicatorStatusEnum NORMAL 指标状态。可取值如下:
DRAFT
DEV
NORMAL ownerId String 0001 负责人 BaseId ownerName String 负责人姓名 负责人名称 isDeleted DeleteTagEnum NO 是否被删除。可取值如下:
YES
NO uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 创建时间 gmtModified TimeStamp 1644459965000 修改时间 creatorId String 0123456 创建人 BaseId creatorName String 甲乙丙丁 创建人名称 modifierId String 0123456 修改人 BaseId modifierName String 甲乙丙丁 修改人名称
查询复合指标使用的 FML 语句如下。
show derivative composite indicators;
参数名 参数类型 示例值 描述信息 businessUnitCode String project_code 工作空间名称 businessProcessUuid String di-0002 业务过程 UUID businessProcessCode String pay 业务过程 Code businessProcessName String 支付 业务过程名称 dataDomainUuid String di-0003 数据域 UUID dataDomainCode String trd 数据域 Code dataDomainName String 交易 数据域名称 categoryUuid String di-0001 业务分类 UUID categoryCode String tb 业务分类 Code categoryName String 淘宝 业务分类名称 type String DERIVATIVE_COMPOSITE 计算模式。可取值 DERIVATIVE_COMPOSITE (计算表达式)、DERIVATIVE_COMPARISON(同环比) code String pay_amt 指标英文缩写 name String 支付金额 指标中文名称 extendName String pay amount 指标英文名称 description String remark 指标描述信息 calculateExpression String {@pay_amt_1d[近 1 天_支付金额]}/{@pay_amt_1m[近 30 天_支付金额]} 计算表达式 comparisonPeriodType String DAY_MOM 同环比对比类型。取值如下: DAY_MOM(日环比)、 WEEK_MOM(周环比)、WEEK_YOY(周同比)、MONTH_MOM(月环比)、MONTH_YOY(月同比)、QUARTER_MOM(季度环比)、YEAR_MOM(年环比)、YEAR_YOY(年同比) comparisonIndicatorUuid String obj-123456 同环比对比指标的 UUID comparisonIndicatorCode String pay_amt_1d 同环比对比指标的英文缩写 comparisonIndicatorName String 近 1 天_支付金额 同环比对比指标的中文名称 ownerId String 0001 指标负责人的 BaseId ownerName String 张三 指标负责人的姓名 isDeleted DeleteTagEnum NO 是否被删除,可取值 YES 或 NO。 uuid String obj-123456 对象唯一标识 gmtCreate TimeStamp 1644397025000 指标创建时间 gmtModified TimeStamp 1644459965000 指标修改时间 creatorId String 0123456 指标创建人 BaseId creatorName String 甲乙丙丁 指标创建人名称 modifierId String 0123456 指标修改人 BaseId modifierName String 甲乙丙丁 指标修改人名称
查询单个指标所依赖模型的相关信息,使用的 FML 语句如下。
show statistic indicator table_code;
参数名 参数类型 示例值 描述信息 uuid String obj-123456 指标唯一标识 code String pay_amt 指标英文缩写 name String 支付金额 指标中文名称 extendName String pay amount 指标英文名称 relations List 示例请参见下文 依赖指标的模型信息列表,EntityInfo 的结构参见下文
EntityInfo 的结构示例及参数描述如下。
"uuid": "uuid",
"code": "code",
"name": "中文名称",
"extendName": "full name in English",
"entityType": "EntityTypeEnum.BASE_DERIVATIVE_INDICATOR",
"entityTypeName": "实体类型名称",
"entitySubType": "DERIVATIVE_INDICATOR",
"entitySubTypeName": "实体子类型名称",
"ownerId": "0001",
"ownerName": "负责人姓名"
参数名 参数类型 示例值 描述信息 uuid String obj-123456 模型唯一标识 code String dws_001 模型英文缩写 name String 支付汇总表 模型中文名称 extendName String dws_001 模型英文名称 entityType EntityTypeEnum Table 依赖指标的实体类型。取值包括但不限于TABLE、BASE_ATOMIC_INDICATOR、BASE_DERIVATIVE_INDICATOR
entityTypeName String 表 实体类型名称 entitySubType String DWS_TABLE 实体子类型。取值包括但不限于DWS_TABLE、ATOMIC_INDICATOR、DERIVATIVE_INDICATOR
entitySubTypeName String 汇总表 实体子类型名称 ownerId String 0001 负责人 BaseId ownerName String 张三 负责人名称
示例
正常返回示例
JSON
格式
{
"RequestId": "4CFB2DED-7D9B-4C42-B4AA-CFF4991DFFF4",
"ReturnValue": [
"test": "test",
"test2": 1
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Valid.FML.NoPermission | You are not authorized to access the project resources. | 您没有权限访问当前项目资源。 |
400 | Valid.FML.OnlySupportQueryStatement | Only FML query statement is supported. | 只支持FML查询语句。 |
400 | Valid.FML.ProjectNotExist | The project does not exist. | 项目信息不存在,请检查输入参数。 |
400 | Valid.FML.StatementNotValid | The FML statement is invalid. | FML语句不合法,请参考FML语法文档:https://dataworks-doc.yuque.com/docs/share/ff7899ed-c433-4970-b20e-6582ea3939f3?# |
400 | Valid.FML.ProductExpired | 智能数据建模产品购买已到期 | 智能数据建模产品购买已到期 |
400 | Valid.FML.ProductNotActivated | 智能数据建模产品未开通 | 智能数据建模产品未开通 |
500 | Execute.FML.ProcessError | Failed to execute FML statement. | FML执行失败,请稍后再试! |
访问
错误中心
查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
OpenAPI 错误码发生变更 | 看变更集 | |||||||||
|