增量导入图(2.1.2)
功能介绍
增量导入图数据。

为防止系统重启时,不能正常恢复导入图数据,建议在使用图期间,不要删除存储在OBS中的数据。
URL
- URI 格式
POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=import-graph
- 参数说明
表1 URI参数说明 参数
是否必选
类型
说明
project_id
是
String
项目编号,用于资源隔离。请参考获取项目ID。
graph_id
是
String
图ID。
请求
- 请求样例
POST http://Endpoint/v1.0/{project_id}/graphs/{graph_id}/action?action_id=import-graph { "edgesetPath": "testbucket/demo_movie/edges/", "edgesetFormat": "csv", "vertexsetPath": "testbucket/demo_movie/vertices/", "vertexsetFormat": "csv", "schemaPath": "testbucket/demo_movie/incremental_data_schema.xml", "logDir": "testbucket/importlogdir", "parallelEdge": { "action":"override", "ignoreLabel":true } }
- 参数说明
表2 Body参数说明 参数
是否必选
类型
说明
edgesetPath
否
String
边文件目录或边文件名。
edgesetFormat
否
String
边数据集格式。当前仅支持csv。
默认为csv。
vertexsetPath
否
String
点文件目录或点文件名。
vertexsetFormat
否
String
点数据集格式。当前仅支持csv。
默认为csv。
schemaPath
否
String
新增数据的元数据文件OBS路径。
logDir
否
String
导入图日志存放目录,用于存储导入失败的数据和详细错入原因。
parallelEdge
否
Object
重复边处理
action
否
String
处理方式,取值为allow,ignore和override,默认为allow。
- allow表示允许重复边。
- ignore表示忽略之后的重复边。
- override表示覆盖之前的重复边。
ignoreLabel
否
Boolean
重复边的定义,是否忽略Label。取值为true或者false,默认取true。
- true 表示重复边定义不包含Label,即用<源点,终点>标记一条边,不包含Label。
- false 表示重复边定义包含Label,即用<源点,终点,Label>标记一条边。
响应
- 要素说明
表3 要素说明 参数
是否必选
类型
说明
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" }
