PostgreSQL

介绍

PostgreSQL 可以作为 NocoBase 的主数据库使用，用于存储 NocoBase 系统表数据和主数据源中的业务数据。主数据库在部署 NocoBase 时配置，应用运行后不可删除。

配置项	说明
支持版本	>= 10。
商业版本	社区版、标准版、专业版、企业版均支持。
数据库类型	PostgreSQL。

PostgreSQL 支持继承表能力，适合需要数据模型继承的场景。

插件安装

PostgreSQL 为内置能力，无需单独安装插件。

使用说明

1. 部署 NocoBase 时，在数据库连接配置中选择或填写 PostgreSQL 对应的连接参数。
2. 启动 NocoBase 后，在「数据源管理」中进入「Main」数据源，可以管理主数据库中的数据表和字段。
3. 如需接入数据库中已经存在的表，可以在主数据库管理页使用「从数据库同步」。
4. 配置数据表字段时，可以参考数据表、字段目录选择字段类型和字段组件。

字段类型映射

在主数据库中，通过 NocoBase 页面创建字段时，NocoBase 会根据字段配置创建对应的 PostgreSQL 字段。通过「从数据库同步」接入已有表时，NocoBase 会根据 PostgreSQL 字段类型，自动映射到合适的 Field type 和 Field interface。你可以在字段配置中调整界面展示方式。

常见映射如下：

PostgreSQL 字段类型	NocoBase Field type	可选 Field interface
BOOLEAN	boolean	Checkbox、Switch。
SMALLINT、INTEGER、SERIAL、SMALLSERIAL	integer、boolean、sort	Integer、Sort、Checkbox、Switch、Select、Radio group。
BIGINT、BIGSERIAL	bigInt、sort	Integer、Sort、Checkbox、Switch、Select、Radio group、Unix timestamp、Created at、Updated at。
REAL	float	Number、Percent。
DOUBLE PRECISION	double	Number、Percent。
DECIMAL、NUMERIC	decimal	Number、Percent、Currency。
VARCHAR、CHAR	string、password、uuid、nanoid	Input、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
TEXT	text、json	Textarea、Markdown、Vditor、Rich text、URL、JSON。
UUID	uuid	UUID。
JSON、JSONB	json	JSON。
TIMESTAMP	date	Date、Time、Created at、Updated at。
DATE	dateOnly	Date。
TIME	time	Time。
POINT、LINESTRING、POLYGON、CIRCLE	point、lineString、polygon、circle	Point、Line string、Polygon、Circle、JSON。
ARRAY	array	Multiple select、Checkbox group。

:::warning 注意

不支持的 PostgreSQL 字段类型会在字段配置中单独展示。这类字段需要开发适配后才能在 NocoBase 中作为普通字段使用。

:::

更多通用配置见主数据源介绍。