# 增量导入图(2.1.14) -ImportGraph2 #### 功能介绍 增量导入图数据。 ![](https://support.huaweicloud.com/api-ges/public_sys-resources/note_3.0-zh-cn.png) 1. 为防止系统重启时，不能正常恢复导入图数据，建议在使用图期间，不要删除存储在OBS中的数据。 2. 导入目录下的单文件或者导入的单文件大小不能超过5GB，如果超过5GB，则会导入失败，建议把文件拆成小于5GB的多个文件后再导入。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GES&api=ImportGraph2&version=v2)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI POST /v2/{project_id}/graphs/{graph_id}/import-graph 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-ges/ges_03_0111.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母和数字组成，且长度为\[1-64\]个字符。 **默认取值：** 不涉及。 | | graph_id | 是 | String | **参数解释：** 图ID。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。用于获取操作API的权限。获取方法请参见[获取Token接口](https://support.huaweicloud.com/api-ges/ges_03_0005.html)，响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | edgeset_path | 否 | String | **参数解释**： 边文件目录或边文件名。 **约束限制**： 当vertexset_path、schema_path为空时，该参数为必选参数。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | edgeset_format | 否 | String | **参数解释**： 边数据集格式。 **约束限制**： 不涉及。 **取值范围**： - csv：csv格式。 - txt：txt格式。 **默认取值**： csv。 | | vertexset_path | 否 | String | **参数解释**： 点文件目录或点文件名。 **约束限制**： 当edgeset_path、schema_path为空时，该参数为必选参数。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | vertexset_format | 否 | String | **参数解释**： 点数据集格式。 **约束限制**： 不涉及。 **取值范围**： - csv：csv格式。 - txt：txt格式。 **默认取值**： csv。 | | schema_path | 否 | String | **参数解释**： 新增数据的元数据文件路径。 **约束限制**： 当edgeset_path、vertexset_path为空时，该参数为必选参数。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | log_dir | 否 | String | **参数解释**： 导入图日志存放目录，用于存储导入失败的数据和详细错误原因。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | parallel_edge | 否 | [parallel_edge] object | **参数解释**： 重复边处理。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | delimiter | 否 | String | **参数解释**： csv格式文件字段分隔符。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 默认值为逗号（,）。 list/set类型的字段内元素分隔符默认为分号（;）。 | | trim_quote | 否 | String | **参数解释**： csv格式文件字段包围符。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 默认值为双引号（"）。用来包围一个字段，如字段中含有分隔符或者换行等。 | | offline | 否 | Boolean | **参数解释**： 是否离线导入。 **约束限制**： 不涉及。 **取值范围**： - true 表示离线导入，导入速度较快，但导入过程中图处于锁定状态，不可读不可写。 - false 表示在线导入，相对离线导入，在线导入速度略慢，但导入过程中图并未锁定，可读不可写。 **默认取值**： false。 | 表4parallel_edge | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | action | 否 | String | **参数解释**： 处理方式。 **约束限制**： 不涉及。 **取值范围**： - allow表示允许重复边。 - ignore表示忽略之后的重复边。 - override表示覆盖之前的重复边。 **默认取值**： allow。 | | ignore_label | 否 | Boolean | **参数解释**： 重复边的定义，是否忽略Label。 **约束限制**： 不涉及。 **取值范围**： - true 表示重复边定义不包含Label，即用\<源点，终点\>标记一条边，不包含Label。 - false 表示重复边定义包含Label，即用\<源点，终点，Label\>标记一条边。 **默认取值**： true。 | | sort_key_column | 否 | String | **参数解释**： sortKey在边文件中的位置，当前仅支持"lastColumn"，边文件中无sortKey时，不传此参数。 sortKey的作用：通过配置不同SortKey的值来区分重复边（源点，终点，Label三者都相同的边），仅持久化图需要填写。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | #### 响应参数 **状态码： 200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | job_id | String | **参数解释**： 执行该异步任务的jobId。 **取值范围**： 不涉及。 | **状态码： 400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 系统提示信息。 - 执行成功时，字段可能为空。 - 执行失败时，用于显示错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 系统提示信息。 - 执行成功时，字段可能为空。 - 执行失败时，用于显示错误信息。 **取值范围**： 不涉及。 | #### 请求示例 增量导入图数据，边文件目录为testbucket/demo_movie/edges/，边数据集格式为csv，点文件目录为testbucket/demo_movie/vertices/，点数据集格式为csv。 ``` POST https://{Endpoint}/v2/{project_id}/graphs/{graph_id}/import-graph { "edgeset_path" : "testbucket/demo_movie/edges/", "edgeset_format" : "csv", "vertexset_path" : "testbucket/demo_movie/vertices/", "vertexset_format" : "csv", "schema_path" : "testbucket/demo_movie/incremental_data_schema.xml", "log_dir" : "testbucket/importlogdir", "parallel_edge" : { "action" : "override", "ignore_label" : true }, "delimiter" : ",", "trim_quote" : "\"", "offline" : false } ``` #### 响应示例 **状态码： 200** 成功响应示例 ``` { "job_id" : "b4f2e9a0-0439-4edd-a3ad-199bb523b613" } ``` **状态码： 400** 失败响应示例 ``` { "error_msg" : "parameter format error", "error_code" : "GES.8013" } ``` #### 状态码 | 返回值 | 说明 | |:---|:---| | 400 Bad Request | 请求错误 | | 401 Unauthorized | 鉴权失败 | | 403 Forbidden | 没有操作权限 | | 404 Not Found | 找不到资源 | | 500 Internal Server Error | 服务内部错误 | | 503 Service Unavailable | 服务不可用 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0040.html)。