Postgres.app 技术文档

Postgres.app 技术文档

安装指南

下载

您可以从 Postgres.app 官网 下载最新版本的 Postgres.app。GitHub 的 releases 部分提供了旧版本和预发布版本。

安装步骤

1. 下载完成后，双击下载的 .dmg 文件。
2. 将 Postgres.app 拖动到您的 Applications 文件夹中。
3. 打开 Postgres.app，应用程序将自动初始化并启动 PostgreSQL 服务器。

项目的使用说明

启动和停止服务器

• 启动服务器: 打开 Postgres.app，应用程序将自动启动 PostgreSQL 服务器。
• 停止服务器: 关闭 Postgres.app 或使用应用程序界面中的停止按钮。

运行多个版本的 PostgreSQL

Postgres.app 支持同时运行多个版本的 PostgreSQL。您可以在应用程序界面中选择要启动的版本。

使用 GUI

Postgres.app 提供了一个简洁的 GUI，用于启动和停止服务器，查看服务器状态，以及打开文档。

项目API使用文档

命令行工具

Postgres.app 包含了许多有用的命令行工具，例如：

• PostgreSQL: clusterdb, createdb, createlang, createuser, dropdb, droplang, dropuser, ecpg, initdb, oid2name, pg_archivecleanup, pg_basebackup, pg_config, pg_controldata, pg_ctl, pg_dump, pg_dumpall, pg_receivexlog, pg_resetxlog, pg_restore, pg_standby, pg_test_fsync, pg_test_timing, pg_upgrade, pgbench, postgres, postmaster, psql, reindexdb, vacuumdb, vacuumlo
• PROJ.4: cs2cs, geod, invgeod, invproj, nad2bin, proj
• GDAL: gdal_contour, gdal_grid, gdal_rasterize, gdal_translate, gdaladdo, gdalbuildvrt, gdaldem, gdalenhance, gdalinfo, gdallocationinfo, gdalmanage, gdalserver, gdalsrsinfo, gdaltindex, gdaltransform, gdalwarp, nearblack, ogr2ogr, ogrinfo, ogrtindex, testepsg
• PostGIS: pgsql2shp, raster2pgsql, shp2pgsql

使用 pl/pgsql 调试器

1. 编辑 postgresql.conf 文件，添加以下行：

   shared_preload_libraries = 'plugin_debugger'
   

2. 保存文件后，重启服务器。
3. 在需要调试的数据库中加载调试器扩展：

   CREATE EXTENSION pldbgapi;
   

4. 使用支持的客户端（如 PgAdmin 4）进行调试。

项目安装方式

构建 GUI

如果您只想修改用户界面，不需要重新编译二进制文件。默认情况下，Postgres.app 的构建脚本会从 /Applications/Postgres.app/Contents/Versions 复制二进制文件。

• 确保在 Applications 文件夹中有一个 Postgres.app 的副本。
• 打开 Xcode 文件并开始修改。

构建二进制文件

如果您想构建自己的 PostgreSQL 二进制文件，需要进行以下步骤：

1. 确保安装了所有必要的工具和依赖项（详见 README）。
2. 在 src-xx 目录中，每个目录都包含一个 Makefile，用于下载和构建所有二进制文件。
3. 输入 make 开始构建。

依赖项

• Xcode
• 开发者工具（使用 xcode-select --install 安装）
• Python（版本根据 PostgreSQL 版本不同而不同）
• autoconf, automake, pkgconfig, libtool, cmake（用于构建 PostGIS 和其依赖项）
• docbook-xml-4.5, docbook-xsl-nons, fop（用于构建 PostgreSQL 文档）

通过 MacPorts 或 Homebrew 可以快速安装这些依赖项。