图数据库如何调用HTTP接口清除实例的数据_图数据库(Graph Database)-阿里云帮助中心

当图数据库GDB实例中的数据不再使用但需要保留该实例时，您可以通过调用HTTP接口（controller/engine/dropAllData）的方法清除实例中的数据。本文介绍通过HTTP接口清除图数据库GDB实例数据的方法。

注意事项

清除实例数据后仅保留实例账号信息，且清除的数据不可回滚，请谨慎操作。
如果目标实例下存在只读实例，清除目标实例数据的同时，只读实例的数据会被同步清除，建议您先确保目标实例和只读实例中的数据均不需要使用，然后进行清除数据操作。
清除数据大约耗时5s（数据量越多，耗时时间越长），在清除数据过程中建议您不要执行数据更新操作（执行数据更新操作，可能会导致更新的数据被清理）。

准备工作

如果客户端为ECS实例，您需要确保图数据库GDB实例和ECS实例满足以下条件，以保证网络的连通性。ECS实例信息的查看方法请参见查看实例信息。

所在地域相同，并建议所在可用区相同（以减少网络延时）。
网络类型为专有网络，需确保使用相同的专有网络ID。

说明如果ECS实例的网络类型为经典网络，您可以将ECS实例网络类型转换为专有网络，具体请参见ECS实例从经典网络迁移到专有网络。

操作步骤

添加客户端IP至图数据库GDB实例白名单。
1. 查看并记录客户端的IP地址。
  
  说明如果客户端为ECS服务器，查看ECS服务器IP地址的方法请参见查看实例信息。
2. 将客户端IP地址添加至目标图数据库GDB实例的白名单，添加方法请参见设置白名单。
获取目标图数据库GDB实例信息。
1. 登录图数据库控制台。
2. 在页面左上角，选择实例所在地域。
3. 单击目标实例ID或目标实例所在行操作列的管理。
  - 获取目标实例的账号和账号密码
    在左侧导航栏，单击账号管理，查看目标实例的账号。
    
    说明
    
    如果目标实例当前未创建账号，您可以先创建账号，创建方法请参见创建账号。
    
    如果您忘记需要使用的目标账号密码，您可以单击目标账号所在行操作列的重置密码为目标账号重新设置密码，具体请参见重置密码。
  - 获取目标实例的连接地址和端口
    在基本信息区域，根据业务需求，查看并记录对应连接地址和端口。
    
    如果您需要使用内网地址和内网端口，您可以查看并记录内网地址和内网端口的值。
    
    如果您需要使用外网地址和外网端口，您可以查看并记录外网地址和外网端口的值。
    
    说明如果还未申请外网地址，请先申请外网地址，申请方法请参见申请外网地址。
    
    查看目标实例的当前版本号
    在基本信息区域，查看目标实例的当前版本号是否为“1.0.27”。
    
    是：请直接执行3。
    
    否：请升级内核小版本至1.0.27，升级方法请参见升级内核小版本。
清除实例数据。
注意
- 清除实例数据后仅保留账号信息，且清除的数据不可回滚，请谨慎操作。
- 如果目标实例下存在只读实例，清除目标实例数据的同时，只读实例的数据会被同步清除，建议您先确保目标实例和只读实例中数据均不需要使用，然后进行清除数据操作。
1. 登录客户端。
  
  说明如果客户端为ECS服务器，请根据业务需求选择登录方法，具体请参见登录ECS实例概览。
2. 执行如下命令，清除实例数据。
```
curl -i -u <user>:<password> "<gdbHost>:<gdbPort>/controller/engine/dropAllData?graph_name=user"
```
  说明
  
  <user>：目标实例的账号。
  
  <password>：目标实例的账号密码。
  
  <gdbHost>：目标实例的连接地址（内网地址或外网地址）。
  
  <gdbPort>：目标实例的端口（内网端口或外网端口）。
  示例：
```
curl -i -u gdb_account:******** "gds-bp1t4x427r15331915****.graphdb.rds.aliyuncs.com:8182/controller/engine/dropAllData?graph_name=user"
```
  回显信息中包含如下信息，说明数据清除成功。
```
{"payload":"OK","status":"200 OK"}
```

通过HTTP接口清除实例数据

注意事项

准备工作

操作步骤

相关文档