# 数据库、数据导入与 SQL 编辑器

通过实例列表中的 **连接 > 通过云平台连接** 登录 MatrixOne **数据库管理平台**后，可在浏览器中管理数据库对象与跨实例数据发布/订阅、导入样例或对象存储数据、在 SQL 编辑器中编写和可视化查询结果，并在查询历史中查看执行计划与 CU 消耗。

## 管理数据库与数据分享

在左侧导航打开**数据库**，可浏览当前实例中的数据库和表对象（展示表数目、库大小、所有者与创建时间），并按关键字搜索库或表。

### 发布与订阅数据

数据库页面支持通过**发布**和**订阅**在实例之间共享只读数据：

1. **添加发布**：在**发布**页签点击**添加发布**，输入**发布名**（仅支持字母、数字、下划线和 `$`，且不能重复），选择**发布数据库**（系统库与订阅库不支持发布），并在**发布目标**中选择本组织实例或其他组织实例。当前发布权限为只读（`READONLY`）。
2. **管理发布**：可按数据库或目标实例 ID 搜索，对已有发布执行编辑或删除；如果某数据库正在发布中，删除前需先删除对应发布记录（删除后关联订阅将无法继续访问数据）。
3. **管理订阅**：在**订阅**页签查看其他实例发布的数据库与订阅状态，按需要创建或管理订阅访问。

## 导入数据

点击**导入数据**可从内置样例或外部对象存储快速向表写入数据：

- **样例数据快速体验**：选择 **TPC-H** 样例数据集，一键导入至当前实例的样例数据库（如 `mo_sample_data_tpch_sf1`）并直接在 SQL 编辑器运行查询。导入过程中请勿关闭当前浏览器页签。
- **从对象存储导入 CSV / JSON**：选择 **CSV 文件**或 **Json 文件**导入场景，填写对象存储 Bucket URL，选择认证方式（**IAM 角色 ARN** 或 **阿里云 AccessKey / AWS 访问密钥**），再选择或填写目标**数据库**和**表**执行导入。开始导入前请确认 SQL 编辑器中没有正在冲突执行的操作，或按页面提示稍后重试。

> 需要接入非结构化文档、REST API、Kafka 或通过工作流编排复杂处理管道时，请使用 AI Studio 的[数据连接](../ai-studio/data-sources/index.md)与[数据处理](../ai-studio/processing/index.md)。

## 使用 SQL 编辑器

打开 **SQL 编辑器**可执行交互式查询并保存工作簿：

1. 在左侧树选择目标数据库，并在工作簿列表新建或打开已有工作簿（工作簿可搜索、重命名或删除；单个工作簿内容上限为 **1 MB**，超出限制需新建工作簿继续编辑）。
2. 在编辑区编写 SQL 语句后点击运行；下方结果区可折叠、最小化、最大化或还原窗口尺寸。
3. 结果生成后，可切换到**图表**页签，选择图表类型（**柱状图**、**饼图**或**折线图**）并配置 X 轴、Y 轴及聚合方式进行可视化展示。

完整 SQL 语法、数据类型与内置函数见[SQL 参考](../../reference/sql/index.md)。

## 查询历史与执行分析

打开**查询历史**可查看并审计当前实例执行的 SQL 记录：

1. 按状态（**所有**、**运行中**、**成功**、**失败**）或展开**筛选项**按 SQL 语句、数据库、用户名、查询 ID、连接 ID、事务 ID、执行时长阈值及时间范围筛选记录，并支持将筛选结果下载到本地。
2. 列表展示每条查询的 SQL 文本、状态、SQL 类型、时长、开始/结束时间、读行数、扫描数据量、结果行数和 **CU** 消耗。
3. 点击目标记录打开**查询详情**，可查看完整查询信息、**查询结果**，以及切换到**查询分析**查看可视化的 SQL 执行计划树（点击算子节点可查看对应算子 SQL 片段及 CPU、内存概览）。

## 完成标志与后续操作

- 在**数据库**列表中确认新导入或订阅的数据表可见，在 **SQL 编辑器**成功执行 `SELECT` 并查看**查询历史**中的 `Success` 状态记录，即说明实例工作台已就绪。
- 需要配置实例指标告警或管理实例内角色权限与白名单时，继续查看[实例监控](monitoring.md)与[访问控制与权限](permissions.md)。
