数据库连接

数据库连接把 MapX 与外部 PostgreSQL 或 MySQL 数据库关联起来。连接后，AI 可以检查表结构并执行只读查询，你可以把查询结果导入为地图图层，PostGIS 空间表也能直接变成地图上的实时图层——无需导出数据。

​

添加连接

1. 打开仪表盘的数据源。
2. 添加连接，填写主机、端口、数据库名、用户名和密码。
3. 选择 SSL 模式（disable 或 require）并测试连接。

密码加密存储，API 不会返回。运行时访问在服务端完成，凭据不会进入 AI 沙箱。

​

在对话中查询

连接后，用自然语言让 AI 探索数据库：

• 「列出我分析数据库里的所有表。」
• 「显示 orders 表的字段。」
• 「统计最近 30 天各区域的订单数量。」

AI 会先检查表结构，再执行只读 SQL。查询限制为只读操作，写操作会被拒绝。

​

导入为地图图层

当表包含空间字段（PostGIS geometry 或 MySQL spatial 类型）时，可以直接导入为地图图层。非空间的查询结果同样可以可视化。

​

把 PostGIS 表用作实时图层

如果你的 PostgreSQL 数据库启用了 PostGIS，可以直接把某个空间表放到地图上作为图层。选择表后，MapX 会像渲染普通图层一样渲染它——可以按属性配色、筛选、执行分析，并且与数据库保持同步：底层表发生变化时，图层也会随之更新。 PostGIS 实时图层与其它图层行为一致：

• 就地编辑——打开属性表或编辑几何，修改会立即写回数据库。见编辑数据与几何。
• 3D 展示——数据库图层同样支持柱体、抬升路径和挤出多边形。见3D 视角。

MySQL 连接保持原有能力：AI 可以只读查询，并可以把查询结果或空间表导入为地图图层；实时数据库图层是 PostgreSQL（PostGIS）专属能力。

​

管理连接

每个连接会显示状态（active 或 failed）和最近检查时间。你可以禁用某个连接以阻止 AI 使用它，也可以在修改凭据后重新测试。 AI 如何执行这些操作见MCP 连接。