-
时间轴设置 创建动态图后,在“图管理”页面,单击动态图“操作”列的“访问”按钮,进入图引擎编辑器。 在编辑器内,页面会弹出“时间轴设置”框,需要您设置以下参数: 这里设置的参数会同步设置群体演化和动态拓展模块内的参数。 开始时间属性值:用您导入或创建的元数据的属性作为动态图开始时间的属性名称,默认为startime,属性为date或long、int类型。 时间轴开始时间:动态分析图的开始时间(start),开始时间必须要小于等于结束时间。 结束时间属性值:用您导入或创建的元数据的属性作为动态图结束时间的属性名称,默认为endtime,属性为date或long、int类型。 时间轴结束时间:动态分析图的结束时间(end)。 更多设置:包括“默认设置”或“自定义”。 默认:选择系统设定的默认值。 自定义:包含参数“点边可视持续时间”。 点边可视持续时间:画布上算法结果点边可视化的持续时间,当前仅对动态拓展(Temporal BFS)有效,默认值:604800(7天,时间戳类型,单位为秒)。 该选项针对算法返回的点边数据只有开始时间的数据。 图1 时间轴设置框 完成设置后,单击“确认”。 如果您想修改以上参数,单击画布左下方进行设置。
-
图引擎编辑器介绍 编辑器页面分为图分析区(包括探索区、操作区、元数据区、算法区、索引区)、绘图区、查询区、结果展示区、条件过滤及属性区。 图1 编辑器页面 表1 区域说明 区
域名 称 说明 探索区 提供图相关工具来探索图(例如:路经拓展),具体功能介绍请参考图探索功能。 操作区 通过调用API的方式来添加自定义操作。具体功能介绍请参考添加自定义操作。 元数据区 可以对元数据进行操作(如添加、隐藏、导入或导出等)。具体功能介绍请参考Schema编辑。 算法区 显示了GES服务支持的所有算法,且可在此区域设置各算法相关的属性。完整算法区功能介绍如表2所示。 说明: 算法区选择算法,执行后,画布区将展示包含关键结果的采样子图,对应的执行结果非完整结果。想获取完整返回结果请通过调用API获取。 索引区 图访问界面增加索引管理功能,方便您在界面进行索引增删查操作。 绘图区 图数据的可视化展示区。绘图区预置了快捷操作,方便您对图数据进行分析。 绘图区详细功能介绍如表3所示。 图数据查询区 可以输入Gremlin查询语句执行查询操作。 可以输入Cypher查询语句执行查询操作。 可以输入DSL查询语句执行查询操作。 结果展示区 包含如下两个页签: 运行记录:具体介绍请参考查看运行记录 查询结果:具体介绍请参考查看查询结果 条件过滤及属性区 在绘图区,可以选中一个点,单击右键,选择“查看属性”,显示该页面。 包含如下三个页签: 条件过滤页签可以设置条件属性,对图数据进行筛选分析。具体介绍请参考条件过滤。 属性页签展示选中点或边的属性信息。 统计信息展示页签会显示出当前所框选的点边对应的标签和节点权重的数量。具体介绍请参考统计信息展示。 持久化版的图有如下限制: 没有算法区。 元数据区不支持添加Label。 无操作区功能(不支持添加自定义操作)。 图数据查询区,只有cypher查询,不支持gremlin查询。 图2 算法区 表2 算法区介绍 界面元素 说明 输入算法名称,快速查找对应的算法。 展开算法的参数配置区域。 运行算法。 算法的属性设置区域。每个算法的属性不同,详细信息请参考算法介绍。 图3 绘图区 表3 绘图区介绍 界面元素 说明 第1行: 13表示当前图上的点数据,886813表示整张图的所有点数据。 第2行: 9表示当前图上的边数据,892773表示整张图所有边的数据。 孤立点是指和其余点没有关联,在画布中独立存在的点。 框选内孤立点:框选(Shift+ 鼠标左键拖动)画布中的点,单击该按钮可查看框选范围内的所有孤立点。 画布内全量孤立点:直接单击该按钮,可显示画布中所有的孤立点。 选中画布中任意一个非孤立点,单击该按钮可查看与当前选中点有关联的所有点。 撤销前一步操作。 恢复被撤销的前一步操作。 选择显示“全图数据”或“当前数据”。 “全图数据”是图的所有数据。 “当前数据”是当前在画布上渲染出来的数据。 可以切换图引擎编辑器的主题,支持浅色、深色和跟随系统三种主题。 选择了“全图数据”或者“当前数据”,在搜索框里输入节点ID,按回车或者单击查询图标,可快捷搜索出对应的点数据并渲染到图展示区域。 说明: 当前只支持单个顶点ID的输入。 选择“当前数据”搜索,当前画布存在点会高亮显示出来。 单击“清空画布”,清除画布所有内容。 将画布内容导出,支持导出为txt格式(当前画布的点边文件)。 快捷键。 Ctrl+E(选择画布中与当前已选中点关联的点和边)。 +(放大画布)。 -(缩小画布)。 Ctrl+Z (撤销输入框内的上一步输入)。 Ctrl+A(画布内容全选)。 Ctrl+Delete(清空画布)。 Delete(快捷隐藏点)。 Ctrl+单击(多选单击的点和边)。 快照,用户可以快速保存和恢复画布当前所展示的图。具体功能介绍请参考快照。 放大图,最大放大至6倍。 缩小图,最小缩小至0.05倍。 适配当前屏幕。 当界面中展示的点边与当前操作的浏览器窗口大小失调时,单击此按钮,可快速自动适配窗口大小。 快速切换布局。从左往右分别为:圆形布局、网格布局、核心单节点布局、分层布局、自动分群布局、核心双节点布局。展示效果如图 圆形布局展示效果所示。 说明: 核心双节点布局必须要选中两个点才可以生效。 当画布中有图数据时,单击图数据内容,可根据需要选择图数据的颜色和大小。 点详情弹窗。把鼠标移动到想要查看的非虚化节点上,会自动显示出该节点的id、label,属性等信息。 说明: 弹窗最多能显示节点的6个属性。当该节点的属性大于6个时,您可以到条件过滤及属性区查看该节点的完整属性信息。 绘图区快捷键操作 框选:Shift+ 鼠标左键拖动 框选区域内所有点边,效果如下所示。 多选:Ctrl+ 鼠标左键拖动 框选区域内所有点边被选中并高亮,效果如下所示。 正选/反选:Ctrl + 鼠标左键 ctrl+鼠标左键选中点或者边,可以选中并高亮,按住ctrl键再次单击选中点或者边,可以取消选中并去除高亮状态。 全选:Ctrl + A 选中所有点和边,并高亮。 选择关联点边:Ctrl + E 选中点之后按ctrl+E,可以将有关系的点和边选中高亮。 隐藏:Delete 选中点或边,按Delete,可以快捷隐藏点或者边。 适配:Ctrl + F 根据当前屏幕宽度和高度自动缩放所有点和边。 缩小:- 键盘对应 - 键,缩小当前画布显示。 放大:=(+) 键盘对应 + 键,放大当前画布展示。 取消选中:Esc 所有选中的点和边取消选中,高亮状态消失。 放大缩小:滑动鼠标滚轮 滑动鼠标滚轮可以放大缩小画布显示。 图4 圆形布局展示效果 图5 网格布局展示效果 图6 核心单节点布局展示效果 图7 分层布局展示效果 图8 自动分群布局展示效果 图9 核心双节点布局展示效果 父主题: 访问图和分析图
-
图管理简介 在“图管理”页面,您可以查看图的名称,运行状态,内网访问地址,公网访问地址,计费模式,创建时间。 “内网访问地址”可单击查看,该地址是访问图实例的浮动IP,通过单击该IP地址您可以查看访问图实例的物理IP列表。为了防止浮动IP切换造成业务闪断,推荐您通过轮询的方式使用物理IP访问图实例。 方式1:单击“图名称”前的 ,页面下方将会显示该图的信息,包括“图ID”,“虚拟私有云”,“子网”,“安全组”,“图规格(边数)”,“点数据集”,“边数据集”,“元数据”,“图版本”,“是否支持跨AZ高可用”,“是否支持全文索引”,“创建人”,“企业项目”,“CPU架构”,“点ID类型”(持久化版)等。 图1 图详情页签 方式2:单击图名称进入图详情页,查看图的详细信息。在该页面右上角可以单击“访问”、“备份”、“更多”等按钮对该图进行图管理操作。 图2 图详情页 父主题: 管理图
-
创建索引 进入图引擎编辑器页面,详细操作请参见访问图引擎编辑器。 在图引擎编辑器左侧的索引模块,单击“创建索引”。 图1 创建索引 在创建索引弹框中,填写以下参数: 索引名称:自定义索引名称。 索引类型: 内存版图:有全局点索引和全局边索引。 持久化版图:有全局点索引、全局边索引、局部点索引、局部边索引四个选项。 注意:若您在创建图的时候,选择“是否支持全文/向量索引”,那么索引类型可以选择全文索引、点向量索引、边向量索引。 是否有Label:您可以选择打开或者关闭(当索引类型为向量索引时,不显示当前选项)。 索引Label名称:当您选择的索引类型为“局部点索引”或“局部边索引”时会有这个选项。 索引属性名称:只有属性基数为单值类型的属性才会显示在这里,多值不显示(当索引类型为向量索引时,仅支持单个属性,且属性类型为list)。 图2 创建索引参数 持久化版新增索引没有上限,内存版最多能创建10个索引。 填写完成后,单击“确定”会弹出一个提示框,您可以选择是否前往任务中心查看索引创建进度。 图3 查看创建进度 创建成功的索引会显示在左侧的索引模块中。
-
Gremlin特殊语法优化 GES集成了gremlin中的OLTP功能,并在一定程度上做了部分功能增强与strategy优化。 增强版Text Predicate g.V().has('name', Text.textSubString('xx')) Predicate 描述 textSubString 子字符串 textCISubString 忽略大小写的子字符串 textFuzzy 模糊匹配 textPrefix 前缀查询 textRegex 正则匹配 在指定schema时,不要给属性取名为id, label, property, properties。 在进行gremlin操作时,有很多step会把结果转化为map结果。众所周知,在map结构中,是不允许出现两个相同key。一般来说当向一个map中重复insert多个相同的key,其value会被覆盖 or 该操作被取消。当把属性名取为id, label, property, properties,在很多操作中,如果id与属性中的id一起返回,结果将是不完整的。
-
Gremlin查询语句 常用的查询语句如下所示: 点查询 g.V().limit(100):查询所有点,但限制点的返回数量为100,也可以使用range(x, y)的算子,返回区间内的点数量。 g.V().hasLabel('movie'):查询点的label值为movie的点。 g.V('11'):查询id为11的点。 不推荐使用“g.V()”语法,由于点过大时,这种查询方式影响展示效果。 为了避免返回数据过大导致系统查询耗时过长,强烈建议您添加limit参数,并且将limit参数设置在1000以内,展示效果更佳。 边查询 g.E():查询所有边,不推荐使用,边数过大时,这种查询方式不合理,一般需要添加过滤条件或限制返回数量。 g.E('55-81-5'):查询边id为55-81-5的边。 g.E().hasLabel('rate'):查询label为rate的边。 g.V('46').outE('rate'):查询点id为46所有label为rate的边。 属性查询 g.V().limit(3).valueMap():查询点的所有属性(可填参数,表示只查询该点, 一个点所有属性一行结果)。 g.V().limit(1).label():查询点的label。 g.V().values('userid').limit(10):查询点的属性为userid的值(可不填参数,表示查询所有属性, 一个点每个属性一行结果,只有value,没有key)。 新增点 g.addV('user').property(id,'600').property('age','18-24'):新增点,Label为user,ID为600,age为18-24。 删除点 g.V('600').drop():删除ID为600的点。 新增边 g.addV('user').property(id,'501').property('age','18-24') g.addV('movie').property(id,'502').property('title','love') g.addE('rate').property('Rating', '4').from(V('501')).to(V('502')) 分别添加点,然后新增边,边的两个点ID分别为501、502。 删除边 g.E('501-502-0').drop():删除ID为501-502-0的边。 如果您输入了多个Gremlin查询命令,可以在输入框中通过上下方向键来查找历史命令。 Gremlin查询支持联想历史记录的功能,根据您输入的语法关键字会自动显示您刚输入过的语法供您参考和选择,帮助您提高查询效率。 图2 Gremlin联想查询 输入栏中的关键词,不同的类型会呈现出不同的颜色,具体颜色区分如下: 保留字:灰色 注意:保留字是编程语言中的一类语法结构。在特定的编程语言里,这些保留字具有较为特殊的意义,并且在语言的格式说明里被预先定义。 String类型:橙色 分隔符(包含 [] {} , ; () . 等):红色 变量:绿色 图3 Gremlin关键字高亮
-
自定义创建图 登录华为云账号,进入图引擎服务管理控制台,单击右上角的“创建图”按钮,进入创建图页面。 选择“区域”,即集群工作区域,可在页面左上角下拉栏选择。 在创建图页面单击“自定义创建”tab页进入自定义创图界面。 在“服务选型”页面设置以下参数: 图1 图名称和软件版本 参数 说明 图名称 可自行设置或使用系统默认名称。图创建后,不支持修改图名称。 图名称的长度需同时满足如下条件: 4~50个字符,且必须以字母开头。 字母不区分大小写。 只能包含字母、数字或下划线,不能包含其他特殊字符。 GES软件版本 系统默认当前最新版本,目前只能选择当前默认的版本号。 选择网络信息,包含“虚拟私有云”、“子网”、“安全组”、“公网访问”和“企业项目”。 图2 网络信息 参数 说明 虚拟私有云 VPC即虚拟私有云,是通过逻辑方式进行网络隔离,提供安全、隔离的网络环境。 选择需要创建集群的VPC,单击“查看虚拟私有云”,可进入VPC服务查看已创建的VPC名称和ID。 说明: 若您的账号下有vpc,则自动选择一个填充,您可自行更改;若无vpc,则需要创建一个新的vpc,创建成功后,可自动填充。 子网 通过子网提供与其他网络隔离的、可以独享的网络资源,以提高网络安全。 选择需要创建集群的子网,可进入VPC服务查看VPC下已创建的子网名称和ID。 安全组 安全组是一个逻辑上的分组,为同一个VPC内具有相同安全保护需求并相互信任的弹性云服务器提供访问策略。 单击“如何配置安全组”可了解配置安全组的具体操作。 单击“查看安全组”可了解安全组详情。 公网访问 选择公网访问的方式,用户可根据自身需求选择。 “暂不使用”:不使用弹性IP的图实例并且不能与互联网互通,仅可通过私有网络中已部署的弹性云服务器连接当前图实例使用。 “现在购买”:服务将自动为图实例分配独享带宽的弹性IP,以支持通过弹性IP从互联网对图实例进行访问。同时,服务将使用租户权限在当前项目下自动创建以ges_agency_default为前缀的授权委托以支持弹性IP的绑定处理。 “使用已有”:为图实例绑定指定的弹性IP,通过弹性IP可以从互联网对图实例进行访问。 单击“创建弹性IP”可进入VPC服务创建弹性公网IP。 企业项目 企业项目是一种云资源管理方式,企业项目管理服务提供统一的云资源按项目管理,以及项目内的资源管理、成员管理。 在页面上单击“新建企业项目”跳转至“企业项目管理”页面进行创建。 标签 为资源添加标签。在输入框中,输入标签键和标签值,单击“添加”按钮即可将标签添加在标签框中。 添加后您可以在“图管理”页面的图详情中查看到给该图添加的标签,也可以在“图管理”页面中筛选同一标签下的图。 图3 查看标签详情 说明: 如果您需要使用同一标签标识多种云资源,即所有服务均可在标签输入框下拉选择同一标签,建议在TMS中创建预定义标签。 安全模式 开启安全模式后,访问图实例将进行通讯加密(表示调用API时只能采用HTTPS协议),该功能开启后对性能有一定的影响。 密码算法 有两种方式可供选择。 通用加密算法(不支持SM系列商密算法):该状态下所有部件敏感数据存储、传输均使用通用加密算法。主要适用于国外局点和没有特殊算法需求的局点。 支持SM系列商密算法(兼容国际通用算法):该状态下所有部件敏感数据存储使用SM系列商密算法,数据传输兼容SM系列商密算法和国际算法。 填写图相关参数。 图4 图相关参数 参数 说明 是否支持跨AZ高可用 该选项表示是否支持跨可用区部署集群。 开启该选项,图实例分布在不同可用区(AZ)增强可靠性。 用途 创建图的用途。 “企业生产”:支持高可靠,高并发,适合企业生产及大规模应用时使用。 “开发学习”:完整功能体验,适合开发者学习使用。 产品类型 可选的产品类型。 内存版:容量有限,最大可支持到百亿边。基于内存存储和计算,预置丰富的算法,支持Gremlin和Cypher查询语言。 持久化版:容量无限。基于分布式KV数据库做存储和计算的新一代图数据库,有更高的性能,仅支持Cypher查询语言。 点ID类型(当您选择产品类型为持久化版时,会有此选项) 持久化版目前支持固定长度String、可变长度String和哈希三种点ID类型。 String(固定长度):实际点ID直接用于内部存储与计算,需指定一长度,实际点ID不可超过此长度。长度过大可能影响查询性能,建议根据数据集状态进行设置。 String(可变长度):用户写入的点ID无长度限制,但是ID过长会影响读写性能,建议长度控制在1K字节以内,最大不要超过4K字节。 哈希:哈希格式下,内部计算时将实际点ID转换成哈希码进行存储与计算,对实际点ID长度无限制,但是存在极低的概率(约10^(-43))出现点ID碰撞。 说明: 若用户无法确定点ID的最大长度,建议选择哈希类型。 SortKey类型(当您选择产品类型为持久化版时,会有此选项) 通过配置不同SortKey的值来区分重复边(源点,终点,Label三者都相同的边)。有如下三种取值: 整数: 整数类型,可节省空间。 String(字节长度小于等于40)。 String(可变长度):不限长度字符串,过长会影响读写性能,建议长度控制在1K字节以内,最大不要超过2K字节。 计算类型 计算类型。 弹性云服务器:是具有完整硬件、操作系统、网络功能,并且运行在一个完全隔离环境中的计算机系统。 CPU架构 CPU架构:目前支持“X86计算”和“鲲鹏计算”架构。 图规格(边数) 以边为单位,根据用户当前的配额,系统会提示可创建的图的数量以及边数。 “企业生产”和“开发学习”有不同的规格。 “开发学习”:目前只有“一万边”一种规格,无论在哪种产品类型下。 “企业生产”:产品类型不同,图规格不同。 “内存版”:目前可选择“一百万边”、“一千万边”、“一亿边”,“十亿边”,“十亿边-增强版”,“一百亿边”六种规格。 “持久化版”:目前可选择“十亿边”,“一百亿边”和“一千亿边”三种规格。 说明: 图的规模,以图的边数为依据,非精确值。如果图的点数和属性较多的话,建议您申请更大规模图。 “高级配置”:包括“默认配置”或“自定义”。 “默认配置”:选择系统设定的默认值。 “自定义”: 当您选择产品类型为“内存版”时,自定义包括“启用细粒度权限控制”。 图5 内存版高级配置 参数 说明 启用细粒度权限控制 可对特定Label的特定属性设置遍历(traverse)、读、写权限。 开启后,需要先创建策略、创建用户组和策略绑定用户组,然后用户才可以访问图数据。 当您选择产品类型为“持久化版”时,自定义包括“是否支持HyG计算引擎”“启用细粒度权限控制”。 图6 持久化版高级配置 参数 说明 是否支持HyG计算引擎 HyG是一个高性能分布式图计算框架,支持了诸多图分析算法。如果用户有复杂的图分析场景,可以使用HyG引擎来完成。 启用细粒度权限控制 可对特定Label的特定属性设置遍历(traverse)、读、写权限。 开启后,需要先创建策略、创建用户组和策略绑定用户组,然后用户才可以访问图数据。 是否支持全文/向量索引 开启后,创建的图支持全文索引和向量索引功能。 细粒度权限控制和支持全文/向量索引,两者只能开启一个,不支持同时开启。 单击“确认创建”,进入“规格确认”页面。 在“规格确认”页面,确认信息无误后,单击“提交”开始创建图。 提交成功后系统将自动跳转到“完成”页面,单击“返回图管理列表”可查看所创建图的状态及运行结果。 父主题: 创建图
-
操作场景 图引擎服务在创建图完成后可以导入图数据,或者当您需要新增图数据时,可以利用“导入”功能进行增量导入。 当前仅支持 1.1.8 以上版本的图的增量导入功能。 为防止系统重启时,不能正常恢复导入图数据,建议在使用图期间,不要删除存储在OBS中的数据。 数据列的分隔符默认为逗号,暂不支持自定义。 导入目录下的单文件或者导入的单文件大小不能超过5GB,如果超过5GB,则会导入失败,建议把文件拆成小于5GB的多个文件后再导入。 单次导入的文件总大小(包括点、边数据集)不能超过可用内存的1/5。可用内存参考“运维监控面板”的“节点监控”中名称后缀为ges-dn-1-1和ges-dn-2-1节点可用内存(可以把鼠标悬浮在内存使用率上弹出)的最小值。
-
任务类型对应表 表2 任务类型和任务名称对应表 任务类型 任务名称 100 点查询 101 创建点 102 删除点 103 修改点属性 104 添加点Label 105 删除点Label 200 边查询 201 创建边 202 删除边 203 修改边属性 300 查询Schema详情 301 添加Label 302 修改Label 303 查询Label 304 修改属性 400 查询图详情 401 清空图 402 在线增量导入图 403 创建图 405 删除图 406 导出图 407 filtered_khop 408 查询路径详情 409 离线增量导入图 500 创建备份 501 从备份恢复图 601 创建索引 602 查询索引 603 更新索引 604 删除索引 700 运行算法
-
监控指标 表1 图引擎服务支持的监控指标 指标ID 指标名称 指标含义 取值范围 单位 进制 测量对象(维度) 监控周期(原始指标) ges001_vertex_util 点容量使用率 统计图实例的点容量使用率,其值为当前图点个数和图点容量的比值。 0~100 值类型:Float % 不涉及 GES实例 1分钟 ges002_edge_util 边容量使用率 统计图实例的边容量使用率,其值为当前图边个数和图边容量的比值。 0~100 值类型:Float % 不涉及 GES实例 1分钟 ges003_average_import_rate 平均导入速率 统计图实例导入点或者边的平均速率。 0~400000 值类型:Float Count/s 不涉及 GES实例 1分钟 ges004_request_count 请求个数 统计图实例接收的请求个数。 ≥0 值类型:Int Count 不涉及 GES实例 1分钟 ges005_average_response_time 平均响应时间 统计图实例接收请求平均响应时间。 ≥0 值类型:Int ms 不涉及 GES实例 1分钟 ges006_min_response_time 最小响应时间 统计图实例接收请求最小响应时间。 ≥0 值类型:Int ms 不涉及 GES实例 1分钟 ges007_max_response_time 最大响应时间 统计图实例接收请求最大响应时间。 ≥0 值类型:Int ms 不涉及 GES实例 1分钟 ges008_read_task_pending_queue_size 读任务等待队列长度 统计图实例读请求任务等待队列长度,用于查看当前等待的读请求个数。 ≥0 值类型:Int Count 不涉及 GES实例 1分钟 ges009_read_task_pending_max_time 读任务最长等待时间 统计图实例读请求任务最长等待时间,用于查看读请求最长的等待时间。 ≥0 值类型:Int ms 不涉及 GES实例 1分钟 ges010_pending_max_time_ read_task_type 等待最长的读任务类型 统计图实例等待最长的读请求任务类型,参考任务类型和任务名称对应表可以找到对应的任务名称。 ≥1 值类型:Int - 不涉及 GES实例 1分钟 ges011_read_task_running_queue_size 读任务运行队列长度 统计图实例读请求任务运行队列长度,用于查看当前正在运行的读请求个数。 ≥0 值类型:Int Count 不涉及 GES实例 1分钟 ges012_read_task_running_max_time 读任务最长运行时间 统计图实例读任务最长运行时间,用于查看读请求最长的运行时间。 ≥0 值类型:Int ms 不涉及 GES实例 1分钟 ges013_running_max_time_ read_task_type 运行最长的读任务类型 统计图实例运行最长的读请求类型,参考可以找到对应的任务名称。 ≥1 值类型:Int - 不涉及 GES实例 1分钟 ges014_write_task_pending_queue_size 写任务等待队列长度 统计图实例写请求任务等待队列长度,用于查看当前等待的写请求个数。 ≥0 值类型:Int Count 不涉及 GES实例 1分钟 ges015_write_task_pending_max_time 写任务最长等待时间 统计图实例写请求任务最长等待时间,用于查看写请求最长的等待时间。 ≥0 值类型:Int ms 不涉及 GES实例 1分钟 ges016_pending_max_time_ write_task_type 等待最长的写任务类型 统计图实例等待最长的写请求任务类型,参考任务类型和任务名称对应表可以找到对应的任务名称。 ≥1 值类型:Int - 不涉及 GES实例 1分钟 ges017_write_task_running_queue_size 写任务运行队列长度 统计图实例写请求任务运行队列长度,用于查看当前正在运行的写请求个数。 ≥0 值类型:Int Count 不涉及 GES实例 1分钟 ges018_write_task_running_max_time 写任务最长运行时间 统计图实例写请求任务最长运行时间,用于查看写请求最长的运行时间。 ≥0 值类型:Int ms 不涉及 GES实例 1分钟 ges019 _running_max_time_ write_task_type 运行最长的写任务类型 统计运行最长的写请求任务类型,参考可以找到对应的任务名称。 ≥1 值类型:Int - 不涉及 GES实例 1分钟 ges020_computer_resource_usage 计算资源 使用率 统计每个图实例的计算资源使用率。 0~100 值类型:Float % 不涉及 GES实例 1分钟 ges021_memory_usage 内存资源使用率 统计每个图实例的内存资源使用率。 0~100 值类型:Float % 不涉及 GES实例 1分钟 ges022_iops IOPS 统计每个图实例每秒处理的I/O请求数量。 ≥0 值类型:Int Count/s 不涉及 GES实例 1分钟 ges023_bytes_in 网络输入吞吐量 统计每秒从网络输入每个图实例的数据总量。 ≥0 值类型:Float Byte/s 1024 GES实例 1分钟 ges024_bytes_out 网络输出吞吐量 统计从每个图实例每秒发送到网络的数据总量。 ≥0 值类型:Float Byte/s 1024 GES实例 1分钟 ges025_disk_usage 磁盘利用率 统计每个图实例节点的磁盘使用情况。 0~100 值类型:Float % 不涉及 GES实例 1分钟 ges026_disk_total_size 磁盘总大小 统计每个图实例的数据磁盘总大小。 ≥0 值类型:Float GB 不涉及 GES实例 1分钟 ges027_disk_used_size 磁盘使用量 统计每个图实例的数据磁盘已用大小。 ≥0 值类型:Float GB 不涉及 GES实例 1分钟 ges028_disk_read_throughput 磁盘读吞吐量 统计图实例数据磁盘每秒读取的数据量。 ≥0 值类型:Float Byte/s 1024 GES实例 1分钟 ges029_disk_write_throughput 磁盘写吞吐量 统计图实例数据磁盘每秒写入的数据量。 ≥0 值类型:Float Byte/s 1024 GES实例 1分钟 ges030_avg_disk_sec_per_read 磁盘读耗时 统计图实例数据磁盘每次读取数据的平时耗时。 ≥0 值类型:Float s 不涉及 GES实例 1分钟 ges031_avg_disk_sec_per_write 磁盘写耗时 统计图实例数据磁盘每次写入数据的平时耗时。 ≥0 值类型:Float s 不涉及 GES实例 1分钟 ges032_avg_disk_queue_length 磁盘平均队列长度 统计每个图实例数据磁盘平均的I/O队列长度。 ≥0 值类型:Int Count 不涉及 GES实例 1分钟
-
响应示例 状态码: 200 OK Http Status Code: 200
{
"jobId": "ff80808167f09aaa0167f19b35ec0305",
"status": "success",
"jobType": "GraphManagement",
"jobName": "ImportGraph",
"relatedGraph": "GES_UI_AUTO",
"beginTime": "2018-11-27T21:39:00",
"endTime": "2018-11-27T21:39:56",
"jobDetail": {
"vertexsetPath": [
{
"path": "ges-ui/auDatas/list_set_vertex.csv",
"log": null,
"cause": null,
"status": "success"
}
],
"edgesetPath": [
{
"path": "ges-ui/auDatas/list_set_edge.csv",
"log": null,
"cause": null,
"status": "success"
}
],
"schemaPath": [
{
"path": "ges-ui/auDatas/list_set_schema.xml",
"log": null,
"cause": null,
"status": "success"
}
]
},
"jobProgress": 0
} 状态码: 400 Bad Request {
"errorMessage" : "can not find job, jobId is ff808081646e81d40164c5fb414b2b1a1",
"errorCode" : "GES.8301"
}
-
响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 jobId String 任务ID。 status String 任务状态。 pending:等待中。 running:运行中。 success:成功。 partiallyFailed:部分成功。 failed:失败。 jobType String 任务类型。 jobName String 任务名称。 relatedGraph String 关联图名称。 beginTime String 任务开始时间,格式为UTC,"yyyy-MM-dd'T'HH:mm:ss" endTime String 任务结束时间,格式为UTC,"yyyy-MM-dd'T'HH:mm:ss" jobDetail JobDetail object 只有jobName为ImportGraph时才返回,用于显示导入图详情。 failReason String 任务失败原因。 jobProgress Double 任务执行进度,预留字段,暂未使用。 表4 JobDetail 参数 参数类型 描述 schemaPath Array of schemaPath objects 元数据路径。 edgesetPath Array of edgesetPath objects 边数据集路径。 vertexsetPath Array of vertexsetPath objects 点数据集路径。 表5 schemaPath 参数 参数类型 描述 path String OBS文件路径。 log String OBS文件导入的日志存储文件。 status String OBS文件导入状态。 success:完全成功 failed:完全失败 partFailed:部分成功 cause String 导入失败原因。 表6 edgesetPath 参数 参数类型 描述 path String OBS文件路径。 log String OBS文件导入的日志存储文件。 status String OBS文件导入状态。 success:完全成功 failed:完全失败 partFailed:部分成功 cause String 导入失败原因。 totalLines Long 导入的总行数,以您的配额以及所创图的规格为准。其值为-1时表示当前版本没有返回该字段。 failedLines Long 导入失败行数。其值为-1时表示当前版本没有返回该字段。 successfulLines Long 导出成功行数。其值为-1时表示当前版本没有返回该字段。 表7 vertexsetPath 参数 参数类型 描述 path String OBS文件路径。 log String OBS文件导入的日志存储文件。 status String OBS文件导入状态。 success:完全成功 failed:完全失败 partFailed:部分成功 cause String 导入失败原因。 totalLines Long 导入总行数。以您的配额以及所创图的规格为准,其值为-1时表示当前版本没有返回该字段。 failedLines Long 导入失败行数。其值为-1时表示当前版本没有返回该字段。 successfulLines Long 导出成功行数。其值为-1时表示当前版本没有返回该字段。
-
响应参数 表2 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 result String 响应结果。成功时result值为success。 data Object 当批量添加部分失败时,data字段包含失败的label_name以及失败原因。
-
响应示例 状态码: 200 成功响应示例 Http Status Code: 200
{
"jobId": "f99f60f1-bba6-4cde-bd1a-ff4bdd1fd500000168232",
"jobType": 3
} 状态码: 400 失败响应示例 Http Status Code: 400
{
"errorMessage":"Parameter error!",
"errorCode":"GES.8005"
}
-
响应示例 状态码: 200 成功响应样例 {
"data": {
"edges": [
{
"source": "46",
"target": "39",
"label": "rate",
"sortKey": 5,
"properties": {
"Rating": [
5
],
"Datetime": [
"2018-01-0120:30:05"
]
}
}
]
},
"result": "success"
} 状态码: 400 失败响应示例 Http Status Code: 400
{
"errorMessage": "Graph [31dc8f201e6246768fde20492d4a9875-demo] does not exist, please check projectId and graphName.",
"errorCode": "GES.8000",
"result": "failed"
}