> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapxagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据库连接

> 把 MapX 连接到外部 PostgreSQL 或 MySQL 数据库，在对话中查询数据、把结果导入为图层，或把 PostGIS 空间表变成实时地图图层。

数据库连接把 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 实时图层与其它图层行为一致：

* **就地编辑**——打开属性表或编辑几何，修改会立即写回数据库。见[编辑数据与几何](/zh/concepts/layers#编辑数据与几何)。
* **3D 展示**——数据库图层同样支持柱体、抬升路径和挤出多边形。见[3D 视角](/zh/concepts/3d-view)。

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

## 管理连接

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

<Warning>
  数据库连接授予 AI 对所连数据库的读取权限。只连接你有权读取的数据库，并尽可能使用只读账号保存凭据。
</Warning>

AI 如何执行这些操作见[MCP 连接](/zh/concepts/mcp)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.