Azimutt 实用指南- 让你的数据库不再是黑盒子

你是不是经常遇到这些情况：接手一个项目，看到数据库里几百张表，完全不知道从哪里下手？或者想找两个表之间的关联，结果在十几层外键里迷路了？别慌，今天介绍的这个工具能让你的数据库变得一目了然。

## 🎯 Azimutt 是什么？

简单来说，Azimutt 就是一个**可视化数据库探索工具**。跟传统的 ER 图工具不同，它专门为真实世界的大型数据库设计——就是那种有几百张表、关系错综复杂的数据库。



https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.azimutt



### 上手指南

应用安装后，先注册一个用户,密码至少要12 character

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/ff80f553-ecff-4690-91e5-310e1113ab61.png "image.png")

有几种方式可以链接数据库，这里我用第一种

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/f777562c-ff83-4340-a247-6513a8bac4ad.png "image.png")

支持 PostgreSQL、MySQL、MongoDB 等主流数据库。

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/b842c9fd-62ad-4c7f-85f8-3eee0c60fbff.png "image.png")

在这里我碰到了这个报错：

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/2e1952dd-7721-4734-b22c-f40406824d42.png "image.png")

打开终端（我用的 Mac 电脑），执行这个命令：npx azimutt@latest gateway
安装好之后，点击 try agin

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/4da4138d-a386-4396-82a2-96deed0a96b6.png "image.png")

这时候就可以了，点击 Create project 新建项目

它检测出了数据库的表结构

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/879bc436-5f21-4eae-a37e-170e56941bc8.png "image.png")
### 1. 智能探索 

**场景**：你想知道用户表和订单表是怎么关联的。

**传统方法**：打开 ER 图，在密密麻麻的线条中找关系，眼睛都看花了。

**Azimutt 方法**：
- 搜索 `users` 表，点击显示
- 点击表格右边的关系图标，选择 `orders`
- 自动显示关联路径，清清楚楚

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/3d0de3e5-b784-4619-8a36-567caba0a855.png "image.png")
**进阶技巧**：使用"Find Path"功能（右上角闪电图标），输入两个表名，Azimutt 会自动找出所有可能的关联路径。

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/4644efe3-dd6d-4eca-91f8-76fdee77da2e.png "image.png")

这个功能在处理多层关联时特别有用.

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/2367baf3-adee-4f5c-9bdd-f7247bb57add.png "image.png")
### 2. 布局管理 

**场景**：一个电商系统有 200 多张表，但你只关心用户模块。

**操作步骤**：
1. 创建新布局，命名为"用户管理"

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/cc020e56-a25a-41cc-b94a-9caf520fd44d.png "image.png")
 搜索并添加相关表：`users`, `user_profiles`, `user_addresses`, `user_permissions`
隐藏不需要的字段，只保留核心字段
保存布局，下次直接打开

这样你就有了一个专门的用户模块视图，不会被其他无关的表干扰。你可以创建多个布局：
- "订单流程"布局
- "库存管理"布局
- "支付系统"布局

每个布局都是独立的，切换起来超方便。不过自部署的版本会有数量限制，一个画布最多 10 个表。

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/f5de8fc4-f765-4d0a-b216-dd95383e1f2a.png "image.png")

### 3. 虚拟关系 - 补充缺失的外键

很多时候，数据库里的关系并没有建立外键约束（可能是历史原因，也可能是性能考虑）。Azimutt 让你可以手动添加这些"虚拟关系"：

1. 点击右上角闪电菜单
2. 选择"Add a relation"

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/23622032-657d-42f8-90c5-d3604466130f.png "image.png")
 选择源表和目标表，指定关联字段
 保存后，这个关系就会在图中显示

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/2227a310-f38f-44b6-8c29-b781275dfcb3.png "image.png")
这个功能特别适合：
- 老项目中没有外键约束的表
- 跨数据库的关联
- 基于业务逻辑的隐式关联

### 4. AML - 快速设计新表

如果你要设计新表，不用画图工具，直接用 AML（Azimutt 的建模语言）：

```aml
users
  id uuid pk
  email varchar(255) unique
  username varchar(50) unique | 用户名，用于登录
  created_at timestamp
  
posts
  id uuid pk
  user_id uuid fk users.id
  title varchar(200)
  content text | 文章内容，支持 Markdown
  published_at timestamp nullable
```

这比拖拽画图快多了！写完直接生成图表，还能导出成 SQL。

它也支持表中数据的查询，方便了解信息

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/6174408a-9a15-4c1b-9f88-ab6a2d414e58.png "image.png")

## 🤔 什么时候用 Azimutt？

**特别适合**：
- 接手遗留项目，需要快速了解数据库结构
- 大型项目（50+ 张表）的日常开发
- 数据库重构前的影响分析
- 新人培训，快速熟悉业务
- 编写技术文档


## 最后的话

Azimutt 不是传统意义上的 ER 图工具，它更像是数据库的"谷歌地图"。你不需要一次看到整个世界，只需要找到你要去的地方就行了。

如果你也厌倦了在复杂的数据库中迷路，不妨试试 Azimutt。它是开源的，基础功能完全免费，而且数据都保存在你的浏览器本地，不用担心安全问题。