Radim Marek：深入探讨PostgREST - 休假管理器（第一部分）
内容提要
boringSQL旨在探索SQL和PostgreSQL生态系统，展示这些工具如何应对软件开发中的噪音和复杂性。本系列将引导您构建一个完全功能的休假管理器应用程序，演示实用的数据库/SQL方法，并提供一个可扩展的解决方案。第一部分关注应用程序逻辑和使用postgREST暴露原始数据，帮助您理解概念。教程假设您已安装PostgreSQL，使用数据库客户端连接到它，并了解模式操作和SQL的基础知识。
延伸解读
PostgREST 的快速 CRUD 暴露
文章展示了如何通过简单的配置文件将 PostgreSQL 表直接暴露为 REST API，并支持完整的 CRUD 操作。读者可以了解到，只需定义 db-uri、db-schema 和 db-anon-role，就能用 cURL 进行数据查询和修改。这种方式适合快速原型开发，但需注意权限控制，如为匿名角色授予表级权限。
数据库模式设计要点
示例中的 users 表通过 manager_id 自引用实现层级关系，为后续审批工作流打下基础。leave_types 和 time_off_transactions 表则分别定义请假类型和交易记录，其中 time_off_period 使用 daterange 类型，amount 为整数，简化了天数计算。这种设计贴近实际，但初始余额假设所有员工全年满额，未考虑年中入职等场景。
模式缓存与重载机制
PostgREST 会缓存数据库模式元数据以提升性能，因此修改表结构后必须重载缓存，否则新对象会返回 404。文章提到可通过重启服务或发送 SIGUSR1 信号来重载。这是使用 PostgREST 时容易忽略的步骤，尤其在开发迭代中需特别注意。
安全与生产环境注意事项
教程中硬编码了数据库连接信息，并直接使用匿名角色访问数据，这仅适用于学习目的。生产环境应遵循最佳实践，如使用独立数据库用户、避免在代码库中存储密码，并考虑更细粒度的权限控制。文章也提示，第二部分将迁移到新的 api 模式，以提供更安全的访问方式。
Q&A
PostgREST是什么，它的主要功能是什么？
PostgREST是一个将PostgreSQL数据库暴露为RESTful API的工具，主要功能是提供CRUD操作，方便开发者通过HTTP请求访问和操作数据库中的数据。
如何创建一个休假管理器应用程序？
创建休假管理器应用程序需要使用PostgreSQL创建数据库，定义用户模型和请假类型表，并使用PostgREST暴露这些数据以实现CRUD功能。
在PostgREST中如何配置数据库连接？
在PostgREST中配置数据库连接需要创建一个postgrest.conf文件，设置db-uri、db-schema和db-anon-role等参数，以便连接到PostgreSQL数据库。
休假管理器的主要需求是什么？
休假管理器的主要需求包括维护用户列表、时间休假余额和审批工作流，以便有效管理员工的请假情况。
如何使用cURL命令访问PostgREST暴露的用户数据？
可以使用cURL命令如`curl http://localhost:3000/users`来访问PostgREST暴露的用户数据，支持多种查询和操作。
如何定义请假类型和请假交易的表？
请假类型和请假交易的表可以通过SQL语句创建，分别定义请假类型的属性和记录请假交易的详细信息。
