配置阿里云CLI并安装SelectDB插件后,您只需用自然语言描述需求,即可由Agent调用阿里云CLI完成云数据库SelectDB实例的管控操作。本文以创建Serverless实例为例,为您介绍完整的操作流程。
背景信息
阿里云CLI(Alibaba Cloud CLI)是基于阿里云OpenAPI构建的命令行工具,安装SelectDB插件后,即可通过命令完成实例的查询、创建和删除等管控操作。
本文中的Agent指具备本地命令行执行能力的AI助手(例如Claude Code、Codex等),它能够根据自然语言指令在本地执行命令并读取返回结果。因此,您无需记忆具体的命令和参数,只需使用自然语言描述需求,即可由Agent调用阿里云CLI完成实例管控操作。
前提条件
已安装阿里云CLI。本文以macOS环境为例,安装方法请参见安装/更新阿里云CLI。
配置与管理身份凭证。由于阿里云账号(主账号)具有资源的所有权限,一旦泄露将面临重大风险,建议您使用RAM用户的AccessKey,并为该RAM用户授予AliyunSelectDBFullAccess权限。授权操作,请参见管理RAM用户的权限。
已准备具备本地命令行执行能力的Agent客户端。
步骤一:配置阿里云CLI
执行以下命令,创建名为
AkProfile的配置。aliyun configure --profile AkProfile在交互过程中,依次填入AccessKey ID、AccessKey Secret和地域ID等信息。返回如下信息,表示配置成功。
Configuring profile 'AkProfile' in 'AK' authenticate mode... Access Key Id []: <yourAccessKeyID> Access Key Secret []: <yourAccessKeySecret> Default Region Id []: cn-hangzhou Default Output Format [json]: json (Only support json) Default Language [zh|en] en: zh Saving profile[AkProfile] ...Done.说明输出格式(Default Output Format)仅支持
json。执行以下命令,安装SelectDB插件。
aliyun plugin install --name selectdb执行以下命令,验证插件是否安装成功。
aliyun selectdb --help返回SelectDB相关的命令列表,表示插件已安装成功。
步骤二:为Agent提供必要的前置信息
在使用Agent管控实例前,建议先引导Agent通过帮助命令自行学习SelectDB的命令用法。向Agent输入以下内容。
本地已安装 aliyun cli 工具,请使用 aliyun selectdb --help 来自行学习相关管控操作,后续将通过 cli 来操控 selectdb 实例如果不提供上述前置信息,而是直接要求Agent通过阿里云CLI管控实例,Agent将在缺少命令用法信息的情况下通过多次试错来补全命令,实测最坏情况下需要试错八次才能正确执行命令,耗时较长。先引导Agent通过aliyun selectdb --help自行学习命令用法,可以大幅减少试错次数,提升执行效率。
Agent执行帮助命令后,会总结出SelectDB的管控能力。常用的实例管理命令如下,均为aliyun selectdb的子命令。
命令 | 说明 |
| 查询指定地域下的实例列表。 |
| 查询指定实例的详细信息。 |
| 创建实例。 |
| 删除实例。 |
上表仅列出部分常用命令,完整的命令列表请以aliyun selectdb --help的实际返回为准。
步骤三:通过Agent创建Serverless实例
向Agent输入以下内容,发起创建实例的请求。
接下来你帮我创建一个 selectdb serverless 实例,参数需要跟我确认一下重要请在输入内容中明确要求Agent与您确认参数,否则Agent可能自行设置实例参数,导致创建的实例不符合预期。
根据Agent的提示,依次确认实例参数。本文示例中确认的参数如下。
参数
示例取值
说明
地域
cn-hangzhou
实例所在的地域。建议选择与需要访问实例的云服务器相同的地域,否则二者无法通过专有网络互通。支持的地域,请参见服务接入点。
付费类型
按量付费(Postpaid)
支持按量付费(Postpaid)和包年包月(Prepaid)。
数据库引擎版本
4.1
支持4.0和4.1,建议选择4.1。
实例规格
selectdb.xlarge
可选规格如下:
selectdb.xlarge:4核32 GB
selectdb.2xlarge:8核64 GB
selectdb.4xlarge:16核128 GB
Serverless实例支持按需弹性伸缩,建议选择较小的规格。
实例备注名称
selectdb-serverless-test
实例的备注名称,便于后续识别和管理实例。
专有网络和交换机
由Agent查询后指定
如果您已有专有网络和交换机,可直接向Agent提供对应的ID;如果没有,可要求Agent查询当前地域下可用的专有网络和交换机。
参数确认完成后,Agent会调用
create-db-instance命令创建实例,并返回实例ID和订单ID。返回示例如下。实例 ID:selectdb-bp1xg08n9**** 订单 ID:2940435177****查询实例状态,确认实例是否创建完成。
实例初始化通常需要几分钟。您可以要求Agent调用
describe-db-instance-attribute命令查询实例状态,实例状态变为ACTIVATION表示实例已创建完成。您也可以登录云数据库SelectDB控制台,在实例列表页面查看实例状态。
后续步骤
实例创建完成后,您可以继续完成以下操作。以下操作同样支持通过Agent调用阿里云CLI完成。
新增集群。一个实例可包含多个集群,如需为不同业务分别设置弹性规则,可在实例中新增集群。具体操作,请参见云数据库SelectDB Serverless版使用。
设置白名单。具体操作,请参见设置白名单。
如需从公网访问实例,需申请公网地址。具体操作,请参见申请和释放公网地址。
连接实例。具体操作,请参见连接实例。