文档首页 > > API参考> 业务面API>

通过导入文件更新点边的指定属性(2.2.13)

通过导入文件更新点边的指定属性(2.2.13)

分享
更新时间:2021/04/07 GMT+08:00

功能介绍

通过导入文件更新点边的指定属性。

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

URL

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

    参数

    是否必选

    类型

    说明

    projectId

    String

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

    graphName

    String

    图名称。

请求

  • 请求样例
    POST http://Endpoint/v1.0/{projectId}/graphs/{graphId}/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
    }
  • 参数说明

    导入文件更新属性的csv文件格式如下:

    • 点文件(包含label):点ID,label,property_1,…property_n
    • 点文件(不包含label):点ID,property_1,…property_n
    • 边文件:源点ID,目的点ID,label,边ID属性,property_1,…property_n
    表2 Body参数说明

    参数

    是否必选

    类型

    说明

    vertexsetPath(2.2.8)

    vertexsetPath和edgesetPath至少有一个

    String

    点文件目录或点文件名。

    vertexsetFormat(2.2.8)

    String

    点数据集格式。当前仅支持csv。

    默认为csv。

    vertexProperties(2.2.8)

    有vertexsetPath则必选

    Json

    点文件中点的label和待更新属性列表信息,JsonArray格式。

    edgesetPath

    (2.2.8)

    vertexsetPath和edgesetPath至少有一个

    String

    边文件目录或边文件名。

    edgesetFormat(2.2.8)

    String

    边数据集格式。当前仅支持csv。

    默认为csv。

    edgeProperties(2.2.8)

    有edgesetPath则必选

    Json

    边文件中边的label和待更新属性列表信息,JsonArray格式。

    targetProperties(2.2.8)

    有edgesetPath则必选

    Json

    边文件中用于区分重复边的属性信息,JsonArray格式。

    delimiter(2.2.8)

    Character

    csv格式文件字段分隔符,默认值为逗号(,)。list/set类型的字段内元素分隔符默认为分号(;)。

    trimQuote(2.2.8)

    Character

    csv格式文件字段包围符,默认值为双引号(")。用来包围一个字段,如字段中含有分隔符或者换行等。

    obsParameters(2.2.8)

    String

    OBS认证参数。请参见表 obsParameters参数说明

    vertexFileContainLabel(2.2.13)

    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

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

    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

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

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问