操作场景
创建 DatabaseClaw 实例后，您可以在实例管理页面查看、搜索和管理所有实例，包括隔离、重启、下线等生命周期操作。本文介绍如何在控制台管理 DatabaseClaw 实例。
背景信息
DatabaseClaw 实例是 AI DBA 助手的运行载体。每个实例拥有独立的 Skill 配置、SOUL 配置和数据源连接。实例的生命周期由用户自主管控，支持隔离（暂停服务）、重启（恢复异常）和下线（终止服务）三种管理操作。
实现机制
DatabaseClaw 实例的生命周期状态机制如下。
隔离操作：调用后端 API 将实例状态设为
isolated，TKE 集群中对应的 Agent Pod 被暂停（Scale to 0），配置数据保留在数据库中。解除隔离时 Pod 恢复运行。重启操作：删除异常的 Agent Pod 并重新创建，触发 Skill 运行时和数据源连接的重新初始化。
下线操作：执行软删除（Soft Delete），标记实例为
offline，后台异步清理 TKE 资源和关联数据。使用限制
限制项 | 限制说明 |
实例搜索 | 支持按实例名称或实例 ID 进行模糊搜索。 |
状态筛选 | 支持按全部、运行中、已隔离、异常四种状态筛选。 |
下线操作 | 下线为终态操作，执行后不可恢复。 |
注意事项
隔离实例后，该实例将暂停所有服务，但配置信息保留，可随时解除隔离恢复服务。
下线实例后，所有配置（Skill、SOUL、定时任务等）和历史会话记录将被永久清除，操作不可恢复。
每个管理操作均需二次确认，请仔细核对操作对象后再确认执行。
前提条件
已创建至少一个 DatabaseClaw 实例。如尚未创建，请参见 创建 DatabaseClaw 实例。
已被授予
QcloudDatabaseClawUserFullAccess 或 QcloudDatabaseClawAdminFullAccess CAM 策略。操作步骤
查看实例列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. （可选）在实例管理页面，搜索和筛选实例。
在实例管理页面顶部的搜索栏中，输入实例名称或实例 ID 进行搜索。
单击状态筛选下拉框，按全部、运行中、已隔离、异常筛选实例。
4. 查看 DatabaseClaw 实例。
页面顶部展示当前地域及实例数量。您可以通过地域选择器切换查看不同地域的实例。
每个实例卡片展示以下信息：
参数 | 说明 |
实例名称 | 实例的自定义名称，如生产环境-MySQL 巡检助手。 |
实例状态 | 实例当前运行状态，包括创建中、运行中、已隔离、异常、重启中和已下线。 创建中：实例正在创建，尚未就绪。此状态下不可执行任何操作。 运行中：实例正常运行，可接受对话请求。 已隔离：用户主动隔离实例，暂停所有服务。实例配置保留，可随时解除隔离恢复服务。 异常：实例运行异常（Agent 崩溃、连接中断等）。可执行重启或重新安装操作。 重启中：实例正在进行重启操作，重启完成后将恢复运行。 已下线：实例已下线，不可服务。为终态，实例将从列表移除。 |
实例 ID | 实例的唯一标识，格式为 clawins-xxxxxxxx，如 clawins-y5bv7133。 |
地域 | 实例所在地域，如广州。 |
描述 | 实例的描述信息。 |
最近活跃 | 实例最近一次活跃的时间信息。 |
创建时间 | 实例的创建时间。 |
Agent Runtime 状态 | Agent Runtime 的运行状态，如崩溃、正常等。 |
进入对话
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 在实例管理页面，单击目标实例卡片，即可进入该实例的对话页面。
编辑/隔离/重启/下线实例
编辑实例信息：在实例卡片右上方单击
隔离实例：在实例卡片右上方单击
操作成功后，实例状态变为已隔离。
重启实例：在实例卡片右上方单击
下线实例：在状态为已隔离的实例卡片右上方单击
注意：
隔离后实例将暂停所有服务，无法接收新的对话请求。已在执行的任务将被终止。隔离期间实例配置保留，可随时解除隔离恢复服务。
重启实例过程中实例将短暂不可用，重启后实例将自动恢复运行。实例状态不会被清理。
下线实例后，所有配置（Skill、SOUL、定时任务等）和历史会话记录将被永久清除，操作不可恢复。
后续步骤
实例运行正常后，可 使用对话功能 开始 AI 运维。
如需为实例添加数据库连接，请参见 管理数据源。
相关操作
使用对话功能
管理数据源
常见问题
实例状态为“异常”该怎么办？
可尝试通过操作菜单执行重启操作恢复实例。如重启后仍为异常状态，请检查实例所在 VPC 网络是否正常，或联系技术支持。
下线实例后数据会保留吗？
不会。下线操作为终态，实例的所有配置（Skill、SOUL、定时任务等）和历史会话记录将被永久清除，操作不可恢复。
隔离和下线有什么区别？
隔离是暂停服务，实例配置保留，可随时解除隔离恢复；下线是终止服务，所有数据永久清除，不可恢复。
