版本：26.x

SelectDB Cloud 快速开始

预计完成时间：10–15 分钟，实际时间取决于仓库创建进度。

本教程将带你创建一个 SelectDB Cloud 仓库，通过浏览器中的 SQL 编辑器写入订单数据，并运行分析查询。完成后，你将掌握从创建资源到查询数据的基本流程。

示例使用 8 条内置订单数据，无需准备文件、对象存储账号或外部数据源，适用于控制台中可选的云厂商和地域。已有可用仓库和计算集群时，可以直接从步骤 3 开始。

步骤 1：注册并登录

打开 SelectDB Cloud 控制台。
如果尚无账号，进入注册页面，按提示填写姓名、手机号和邮箱等信息，完成验证和注册。已有账号时，直接登录。
登录后确认当前组织；需要切换时，使用顶部导航栏的切换组织入口。

创建仓库需要相应的组织权限。如果你加入的是已有组织但无法新建仓库，请联系组织管理员。

步骤 2：创建仓库和计算集群

仓库用于管理数据库、表和数据，计算集群用于执行导入和查询任务。创建仓库时会同时创建初始计算集群。本教程使用由 SelectDB 托管基础设施的 SaaS 仓库。

单击顶部导航栏的仓库切换入口，再单击新建仓库。也可以在组织概览页面单击新建仓库。
在创建仓库页面选择 SaaS，单击继续。

在创建 SaaS 仓库页面填写仓库配置：

配置项	本教程的建议
仓库名称	输入 `selectdb_quickstart`，或其他在当前组织内唯一的名称。
云厂商	选择页面提供的云厂商，例如阿里云。
地域	选择靠近应用程序或客户端的地域。例如，阿里云下可选择华北 2（北京)。具体可选地域随云厂商变化，以当前页面为准。
内核版本	选择页面提供的版本。本文的 SQL 示例适用于 SelectDB Cloud 26.x。
Admin 密码	设置并妥善保存数据库管理员 `admin` 的密码，格式要求见表单提示。
高级设置	本教程可保留默认值。表名大小写在仓库创建后无法修改。

在初始化集群中确认可用区、计算资源和缓存空间。本教程数据量很小，可选择页面允许的小规格资源；保留自动暂停，按需设置空闲时长。
核对配置摘要及费用信息，单击创建。
等待创建完成。进入目标仓库，单击左侧导航栏的计算集群，确认初始集群状态为运行中，再继续下一步。

试用与部署方式

如果组织具有试用资格，可以按控制台展示的试用入口创建仓库。试用时长、资源规格和使用限制以页面提示为准；创建付费资源前，请确认费用和组织可用额度。

如果需要将数据和计算部署在自己的云账号及 VPC 内，请参考创建私有仓库（BYOC）。

步骤 3：打开 SQL 编辑器

在顶部导航栏选择刚创建的仓库，单击左侧导航栏的 SQL 编辑器。
如果提示连接或登录，使用数据库用户 admin 和创建仓库时设置的 Admin 密码。如需更换数据库身份，使用顶部的切换用户入口。
打开或新建查询窗口，选择处于运行中状态的计算集群；初始集群通常名为 initial_cluster。目录选择 internal。
输入以下 SQL，单击运行，验证连接：
```
SHOW DATABASES;
```
结果中应包含系统数据库 information_schema，其他数据库随仓库实际情况而异。

账号与执行方式

控制台账号用于管理云资源，数据库用户用于访问仓库中的数据，两者的密码相互独立。

后续 SQL 请按顺序执行，每次检查执行状态后再继续。查询窗口中有多段 SQL 时，可以选中本次需要执行的语句，再单击运行选中。

SQL 编辑器首页还提供连接查询、全文检索和半结构化数据等 SQL 模板，可以在完成本教程后继续探索。更多操作参见 SQL 编辑器。

步骤 4：创建数据库和表

在 SQL 编辑器中依次执行以下语句。示例统一使用完整表名，避免切换查询窗口或数据库后访问到其他表。

CREATE DATABASE selectdb_quickstart;

CREATE TABLE selectdb_quickstart.orders (
    order_id     BIGINT NOT NULL,
    order_date   DATE NOT NULL,
    region       VARCHAR(20) NOT NULL,
    category     VARCHAR(20) NOT NULL,
    quantity     INT NOT NULL,
    amount       DECIMAL(12, 2) NOT NULL
)
DUPLICATE KEY(order_id, order_date)
DISTRIBUTED BY HASH(order_id) BUCKETS 1;

orders 是一张明细表，每行记录一笔订单的日期、地区、商品类别、数量和金额。示例只使用 1 个分桶，便于小数据量体验；实际业务应根据数据规模设计表结构和分桶。

执行以下语句检查表结构：

DESC selectdb_quickstart.orders;

结果应包含 order_id、order_date、region、category、quantity 和 amount 共 6 个字段。

重复运行教程

如果已有同名数据库或表，请为本次练习选择其他名称，并同步替换后续 SQL 中的名称。不要在已有业务表上直接执行示例写入。

步骤 5：写入并校验数据

执行以下语句，写入 8 条订单数据：

INSERT INTO selectdb_quickstart.orders VALUES
(1, '2026-01-05', '华北', '电子产品', 2, 1200.00),
(2, '2026-01-12', '华东', '家居用品', 3,  600.00),
(3, '2026-01-18', '华南', '电子产品', 1,  800.00),
(4, '2026-01-25', '华北', '家居用品', 2,  400.00),
(5, '2026-02-03', '华东', '电子产品', 2, 1600.00),
(6, '2026-02-10', '华南', '家居用品', 4,  800.00),
(7, '2026-02-16', '华北', '电子产品', 1,  900.00),
(8, '2026-02-22', '华东', '家居用品', 1,  200.00);

写入成功后，执行以下 SQL 校验行数和总金额：

SELECT COUNT(*) AS total_orders, SUM(amount) AS total_amount
FROM selectdb_quickstart.orders;

预期结果：

total_orders	total_amount
8	6500.00

请只执行一次上述 INSERT。本例使用明细模型，重复写入会增加记录；如果结果不是 8 行，请先检查是否重复执行了写入语句。

INSERT INTO ... VALUES 适合本次小数据量体验。批量导入文件或接入业务数据时，请使用数据导入中的相应方式。

步骤 6：运行分析查询

使用同一张订单表，体验分组聚合和按月分析。以下结果均基于步骤 5 中只写入一次的 8 条记录。

按地区汇总订单金额

统计每个地区的订单数、商品数量和订单总金额，按总金额降序排列。

SELECT
    region,
    COUNT(*) AS order_count,
    SUM(quantity) AS total_quantity,
    SUM(amount) AS total_amount
FROM selectdb_quickstart.orders
GROUP BY region
ORDER BY total_amount DESC;

查看预期结果

region	order_count	total_quantity	total_amount
华北	3	5	2500.00
华东	3	6	2400.00
华南	2	5	1600.00

按月比较商品类别的销售额

按月份和商品类别分组，观察不同类别的销售额变化。

SELECT
    DATE_FORMAT(order_date, '%Y-%m') AS order_month,
    SUM(CASE WHEN category = '电子产品' THEN amount ELSE 0 END) AS electronics_amount,
    SUM(CASE WHEN category = '家居用品' THEN amount ELSE 0 END) AS home_amount,
    SUM(amount) AS total_amount
FROM selectdb_quickstart.orders
GROUP BY DATE_FORMAT(order_date, '%Y-%m')
ORDER BY order_month;

查看预期结果

order_month	electronics_amount	home_amount	total_amount
2026-01	2000.00	1000.00	3000.00
2026-02	2500.00	1000.00	3500.00

（可选）使用 MySQL 客户端连接

SelectDB Cloud 兼容 MySQL 网络协议。除浏览器内的 SQL 编辑器外，也可以使用 MySQL 客户端访问同一仓库，无需重复建表或写入数据。

安装 MySQL 客户端。
在目标仓库的左侧导航栏单击连接，选择公网连接。
在 IP 白名单管理中添加客户端实际使用的公网出口 IP。具体操作参见网络设置。
选择 MySQL CLI，复制控制台提供的连接命令，在本地终端执行，并按提示输入数据库用户密码。请保留命令中的实际主机、端口及 TLS 参数，不要使用控制台登录密码。

连接成功后，执行以下查询验证数据：

SELECT COUNT(*) AS total_orders FROM selectdb_quickstart.orders;

结果应为 8。

私网连接、JDBC 和其他数据库工具的配置参见连接方式。

下一步

导入业务数据：了解文件导入和外部数据源接入方式。
管理计算集群：了解扩缩容、暂停及自动暂停。体验结束后，可暂停不再使用的集群；仓库存储等资源仍可能产生费用。
查看资源用量与费用：确认资源消耗和账单；试用仓库需要在试用结束前按需转付费。
开始 POC 前的准备：使用业务数据评估表设计和查询性能。本教程的小型数据集用于熟悉操作流程。

步骤 1：注册并登录​

步骤 2：创建仓库和计算集群​

步骤 3：打开 SQL 编辑器​

步骤 4：创建数据库和表​

步骤 5：写入并校验数据​

步骤 6：运行分析查询​

按地区汇总订单金额​

按月比较商品类别的销售额​

（可选）使用 MySQL 客户端连接​

下一步​