凯发k8国际娱乐官网入口-k8凯发> 图引擎服务 ges> > > > > 导入图（2.1.14）
更新时间：2023-07-19 gmt 08:00

导入图（2.1.14）-凯发k8国际娱乐官网入口

uri

post /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=import-graph
表1 路径参数

参数

是否必选

类型

说明

project_id

是

string

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

graph_name

是

string

图名称。

请求参数

表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>标记一条边。

delimiter

否

character

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

trimquote

否

character

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

offline

否

boolean

是否离线导入，取值为true或者false，默认取false。

  • true 表示离线导入，导入速度较快，但导入过程中图处于锁定状态，不可读不可写。
  • false 表示在线导入，相对离线导入，在线导入速度略慢，但导入过程中图并未锁定，可读不可写。

obsparameters

是

object

obs相关参数。
表3 obsparameters参数类型

参数

是否必选

类型

说明

accesskey

是

string

用户的accesskey。

secretkey

是

string

用户的secretkey。

响应参数

表4 响应body参数说明

参数

类型

说明

errormessage

string

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误信息。

errorcode

string

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误码。

jobid

string

执行该异步任务的jobid。

可以查询jobid查看任务执行状态、获取返回结果，详情参考。

请求示例

进行导入图操作，边文件目录为testbucket/demo_movie/edges/，边数据集格式为csv，点文件目录为testbucket/demo_movie/vertices/，点数据集格式为csv，新增数据的元数据文件obs路径为testbucket/demo_movie/incremental_data_schema.xml，日志存放目录为testbucket/importlogdir。

post http://{server_url}/ges/v1.0/{project_id}/graphs/{graph_name}/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
   },
  "delimiter": ",",
  "trimquote": "\"",
  "offline": true,
  "obsparameters": {
    "accesskey": "xxxxxx",
    "secretkey": "xxxxxx"
  }
}

响应示例

状态码： 200

成功响应示例

http status code: 200
{
"jobid": "b4f2e9a0-0439-4edd-a3ad-199bb523b613"
}

状态码： 400

失败响应示例

http status code: 400
{
   "errorcode": "ges.8013",
   "errormessage": "graph [movie2] is not found"
}

状态码

返回值

说明

400 bad request

请求错误。

401 unauthorized

鉴权失败。

403 forbidden

没有操作权限。

404 not found

找不到资源。

500 internal server error

服务内部错误。

503 service unavailable

服务不可用。

错误码

请参见。

父主题：
分享：
网站地图