通过导入文件更新点边的指定属性
功能介绍
通过导入文件更新点边的指定属性。
为防止系统重启时，不能正常恢复更新图数据，建议在使用图期间，不要删除存储在OBS中的数据。
URL
- URI 格式
POST /v1.0/{project_id}/graphs/{graph_name}/action?action_id=import-properties - 参数说明
表1 URI参数说明 参数
是否必选
类型
说明
project_id
是
String
项目编号，用于资源隔离。请参考获取项目ID。
graph_name
是
String
图名称。
请求
- 请求样例
POST http://Endpoint/v1.0/{project_id}/graphs/{graph_name}/action?action_id=import-properties { "vertexsetPath": "datasets/movie/movie.csv", "vertexsetFormat": "csv", "vertexProperties": [ { "label": "movie", "properties": [ "genres" ] } ], "edgesetPath": "datasets/movie/ranking_edge.csv", "edgesetFormat": "csv", "edgeProperties": [ { "label": "rate", "properties": [ "Datetime" ] } ], "targetProperties": [ { "label": "rate", "properties": [ "Rating" ] } ], "delimiter": ",", "trimQuote": "\"", "obsParameters": { "accessKey": "XXXXXXX", "secretKey": "XXXXXXX" } "vertexFileContainLabel": true } - 参数说明
- 点文件（包含label）：点ID,label,property_1,…property_n
- 点文件（不包含label）：点ID,property_1,…property_n
- 边文件：源点ID,目的点ID,label,边ID属性,property_1,…property_n
表2 Body参数说明 参数
是否必选
类型
说明
vertexsetPath
vertexsetPath和edgesetPath至少有一个
String
点文件目录或点文件名。
vertexsetFormat
否
String
点数据集格式。当前仅支持csv。
默认为csv。
vertexProperties
有vertexsetPath则必选
Json
点文件中点的label和待更新属性列表信息，JsonArray格式。
edgesetPath
vertexsetPath和edgesetPath至少有一个
String
边文件目录或边文件名。
edgesetFormat
否
String
边数据集格式。当前仅支持csv。
默认为csv。
edgeProperties
有edgesetPath则必选
Json
边文件中边的label和待更新属性列表信息，JsonArray格式。
targetProperties
有edgesetPath则必选
Json
边文件中用于区分重复边的属性信息，JsonArray格式。
delimiter
否
Character
csv格式文件字段分隔符，默认值为逗号（,）。list/set类型的字段内元素分隔符默认为分号（;）。
trimQuote
否
Character
csv格式文件字段包围符，默认值为双引号（"）。用来包围一个字段，如字段中含有分隔符或者换行等。
obsParameters
是
String
OBS认证参数。请参见表 obsParameters参数说明。
vertexFileContainLabel
否
Boolean
点文件是否包含label信息。可选选项，默认值是true。
表3 vertexProperties参数说明 参数
是否必选
类型
说明
label
是
String
label名称。
properties
是
Json
待更新属性列表，需要与点文件中属性顺序一致，JsonArray格式。
表4 edgeProperties参数说明 参数
是否必选
类型
说明
label
是
String
label名称。
properties
是
Json
待更新属性列表，需要与边文件中属性顺序一致，JsonArray格式。
表5 targetProperties参数说明 参数
是否必选
类型
说明
label
是
String
label名称。
properties
是
Json
边ID属性信息，JsonArray格式。当前仅支持一个属性
响应
- 要素说明
表6 要素说明 参数
是否必选
类型
说明
errorMessage
否
String
系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误信息。
errorCode
否
String
系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误码。
job_id
否
String
执行该异步任务的jobId。
说明：可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。
- 请求成功样例
Http Status Code: 200 { "jobId": "b4f2e9a0-0439-4edd-a3ad-199bb523b613" } - 请求失败样例
Http Status Code: 400 { "errorMessage": "parameter format error", "errorCode": "GES.8013" }
