# 目录、数据库、表、卷和文件

使用 `catalog` 浏览和管理目录、数据库、表、卷、文件夹和文件。开始写入前，先读取资源树，确认目标工作区和资源 ID。

```shell
moi-cli -o catalog tree
moi-cli -o catalog list
moi-cli catalog --help
```

`catalog tree` 返回工作区的数据资源层级。创建、更新、清空或删除资源，以及上传文件，都会影响工作区数据。

## 常用操作

使用下列子命令按资源层级操作：

| 目标 | 命令 |
| --- | --- |
| 目录 | `list`、`create`、`info`、`update`、`delete` |
| 数据库 | `list-databases`、`create-database`、`database-info`、`delete-database` |
| 表 | `create-table`、`table-info`、`preview-table`、`truncate-table`、`delete-table` |
| 卷和文件 | `create-volume`、`files`、`upload`、`file-info`、`download-file`、`delete-file` |

复杂请求使用对应子命令的 `--json` 或 `--json-file` 输入；不要根据其他命令猜测字段名称。删除前先读取资源详情或完整路径，确认目标 ID 和所属工作区。