华为云用户手册

条件过滤 为了方便用户对图数据的分析，可以通过设置条件过滤，对图数据进行进一步的过滤分析。 具体操作如下： 进入图引擎编辑器页面，详细操作请参见访问图引擎编辑器。 单击绘图区右侧的，或者在绘图区，选中一个点，单击右键，选择“查看属性”，显示“条件过滤及属性”页面。 在“条件过滤及属性”区，设置条件，然后单击“过滤”。 匹配：默认选中点，可选择过滤点或者边。 类型：默认选中所有类型，可在下拉框中选择点或者边的“类型”，“类型”在用户上传的元数据文件中定义。 添加过滤条件：单击“添加过滤条件”，选中一个“属性”，并选择约束条件（包含“小于、大于、等于、不等于、在范围、存在、不存在、大于或等于、小于或等于”）。“属性”在用户上传的元数据文件中定义。此处可添加多条过滤条件，也可单击右侧“删除”，删除已设置的过滤条件。 图1 设置条件过滤 运行结束后，过滤结果将呈现在绘图区以及结果查询区。 父主题： 访问图和分析图

管理面任务中心 管理面任务中心功能，可用于查看创建图、备份图、启动图、增加备份、导入图、导出图、升级图等操作的异步任务的详情。 具体操作步骤如下： 在左侧导航栏，选择“任务中心” 在“任务中心”页面可以查看对应图所执行任务的类型，任务名称，图名称，关联图，开始时间，结束时间，状态和运行结果。 图1 任务中心 在“运行结果”列中可单击“查看详情”，查看“失败原因”和任务ID。 图2 查看详情 导入图时，如果任务状态为“部分成功”，可以单击“查看详情”，查看失败的数据“类型” ，“导入失败行数”等信息，失败的具体原因，请查看导入图时指定的日志路径（可选），失败的日志会上传到该路径下。 图3 部分成功 在“任务中心”页面，可以通过以下六种方式查找任务： 图4 查找任务方式 通过选择类型查找 通过任务名称查找 通过输入关联图进行查找 通过输入任务状态进行查找 通过输入任务ID进行查找 通过设置时间查找 父主题： 任务中心

下载SDK和驱动 图2 SDK和驱动 下载SDK和驱动： SDK：SDK是对业务面API的封装，推荐使用业务面SDK访问GES图实例。 驱动程序：针对Cypher API访问，推荐使用Cypher-JDBC驱动。详情请参见使用Cypher JDBC Driver访问GES。 选择集群所支持的CPU架构：目前支持的CPU架构有“X86计算”和“ARM”架构。选择完成后单击“下载”按钮进行SDK的下载。 单击“历史版本”：您可以查看到SDK和驱动的历史版本号，CPU架构以及在操作列可以进行“下载”操作。

图引擎实例连接信息 图3 实例信息 选择您已创建的图实例名称，可以查看到以下信息： 内网访问地址：同一私有网络内的弹性云服务器可以通过内网访问地址连接当前图实例。 公网访问地址：使用公网访问地址（弹性IP）可以从互联网访问图实例。同时支持图实例弹性IP的解绑与绑定。 JDBC连接字符串（内网）：当JDBC驱动执行机器和图实例处于同一私有网络时，使用此配置。 JDBC连接字符串（公网）：当JDBC驱动执行机器可以通过互联网访问图实例（已绑定弹性IP）时，使用此配置。

动态拓展 指定某个起始节点id，结合消息传递时间递增和BFS遍历顺序（temporal bfs算法），搜索周围与之相关联的点，输出对应各节点的到达时间以及和源起点之间的距离。具体操作步骤如下： 在左侧“动态图”操作区的“动态拓展”模块内填写参数： 开始和结束的时间以及属性值在上述章节时间轴设置中已经设置完成，如果要修改参数，单击画布左下方进行设置在时间轴设置框内填写，此处不可填写。 sources：指定单个节点作为起始节点ID。 k：拓展深度，表示要拓展的最大级数，取值范围为1-100，默认值为3。 directed：拓展方向（是否考虑边的方向）取值为true或false，默认true。 true：考虑边的方向。 false：不考虑边的方向。 图1 动态拓展 输入完成后，单击“动态拓展”模块右侧的按钮，运行结果将在画布上展示，该算法下使用单滑块播放。例如图2和图3所示，动态图数据会随着时间呈现递增的效果。 图2 运行结果展示1 图3 运行结果展示2 父主题： 动态图

添加label 在图引擎编辑器左侧的元数据列表中，单击，可增加一个新的标签。 Label 名称表示新增标签的名字。 Label 类型可以选择设置的标签类型（点，边或者通用类型），通用类型表示标签既可以表示点，也可以表示边。 自定义点样式：您可以来定义标签的颜色和标记，用来区分各个点。 属性添加，默认实体只展示第一个添加的属性，其余不展示，可手动调整展示哪个属性，画布上会实时响应。 图1 添加label

隐藏label 隐藏单个label的所有点和边 在图引擎编辑器的左侧的元数据列表中，单击元数据旁的“眼睛”按钮，可在图分析结果中隐藏该元数据的所有点和边。 图4 隐藏label 隐藏当前选择的label的点和边 在绘图区，单击图中任意一个点，被选中的点会显示为。 表示label隐藏。在图数据中默认是全部展示的，单击label旁的“眼睛”按钮，可隐藏当前选择的label的点和边（即在画布中不展示或减淡展示）。 表示基于label的实体过滤查询，单击该查询按钮，可以将该标签的点和属性过滤显示出来。

修改label 图版本为2.3.18及以上版本支持该功能。 在图引擎编辑器左侧的元数据列表中，单击想要修改的元数据，会弹出该元数据label详情页。 可以直接修改label的属性名称、基数、数据类型等信息。 若想要隐藏或删除该属性，可以单击操作列的“隐藏”或“删除”按钮进行操作。 若您误删了某个属性或者修改有误，可以单击“复位”按钮，将会回到您上一次保存的数据状态。 修改完成，确认无误后，单击“保存”按钮进行更新。 图3 修改label

label的导入和导出 将当前图的元数据、点边数据集导入到OBS桶内或者从OBS桶内导出。 导入：单击元数据列表中“导入”。在弹出的窗口中，选择要导入的元数据，点边数据集，日志储存路径，边处理以及导入类型后，单击“确定”可将数据从OBS桶内导入到当前图中。 日志储存路径：用于存储导入图过程中不符合元数据定义的点、边数据集和详细日志。 边处理：包括“允许重复边”，“忽略之后的重复边”，“覆盖之前的重复边”和“重复边忽略Label”。重复边默认起点和终点相同，当考虑label时，表示边的起点、终点、label相同才为重复边。 图5 元数据的导入 导出：单击元数据列表中“导出”。在弹出的窗口中，设置要导出的元数据、点边数据集的名称和导出的路径，单击“确定”可将数据导出到OBS桶内。 图6 元数据的导出

删除label 调用接口后，该label相关联的所有数据都会被删除，请您谨慎操作。 图版本小于2.2.18，不支持schema的label删除功能。 持久化版的图不支持schema的label删除功能。 系统默认的label“_DEFAULT_”不支持删除操作。 删除label的操作如下： 如果您想要删除某个label，在图引擎编辑器的左侧的“元数据”列表中，单击元数据旁的“删除”按钮。 图7 删除label 在弹出的确认窗口内，认真阅读完提示信息，确认要删除的label名称后，在框内完整的输入“DELETE”，单击“确定”。 图8 删除确认窗口 删除过程中，画布下方“结果展示区”会显示删除label算法的返回结果。 图9 结果展示 删除过程中，绘图区右侧的条件过滤功能置灰，不可使用。 图10 条件过滤

操作步骤 备份操作的入口有两个：“图管理”页面和“备份管理”页面。 “图管理”页面操作如下： 登录图引擎服务管理控制台。在左侧导航栏，选择“图管理”。 在图管理列表中，选择需要备份的图，在“操作”列单击“备份”。 在弹出的确认提示框中，单击“确定”完成图备份。 图1 图管理页面备份 “图管理”页面里的“备份”操作只是针对所选择的图进行备份，关联图选项不能更改。 在左侧导航栏选择“备份管理”，您可以在备份管理列表中查看正在备份或已备份的数据。 若备份“状态”显示为“备份中”，请耐心等待几分钟，当备份“状态”显示为“成功”时，表示备份成功。 图2 备份管理 “备份管理”页面操作如下： 登录图引擎服务管理控制台。在左侧导航栏选择“备份管理”。 在“备份管理”页面右上角，单击“备份”。 在备份页面，选择“关联图”，即当前用户创建的图，单击“确定”开始备份。 图3 备份管理页面备份 “备份管理”页面的“备份”操作，可选择“关联图”，但是当系统中只有一个图时，也不能更改其关联图选项。 您可以在备份管理列表中查看正在备份或已备份的数据。 若备份“状态”显示为“备份中”，请耐心等待几分钟，当备份“状态”显示为“成功”时，表示备份成功。 图4 备份管理 对已经备份好的图。在“备份管理”页面，您可以查看备份数据的备份名称和类型，关联图名称、状态、规格和架构，备份图的创建时间、结束时间、备份大小和备份时长等。

操作步骤 登录图引擎服务管理控制台。 在左侧导航栏，选择“图管理”。 在图管理列表中，选择需要导入数据的图，在“操作”列选择“导入”。 图1 导入数据 在弹出的导入提示框中，选择以下参数。 元数据：可选择已有元数据或创建新的元数据，具体操作可参考创建元数据。 边数据集：选择对应的边数据集。 点数据集：选择对应的点数据集。若不选择，则以边数据集中的点作为点数据集来源。 日志存储路径：用于存储导入图过程中不符合元数据定义的点、边数据集和详细日志。存储在OBS中可能会产生费用，请及时删除。 边处理：包括“允许重复边”，“忽略之后的重复边”，“覆盖之前的重复边”和“重复边忽略Label”。 边处理的具体含义如下： “边处理”：重复边默认起点和终点相同，当考虑label时，表示边的起点、终点和label相同才为重复边。 “允许重复边”：表示起点到终点之间可以有多条边。 “忽略之后的重复边”：表示起点和终点之间有多条边时，仅保留最先读入的那条边。 “覆盖之前的重复边”：表示起点和终点之间有多条边时，仅保留最后读入的那条边。 “重复边忽略Label”：忽略label时，表示边的起点、终点相同即为重复边。 导入类型：包括“在线导入”和“离线导入”。 持久化版图支持多图管理需要选择图名称，不支持边处理和导入类型。 边数据集和点数据集当前仅支持英文路径和文件夹格式。 目前只支持从OBS中选择边数据集和点数据集，建议您提前将数据文件存储至OBS中，导入OBS的操作请参见OBS《快速入门》。 所选边数据文件或点数据文件中的“Label”和“Label”中“Property”的顺序需与所选元数据文件中的一致，否则会提示“所选边数据/点数据文件与元数据文件不匹配”而无法创建图。关于GES图数据的格式的具体内容可参考图数据的格式。 图数据（包含元数据、边数据集、点数据集）需按照模板中的格式导入。模板中已包含一份电影数据，可单击“下载模板”后直接导入。 单击“确定”完成导入。

从本地或OBS导入数据 在图引擎管理控制台，单击左侧导航栏的“元数据管理”。 在“元数据管理”页面，单击左上角“导入”。 在“导入”页面，您可以在“类型”中选择从“本地”或从“OBS”中导入元数据。 从本地导入 “选择本地文件”：单击“上传”，选择本地的文件。 文件格式必须为xml格式。 “名称”：元数据在图引擎服务中的文件名称。 “存储路径”：选择元数据文件存储的OBS路径。 图1 从本地导入元数据 从OBS导入 “选择文件路径”：单击从OBS中选择元数据文件。 文件格式必须为xml。 您需要提前将元数据文件上传至OBS桶中。 “名称”：元数据在图引擎服务中的文件名称。 图2 从OBS导入元数据 单击“确定”完成操作。 导入完成后，元数据文件将展示在元数据管理页面中。 父主题： 导入元数据

图引擎编辑器介绍 编辑器页面分为图分析区（包括探索区、操作区、元数据区、算法区）、绘图区、查询区、结果展示区、条件过滤及属性区。 图1 编辑器页面 表1 区域说明 区域名称 说明 探索区 提供图相关工具来探索图（例如：路经拓展），具体功能介绍请参考图探索功能。 操作区 通过调用API的方式来添加自定义操作。具体功能介绍请参考添加自定义操作。 元数据区 可以对元数据进行操作（如添加、隐藏、导入或导出等）。具体功能介绍请参考Schema编辑。 算法区 显示了GES服务支持的所有算法，且可在此区域设置各算法相关的属性。完整算法区功能介绍如表2所示。 说明： 算法区选择算法，执行后，画布区将展示包含关键结果的采样子图，对应的执行结果非完整结果。想获取完整返回结果请通过调用API获取。 绘图区 图数据的可视化展示区。绘图区预置了快捷操作，方便您对图数据进行分析。 绘图区详细功能介绍如表3所示。 图数据查询区 可以输入Gremlin查询语句执行查询操作。 可以输入Cypher查询语句执行查询操作。 可以输入DSL查询语句执行查询操作。 结果展示区 包含如下两个页签： 运行记录：具体介绍请参考查看运行记录 查询结果：具体介绍请参考查看查询结果 条件过滤及属性区 在绘图区，可以选中一个点，单击右键，选择“查看属性”，显示该页面。 包含如下三个页签： 条件过滤页签可以设置条件属性，对图数据进行筛选分析。具体介绍请参考条件过滤。 属性页签展示选中点或边的属性信息。 统计信息展示页签会显示出当前所框选的点边对应的标签和节点权重的数量。具体介绍请参考统计信息展示。 图2 算法区 表2 算法区介绍 界面元素 说明 输入算法名称，快速查找对应的算法。 展开算法的参数配置区域。 运行算法。 算法的属性设置区域。每个算法的属性不同，详细信息请参考算法介绍。 图3 绘图区 表3 绘图区介绍 界面元素 说明 第1行： 13表示当前图上的点数据，886813表示整张图的所有点数据。 第2行： 9表示当前图上的边数据，892773表示整张图所有边的数据。 孤立点是指和其余点没有关联，在画布中独立存在的点。 框选内孤立点：框选（Ctrl+ 鼠标左键拖动）画布中的点，单击该按钮可查看框选范围内的所有孤立点。 画布内全量孤立点：直接单击该按钮，可显示画布中所有的孤立点。 选中画布中任意一个点，单击该按钮可查看与当前选中点有关联的所有点。 撤销前一步操作。 恢复被撤销的前一步操作。 选择显示“全图数据”或“当前数据”。 “全图数据”是图的所有数据。 “当前数据”是当前在画布上渲染出来的数据。 可以切换图引擎编辑器的主题，支持浅色、深色和跟随系统三种主题。 选择了“全图数据”或者“当前数据”，在搜索框里输入节点ID，例如2，按回车或者单击查询图标，可快捷搜索出对应的点数据并渲染到图展示区域。 说明： 当前只支持单个顶点ID的输入。 选择“当前数据”搜索，当前画布存在点会高亮显示出来。 单击“清空”，清除画布所有内容。 将画布内容导出，支持导出为png/csv（当前画布的snapshot/点边文件）。 快捷键。 Ctrl+E（选择关联实体）。 Ctrl+‘+’（放大）。 Ctrl+‘-’（缩小）。 Ctrl+Z (撤销 undo)。 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 快捷隐藏点或者边。 适配：Ctrl + F 根据当前屏幕宽度和高度自动缩放所有点和边。 缩小：- 键盘对应 - 键，缩小当前画布显示。 放大：=（+） 键盘对应 + 键，放大当前画布展示。 取消选中：Esc 所有选中的点和边取消选中，高亮状态消失。 放大缩小：滑动鼠标滚轮 滑动鼠标滚轮可以放大缩小画布显示。 图4 力引导布局展示效果 图5 圆形布局展示效果 图6 网格布局展示效果 图7 核心单节点布局展示效果 图8 分层布局展示效果 图9 自动分群布局展示效果 图10 核心双节点布局展示效果 父主题： 访问图和分析图

任务类型和任务名称对应表 表3 对应表 任务类型 任务名称 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 运行算法 800 查询异步任务

操作步骤 在“元数据管理”页面，复制元数据有两个入口： 单击对应元数据文件名称，进入元数据详情页，在页面底端单击“复制”。 在对应的元数据文件的“操作”列，单击“复制”。 定义元数据文件名称以及存储路径。 “名称”：复制后的元数据文件名称，仅需要设置名称，文件格式默认为xml。 “存储路径”：存储元数据文件的OBS路径。 “加密元数据”：默认关闭状态，是否对复制后的元数据进行加密。“密钥源”默认为“KMS”。“密钥名称”用于选择对应的密钥。 图1 复制元数据 单击“确定”，完成复制元数据。 元数据文件复制成功后，新的元数据文件将在“元数据管理”页面呈现。

操作步骤 在图引擎编辑器左侧的操作区内，单击“编辑”后，下方会出现“新增操作”的按钮，单击此按钮。 图1 新增操作 在弹出的新增操作框中填写以下参数： 自定义操作名称：填写名称，方便后续快速查找和使用。 API类型：目前有Cypher查询，Gremlin查询，算法，路径查询等四个类型可供选择。 API请求体：填写想要实现的操作请求体。 自定义操作描述：可对该操作添加说明文字。 如下图例所示： 图2 自定义操作样例 确认无误后，单击“确定”，完成添加。需注意添加后不支持参数的修改。 新增自定义操作会展示在左侧的操作区内，单击右侧的运行键，可在画布上看到该操作实现的效果。 图3 操作集 若您要删除该操作，单击“编辑”按钮，该自定义操作右上角会出现按钮，可进行删除。

时间轴设置 创建动态图后，在“图管理”页面，单击动态图“操作”列的“访问”按钮，进入图引擎编辑器。 在编辑器内，页面会弹出“时间轴设置框”，需要您设置以下参数： 这里设置的参数会同步设置群体演化和动态拓展模块内的参数。 开始时间属性值：用您导入或创建的元数据的属性作为动态图开始时间的属性名称，默认为startime，属性为date或long、int类型。 时间轴开始时间：动态分析图的开始时间(start)，开始时间必须要小于等于结束时间。 结束时间属性值：用您导入或创建的元数据的属性作为动态图结束时间的属性名称，默认为endtime，属性为date或long、int类型。 时间轴结束时间：动态分析图的结束时间(end)。 更多设置：包括“默认设置”或“自定义”。 默认：选择系统设定的默认值。 自定义：包含参数“点边可视持续时间”和“设置label显示的优先级”。 点边可视持续时间：画布上算法结果点边可视化的持续时间，当前仅对动态拓展(Temporal BFS)有效，默认值:604800(7天，时间戳类型，单位为秒)。 该选项针对算法返回的点边数据只有开始时间的数据。 设置label显示的优先级（该选项只有在多标签的动态图下才会显示，多标签图的创建请参考创建图）：支持选择多个label，点属性上相同时间段的优先显示最左边的label数据。 图1 时间轴设置框 完成设置后，单击“确认”。 如果您想修改以上参数，单击画布左下方进行设置。

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().limit(10).values('userid')：查询点的name属性（可不填参数，表示查询所有属性， 一个点每个属性一行结果，只有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关键字高亮

从OBS中导入备份 将导出到OBS的备份文件导入到图中，导入成功后使用该备份还原图实例。 持久化的图暂不支持该功能。 只有2.3.16及以上版本的内存版的图支持该功能，低版本的图需要您先进行升级图操作，升级到最新版本再进行导入。 具体操作步骤如下： 登录图引擎服务管理控制台，在左侧导航栏选择“备份管理”。 在“备份管理”页面右上角，单击“导入”。 在弹出的对话框中，选择将要导入的图和存放备份图数据的OBS路径，单击“是”完成导入备份的图数据。 图1 导入备份数据 OBS导入路径请选择目录层级（文件夹），否则会导致导入备份失败。 任务下发成功后，可以在任务中心查看任务执行情况。 父主题： 备份图和恢复图

导出备份到OBS 为了实现GES跨Region数据迁移，您可以选择将备份文件导出到OBS。 持久化的图暂不支持该功能。 只有2.3.16及以上版本的内存版的图支持该功能，低版本的图需要您先进行升级图操作，升级到最新版本再进行导出。 您需要先在“图管理”页面对图进行成功备份，让图出现在“备份管理”页面，具体操作请参考备份图。 在“备份管理”页面中，关联图的状态是运行中，备份状态是成功的图才可以导出到OBS，否则导出按钮是置灰状态。 登录图引擎服务管理控制台，在左侧导航栏选择“备份管理”。 在备份列表中，选择需要导出的备份数据，在“操作”列，单击“导出”。 在弹出的对话框中，检查备份信息无误后，选择OBS路径。 注意：OBS导出路径只能选择空目录，且导出后该目录下面的图数据文件不能进行删除、新增或者修改操作，否则您再从OBS导入备份到图中时会备份失败。 图1 导出到OBS 选择完成后，单击“是”进行备份。 备份文件存储到OBS会收取费用，具体可以参考OBS服务收费标准。 任务下发成功后，可以在任务中心查看任务执行情况。 父主题： 备份图和恢复图

操作步骤 在“元数据管理”页面，编辑元数据有两个入口： 单击对应元数据文件名称，进入元数据详情页，在页面底端单击“编辑”。 在对应元数据文件的“操作”列，单击“编辑”。 图1 编辑入口 在“编辑”页面： 手动构建页签下，您可以添加Label、添加Property、修改Label名称、通过上移和下移调整Property排序等操作。 可视化构建页签下，您可以拖动点到画布上添加Label，或者单击点或者边，修改label信息 。 修改完成后，单击“确定”保存修改。

请求示例 使用备份文件恢复： MySQL： https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/recovery { "source": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "type": "backup", "backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe" }, "target": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01" } } SQL Server： { "source": { "instance_id": "61879e6085bc44d1831b0ce62d988fd9in04", "type": "backup", "backup_id": "b021670e69ba4538b7b2ed07257306aebr04", "database_name": { "db1": "dbtest1", "db2": "" } }, "target": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04" } } 按时间点恢复： MySQL： { "source": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "type": "timestamp", "restore_time": 1532001446987 }, "target": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01" } } Microsoft SQL Server： { "source": { "instance_id": "61879e6085bc44d1831b0ce62d988fd9in04", "type": "timestamp", "restore_time": 1532001446987, "database_name": { "db1": "dbtest1,dbtest2", "db2": "db2,db02", "db3": "" } }, "target": { "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04" } }

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 switch_option 是 Boolean 是否开启自动扩容。 true为开启。 false为关闭。 limit_size 否 Integer 扩容上限，单位GB。“switch_option”为true时，该参数必填。 取值范围40GB~4000GB，需要大于等于实例当前存储空间总大小。 trigger_threshold 否 Integer 可用存储空间百分比，小于等于此值或者为10GB时触发扩容。“switch_option”为true时，该参数必填。 枚举值： 10 15 20 step_percent 否 Integer 每次自动扩容的步长，单位为百分比，即每次自动扩容当前存储空间的百分比。“switch_option”为true时，且开启了自定义扩容步长功能时，该参数必填。 取值范围为5%~50%。

请求示例 设置实例可用存储空间小于等于总空间10%或者为10GB时触发自动扩容，扩容上限为4000GB。 PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/3d39c18788b54a919bab633874c159dfin01/disk-auto-expansion { "switch_option" : true, "limit_size" : 4000, "trigger_threshold" : 10 } 设置实例可用存储空间小于等于总空间10%或者为10GB时触发自动扩容，扩容上限为4000GB，每次自动扩容当前存储空间的20%。 { "switch_option" : true, "limit_size" : 4000, "trigger_threshold" : 10, "step_percent" : 20 }

接口约束 该接口公测中，如需使用请联系客服申请。 账户余额必须大于等于0元，余额不足会导致自动扩容失败。 该接口仅支持RDS for MySQL和RDS for PostgreSQL磁盘大小为40GB及以上的云盘实例（即存储类型为SSD云盘或极速型SSD）。 实例在进行规格变更、内核小版本升级、备机迁移、重启时，不能进行自动扩容。 包周期实例存在未完成订单时，不会自动扩容。 实例状态为“正常”和“存储空间满”时可以进行扩容。最大可自动扩容至4000GB。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 slow_log_list Array of objects 具体信息。 详情请参见表3。 total_record Integer 总记录数。 表3 slow_log_list字段数据结构说明 名称 参数类型 说明 count String 执行次数。 time String 执行时间。 lock_time String 等待锁时间。 rows_sent String 结果行数量。 rows_examined String 扫描的行数量。 database String 所属数据库。 users String 账号。 query_sample String 执行语法。慢日志默认脱敏显示，如需明文显示，请联系客服人员添加白名单。 type String 语句类型。 start_time String 发生时间，UTC时间。 client_ip String IP地址。 正常响应样例 { "total_record": 1, "slow_log_list": [ { "count": "1", "time": "1.04899 s", "lock_time": "0.00003 s", "rows_sent": "0", "rows_examined": "0", "database": "mysql", "users": "root", "query_sample": "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N, @time_zone_id);", "type": "INSERT", "start_time": "2018-08-06T10:41:14", "client_ip": "192.*.*.1" } ] } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3.1/{project_id}/instances/{instance_id}/slowlog?start_date={start_date}&end_date={end_date} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 要查询的实例ID。 start_date 是 开始日期，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 end_date 是 结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的慢日志。 offset 否 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 支持最多查询数据库最近的2000条慢日志信息，参数值须满足offset + limit取值小于等于2000。示例：offset取值为1900，limit取值100。 limit 否 每页多少条记录（查询结果），取值范围是1~100，不填时默认为10。 type 否 语句类型，取空值，表示查询所有语句类型，也可指定如下日志类型： INSERT UPDATE SELECT DELETE CREATE

URI URI格式 GET /v3.1/{project_id}/instances/{instance_id}/errorlog?start_date={start_date}&end_date={end_date} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 要查询的实例ID。 start_date 是 开始时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 end_date 是 结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 只能查询当前时间前一个月内的错误日志。 offset 否 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 limit 否 每页多少条记录（查询结果），取值范围是1~100，不填时默认为10。 level 否 日志级别，默认为ALL，可取值如下： ALL INFO LOG WARNING ERROR FATAL PANIC NOTE