数据库
Joppa 中的 PostgreSQL、MySQL 和 MariaDB：每个项目一个数据库、扩展（pgvector、PostGIS…）、连接 URL 和 TablePlus。
Joppa 为每种数据库引擎运行一个服务器，使用固定端口；每个项目在其中拥有自己的数据库。这比每个项目一个容器更轻量，你的工具也总是连接到同一个地方。
创建数据库
在服务页面的 数据库 部分：点击 + 新建数据库。为它命名，选择要连接的项目；如果是 PostgreSQL，还可以选择扩展。
通常你甚至不需要这样做：在 环境 标签页中把服务接入项目时，如果项目的数据库不存在，Joppa 会自动创建。
数据库表格会显示每个数据库的大小、扩展和所属项目。每个数据库的菜单：扩展…、复制 URL、删除…。
连接
| 引擎 | URL |
|---|---|
| PostgreSQL | postgresql://postgres:[email protected]:5432/<base> |
| MySQL、MariaDB | mysql://root:[email protected]:3306/<base> |
这些是开发用的凭据，所在的服务器只监听你的本机。
TablePlus
在 TablePlus 中打开（在服务或某个数据库上）会打开一个已命名为「Joppa · 数据库名」、并以绿色标记为本地环境的连接。
在终端中
joppa dbs postgres # 数据库及其 URL
joppa dbs postgres --json # 供脚本使用PostgreSQL 扩展
安装在服务器上
有些扩展需要服务器上的文件。在 版本、端口和扩展… 中选择它们：Joppa 会在下次启动时构建一个包含这些扩展的本地 PostgreSQL 镜像（首次需要几分钟）。现有数据库会保留。
| 扩展 | 用途 |
|---|---|
pgvector（vector） |
嵌入向量和相似度搜索 |
| PostGIS | 地理数据 |
| pgRouting | 路径规划（配合 PostGIS） |
| HypoPG | 假设索引 |
| pg_partman | 分区 |
| pg_stat_statements | 查询统计（预加载） |
始终可用
pg_trgm、uuid-ossp、pgcrypto、citext、hstore、unaccent、fuzzystrmatch。
按数据库
在数据库上使用 扩展… 可以启用或移除扩展。取消勾选扩展会将其从数据库中删除，连同依赖它的内容（vector 列、几何数据…）。
新数据库中默认启用 用于选择创建数据库时预先勾选的扩展；外部工具（迁移、createdb）创建的数据库中也会包含它们。
MySQL 和 MariaDB
MySQL 使用官方镜像（LTS 与 innovation 版本），MariaDB 是它的社区分支，兼容相同的客户端。两者默认都使用 3306 端口：如果同时运行两者，第二个会使用 3307。