文档首页 > > API参考> 历史API> 管理面API> 图管理API>

增量导入图(2.1.2)

增量导入图(2.1.2)

分享
更新时间:2020/12/14 GMT+08:00

功能介绍

增量导入图数据。

为防止系统重启时,不能正常恢复导入图数据,建议在使用图期间,不要删除存储在OBS中的数据。

URL

  • URI 格式
    POST  /v1.0/{projectId}/graphs/{graphId}/action?action_id=import-graph
  • 参数说明
    表1 URI参数说明

    参数

    是否必选

    类型

    说明

    projectId

    String

    项目编号,用于资源隔离。请参考获取项目ID

    graphId

    String

    图ID。

请求

  • 请求样例
    POST http://Endpoint/v1.0/{projectId}/graphs/{graphId}/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>标记一条边。
    • edgesetPath、vertexsetPath、schemaPath、logDir字符串取值合法性参考OBS对象名约束

响应

  • 要素说明
    表3 要素说明

    参数

    是否必选

    类型

    说明

    errorMessage

    String

    系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误信息。

    errorCode

    String

    系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误码。

    jobId

    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"
    }

返回值

  • 正常

    200

  • 异常
    表4 异常返回值说明

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区论坛频道来与我们联系探讨

智能客服提问云社区提问