保存或修改数据集 - SaveDatasetForOpenApi

project_id

是

String

参数解释：

项目ID。获取方法请参见获取项目ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Workspace-Id

是

String

参数解释：

工作空间ID。获取方法请参见获取工作空间ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Auth-Token

是

String

参数解释：

用户Token。通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

id

否

String

参数解释：

数据集ID。

取值范围：

不涉及

caption

是

String

参数解释：

数据集语义化名称。

取值范围：

不涉及

status

否

String

参数解释：

数据集状态。

取值范围：

不涉及

description

否

String

参数解释：

数据集描述。

取值范围：

不涉及

ds_id

否

String

参数解释：

数据源ID。

取值范围：

不涉及

ds_name

否

String

参数解释：

数据源名称。

取值范围：

不涉及

ds_type

否

String

参数解释：

数据源类型。

取值范围：

不涉及

table_type

是

String

参数解释：

数据集类型。

取值范围：

• table：不含自定义SQL表的数据集

• sql：含自定义SQL表的数据集

resource_code

否

String

参数解释：

数据集资源标识。

取值范围：

不涉及

physical_schema

是

PhysicalOpenApiSchema object

数据集物理schema。

logical_schema

是

LogicalSchemaOpenApiVO object

数据集逻辑schema。

tables

是

Array of DatasetTableOpenApiVO objects

物理表信息。

database_name

是

String

参数解释：

数据库。

取值范围：

不涉及

is_fact_table

是

Boolean

参数解释：

是否为端点表。

取值范围：

不涉及

schema_name

否

String

参数解释：

模式。

取值范围：

不涉及

sql_text

否

String

参数解释：

查询SQL。

取值范围：

不涉及

table_name

是

String

参数解释：

表名。

取值范围：

不涉及

table_type

是

String

"参数解释：

表类型。

取值范围：

• table：物理表

• sql：自定义SQL表

field_schema

否

DatasetFieldSchemaOpenApiVO object

字段选择信息。

variables

否

Array of SqlVariable objects

SQL变量列表。

relations

否

Array of DatasetRelationOpenApiVO objects

物理表关系。

columns

否

Array of ColumnOpenApiVO objects

字段选择列表和字段名称赋值。

caption

是

String

参数解释：

字段名称。

取值范围：

不涉及

origin_column_name

是

String

参数解释：

字段物理名称。

取值范围：

不涉及

schema_name

否

String

参数解释：

字段所属schema。

取值范围：

不涉及

table_name

是

String

参数解释：

字段所属名。

取值范围：

不涉及

default_values

否

Array of objects

参数解释：

变量默认值。

取值范围：

不涉及

format

否

String

参数解释：

变量格式，针对日期时间类型变量有效。

取值范围：

不涉及

name

是

String

参数解释：

变量名称。

取值范围：

不涉及

type

是

String

参数解释：

变量类型，目前支持文本、数值、日期、系统变量等类型。

取值范围：

• STRING：普通文本类型，组装执行sql时“输入值”使用单引号包裹，如：'value'

• NUMBER：整数或小数类型，组装执行sql时，直接拼接输入值

• YEARREGION：日期-年类型

• QUARTERREGION：日期-年季类型

• MONTHREGION：日期-年月类型

• DATEREGION：日期-年月日类型

• YMDHMSREGION：日期-年月日时分秒类型

• SYSTEM：系统变量，无法指定具体值，由系统后台填写，如：“访问用户名称”后台将当前访问用户名作为值组装执行sql

use_scope

是

String

参数解释：

变量作用域。

取值范围：

• dataset：当前数据集范围

• global：全局

source_database_name

是

String

参数解释：

源表所属数据库名称。

取值范围：

不涉及

source_schema

否

String

参数解释：

源表所属schema名称。

取值范围：

不涉及

source_table_name

是

String

参数解释：

源表名称。

取值范围：

不涉及

target_database_name

是

String

参数解释：

目标表所属数据库名称。

取值范围：

不涉及

target_schema

否

String

参数解释：

目标表所属schema名称。

取值范围：

不涉及

target_table_name

是

String

参数解释：

目标表名称。

取值范围：

不涉及

join_type

是

String

参数解释：

关联类型。

取值范围：

不涉及

relation

是

String

参数解释：

关系类型。

取值范围：

不涉及

joins

是

Array of DatasetJoinOpenApiVO objects

关联键。

condition

是

String

参数解释：

关联关系。

取值范围：

不涉及

source_key

是

String

参数解释：

源表字段。

取值范围：

不涉及

target_key

是

String

参数解释：

目标表字段。

取值范围：

不涉及

caption

String

参数解释：

数据集语义化名称。

取值范围：

不涉及

domain_id

String

参数解释：

租户ID。

取值范围：

不涉及

ds_id

String

参数解释：

数据源ID。

取值范围：

不涉及

ds_type

String

参数解释：

数据源类型。

取值范围：

不涉及

id

String

参数解释：

数据集ID。

取值范围：

不涉及

logical_schema

LogicalSchema object

数据集逻辑schema。

physical_schema

PhysicalSchema object

数据集物理schema。

project_id

String

参数解释：

项目ID。

取值范围：

不涉及

version

String

参数解释：

数据集版本。

取值范围：

• 1.0

• 2.0

workspace_id

String

参数解释：

工作空间ID。

取值范围：

不涉及

create_date

Long

参数解释：

创建时间戳。

取值范围：

不涉及

create_user

String

参数解释：

创建者ID。

取值范围：

不涉及

create_user_name

String

参数解释：

创建者名称。

取值范围：

不涉及

update_date

Long

参数解释：

更新时间戳。

取值范围：

不涉及

update_user

String

参数解释：

更新者ID。

取值范围：

不涉及

update_user_name

String

参数解释：

更新者名称。

取值范围：

不涉及

resource_code

String

参数解释：

数据集资源标识。

取值范围：

不涉及

field_schema

DatasetFieldSchemaVO object

字段schema。

relations

Array of DatasetRelationVO objects

物理表关系。

variables

Array of SqlVariable objects

SQL变量列表。

dimensions

Array of DimensionVo objects

维度。

measures

Array of MeasureVo objects

度量。

caption

String

参数解释：

维度语义化名。

取值范围：

不涉及

cube_id

String

参数解释：

维度所属物理表ID。

取值范围：

不涉及

description

String

参数解释：

维度描述。

取值范围：

不涉及

id

String

参数解释：

维度ID。

取值范围：

不涉及

hierarchies

Array of Hierarchy objects

层级结构

caption

String

参数解释：

层级结构语义化名。

取值范围：

不涉及

levels

Array of LevelVO objects

层级结构

caption

String

参数解释：

语义化名。

取值范围：

不涉及

column_formula

String

参数解释：

level表达式。

取值范围：

不涉及

data_type

String

参数解释：

字段类型。

取值范围：

• STRING：字符

• DATE：日期

• DATETIME：日期时间

expansion_type

Integer

参数解释：

扩展字段类型。

取值范围：

• 0：普通扩展字段

• 1：聚合扩展字段

id

String

参数解释：

level ID。

取值范围：

不涉及

is_expansion

Integer

参数解释：

是否为扩展字段。

取值范围：

• 0：不是

• 1：是

level_type

String

参数解释：

level类型（时间字段有level类型值）。

取值范围：

• yearLevel：年

• quarterLevel：季

• monthLevel：月

• weekLevel：周

• dayLevel：天

• hourLevel：小时

• minuteLevel：分钟

• secondLevel：秒

• ymdhmsLevel：年月时分秒

• ymdhLevel：年月时。

origin_column_name

String

参数解释：

原始字段名称。

取值范围：

不涉及

origin_column_type

String

参数解释：

原始字段类型。

取值范围：

不涉及

origin_data_type

String

参数解释：

转换前的数据类型。

取值范围：

• STRING：字符

• DATE：日期

• DATETIME：日期时间

caption

String

参数解释：

度量语义化名。

取值范围：

不涉及

column_formula

String

参数解释：

度量字段表达式。

取值范围：

不涉及

cube_id

String

参数解释：

字段所属物理表ID。

取值范围：

不涉及

data_type

String

参数解释：

数据类型。

取值范围：

• STRING：字符

• NUMBER：数字

• DATE：日期

• DATETIME：日期时间

expansion_type

Integer

参数解释：

扩展字段类型。

取值范围：

• 0：普通扩展字段

• 1：聚合扩展字段

id

String

参数解释：

度量ID。

取值范围：

不涉及

is_expansion

Integer

参数解释：

是否为扩展字段。

取值范围：

• 0：不是

• 1：是

origin_column_name

String

参数解释：

原始字段名称。

取值范围：

不涉及

origin_column_type

String

参数解释：

原始字段类型。

取值范围：

不涉及

origin_data_type

String

参数解释：

转换前的数据类型。

取值范围：

• STRING：字符

• NUMBER：数字

• DATE：日期

• DATETIME：日期时间

join_type

String

参数解释：

关联类型。

取值范围：

• left join：左连接

• right join：右连接

• inner join：内连接

joins

Array of DatasetJoinVO objects

关联键。

relation

String

参数解释：

关系类型。

取值范围：

• one-to-one：1对1

• one-to-many：1对多

• many-to-one：多对1

source

String

参数解释：

源表ID。

取值范围：

不涉及

target

String

参数解释：

目标表ID。

取值范围：

不涉及

condition

String

参数解释：

关系。

取值范围：

不涉及

source_key

String

参数解释：

源字段ID。

取值范围：

不涉及

source_type

String

参数解释：

源字段类型

取值范围：

• dimension：维度

• measure：度量

target_key

String

参数解释：

目标字段ID。

取值范围：

不涉及

target_type

String

参数解释：

目标字段类型 。

取值范围：

• dimension：维度

• measure：度量

default_values

Array of objects

参数解释：

变量默认值。

取值范围：

不涉及

format

String

参数解释：

变量格式，针对日期时间类型变量有效。

取值范围：

不涉及

name

String

参数解释：

变量名称。

取值范围：

不涉及

type

String

参数解释：

变量类型，目前支持文本、数值、日期、系统变量等类型。

取值范围：

• STRING：普通文本类型，组装执行sql时“输入值”使用单引号包裹，如：'value'

• NUMBER：整数或小数类型，组装执行sql时，直接拼接输入值

• YEARREGION：日期-年类型

• QUARTERREGION：日期-年季类型

• MONTHREGION：日期-年月类型

• DATEREGION：日期-年月日类型

• YMDHMSREGION：日期-年月日时分秒类型

• SYSTEM：系统变量，无法指定具体值，由系统后台填写，如：“访问用户名称”后台将当前访问用户名作为值组装执行sql

use_scope

String

参数解释：

变量作用域。

取值范围：

• dataset：当前数据集范围

• global：全局

tables

Array of DatasetTableVO objects

物理表信息

id

String

参数解释：

表ID。

取值范围：

不涉及

database_name

String

参数解释：

数据库。

取值范围：

不涉及

schema_name

String

参数解释：

schema名称。

取值范围：

不涉及

table_name

String

参数解释：

表名。

取值范围：

不涉及

table_type

String

参数解释：

数据集类型。

取值范围：

不涉及

sql_text

String

参数解释：

查询SQL。

取值范围：

不涉及

is_fact_table

Boolean

参数解释：

是否为端点表。

取值范围：

不涉及

200

保存或者修改数据集成功。