图引擎服务 GES
图引擎服务 GES
- 最新动态
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 如何使用图引擎服务
- 准备工作
- 权限管理
- 元数据操作
- 创建图
- 管理图
- 数据迁移
- 访问图和分析图
- 查看图任务
- 配置图操作权限
- 运维监控
- 套餐包管理
-
算法参考
- 算法一览表
- PageRank算法
- PersonalRank算法
- k核算法（k-core）
- k跳算法（k-hop）
- 最短路径算法（Shortest Path）
- 全最短路算法（All Shortest Paths）
- 带一般过滤条件最短路径（Filtered Shortest Path）
- 单源最短路算法（SSSP）
- 点集最短路（Shortest Path of Vertex Sets）
- 关联路径算法（n-Paths）
- 紧密中心度算法（Closeness Centrality）
- 标签传播算法（Label Propagation）
- Louvain算法
- 关联预测算法（Link Prediction）
- Node2vec算法
- 实时推荐算法（Real-time Recommendation）
- 共同邻居算法（Common Neighbors）
- 连通分量算法（Connected Component）
- 度数关联度算法（Degree Correlation）
- 三角计数算法（Triangle Count）
- 聚类系数算法（Cluster Coefficient）
- 中介中心度算法（Betweenness Centrality）
- 边中介中心度（Edge-betweenness Centrality）
- OD中介中心度（OD-betweenness Centrality）
- 单点环路检测（Single Vertex Circles Detection）
- 点集共同邻居（Common Neighbors of Vertex Sets）
- 点集全最短路（All Shortest Paths of Vertex Sets）
- 带一般过滤条件环路检测（filtered circle detection）
- 子图匹配（Subgraph Matching）
- 带过滤全对最短路径（Filtered All Pairs Shortest Paths）
- 带过滤全最短路径（Filtered All Shortest Paths）
- TopicRank算法
- 带过滤的n_paths算法（filtered_n_paths）
- 时序路径分析（Temporal Paths）
- 开发指南
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 管理面API（V2）
-
业务面API
-
内存版
- 点操作API
- 边操作API
- 元数据操作API
- 索引操作API
- Gremlin操作API
-
算法API
- 执行算法(1.0.0)
-
算法API参数参考
- 算法公共参数
- pagerank算法(1.0.0)
- personalrank算法(1.0.0)
- k核算法（kcore）(1.0.0)
- k跳算法（k_hop）(1.0.0)
- 共同邻居（common_neighbors）(1.0.0)
- 点集共同邻居(common_neighbors_of_vertex_sets)(2.2.13)
- 关联预测（link_prediction）(1.0.0)
- 最短路径（shortest_path）(2.1.5)
- 全最短路（all_shortest_paths）(1.0.12)
- 带一般过滤条件最短路径（filtered_shortest_path）(2.2.4)
- 单源最短路（sssp）(1.0.0)
- 点集最短路（shortest_path_of_vertex_sets）(2.1.5)
- 关联路径（n_paths）(1.1.2)
- 带过滤的n_paths算法（filtered_n_paths）(2.2.22)
- 带过滤全对最短路径（filtered_all_pairs_shortest_paths）(2.2.17)
- 点集全最短路(all_shortest_paths_of_vertex_sets)(2.2.15)
- 带过滤全最短路径（filtered_all_shortest_paths）(2.2.17)
- 连通分量（connected_component）(1.0.0)
- 标签传播（label_propagation）(2.1.8)
- louvain算法（louvain）(2.2.1)
- node2vec算法（node2vec）(1.0.5)
- 实时推荐（realtime_recommendation）(2.2.21)
- 度数关联度（degree_correlation）(1.0.0)
- 三角计数（triangle_count）(1.0.0)
- 聚类系数（cluster_coefficient）(1.0.0)
- 紧密中心度（closeness）(1.0.0)
- 中介中心度算法（betweenness）(2.2.4)
- 边中介中心度（edge_betweenness）(2.2.4)
- OD中介中心度（od_betweenness）（2.2.4）
- 单点环路检测（single_vertex_circles_detection）（2.2.4）
- 带一般过滤条件环路检测（filtered_circle_detection）(2.2.15)
- 子图匹配（subgraph_matching）(2.2.16)
- topicrank算法（topicrank）(2.2.20)
- 动态图分析API
- 路径API
- 图统计API
- 图操作API
- 子图操作API
- Job管理API
- 自定义操作API
- Cypher操作API（2.2.16）
- Filtered-query API(2.2.13)
- Filtered-query V2(2.3.6)
- DSL查询API（2.3.14）
- 通过导入文件更新点边的指定属性(2.2.13)
- 通过读取文件删除点边（2.2.15）
- 运维监控API
-
持久化版
- 持久化版规格说明
- 点操作API
- 边操作API
- 元数据操作API
- 索引操作API
- HyG图管理API
-
HyG算法API
- 执行算法
-
算法API参数参考
- 算法公共参数
- pagerank算法
- personalrank算法（personalrank）
- k核算法（kcore）
- k跳算法（k_hop）
- 点集共同邻居(common_neighbors_of_vertex_sets)
- 最短路径（shortest_path）
- 全最短路（all_shortest_paths）
- 全对最短路径（all_pairs_shortest_paths）
- 单源最短路算法（sssp）
- 点集最短路（shortest_path_of_vertex_sets）
- 点集全最短路（all_shortest_paths_of_vertex_sets）
- 连通分量（connected_component）
- 三角计数算法（triangle_count）
- 紧密中心度算法（closeness）
- 中介中心度算法（betweenness）
- 边中介中心度（edge_betweenness）
- OD中介中心度（od_betweenness）
- 单点环路检测（single_vertex_circles_detection）
- topicrank算法（topicrank）
- louvain算法（louvain）
- Bigclam算法（bigclam）
- Cesna算法（cesna）
- infomap算法（infomap）
- 标签传播算法（label_propagation）
- 子图匹配算法（subgraph matching）
- 关联预测算法（link_prediction）
- n_paths算法（n_paths）
- 聚类系数算法（cluster_coefficient）
- 算法结果TXT格式说明
- 执行DSL算法
- DSL语法说明
- HyG Job管理API
- 原生算法API
- 图统计API
- 图操作API
- Job管理API
- Cypher操作API
- 交互式事务API
- 运维监控API
-
内存版
- 应用示例
- 权限策略和授权项
- 云监控服务监控指标说明
- 历史API
- 附录
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功！
一般图数据格式
在导入图数据之前，您需要了解GES中支持的图数据格式。
- GES仅支持载入具有标准CSV格式的原始图数据，如果您的原始数据并不符合指定的格式，则需要将数据整理为GES支持的格式。
- GES支持的图数据格式包含三部分：点文件、边文件以及元数据。
- 点文件用于存放点数据。
- 边文件用于存放边数据。
- 元数据用于描述点文件和边文件中的数据格式。
概念说明
GES基于属性图模型导入图数据，因此，您需要了解属性图（Property graph）的基本概念。
一个属性图是由点、边、标签（Label）和属性（Property）组成的有向图。
- 点又称作节点（Node），边又称作关系（Relationship），点和关系是最重要的实体。
- 元数据是用于描述点或边的属性信息，元数据由多个标签组成，每个标签由一个或多个属性组成。
- 为点或边设置标签，那么拥有相同标签的点属于一个分组，是一个集合。
- 点和边只能设置一个标签。
如下示例中，此图数据由3个点和3条边组成，Vivian、Eric和Lethal Weapon表示点，（Vivian，Eric）、（Vivian，Lethal Weapon）和（Eric、Lethal Weapon）表示边，user和movie表示点的类型（标签），rate和friends表示关系类型（标签）。
图1 图数据格式的示例
- 标签（Label）
标签是属性的集合，描述了一个点或边拥有的所有属性的数据格式。
说明：
在不同的标签中，如果定义了相同的属性名称（Property name），则定义的cardinality和dataType需要跟已定义的一致。2.3.18版本以后不再有该限制，即支持不同Label下的同名属性类型不同。
- 属性（Property）
属性指的是单个属性的数据格式，包含3个字段。
- Property name：自定义属性名称，长度限制为1到256位，且不能包含<，>，&和ASCII码为14，15，30的特殊字符。
说明：
同一个标签中不能包含相同的Property name。
- cardinality：数据的复合类型，取值为single、list和set。
- single是单值类型，表示该属性的数据是一个单值，如一个数字或一个字符串。
说明：
当数据文件中single属性的数值为“value1;value2”这样的值时，将被识别为单值“value1;value2”。
- list和set是多值类型，表示该属性的数据由多个值组成，不同的值用分号分隔。
- list：数值有放入顺序，可重复，例如，“1;1;1”表示3个“1”。
- set：数值无放入顺序，不可重复，重复数值会覆盖掉，例如，“1;1;1”只表示1个“1”。
说明：
list和set类型不支持char array数据类型。
- single是单值类型，表示该属性的数据是一个单值，如一个数字或一个字符串。
- dataType：数据类型，支持的的数据类型如下表所示。
表1 支持的数据类型 类型
描述
char
字符。
char array
定长字符串（需指定最大长度，用maxDataSize参数实现）。
说明：
- 您可以设置maxDataSize参数来限制该类型数据的最大长度，详见图_元数据示例。
- 只有single类型支持该数据类型。
- 如果是数据类型是字符串类型，建议设置为char array，比设置为string类型，导入速度快。
float
float浮点类型（32位浮点）。
double
double浮点类型（64位浮点）。
bool
bool类型，取值（0/1）或者（true/false）。
long
长整数类型（取值范围-2^63 to 2^63-1）。
int
整数类型（取值范围-2^31 to 2^31-1）。
date
日期，目前支持格式如下所示：
- YYYY-MM-DD HH:MM:SS
- YYYY-MM-DD
说明：
MM和DD均须写为两位数，即个位数字前加上“0”，例如“05/01”。
enum
枚举类型（需指定枚举类型的个数以及每个枚举值），详见图_元数据示例。
string
不定长字符串类型。
说明：
由于string为不定长类型，影响数据导入效率，建议使用char array替代；
char array的长度根据业务需要自行定义，建议不超过32个字符。
- Property name：自定义属性名称，长度限制为1到256位，且不能包含<，>，&和ASCII码为14，15，30的特殊字符。
元数据示例如下所示：
<?xml version="1.0" encoding="ISO-8859-1"?>
<PMML version="3.0"
xmlns="http://www.dmg.org/PMML-3-0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema_instance" >
<labels>
<label name="default">
</label>
<label name="movie">
<properties>
<property name="ChineseTitle" cardinality="single" dataType="int" />
<property name="Year" cardinality="single" dataType="string"/>
<property name="Genres" cardinality="single" dataType="string"/>
</properties>
</label>
<label name="user">
<properties>
<property name="ChineseName" cardinality="single" dataType="int" />
<property name="Gender" cardinality="single" dataType="string"/>
<property name="age" cardinality="single" dataType="enum" typeNameCount="7"
typeName1="Under 18" typeName2="18-24" typeName3="25-34" typeName4="35-44" typeName5="45-49"
typeName6="50-55" typeName7="56+"/>
<property name="occupation" cardinality="single" dataType="enum" typeNameCount="21"
typeName1="other or not specified" typeName2="academic/educator" typeName3="artist" typeName4="clerical/admin" typeName5="college/grad student"
typeName6="customer service" typeName7="doctor/health care" typeName8="executive/managerial" typeName9="farmer" typeName10="homemaker"
typeName11="K-12 student" typeName12="lawyer" typeName13="programmer" typeName14="retired" typeName15="sales/marketing"
typeName16="scientist" typeName17="self-employed" typeName18="technician/engineer" typeName19="tradesman/craftsman" typeName20="unemployed"
typeName21="writer"/>
<property name="Zip-code" cardinality="single" dataType="char array" maxDataSize="12"/>
</properties>
</label>
<label name="rate">
<properties>
<property name="Rating" cardinality="single" dataType="int" />
<property name="Datetime" cardinality="single" dataType="string"/>
</properties>
</label>
</labels>
</PMML>
点文件
点文件罗列了各个点的数据信息。一行为一个点的数据。格式如下所示，id是点数据的唯一标识。
id,label,property 1,property 2,property 3,…
说明：
- 点id的名称，建议您不要使用中划线（-）命名，会影响Gremlin查询的使用。
- 点id的类型不需要设置，默认为string。
- 请注意label前后不要任意加空格，逗号表示分隔符，空格会被识别成label的一部分，可能会出现识别不了或提示label不存在的情况。
示例：
Vivian,user,薇薇安,F,25-34,artist,98133 Eric,user,埃里克,M,18-24,college/grad student,40205
边文件
边文件罗列了各个边的数据信息，一行为一条边的数据。GES中图规格是以边的数量进行定义的，如一百万边。格式如下所示，id 1、id 2是一条边的两个端点的id。
id 1, id 2, label, property 1, property 2, …
示例：
Eric,Lethal Weapon,rate,4,2000-11-21 15:33:18 Vivian,Eric,friends
注意：在持久化版中想要把两个端点和标签都相同的边存入进去，则需要sortKey列，放在属性后面即最后一列。
导入时指定sortKeyColumn参数，如果sortKey有值，则会根据图的sortKey类型正确读入，如果没有值需要在属性的末尾添加逗号，导入时会读入空表示将sortKey设置为空，即NULL。
id 1, id 2, label, property 1, property 2, …,sortKey
示例：
Eric,Lethal Weapon,rate,4,2000-11-21 15:33:18，5 Vivian,Eric,friends,
父主题： 图数据的格式
